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 文档

CreateFulfillmentOrder

请求亚马逊将商品从卖家的 亚马逊物流 库存中配送至目的地地址。

描述

CreateFulfillmentOrder 操作将生成一个请求,让亚马逊将商品从亚马逊物流中的卖家库存配送到目的地地址。
注: 如果亚马逊物流中的库存不足以创建配送订单,服务将返回错误。

暂缓配送订单

当您出于某种原因(如验证付款)而需要推迟订单配送时,可以使用 CreateFulfillmentOrder 操作暂缓配送订单。暂缓配送订单不仅可以防止对订单进行配送,而且可以防止配送订单中的库存商品被用于亚马逊网站上的亚马逊物流 (FBA)订单。帮助您避免在亚马逊网站上和通过多渠道配送重复销售您的亚马逊库存。

要创建暂缓配送订单,请调用 CreateFulfillmentOrder 操作并指定 FulfillmentAction = Hold。 关于发送或更新暂缓配送订单的信息,请参阅UpdateFulfillmentOrder

注: 订单配送可以暂缓两周。两周后,如果您没有发送或取消配送订单,配送订单将被自动取消。那时,配送订单中的库存商品将可以被用于亚马逊网站上的亚马逊物流订单。

限制

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

请求参数

名称 描述 必填项
SellerFulfillmentOrderId 您创建的用于跟踪配送订单的配送订单编号。SellerFulfillmentOrderId 对于您创建的每个配送订单都必须是独一无二的。如果您的系统已经创建了唯一的订单编号,您可以将这些编号作为 SellerFulfillmentOrderId 的值。 最大长度:40 个字符

类型:xs:string

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

默认值:Ship

类型:xs:string

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

类型:xs:string

DisplayableOrderDateTime 配送订单日期,格式为 ISO 8601。在面向买家的材料(如出库货件装箱单)中显示为订单日期。 类型:xs:dateTime
DisplayableOrderComment 在面向买家的材料(如出库货件装箱单)中出现的订单详情文本。 最大长度:1000 个字符

类型:xs:string

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

类型:xs:string

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

默认值:FillOrKill

类型:xs:string

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

类型:类型列表:xs:string

CODSettings 货到付款 (COD) 配送订单的货到付款金额。 CODSettings 请求参数只适用于中国 (CN) 和日本 (JP)。如果在其他商城中指定 CODSettings 参数,系统将返回错误。

类型:CODSettings

Items 要包含在配送订单预览中的商品列表,包含数量。 类型:CreateFulfillmentOrderItem列表
DeliveryWindow 指定计划配送订单的配送时间范围。
重要:
  • DeliveryWindow 请求参数的 StartDateTimeEndDateTime 值必须是您之前通过调用 GetFulfillmentPreview 操作返回的值。 如果您指定的 StartDateTimeEndDateTime 值不是 GetFulfillmentPreview 操作返回的值,服务返回错误。
  • 您调用 GetFulfillmentPreview 操作时的可用配送时间范围有可能在稍后调用 CreateFulfillmentOrder 操作时变为不可用。如果此情况发生,服务将返回错误。这时,您需要重新调用 GetFulfillmentPreview 操作,获取当前可用的配送时间范围。

更多信息,请参阅计划配送

否。只有当 ShippingSpeedCategory = ScheduledDelivery 时必填。 DeliveryWindow 请求参数只适用于日本 (JP)。如果在其他商城中指定 DeliveryWindow,系统将返回错误。

类型:DeliveryWindow

响应元素

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

示例

查询请求示例

http://mws.amazonservices.jp/FulfillmentOutboundShipment/2010-10-01/
  ?Action=CreateFulfillmentOrder
  &Version=2010-10-01
  &AWSAccessKeyId=AKIAJGUEXAMPLEE2NVUA
  &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
  &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=ScheduledDelivery
  &DeliveryWindow.StartDateTime=2014-01-03T03:00:00Z
  &DeliveryWindow.EndDateTime=2014-01-03T05:00:00Z
  &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=2013-12-29
  &FulfillmentAction=Hold
  &CODSettings.IsCODRequired=true
  &CODSettings.CODCharge.CurrencyCode=JPY
  &CODSettings.CODCharge.Value=10.00
  &CODSettings.CODChargeTax.CurrencyCode=JPY
  &CODSettings.CODChargeTax.Value=2.00
  &CODSettings.ShippingCharge.CurrencyCode=JPY
  &CODSettings.ShippingCharge.Value=5.00
  &CODSettings.ShippingChargeTax.CurrencyCode=JPY
  &CODSettings.ShippingChargeTax.Value=3.00
  &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.PerUnitPrice.CurrencyCode=JPY
  &Items.member.1.PerUnitPrice.Value=40.00
  &Items.member.1.PerUnitTax.CurrencyCode=JPY
  &Items.member.1.PerUnitTax.Value=2.00
  &Items.member.1.Quantity=1
  &Items.member.1.SellerFulfillmentOrderItemId=mws-test-1
  &Items.member.1.SellerSKU=Sample_SKU_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.PerUnitPrice.CurrencyCode=JPY
  &Items.member.2.PerUnitPrice.Value=22.00
  &Items.member.2.PerUnitTax.CurrencyCode=JPY
  &Items.member.2.PerUnitTax.Value=6.00
  &Items.member.2.Quantity=2
  &Items.member.2.SellerFulfillmentOrderItemId=mws-test-2
  &Items.member.2.SellerSKU=Sample_SKU_2
  &NotificationEmailList.member.1=test1%40amazon.com
  &NotificationEmailList.member.2=test2%40amazon.com

响应示例

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