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

出库数据类型

以下是用于亚马逊商城网络服务 (亚马逊 MWS)“配送出库货件 API”部分的请求参数和响应元素的数据类型：

数据类型 描述
Address 邮寄地址信息。
CODSettings 您为货到付款 (COD) 订单设置的货到付款金额。请注意，货到付款配送订单只适用于中国 (CN) 和日本 (JP)。
CreateFulfillmentOrderItem 用于创建配送订单的商品信息。
Currency 货币类型和金额。
DeliveryWindow 发送计划配送订单的时间范围。
Fee 费用类型和金额。
FulfillmentOrder 配送订单的基本信息，包括订单状态。
FulfillmentOrderItem 配送订单的商品信息。
FulfillmentPreview 关于配送订单预览的信息，包括根据配送方式预计的配送和费用信息。
FulfillmentPreviewItem 配送订单预览中货件的商品信息。
FulfillmentPreviewShipment 配送订单预览中货件的配送和商品信息。
FulfillmentShipment 配送订单中货件的配送和商品信息。
FulfillmentShipmentItem 配送订单中货件的商品信息。
FulfillmentShipmentPackage 配送订单中货件的包裹信息。
GetFulfillmentPreviewItem 配送订单预览的商品信息。
ScheduledDeliveryInfo 计划配送信息。
TrackingAddress 用于追踪包裹的地址信息。
TrackingEvent 用于追踪包裹配送的信息。
UnfulfillablePreviewItem 配送订单预览中的无法配送商品的信息。
UpdateFulfillmentOrderItem 用于更新配送订单的商品信息。
Weight 重量单位和数值。

Address

邮寄地址信息。

操作

Address 数据类型用于以下操作的请求参数或响应元素：

数据类型内容

下表列出了 Address 数据类型的元素：

名称 描述 必填项 值
Name 收件人的姓名。 是 最大长度：50 个字符

类型：xs:string
Line1 收件人的街道地址信息。 是 最大长度：60 个字符

类型：xs:string
Line2 其他街道地址信息（如果需要）。 否 最大长度：60 个字符

类型：xs:string
Line3 其他街道地址信息（如果需要）。 否 最大长度：60 个字符

类型：xs:string
DistrictOrCounty 收件人所在的区或县。 否 最大长度：150 个字符

类型：xs:string
City 收件人所在的城市。 必填项，日本除外。请勿在日本使用。 最大长度：50 个字符

类型：xs:string
StateOrProvinceCode 收件人所在的省/自治区/直辖市代码。 是 最大长度：150 个字符

类型：xs:string
CountryCode 收件人所在的国家/地区两位数代码。 是 ISO 3166-1-alpha 2 国家/地区代码。

类型：xs:string
PostalCode 邮政编码（发往美国的货件必须填写）。 否 最大长度：20 个字符

类型：xs:string
PhoneNumber 收件人的电话号码。 否 最大长度：20 个字符

类型：xs:string

CODSettings

您为货到付款 (COD) 订单设置的货到付款金额。请注意，货到付款配送订单只适用于中国 (CN) 和日本 (JP)。

操作

CODSettings 数据类型用于以下操作的请求参数或响应元素：

数据类型内容

下表列出了 CODSettings 数据类型的元素：

名称 描述 必填项 值
IsCODRequired 指明此配送订单是否要求货到付款 (COD)。 否 IsCODRequired 值：
  • true - 要求货到付款。
  • false - 不要求货到付款。
注： IsCODRequired 的 true 值只适用于中国 (CN) 和日本 (JP)。如果在其他商城调用 CreateFulfillmentOrder 时指定 IsCODRequired=true，系统将返回错误。
注： 如果指定 IsCODRequired=true， 还必须指定 PerUnitPrice。关于 PerUnitPrice 的更多信息，请参阅CreateFulfillmentOrderItem。

类型：xs:boolean
CODCharge 买家需要对货到付款订单支付的金额。 否 默认值：0
注： CODCharge 只适用于中国和日本。

类型：Currency
CODChargeTax 买家需要对货到付款订单支付的税费。 否 默认值：0
注： CODChargeTax 只适用于中国和日本。

类型：Currency
ShippingCharge 买家需要对货到付款订单支付的运费金额。 否 默认值：0
注： ShippingCharge 只适用于中国和日本。

类型：Currency
ShippingChargeTax 买家需要对货到付款订单支付的运费的税费。 否 默认值：0
注： ShippingChargeTax 只适用于中国和日本。

类型：Currency

CreateFulfillmentOrderItem

配送订单的商品信息。通过 CreateFulfillmentOrder 操作提交。

操作

CreateFulfillmentOrderItem 数据类型用于以下操作的请求参数：

数据类型内容

下表列出了 CreateFulfillmentOrderItem 数据类型的元素：

名称 描述 必填项 值
SellerSKU 商品的卖家 SKU。 是 最大长度：50 个字符

类型：xs:string
SellerFulfillmentOrderItemId 您创建的用于跟踪配送订单商品的配送订单商品编号。您可以使用此值区分具有相同 SellerSKU 的多件配送商品。例如，您可以向具有相同 SellerSKU 值但 GiftMessage 值不同的配送订单中的两件商品分配不同的 SellerFulfillmentOrderItemId 值。 是 最大长度：50 个字符

类型：xs:string
Quantity 商品数量。 是 类型：xs:int
GiftMessage 给礼物收件人的消息（如适用）。 否 最大长度：512 个字符

类型：xs:string
DisplayableComment 在面向收件人的材料（如出库货件装箱单）中显示的商品详情文本。 否 最大长度：250 个字符

类型：xs:string
FulfillmentNetworkSKU 商品的亚马逊配送网络 SKU。 否 类型：xs:string
PerUnitDeclaredValue 卖家为此商品指定的价格。 否 默认值：0

类型：Currency
PerUnitPrice 买家需要对货到付款 (COD) 订单中的此商品支付的金额。

类型：Currency

注： 货到付款配送订单只适用于中国 (CN) 和日本 (JP)。
 否 默认值：0

类型：Currency
PerUnitTax 买家需要对货到付款 (COD) 订单中的此商品支付的金额的税费。

类型：Currency

注： 货到付款配送订单只适用于中国 (CN) 和日本 (JP)。
 否 默认值：0

类型：Currency

Currency

货币类型和金额。

操作

Currency 数据类型用于以下操作的请求参数或响应元素：

数据类型内容

下表列出了 Currency 数据类型的元素：

名称 描述 必填项 值
CurrencyCode ISO 4217 格式的三位数货币代码。 是 类型：xs:string
Value 货币金额。 是 类型：xs:string

DeliveryWindow

发送计划配送订单的时间范围。

操作

DeliveryWindow 数据类型用于以下操作的请求参数或响应元素：

数据类型内容

下表列出了 DeliveryWindow 数据类型的元素：

名称 描述 必填项 值
StartDateTime 计划配送时间范围的开始日期和时间，格式为 ISO 8601。 是 类型：xs:dateTime
EndDateTime 计划配送时间范围的结束日期和时间，格式为 ISO 8601。 是 类型：xs:dateTime

Fee

费用类型和金额。

操作

Fee 数据类型用于以下操作的响应元素：

数据类型内容

下表列出了 Fee 数据类型的元素：

名称 描述 必填项 值
Name 费用类型。 是 Name 值：
  • FBAPerUnitFulfillmentFee - 配送订单中每件商品的预计费用。
  • FBAPerOrderFulfillmentFee - 预计的订单费用。
  • FBATransportationFee - 预计的配送费用。
  • FBAFulfillmentCODFee - 预计的货到付款 (COD) 费用。此费用只适用于货到付款配送订单预览。
    注： 货到付款配送订单只适用于中国 (CN) 和日本 (JP)。

类型：xs:string
Amount 费用金额。 是 类型：Currency

FulfillmentOrder

关于配送订单的基本信息，包括订单状态。

操作

FulfillmentOrder 数据类型用于以下操作的响应元素：

数据类型内容

下表列出了 FulfillmentOrder 数据类型的元素：

名称 描述 必填项 值
SellerFulfillmentOrderId 您使用 CreateFulfillmentOrder 操作创建并提交的配送订单编号。 是 类型：xs:string
DisplayableOrderId 您在提交 CreateFulfillmentOrder 操作时创建的配送订单编号。在面向收件人的材料（如装箱单）中显示为订单编号。 是 类型：xs:string
DisplayableOrderDateTime 您在提交 CreateFulfillmentOrder 操作时创建的日期。在面向收件人的材料（如装箱单）中显示为订单日期。 是 类型：xs:dateTime
DisplayableOrderComment 您在提交 CreateFulfillmentOrder 操作时创建的文本块。显示在装箱单等面向收件人的材料中。 是 类型：xs:string
ShippingSpeedCategory 您在提交 CreateFulfillmentOrder 操作时选择的配送方式。 是 ShippingSpeedCategory 值：
  • Standard - 标准配送方式。
  • Expedited - 加急配送方式。
  • Priority - 优先配送方式。
  • ScheduledDelivery - 预约送货上门配送方式。预约送货上门仅适用于日本 (JP)。如需更多信息，请参阅计划配送。
注： 各商城的配送方式服务水平协议有所不同。查看您所在商城的亚马逊卖家平台网站以了解配送方式服务水平协议和配送费用。

类型：xs:string
DeliveryWindow 发送计划配送订单的时间范围。 否 类型：DeliveryWindow
DestinationAddress 您在提交 CreateFulfillmentOrder 操作时创建的目的地地址。 是 类型：Address
FulfillmentPolicy 您在提交 CreateFulfillmentOrder 操作时选择的 FulfillmentPolicy 值。 否 FulfillmentPolicy 值：
  • FillOrKill - 如果在订单中的任一货件进入 Pending 状态（已开始从库存中拣货）之前，该配送订单中的商品被确定为无法配送，则整个订单将被视为无法配送。但是，如果在订单中的货件进入 Pending 状态之后，该配送订单中的商品被确定为无法配送，亚马逊将尽可能地取消配送订单。请参阅FulfillmentShipment数据类型了解货件状态定义。
  • FillAll - 配送订单中的所有可配送商品。在亚马逊发送或卖家取消所有商品前，配送订单将仍处于“处理中”状态。
  • FillAllAvailable - 配送订单中的所有可配送商品。由亚马逊取消订单中的所有无法配送商品。

默认值：FillOrKill

类型：xs:string
ReceivedDateTime 亚马逊配送中心接收配送订单的日期，格式为 ISO 8601。 是 类型：xs:dateTime
FulfillmentOrderStatus 配送订单的当前状态。 是 FulfillmentOrderStatus 值：
  • Received - 通过亚马逊商城网络服务 (亚马逊 MWS)接收并经过验证的配送订单。验证包括确定目的地地址是否有效，以及亚马逊的记录是否表明卖家拥有配送此订单的充足可销售（完好无损）库存。卖家可以取消状态为 Received 的配送订单。
  • Invalid - 通过亚马逊商城网络服务 (亚马逊 MWS)接收但无法验证的配送订单。原因包括目的地地址无效，或亚马逊的记录表明卖家没有足够的可销售库存来完成此订单。此时，配送订单无效，且不会发送订单内的任何商品。
  • Planning - 配送订单已发送至亚马逊物流，准备开始准备货件，但尚未从库存中拣货。卖家可以取消状态为 Planning 的配送订单。
  • Processing - 配送订单中至少有一个货件已经开始从库存中拣货。卖家不能取消状态为 Processing 的配送订单。
  • Cancelled - 卖家已取消配送订单。
  • Complete - 配送订单中的所有商品已配送。
  • CompletePartialled - 配送订单中的部分商品已配送；余下商品已取消或无法配送。
  • Unfulfillable - 无法配送订单中的任何商品，原因是亚马逊配送中心工作人员发现库存中没有这些商品，或者没有可销售（完好无损）的库存。

类型：xs:string
StatusUpdatedDateTime 配送订单状态最后更改的日期，格式为 ISO 8601。 是 类型：xs:dateTime
NotificationEmailList 您在提交 CreateFulfillmentOrder 操作时创建的 NotificationEmailList 值。 否 类型：xs:string
CODSettings 您为货到付款 (COD) 订单设置的货到付款金额。 否 只有货到付款订单才会返回 CODSettings。货到付款配送订单只适用于中国 (CN) 和日本 (JP)。

类型：CODSettings

FulfillmentOrderItem

配送订单的商品信息。

操作

FulfillmentOrderItem 数据类型用于以下操作的响应元素：

数据类型内容

下表列出了 FulfillmentOrderItem 数据类型的元素：

名称 描述 必填项 值
SellerSKU 商品的卖家 SKU。 是 类型：xs:string
SellerFulfillmentOrderItemId 您使用 CreateFulfillmentOrder 操作创建并提交的配送订单商品编号。 是 类型：xs:string
Quantity 商品数量。 是 类型：xs:int
GiftMessage 给礼物收件人的消息（如适用）。 否 类型：xs:string
DisplayableComment 在面向收件人的材料（如出库货件装箱单）中显示的商品详情文本。 否 类型：xs:string
FulfillmentNetworkSKU 商品的亚马逊配送网络 SKU。 否 类型：xs:string
CancelledQuantity 卖家取消的商品数量。 是 类型：xs:int
UnfulfillableQuantity 无法配送的商品数量。 是 类型：xs:int
EstimatedShipDateTime 计划从运营中心发送商品的时间，格式为 ISO 8601。请注意，此值可能会有更改。如果货件中包含已取消商品，将不返回 EstimatedShipDateTime。 否 类型：xs:dateTime
EstimatedArrivalDateTime 商品送达的预计时间，格式为 ISO 8601。请注意，此值可能会有更改。如果货件中包含已取消商品，将不返回 EstimatedArrivalDateTime。 否 类型：xs:dateTime
PerUnitDeclaredValue 卖家为此商品指定的价格。 否 默认值：0

类型：Currency
PerUnitPrice 买家需要对货到付款 (COD) 订单中的此商品支付的金额。
注： 货到付款配送订单只适用于中国 (CN) 和日本 (JP)。
 否 默认值：0

类型：Currency
PerUnitTax 买家需要对货到付款 (COD) 订单中的此商品支付的金额的税费。
注： 货到付款配送订单只适用于中国 (CN) 和日本 (JP)。
 否 默认值：0

类型：Currency

FulfillmentPreview

关于配送订单预览的信息，包括根据配送方式预计的配送和费用信息。

操作

FulfillmentPreview 数据类型用于以下操作的响应元素：

数据类型内容

下表列出了 FulfillmentPreview 数据类型的元素：

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

类型：xs:string

IsFulfillable 指明配送订单预览中的订单是否可配送。 是 IsFulfillable 值：
  • true - 可配送
  • false - 不可配送

类型：xs:boolean

IsCODCapable 指明此配送订单预览中的订单是否为货到付款 (COD)。 是 IsCODCapable 值：
  • true - 货到付款。
  • false - 非货到付款。
注： 货到付款配送订单只适用于中国 (CN) 和日本 (JP)。

类型：xs:boolean
EstimatedShippingWeight 此配送订单预览的预计配送重量。 否 类型：Weight
EstimatedFees 此配送订单预览的预计配送费用（如适用）。 否 类型：Fee列表
FulfillmentPreviewShipments 此配送订单预览的可配送出库货件列表。 否 类型：FulfillmentPreviewShipment列表
UnfulfillablePreviewItems 此配送订单预览的无法配送商品列表。 否 类型：UnfulfillablePreviewItem列表
OrderUnfulfillableReasons 与配送订单预览相关的错误代码，说明订单无法配送的原因。 否 错误代码示例：

DeliverySLAUnavailable

InvalidDestinationAddress

类型：类型列表：xs:string
ScheduledDeliveryInfo 计划配送信息。 否 类型：ScheduledDeliveryInfo

FulfillmentPreviewItem

配送订单预览中货件的商品信息。

操作

FulfillmentPreviewItem 数据类型用于以下操作的响应元素：

数据类型内容

下表列出了 FulfillmentPreviewItem 数据类型的元素：

名称 描述 必填项 值
SellerSKU 商品的卖家 SKU。 是 类型：xs:string
SellerFulfillmentOrderItemId 您通过调用 GetFulfillmentPreview 操作创建的配送订单商品编号。 是 类型：xs:string
Quantity 商品数量。 是 类型：xs:int
EstimatedShippingWeight 货件中某商品（根据 SellerSKU 识别）总数的预计配送重量。   类型：Weight
ShippingWeightCalculationMethod 用于计算 EstimatedShippingWeight 的方法。   ShippingWeightCalculationMethod 值：
  • Package - 根据商品的实际重量计算。
  • Dimensional - 根据商品占用的空间计算。

类型：xs:string

FulfillmentPreviewShipment

配送订单预览中货件的配送和商品信息。

操作

FulfillmentPreviewShipment 数据类型用于以下操作的响应元素：

数据类型内容

下表列出了 FulfillmentPreviewShipment 数据类型的元素：

名称 描述 必填项 值
EarliestShipDate 预计从配送中心发送货件的最早日期，格式为 ISO 8601。 是 类型：xs:dateTime
LatestShipDate 预计从配送中心发送货件的最晚日期，格式为 ISO 8601。 是

类型：xs:dateTime
EarliestArrivalDate 预计此货件到达目的地的最早日期，格式为 ISO 8601。 是 类型：xs:dateTime
LatestArrivalDate 预计此货件到达目的地的最晚日期，格式为 ISO 8601。 是 类型：xs:dateTime
FulfillmentPreviewItems 货件中商品的相关信息。 是 类型：FulfillmentPreviewItem列表

FulfillmentShipment

配送订单中货件的配送和商品信息。

操作

FulfillmentShipment 数据类型用于以下操作的响应元素：

数据类型内容

下表列出了 FulfillmentShipment 数据类型的元素：

名称 描述 必填项 值
AmazonShipmentId 由亚马逊分配的货件编号。 是 类型：xs:string
FulfillmentCenterId 发送货件的亚马逊配送中心编号。 是 类型：xs:string
FulfillmentShipmentStatus 货件的当前状态。 是 FulfillmentShipmentStatus 值：
  • Pending - 从库存中拣货的过程已开始。
  • Shipped - 货件中的所有包裹均已离开配送中心。
  • CancelledByFulfiller - 亚马逊配送中心无法按计划配送货件。可能由于库存未位于配送中心的预计位置。取消配送订单后，亚马逊会立即创建新的配送货件，并再次尝试配送该订单。
  • CancelledBySeller - 货件已通过 CancelFulfillmentOrder 请求取消。

类型：xs:string

ShippingDateTime ShippingDateTime 值的含义取决于货件的当前状态。如果 FulfillmentShipmentStatus 当前的值为：
  • Pending - ShippingDateTime 代表货件离开亚马逊配送中心的预计时间。
  • Shipped - ShippingDateTime 代表货件离开亚马逊配送中心的日期。
如果货件包含多个包裹，ShippingDateTime 适用于货件的所有包裹。如果 FulfillmentShipmentStatus 的值是 CancelledByFulfiller 或 CancelledBySeller，则不返回 ShippingDateTime。格式为 ISO 8601。		 否 类型：xs:dateTime
EstimatedArrivalDateTime 货件的预计到达时间，格式为 ISO 8601。请注意，此值可能会有更改。如果货件包含多个包裹，则 EstimatedArrivalDateTime 适用于货件的所有包裹。如果货件已取消，则不返回 EstimatedArrivalDateTime。 否 类型：xs:dateTime
FulfillmentShipmentItem 货件中商品的相关信息。 是 类型：FulfillmentShipmentItem列表
FulfillmentShipmentPackage 货件中单个包裹的相关信息。 否 类型：FulfillmentShipmentPackage列表

FulfillmentShipmentItem

配送订单中货件的商品信息。

操作

FulfillmentShipmentItem 数据类型用于以下操作的响应元素：

数据类型内容

下表列出了 FulfillmentShipmentItem 数据类型的元素：

名称 描述 必填项 值
SellerSKU 商品的卖家 SKU。 否 类型：xs:string
SellerFulfillmentOrderItemId 您使用 CreateFulfillmentOrder 操作创建并提交的配送订单商品编号。 是 类型：xs:string
Quantity 商品数量。 是 类型：xs:int
PackageNumber 包含全部商品的包裹的编号。 否 类型：xs:int

FulfillmentShipmentPackage

配送订单中货件的包裹信息。

操作

FulfillmentShipmentPackage 数据类型用于以下操作的响应元素：

数据类型内容

下表列出了 FulfillmentShipmentPackage 数据类型的元素：

名称 描述 必填项 值
PackageNumber 货件中包裹的编号。 是 类型：xs:int
CarrierCode 向收件人配送货件的承运人。 是 类型：xs:string
TrackingNumber 追踪编码（如果提供）可以用于获取跟踪和配送信息。 否 类型：xs:string
EstimatedArrivalDateTime 包裹的预计到达时间，格式为 ISO 8601。 否 类型：xs:dateTime

GetFulfillmentPreviewItem

配送订单预览的商品信息。

操作

GetFulfillmentPreviewItem 数据类型用于以下操作的请求参数：

数据类型内容

下表列出了 GetFulfillmentPreviewItem 数据类型的元素：

名称 描述 必填项 值
SellerSKU 商品的卖家 SKU。 是 最大长度：50 个字符

类型：xs:string
SellerFulfillmentOrderItemId 您创建的用于跟踪配送订单商品的配送订单商品编号。 是 最大长度：50 个字符

给定请求中的每个 SellerFulfillmentOrderItemId 都必须是独一无二的。

类型：xs:string
Quantity 商品数量。 是 类型：xs:int

ScheduledDeliveryInfo

计划配送信息。

操作

ScheduledDeliveryInfo 数据类型用于以下操作的响应元素：

数据类型内容

下表列出了 ScheduledDeliveryInfo 数据类型的元素：

名称 描述 必填项 值
DeliveryTimeZone 配送订单预览中目的地地址的时区。 是 IANA 时区名称。示例：Asia/Tokyo。

类型：xs:string
DeliveryWindows 计划配送的可用时间范围列表。 是 类型：DeliveryWindow列表

TrackingAddress

用于追踪包裹的地址信息。

操作

TrackingAddress 数据类型用于以下操作的响应元素：

数据类型内容

下表列出了 TrackingAddress 数据类型的元素：

名称 描述 必填项 值
City 城市。 是 最大长度：150 个字符

类型：xs:string
State 省/自治区/直辖市。 是 最大长度：150 个字符

类型：xs:string
Country 国家。 是 最大长度：6 个字符

类型：xs:string

TrackingEvent

包裹配送的追踪事件信息。

操作

TrackingEvent 数据类型用于以下操作的响应元素：

数据类型内容

下表列出了 TrackingEvent 数据类型的元素：

名称 描述 必填项 值
EventDate 配送事件所发生的日期和时间，格式为 ISO 8601。 是 类型：xs:dateTime
EventAddress 配送事件的所发生的城市。 是 类型：TrackingAddress
EventCode 配送事件的事件代码。 是 EventCode 值：
  • EVENT_101 - 已通知承运人取件。
  • EVENT_102 - 已从卖家仓库取件。
  • EVENT_201 - 已在站。
  • EVENT_202 - 配送离站。
  • EVENT_203 - 已到达目的地国家/地区。
  • EVENT_204 - 已开始清关流程。
  • EVENT_205 - 已完成清关流程。
  • EVENT_206 - 取件途中。
  • EVENT_301 - 已发货。
  • EVENT_302 - 配送员在途。
  • EVENT_304 - 已尝试发货。
  • EVENT_306 - 已联系买家安排配送。
  • EVENT_307 - 已安排配送时间。
  • EVENT_308 - 可以进行取件。
  • EVENT_309 - 已退回给卖家。
  • EVENT_401 - 承运人无法配送 - 地址错误。
  • EVENT_402 - 清关延迟。
  • EVENT_403 - 买家地址变更。
  • EVENT_404 - 由于外部因素，配送延迟。
  • EVENT_405 - 包裹破损。
  • EVENT_406 - 承运人无法配送。
  • EVENT_407 - 买家拒收。
  • EVENT_408 - 正在退回给卖家。
  • EVENT_409 - 承运人丢失。
  • EVENT_411 - 单据已收到，但未收到包裹。
  • EVENT_412 - 包裹已收到，但未收到单据。
  • EVENT_413 - 承运人无法配送 - 由于海关费用，买家拒绝签收包裹。
  • EVENT_414 - 承运人分拣错误。
  • EVENT_415 - 已从上一承运人接收。
  • EVENT_416 - 无法配送。
  • EVENT_417 - 包裹分拣错误。
  • EVENT_418 - 包裹延迟。
  • EVENT_419 - 配送地址发生变化，已重新安排配送时间。

类型：xs:string

UnfulfillablePreviewItem

配送订单预览中的无法配送商品的信息。

操作

UnfulfillablePreviewItem 数据类型用于以下操作的响应元素：

数据类型内容

下表列出了 UnfulfillablePreviewItem 数据类型的元素：

名称 描述 必填项 值
SellerSKU 商品的卖家 SKU。 是 最大长度：50 个字符

类型：xs:string
SellerFulfillmentOrderItemId 您通过调用 GetFulfillmentPreview 操作创建的配送订单商品编号。 是 最大长度：50 个字符

类型：xs:string
Quantity 商品数量。 是 类型：xs:int
ItemUnfulfillableReasons 与配送订单预览相关的错误代码，说明商品无法配送的原因。 否 错误代码示例：
  • InventoryUnavailable
  • NoDeliveryOption

类型：xs:string

UpdateFulfillmentOrderItem

用于更新配送订单的商品信息。

操作

UpdateFulfillmentOrderItem 数据类型用于以下操作的请求参数：

数据类型内容

下表列出了 UpdateFulfillmentOrderItem 数据类型的元素：

名称 描述 必填项 值
SellerFulfillmentOrderItemId 您要更新的配送订单商品。之前您通过调用 CreateFulfillmentOrder 操作创建的。 是 最大长度：50 个字符

类型：xs:string
Quantity 商品数量。 是 必须少于或等于之前创建配送订单时为此订单商品指定的数量。必须大于 0。

类型：xs:int
GiftMessage 给礼物收件人的消息（如适用）。 否 最大长度：512 个字符

默认值：如果您之前通过调用 CreateFulfillmentOrder 或 UpdateFulfillmentOrder 操作指定了值，那个值就是默认值。否则，默认值为空。

类型：xs:string
DisplayableComment 在面向收件人的材料（如出库货件装箱单）中显示的商品详情文本。 否 最大长度：250 个字符

默认值：如果您之前通过调用 CreateFulfillmentOrder 或 UpdateFulfillmentOrder 操作指定了值，那个值就是默认值。否则，默认值为空。

类型：xs:string
PerUnitDeclaredValue 卖家为此商品指定的价格。 否 默认值：如果您之前通过调用 CreateFulfillmentOrder 或 UpdateFulfillmentOrder 操作指定了值，那个值就是默认值。否则，默认值为 0。

类型：Currency
PerUnitPrice 买家需要对货到付款 (COD) 订单中的此商品支付的金额。
注： 货到付款配送订单只适用于中国 (CN) 和日本 (JP)。
 否 默认值：如果您之前通过调用 CreateFulfillmentOrder 或 UpdateFulfillmentOrder 操作指定了值，那个值就是默认值。否则，默认值为 0。

类型：Currency
PerUnitTax 买家需要对货到付款 (COD) 订单中的此商品支付的金额的税费。
注： 货到付款配送订单只适用于中国 (CN) 和日本 (JP)。
 否 默认值：如果您之前通过调用 CreateFulfillmentOrder 或 UpdateFulfillmentOrder 操作指定了值，那个值就是默认值。否则，默认值为 0。

类型：Currency

Weight

重量单位和数值。

操作

Weight 数据类型用于以下操作的响应元素：

数据类型内容

下表列出了 Weight 数据类型的元素：

名称 描述 必填项 值
Unit 重量单位。 是 Unit 值：
  • KG - 千克
  • LB - 磅

类型：xs:string

Value 商品重量的数值。 是 类型：xs:string