GetOrder

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

描述

该 GetOrder 操作可为您所指定的每个 AmazonOrderId 值返回订单，最多可返回 50 个。该 GetOrder 操作包括每个所返回订单的订单详情，其中包括 PurchaseDate、 OrderStatus、 FulfillmentChannel 和 LastUpdateDate。

获取买家联系方式和费用信息

下表显示该 GetOrder 操作何时返回卖家配送网络 (MFN) 订单的买家联系信息（BuyerEmail、 BuyerName、ShippingAddress）以及费用信息 (OrderTotal)。

表 1. 普通订单
对于以下状态的普通订单：	…GetOrder 操作返回这些买家联系方式和费用信息响应元素：
Pending	无
Unshipped、 PartiallyShipped、 Shipped	BuyerEmail、 BuyerName、 ShippingAddress、 OrderTotal

表 2. 预订订单
对于以下状态的预订订单：	…GetOrder 操作返回这些买家联系方式和费用信息响应元素：
PendingAvailability、 Pending	BuyerEmail、 BuyerName
Unshipped、 PartiallyShipped、 Shipped	BuyerEmail、 BuyerName、 ShippingAddress、 OrderTotal

注：只有预订订单才有 PendingAvailabitity 状态。预订订单仅适用于日本。

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

请求参数

名称	描述	必填项	有效值
AmazonOrderId	AmazonOrderId 值的列表。 AmazonOrderId 是亚马逊所定义的订单编码，格式为 3-7-7。	是	最大值：50 类型：xs:string

响应元素

名称	描述
LastUpdatedBefore	如果您使用 LastUpdatedAfter 请求参数，将返回日期。如果您还使用 LastUpdatedBefore 请求参数，将返回您随同该请求参数提供的日期。否则将返回 LastUpdatedBefore 请求参数的默认值：您的请求时间减去两分钟。可选。将返回 LastUpdatedBefore 或 CreatedBefore。类型：xs:dateTime
CreatedBefore	如果您使用 CreatedAfter 请求参数，将返回日期。如果您还使用 CreatedBefore 请求参数，将返回您随同该请求参数提供的日期。否则将返回 CreatedBefore 请求参数的默认值：您的请求时间减去两分钟。可选。将返回 LastUpdatedBefore 或 CreatedBefore。类型：xs:dateTime
Orders	订单列表。类型：Order 列表

名称

描述

LastUpdatedBefore

如果您使用 LastUpdatedAfter 请求参数，将返回日期。如果您还使用 LastUpdatedBefore 请求参数，将返回您随同该请求参数提供的日期。否则将返回 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=GetOrder
  &AmazonOrderId.Id.1=058-1233752-8214740
  &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
  &SellerId=A2986ZQ066CH2F
  &Signature=ZQLpf8vEXAMPLE0iC265pf18n0%3D
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &LastUpdatedAfter=2013-08-01T18%3A12%3A21
  &Timestamp=2013-09-05T18%3A12%3A21.687Z
  &Version=2013-09-01

示例响应

<?xml version="1.0" encoding="utf-8"?>
  <GetOrderResponse xmlns="https://mws.amazonservices.com/
  Orders/2013-09-01">
    <GetOrderResult>
      <NextToken>2YgYW55IGNhcm5hbCBwbGVhc3VyZS4=</NextToken>
      <LastUpdatedBefore>2013-09-25T18%3A10%3A21.687Z</LastUpdatedBefore>
      <Orders>
        <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>
    </GetOrderResult>
    <ResponseMetadata>
      <RequestId>88faca76-b600-46d2-b53c-0c8c4533e43a</RequestId>
    </ResponseMetadata>
  </GetOrderResponse>

Deprecation Notice: