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

ListOrdersByNextToken

使用 NextToken 参数返回下一页订单。

描述

该 ListOrdersByNextToken 操作返回下一页订单，通过使用 NextToken 的值来完成此操作，该值是通过您上一步请求 ListOrders 或 ListOrdersByNextToken来进行返回。如果未返回 NextToken 的值，则不会返回其他页面。

该 ListOrders 和 ListOrdersByNextToken 操作的最大请求限额为 6 个，恢复速率为每分钟 1 个请求。有关限制术语的相关定义，请参阅您应了解的“订单 API”部分的相关内容。

请求参数

名称 描述 必填项 有效值
NextToken 您之前对 ListOrders 或 ListOrdersByNextToken的请求的响应中返回的字符串标记。 是 类型：xs:string

响应元素

名称 描述
NextToken 生成的字符串，用于将信息传递给下一请求。如果返回 NextToken，将 NextToken 的值传递给 ListOrdersByNextToken。如果没有返回 NextToken，则不返回其他配送订单。

可选项

类型：xs:string

LastUpdatedBefore 如果您在原始请求中使用 LastUpdatedAfter 请求 ListOrders 参数，将返回日期。如果您还在原始请求中使用 LastUpdatedBefore 请求参数，ListOrders 将返回您随同该请求参数提供的日期。否则将返回 LastUpdatedBefore 请求参数的默认值：您的请求时间减去两分钟。

可选。将返回 LastUpdatedBefore 或 CreatedBefore。

类型：xs:dateTime

CreatedBefore 如果您使用 CreatedAfter 请求参数，将返回日期。如果您还使用 CreatedBefore 请求参数，将返回您随同该请求参数提供的 日期。否则将返回 CreatedBefore 请求参数的默认值：您的请求时间减去两分钟。

可选。将返回 LastUpdatedBefore 或 CreatedBefore。

类型：xs:dateTime

Orders 订单列表。

类型：Order 列表

示例

查询请求示例

https://mws.amazonservices.jp/Orders/2013-09-01
  ?AWSAccessKeyId=0PB842EXAMPLE7N4ZTR2
  &Action=ListOrdersByNextToken
  &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
  &SellerId=A2986ZQ066CH2F
  &Signature=ZQLpf8vEXAMPLE0iC265pf18n0%3D
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &NextToken=2YgYW55IGNhcm5hbCBwbGVhc3VyZS4%3D
  &Timestamp=2013-09-05T18%3A12%3A21.687Z
  &Version=2013-09-01

示例响应

<?xml version="1.0" encoding="utf-8"?>
  <ListOrdersByNextTokenResponse xmlns="https://mws.amazonservices.com/Orders/2013-09-01">
    <ListOrdersByNextTokenResult>
      <NextToken>2YgYW55IGNhcm5hbCBwbGVhc3VyZS4=</NextToken>
      <LastUpdatedBefore>2013-09-25T18%3A10%3A21.687Z</LastUpdatedBefore>
      <Orders>
        <Order>
          <ShipmentServiceLevelCategory>Standard
          </ShipmentServiceLevelCategory>
          <ShipServiceLevel>Std JP Kanto8</ShipServiceLevel>
          <EarliestShipDate>2013-08-20T19:51:16Z</EarliestShipDate>
          <LatestShipDate>2013-08-25T19:49:35Z</LatestShipDate>	
          <MarketplaceId>A1VC38T7YXB528</MarketplaceId>
          <SalesChannel>Amazon.com</SalesChannel>
          <OrderType>Preorder</OrderType>
          <BuyerEmail>5vlhEXAMPLEh9h5@marketplace.amazon.com</BuyerEmail>
          <FulfillmentChannel>MFN</FulfillmentChannel>
          <OrderStatus>Pending</OrderStatus>
          <BuyerName>John Jones</BuyerName>	
          <LastUpdateDate>2013-08-20T19:49:35Z</LastUpdateDate>
          <PurchaseDate>2013-08-20T19:49:35Z</PurchaseDate>
          <NumberOfItemsShipped>0</NumberOfItemsShipped>
          <NumberOfItemsUnshipped>0</NumberOfItemsUnshipped>
          <AmazonOrderId>902-3159896-1390916</AmazonOrderId>
          <PaymentMethod>Other</PaymentMethod>
        </Order>
        <Order>
          <AmazonOrderId>058-1233752-8214740</AmazonOrderId>
          <PurchaseDate>2013-09-05T00%3A06%3A07.000Z</PurchaseDate>      
          <LastUpdateDate>2013-09-07T12%3A43%3A16.000Z</LastUpdateDate>
          <OrderStatus>Unshipped</OrderStatus>
          <OrderType>StandardOrder</OrderType>
          <ShipServiceLevel>Std JP Kanto8</ShipServiceLevel>
          <FulfillmentChannel>MFN</FulfillmentChannel>
          <OrderTotal>
            <CurrencyCode>JPY</CurrencyCode>
            <Amount>1507.00</Amount>
          </OrderTotal>
          <ShippingAddress>
            <Name>Jane Smith</Name>
            <AddressLine1>1-2-10 Akasaka</AddressLine1>
            <City>Tokyo</City>
            <PostalCode>107-0053</PostalCode>
            <Country>JP</Country>
          </ShippingAddress>
          <NumberOfItemsShipped>0</NumberOfItemsShipped>
          <NumberOfItemsUnshipped>1</NumberOfItemsUnshipped>
          <PaymentExecutionDetail>
            <PaymentExecutionDetailItem>
              <Payment>
                <Amount>10.00</Amount>
                <CurrencyCode>JPY</CurrencyCode>
              </Payment>
              <PaymentMethod>PointsAccount</PaymentMethod>
            </PaymentExecutionDetailItem>
            <PaymentExecutionDetailItem>
              <Payment>
                <Amount>317.00</Amount>
                <CurrencyCode>JPY</CurrencyCode>
              </Payment>
              <PaymentMethod>GC</PaymentMethod>
            </PaymentExecutionDetailItem>
            <PaymentExecutionDetailItem>
              <Payment>
                <Amount>1180.00</Amount>
                <CurrencyCode>JPY</CurrencyCode>
              </Payment>
              <PaymentMethod>COD</PaymentMethod>
            </PaymentExecutionDetailItem>
          </PaymentExecutionDetail>
          <PaymentMethod>COD</PaymentMethod>
          <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
          <BuyerName>Jane Smith</BuyerName>
          <BuyerEmail>5vlhEXAMPLEh9h5@marketplace.amazon.com</BuyerEmail>
          <ShipmentServiceLevelCategory>Standard
          </ShipmentServiceLevelCategory>
        </Order>
      </Orders>
    </ListOrdersByNextTokenResult>
    <ResponseMetadata>
      <RequestId>88faca76-b600-46d2-b53c-0c8c4533e43a</RequestId>
    </ResponseMetadata>
  </ListOrdersByNextTokenResponse>