Amazon Services China
亚马逊商城网络服务(亚马逊 MWS)文档

Deprecation Notice:

Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.

亚马逊 MWS 文档

UpdateFulfillmentOrder

更新和/或请求暂缓配送订单的货件。

描述

通过 UpdateFulfillmentOrder 操作,您可以更新和/或发送暂缓配送的订单。关于暂缓配送订单的信息,请参阅CreateFulfillmentOrder

发送配送订单

要配送暂缓配送的订单,请对订单调用 UpdateFulfillmentOrder 操作并指定 FulfillmentAction = Ship
注: 此操作成功后,您将不能再使用 UpdateFulfillmentOrder 操作更新订单信息。

更新配送订单

要更新暂缓配送的订单,请对订单调用 UpdateFulfillmentOrder 操作并使用可选参数指明您要更新的信息。请使用 FulfillmentAction 参数指明您是否要配送更新后的订单。

限制

UpdateFulfillmentOrder 操作的最大请求限额为 30 个,恢复速率为每秒钟 2 个请求。有关限制术语的定义以及限制的完整解释,请参阅亚马逊MWS开发者指南中的限制:针对提交请求频率的限制

请求参数

名称 描述 必填项
SellerFulfillmentOrderId 指明您要更新的配送订单。之前您通过调用 CreateFulfillmentOrder 创建的。 最大长度:40 个字符

类型:xs:string

FulfillmentAction 指定配送订单应立即配送还是暂缓配送。 FulfillmentAction 值:
  • Ship - 立即配送。
  • Hold - 暂缓配送。

默认值:Hold

类型:xs:string

DisplayableOrderId 您创建的配送订单编号。在面向收件人的材料(如出库货件装箱单)中显示为订单编号。DisplayableOrderId 的值应该和您提供给买家的订单编号一致。您可以使用 SellerFulfillmentOrderId 的值,或指定其他值(如果您想让买家参考其他订单编号)。 长度为 1 到 40 个字符的字母数字或符合 ISO-8559-1 规范的字符串。 一行中不能包含两个空格。删除前后空白。

默认值:您之前通过调用 CreateFulfillmentOrderUpdateFulfillmentOrder 操作指定的值。

类型:xs:string

DisplayableOrderDateTime 配送订单的日期,格式为 ISO 8601。在面向买家的材料(如出库货件装箱单)中显示为订单日期。 默认值:您之前通过调用 CreateFulfillmentOrderUpdateFulfillmentOrder 操作指定的值。

类型:xs:dateTime

DisplayableOrderComment 在面向买家的材料(如出库货件装箱单)中出现的订单详情文本。 最大长度:1000 个字符

默认值:您之前通过调用 CreateFulfillmentOrderUpdateFulfillmentOrder 操作指定的值。

类型:xs:string

ShippingSpeedCategory 配送订单的配送方式。 ShippingSpeedCategory 值:
  • Standard - 标准配送方式。
  • Expedited - 加急配送方式。
  • Priority - 优先配送方式。
  • ScheduledDelivery - 预约送货上门配送方式。预约送货上门仅适用于日本 (JP)。如需更多信息,请参阅计划配送
注: 各商城的配送方式服务水平协议有所不同。查看您所在商城的亚马逊卖家平台网站以了解配送方式服务水平协议和配送费用。

默认值:您之前通过调用 CreateFulfillmentOrderUpdateFulfillmentOrder 操作指定的值。

类型:xs:string

DestinationAddress 配送订单的目的地地址。 如果您没有包含 DestinationAddress 参数,将使用您之前调用 CreateFulfillmentOrder 时的 DestinationAddress 值。如果您包含了 DestinationAddress 参数,将使用您指定的值。不会使用您之前通过调用 CreateFulfillmentOrder 操作指定的任何 DestinationAddress 值。

默认值:您之前通过调用 CreateFulfillmentOrderUpdateFulfillmentOrder 操作指定的值。

类型:Address

FulfillmentPolicy 指明应该如何处理配送订单中无法配送的商品。 FulfillmentPolicy 值:
  • FillOrKill - 如果在订单中的任一货件进入 Pending 状态(已开始从库存中拣货)之前,该配送订单中的商品被确定为无法配送,则整个订单将被视为无法配送。但是,如果在订单中的货件进入 Pending 状态之后,该配送订单中的商品被确定为无法配送,亚马逊将尽可能地取消配送订单。请参阅 FulfillmentShipment 数据类型了解货件状态定义。
  • FillAll - 配送订单中的所有可配送商品。在亚马逊发送或卖家取消所有商品前,配送订单将一直处于“处理中”状态。
  • FillAllAvailable - 配送订单中的所有可配送商品。由亚马逊取消订单中的所有无法配送商品。

默认值:如果您之前通过调用 CreateFulfillmentOrderUpdateFulfillmentOrder 操作指定了值,那个值就是默认值。否则,默认值为 FillOrKill

类型:xs:string

NotificationEmailList 您提供的电子邮箱地址列表,亚马逊将使用此列表代表您向买家发送发货通知。 最大长度:64 个字符(每个电子邮箱地址)

默认值:如果您之前通过调用 CreateFulfillmentOrderUpdateFulfillmentOrder 操作指定了值,那个值就是默认值。否则,默认值为空。

类型:类型:xs:string列表

Items 要包含在配送订单预览中的商品列表,包括数量。 更新某个配送订单商品的 Items 值不会影响您之前通过调用 CreateFulfillmentOrderUpdateFulfillmentOrder 指定的其他配送订单商品的 Items 值。

默认值:您之前通过调用 CreateFulfillmentOrderUpdateFulfillmentOrder 操作指定的值。

类型:UpdateFulfillmentOrderItem列表

响应元素

此操作仅返回 标准响应元素。

示例

查询请求示例

http://mws.amazonservices.jp/FulfillmentOutboundShipment/2010-10-01/
  ?Action=UpdateFulfillmentOrder
  &Version=2010-10-01
  &AWSAccessKeyId=AKIAJGUEXAMPLEE2NVUA
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &Signature=ZRA9DR5rveSuz%2F1D18AHvoipg2BAev8yblPQ1BbEbfU%3D
  &Timestamp=2014-01-02T02:40:36Z
  &SellerId=A2NKEXAMPLEF53
  &SellerFulfillmentOrderId=mws-test-query-20100713023203751
  &DisplayableOrderId=mws-test-query-20100713023203751
  &ShippingSpeedCategory=Standard
  &DestinationAddress.Name=Amazon%20Taro
  &DestinationAddress.Line1=Meguro-ku%20Shimomeguro%2012-34-56
  &DestinationAddress.Line2=XXX%20building%20101
  &DestinationAddress.CountryCode=JP
  &DestinationAddress.StateOrProvinceCode=Tokyo
  &DestinationAddress.PostalCode=1500002
  &DisplayableOrderComment=Seller%20comment%20here
  &DisplayableOrderDateTime=2014-01-02
  &FulfillmentAction=Ship
  &Items.member.1.DisplayableComment=Seller%20comment%20here
  &Items.member.1.GiftMessage=Gift%20comment%20here
  &Items.member.1.PerUnitDeclaredValue.CurrencyCode=JPY
  &Items.member.1.PerUnitDeclaredValue.Value=30
  &Items.member.1.Quantity=1
  &Items.member.1.SellerFulfillmentOrderItemId=mws-test-1
  &Items.member.2.DisplayableComment=Seller%20comment%20here
  &Items.member.2.GiftMessage=Gift%20comment%20here
  &Items.member.2.PerUnitDeclaredValue.CurrencyCode=JPY
  &Items.member.2.PerUnitDeclaredValue.Value=20.00
  &Items.member.2.Quantity=2
  &Items.member.2.SellerFulfillmentOrderItemId=mws-test-2
  &NotificationEmailList.member.1=test1%40amazon.com
  &NotificationEmailList.member.2=test2%40amazon.com

响应示例

<?xml version="1.0"?>
<UpdateFulfillmentOrderResponse xmlns="http://mws.amazonaws.com/FulfillmentOutboundShipment/2010-10-01/">
  <ResponseMetadata>
    <RequestId>d95be26c-16cf-4bbc-ab58-dce89fd4ac53</RequestId>
  </ResponseMetadata>
</UpdateFulfillmentOrderResponse>