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.
根据您指定的 AmazonOrderId 返回订单商品。
该 ListOrderItems 操作可为您所指定的 AmazonOrderId 返回订单商品信息。订单商品信息包括 Title、ASIN、 SellerSKU、ItemPrice、 ShippingPrice 以及税费和促销信息。
您可以通过 ListOrders 操作来检索订单商品信息,进而找到您在指定时间段内所创建或更新的订单。所返回的订单中包含 AmazonOrderId。然后,您便可以通过操作使用这些 AmazonOrderId 值,ListOrderItems 以获取每个订单的详细订单商品信息。
请注意:如果订单处于“等待”状态(即已下订单,但未进行付款),则该 ListOrderItems 操作不会返回订单商品的价格、税费、运费、礼品包装或促销信息。当订单状态从“等待”变为“未配送”、“部分配送”或“已配送”状态(即已完成付款)后,ListOrderItems 操作将返回订单商品的价格、税费、运费、礼品包装和促销信息。
如果订单的 OrderStatus 为“等待”,则不会返回以下响应元素。但是,如果订单的 OrderStatus 为“未配送”、“部分配送”或“已配送”,则会返回以下响应元素:
该 ListOrderItems 和 ListOrderItemsByNextToken 操作共享的最大请求限额为 30 个,恢复速率为每 2 秒钟 1 个请求。有关限制术语的相关定义,请参阅您应了解的“订单 API”部分的相关内容。
名称 | 描述 | 必填项 | 有效值 |
---|---|---|---|
AmazonOrderId | 亚马逊所定义的订单编码,格式 为 3-7-7。 | 是 | 类型:xs:string |
名称 | 描述 |
---|---|
NextToken | 生成的字符串,用于将信息传递给下一请求。如果返回 NextToken,将
NextToken 的值传递给
ListOrderItemsByNextToken。如果没有返回 NextToken,则不返回其他订单商品。 可选项 类型:xs:string |
AmazonOrderId | 亚马逊所定义的订单编码,格式
为 3-7-7。
类型:xs:string |
OrderItems | 订单商品列表。 类型:OrderItem 列表 |
https://mws.amazonservices.com/Orders/2013-09-01 ?AWSAccessKeyId=0PB842EXAMPLE7N4ZTR2 &Action=ListOrderItems &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &SellerId=A1XEXAMPLE5E6 &AmazonOrderId=058-1233752-8214740 &Signature=ZQLpf8vEXAMPLE0iC265pf18n0%3D &SignatureVersion=2 &SignatureMethod=HmacSHA256 &Timestamp=2013-09-05T18%3A12%3A21.687Z &Version=2013-09-01
<?xml version="1.0" encoding="utf-8"?> <ListOrderItemsResponse xmlns="https://mws.amazonservices.com /Orders/2013-09-01"> <ListOrderItemsResult> <NextToken>MRgZW55IGNhcm5hbCBwbGVhc3VyZS6=</NextToken> <AmazonOrderId>058-1233752-8214740</AmazonOrderId> <OrderItems> <OrderItem> <ASIN>BT0093TELA</ASIN> <OrderItemId>68828574383266</OrderItemId> <SellerSKU>CBA_OTF_1</SellerSKU> <Title>Example item name</Title> <QuantityOrdered>1</QuantityOrdered> <QuantityShipped>1</QuantityShipped> <ItemPrice> <CurrencyCode>USD</CurrencyCode> <Amount>25.99</Amount> </ItemPrice> <ShippingPrice> <CurrencyCode>USD</CurrencyCode> <Amount>1.26</Amount> </ShippingPrice> <ScheduledDeliveryEndDate>2013-09-09T01:30:00.000-06:00 </ScheduledDeliveryEndDate> <ScheduledDeliveryStartDate>2013-09-071T02:00:00.000-06:00 </ScheduledDeliveryStartDate> <CODFee> <CurrencyCode>USD</CurrencyCode> <Amount>10.00</Amount> </CODFee> <CODFeeDiscount> <CurrencyCode>USD</CurrencyCode> <Amount>1.00</Amount> </CODFeeDiscount> <GiftMessageText>For you!</GiftMessageText> <GiftWrapPrice> <CurrencyCode>USD</CurrencyCode> <Amount>1.99</Amount> </GiftWrapPrice> <GiftWrapLevel>Classic</GiftWrapLevel> </OrderItem> <OrderItem> <ASIN>BCTU1104UEFB</ASIN> <OrderItemId>79039765272157</OrderItemId> <SellerSKU>CBA_OTF_5</SellerSKU> <Title>Example item name</Title> <QuantityOrdered>2</QuantityOrdered> <ItemPrice> <CurrencyCode>USD</CurrencyCode> <Amount>17.95</Amount> </ItemPrice> <PromotionIds> <PromotionId>FREESHIP</PromotionId> </PromotionIds> <ConditionId>Used</ConditionId> <ConditionSubtypeId>Mint</ConditionSubtypeId> <ConditionNote>Example ConditionNote</ConditionNote> </OrderItem> </OrderItems> </ListOrderItemsResult> <ResponseMetadata> <RequestId>88faca76-b600-46d2-b53c-0c8c4533e43a</RequestId> </ResponseMetadata> </ListOrderItemsResponse>