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

ListOrderItems

根据您指定的 AmazonOrderId 返回订单商品。

描述

ListOrderItems 操作可为您所指定的 AmazonOrderId 返回订单商品信息。订单商品信息包括 TitleASINSellerSKUItemPriceShippingPrice 以及税费和促销信息。

您可以通过 ListOrders 操作来检索订单商品信息,进而找到您在指定时间段内所创建或更新的订单。所返回的订单中包含 AmazonOrderId。然后,您便可以通过操作使用这些 AmazonOrderId 值,ListOrderItems 以获取每个订单的详细订单商品信息。

请注意:如果订单处于“等待”状态(即已下订单,但未进行付款),则该 ListOrderItems 操作不会返回订单商品的价格、税费、运费、礼品包装或促销信息。当订单状态从“等待”变为“未配送”、“部分配送”或“已配送”状态(即已完成付款)后,ListOrderItems 操作将返回订单商品的价格、税费、运费、礼品包装和促销信息。

如果订单的 OrderStatus 为“等待”,则不会返回以下响应元素。但是,如果订单的 OrderStatus 为“未配送”、“部分配送”或“已配送”,则会返回以下响应元素:

  • ItemTax
  • GiftWrapPrice
  • ItemPrice
  • PromotionDiscount
  • GiftWrapTax
  • ShippingTax
  • ShippingPrice
  • ShippingDiscount

ListOrderItemsListOrderItemsByNextToken 操作共享的最大请求限额为 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>