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 订单的配送地址。
InvoiceData 发票信息(仅适用于中国)。
Money 货币类型和金额。
Order 订单详情。
OrderItem OrderItem 信息。
PaymentExecutionDetailItem 用于支付 COD 订单的次级付款方式的相关信息。

Address

订单的配送地址。

操作

Address 数据类型用于以下操作的响应元素:

数据类型内容

下表显示 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

发票信息(仅适用于中国)。

操作

InvoiceData 数据类型用于以下操作的响应元素:

数据类型内容

下表显示 InvoiceData 数据类型的元素:

名称 描述
InvoiceRequirement 发票要求信息。

InvoiceRequirement 值:

  • Individual - 买家要求对订单中的每件订单商品单独开具发票。
  • Consolidated - 买家要求对订单中的所有订单商品开具一张发票。
  • MustNotSend - 买家不要求开具发票。

可选项

类型:xs:string

BuyerSelectedInvoiceCategory 买家在下订单时选择的发票类目信息。

可选项

类型:xs:string

InvoiceTitle 买家指定的发票抬头。

可选项

类型:xs:string

InvoiceInformation 发票信息。

InvoiceInformation 值:

  • NotApplicable - 买家不- 要求开具发票。
  • BuyerSelectedInvoiceCategory - 亚马逊建议将此项操作返回的 BuyerSelectedInvoiceCategory 值作为发票上的发票类目。
  • ProductTitle - 亚马逊建议将商品名称作为发票上的发票类目。

可选项

类型:xs:string

Money

货币类型和金额。

操作

Money 数据类型用于以下操作的响应元素:

数据类型内容

下表显示 Money 数据类型的元素:

名称 描述
CurrencyCode 三位数的货币代码。格式为 ISO 4217。

类型:xs:string

Amount 货币金额。

类型:xs:string

Order

订单详情。

操作

Order 数据类型用于以下操作的响应元素:

数据类型内容

下表显示 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 值:

  • COD - 货到付款。仅适用于中国 (CN) 和日本 (JP)。
  • CVS - 便利店。仅适用于日本 (JP)。
  • Other - COD 和 CVS 之外的付款方式。
注: 可使用多种次级付款方式为 PaymentMethod = COD的订单付款。每种次级付款方式均表示为 PaymentExecutionDetailItem 对象。

可选项

类型:xs:string

MarketplaceId 订单生成所在商城的匿名编码。

类型:xs:string

BuyerEmail 买家的匿名电子邮件地址。

可选项

类型:xs:string

BuyerName 买家姓名。

可选项

类型:xs:string

ShipmentServiceLevelCategory 订单的配送服务级别分类。

ShipmentServiceLevelCategory 值:

  • Expedited
  • FreeEconomy
  • NextDay
  • SameDay
  • SecondDay
  • Scheduled
  • Standard

可选项

类型:xs:string

ShippedByAmazonTFM 指明订单配送方是否是亚马逊配送 (Amazon TFM) 服务。
注: 亚马逊 TFM 仅适用于中国 (CN)。

可选项

类型: boolean

TFMShipmentStatus 亚马逊 TFM订单的状态。仅当ShippedByAmazonTFM = True时返回。请注意:即使当 ShippedByAmazonTFM = True 时,如果您还没有创建货件,也不会返回 TFMShipmentStatus

TFMShipmentStatus 值:

  • PendingPickUp
  • LabelCanceled
  • PickedUp
  • AtDestinationFC
  • Delivered
  • RejectedByBuyer
  • Undeliverable
  • ReturnedToSeller
注: 亚马逊 TFM 仅适用于中国 (CN)。

可选项

类型:xs:string

CbaDisplayableShippingLabel 卖家自定义的配送方式,属于Checkout by Amazon (CBA) 所支持的四种标准配送设置中的一种。有关更多信息,请参阅您所在商城 Amazon Payments 帮助中心的“设置灵活配送方式”主题。
注: CBA 仅适用于美国 (US)、英国 (UK) 和德国 (DE) 的卖家。

可选项

类型:xs:string

OrderType 订单类型。

OrderType 值:

  • StandardOrder - 包含当前有库存商品的订单。
  • Preorder -所含预售商品(发布日期晚于当前日期)的订单。
注: 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。

可选。仅对没有 PendingAvailabilityPendingCanceled状态的 MFN 订单返回。

类型:xs:dateTime

LatestDeliveryDate 您承诺的订单送达时间范围的最后一天。日期格式为 ISO 8601。

可选。仅对没有 PendingAvailabilityPendingCanceled状态的 MFN 订单返回。

类型:xs:dateTime

OrderItem

OrderItem 信息。

操作

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 不包括ShippingPriceGiftWrapPrice。有关订单商品的更详细说明,请参见 您应了解的“订单 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 值:

  • New
  • Used
  • Collectible
  • Refurbished
  • Preorder
  • Club

可选项

类型:xs:string

ConditionSubtypeId 商品的子状况。

ConditionSubtypeId 值:

  • New
  • Mint
  • Very Good
  • Good
  • Acceptable
  • Poor
  • Club
  • OEM
  • Warranty
  • Refurbished Warranty
  • Refurbished
  • Open Box
  • Any
  • Other

可选项

类型:xs:string

ScheduledDeliveryStartDate 订单预约送货上门的开始日期(目的地时区)。日期格式为 ISO 8601。
注: 预约送货上门仅适用于日本 (JP)。

可选。仅当订单为预约送货上门时才返回。

类型:xs:string

ScheduledDeliveryEndDate 订单预约送货上门的终止日期(目的地时区)。日期格式为 ISO 8601。
注: 预约送货上门仅适用于日本 (JP)。

可选。仅当订单为预约送货上门时才返回。

类型:xs:string

PaymentExecutionDetailItem

用于支付 COD 订单的次级付款方式的相关信息。

操作

PaymentExecutionDetailItem 数据类型用于以下操作的响应元素:

数据类型内容

下表显示 PaymentExecutionDetailItem 数据类型的元素:

名称 描述
Payment 使用同级PaymentMethod响应元素指明的次级付款方式支付的金额。

类型:Money

PaymentMethod COD 订单的次级付款方式。

PaymentMethod 值:

  • COD - 货到付款。仅适用于中国 (CN) 和日本 (JP)。
  • GC - 礼品卡 仅适用于中国 (CN) 和日本 (JP)。
  • PointsAccount - 亚马逊积分。仅适用于日本 (JP)。

类型:xs:string