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) “订单 API”部分响应元素的数据类型:
数据类型 | 描述 |
---|---|
Address | 订单的配送地址。 |
InvoiceData | 发票信息(仅适用于中国)。 |
Money | 货币类型和金额。 |
Order | 订单详情。 |
OrderItem | OrderItem 信息。 |
PaymentExecutionDetailItem | 用于支付 COD 订单的次级付款方式的相关信息。 |
订单的配送地址。
下表显示 Address 数据类型的元素:
名称 | 描述 |
---|---|
Name | 名称。 类型:xs:string |
AddressLine1 | 街道地址。 类型:xs:string |
AddressLine2 | 其他街道地址信息(如果需要)。 类型:xs:string |
AddressLine3 | 其他街道地址信息(如果需要)。 类型:xs:string |
City | 城市。 类型:xs:string |
County | 区县。 类型:xs:string |
District | 区。 类型:xs:string |
StateOrRegion | 省/自治区/直辖市或地区。 类型:xs:string |
PostalCode | 邮政编码。 类型:xs:string |
CountryCode | 两位数国家/地区代码。格式为 ISO 3166-1-alpha 2
。 类型:xs:string |
Phone | 电话号码。 类型:xs:string |
发票信息(仅适用于中国)。
下表显示 InvoiceData 数据类型的元素:
名称 | 描述 |
---|---|
InvoiceRequirement | 发票要求信息。 InvoiceRequirement 值:
可选项 类型:xs:string |
BuyerSelectedInvoiceCategory | 买家在下订单时选择的发票类目信息。 可选项 类型:xs:string |
InvoiceTitle | 买家指定的发票抬头。 可选项 类型:xs:string |
InvoiceInformation | 发票信息。 InvoiceInformation 值:
可选项 类型:xs:string |
货币类型和金额。
下表显示 Money 数据类型的元素:
名称 | 描述 |
---|---|
CurrencyCode | 三位数的货币代码。格式为 ISO 4217。 类型:xs:string |
Amount | 货币金额。 类型:xs:string |
订单详情。
下表显示 Order 数据类型的元素:
名称 | 描述 |
---|---|
AmazonOrderId | 亚马逊所定义的订单编码,格式为 3-7-7。
类型:xs:string |
SellerOrderId | 卖家所定义的订单编码。 可选项 类型:xs:string |
PurchaseDate | 创建订单的日期。 类型:xs:dateTime |
LastUpdateDate | 订单的最后更新日期。 注: 以错误的订单日期返回 LastUpdateDate,而该日期最近更新于 2009 年 4 月 1 日之前。
类型:xs:dateTime |
OrderStatus | 当前的订单状态。 类型:xs:string |
FulfillmentChannel | 订单配送方式:亚马逊配送 (AFN) 或卖家自行配送 (MFN)。 可选项 类型:xs:string |
SalesChannel | 订单中第一件商品的销售渠道。 可选项 类型:xs:string |
OrderChannel | 订单中第一件商品的订单渠道。 可选项 类型:xs:string |
ShipServiceLevel | 货件服务水平。 可选项 类型:xs:string |
ShippingAddress | 订单的配送地址。 可选项 类型:Address |
OrderTotal | 订单的总费用。 可选项 类型:Money |
NumberOfItemsShipped | 已配送的商品数量。 可选项 类型:xs:int |
NumberOfItemsUnshipped | 未配送的商品数量。 可选项 类型:xs:int |
PaymentExecutionDetail | 货到付款 (COD) 订单的次级付款方式的相关信息。COD 订单是带有PaymentMethod = COD 的订单。包含一个或多个PaymentExecutionDetailItem响应元素。 注: 对于使用某一次级付款方式付款的 COD 订单,将返回一个 PaymentExecutionDetailItem响应元素,其中
PaymentExecutionDetailItem/PaymentMethod = COD。对于使用多种次级付款方式付款的 COD 订单,将返回两个或多个 PaymentExecutionDetailItem响应元素。
可选。仅对 COD 订单返回。仅适用于中国 (CN) 和日本 (JP)。 类型: PaymentExecutionDetailItem 列表 |
PaymentMethod |
订单的主要付款方式。 PaymentMethod 值:
注: 可使用多种次级付款方式为 PaymentMethod = COD的订单付款。每种次级付款方式均表示为 PaymentExecutionDetailItem 对象。
可选项 类型:xs:string |
MarketplaceId | 订单生成所在商城的匿名编码。 类型:xs:string |
BuyerEmail | 买家的匿名电子邮件地址。 可选项 类型:xs:string |
BuyerName | 买家姓名。 可选项 类型:xs:string |
ShipmentServiceLevelCategory | 订单的配送服务级别分类。 ShipmentServiceLevelCategory 值:
可选项 类型:xs:string |
ShippedByAmazonTFM | 指明订单配送方是否是亚马逊配送 (Amazon TFM) 服务。 注: 亚马逊 TFM 仅适用于中国 (CN)。
可选项 类型: boolean |
TFMShipmentStatus | 亚马逊 TFM订单的状态。仅当ShippedByAmazonTFM
= True时返回。请注意:即使当
ShippedByAmazonTFM =
True 时,如果您还没有创建货件,也不会返回
TFMShipmentStatus。
TFMShipmentStatus 值:
注: 亚马逊 TFM 仅适用于中国 (CN)。
可选项 类型:xs:string |
CbaDisplayableShippingLabel | 卖家自定义的配送方式,属于Checkout by Amazon (CBA) 所支持的四种标准配送设置中的一种。有关更多信息,请参阅您所在商城 Amazon Payments 帮助中心的“设置灵活配送方式”主题。
注: CBA 仅适用于美国 (US)、英国 (UK) 和德国 (DE) 的卖家。
可选项 类型:xs:string |
OrderType | 订单类型。 OrderType 值:
注: Preorder 仅在日本 (JP) 是可行的OrderType 值。
类型:xs:string |
EarliestShipDate | 您承诺的订单发货时间范围的第一天。日期格式为 ISO 8601。 可选。仅对卖家配送网络 (MFN) 订单返回。 注: 可能不会对 2013 年 2 月 1 日之前的订单返回 EarliestShipDate。
类型:xs:dateTime |
LatestShipDate | 您承诺的订单发货时间范围的最后一天。日期格式为 ISO 8601。 可选。对卖家配送网络 (MFN) 和亚马逊物流 (AFN) 订单返回。 注: 可能不会对 2013 年 2 月 1 日之前的订单返回 LatestShipDate
。
类型:xs:dateTime |
EarliestDeliveryDate | 您承诺的订单送达时间范围的第一天。日期格式为 ISO 8601。 可选。仅对没有 PendingAvailability、Pending 或 Canceled状态的 MFN 订单返回。 类型:xs:dateTime |
LatestDeliveryDate | 您承诺的订单送达时间范围的最后一天。日期格式为 ISO 8601。 可选。仅对没有 PendingAvailability、Pending 或 Canceled状态的 MFN 订单返回。 类型:xs:dateTime |
OrderItem 信息。
下表显示 OrderItem 数据类型的元素:
名称 | 描述 |
---|---|
ASIN | 商品的亚马逊标准识别号 (ASIN)。 类型:xs:string |
SellerSKU | 商品的卖家 SKU。 可选项 类型:xs:string |
OrderItemId | 亚马逊定义的订单商品识别号。 类型:xs:string |
Title | 商品名称。 可选项 类型:xs:string |
QuantityOrdered | 下面两个子元素的父元素 (两个子元素的类型为:xs:string): 类型:xs:int |
QuantityShipped | 已配送的商品数量。 可选项 类型:xs:int |
ItemPrice | 订单商品的售价。注意,订单商品指的商品和数量。这意味着,ItemPrice 的价值等于商品售价乘以订购数量。请注意:
ItemPrice 不包括ShippingPrice 和GiftWrapPrice。有关订单商品的更详细说明,请参见 您应了解的“订单 API”部分的相关内容。 可选项 类型: Money |
ShippingPrice | 运费 可选项 类型: Money |
GiftWrapPrice | 商品的礼品包装金额。 可选项 类型: Money |
ItemTax | 商品价格的税费。 可选项 类型:Money |
ShippingTax | 运费的税费。 可选项 类型: Money |
GiftWrapTax | 礼品包装金额的税费。 可选项 类型: Money |
ShippingDiscount | 运费的折扣。
可选项 类型:Money |
PromotionDiscount | 报价中的全部促销折扣总计。
可选项 类型:Money |
PromotionIds | PromotionId
元素列表。 可选项 类型:类型列表: xs:string |
CODFee | COD 服务费用。 注: CODFee 是仅在日本 (JP) 使用的响应元素。
可选项 类型:Money |
CODFeeDiscount | 货到付款费用的折扣。
注: CODFeeDiscount 是仅在日本 (JP) 使用的响应元素。
可选项 类型:Money |
GiftMessageText | 买家提供的礼品消息。 可选项 类型:xs:string |
GiftWrapLevel | 买家指定的礼品包装等级。 可选项 类型:xs:string |
InvoiceData | 发票信息(仅适用于中国)。 注: InvoiceData 响应元素仅适用于中国 (CN)。
可选项 类型:InvoiceData |
ConditionNote | 卖家描述的商品状况。
可选项 类型:xs:string |
ConditionId | 商品的状况。
ConditionId 值:
可选项 类型:xs:string |
ConditionSubtypeId | 商品的子状况。
ConditionSubtypeId 值:
可选项 类型:xs:string |
ScheduledDeliveryStartDate | 订单预约送货上门的开始日期(目的地时区)。日期格式为 ISO 8601。 注: 预约送货上门仅适用于日本 (JP)。
可选。仅当订单为预约送货上门时才返回。 类型:xs:string |
ScheduledDeliveryEndDate | 订单预约送货上门的终止日期(目的地时区)。日期格式为 ISO 8601。 注: 预约送货上门仅适用于日本 (JP)。
可选。仅当订单为预约送货上门时才返回。 类型:xs:string |
用于支付 COD 订单的次级付款方式的相关信息。
下表显示 PaymentExecutionDetailItem 数据类型的元素:
名称 | 描述 |
---|---|
Payment | 使用同级PaymentMethod响应元素指明的次级付款方式支付的金额。 类型:Money |
PaymentMethod | COD 订单的次级付款方式。 PaymentMethod 值:
类型:xs:string |