Amazon Services Japan
Amazonマーケットプレイス Web サービス (Amazon MWS) ドキュメント
Amazon MWS ドキュメント

GetOrder

指定したAmazonOrderId値に基づいて注文を返します。

説明

GetOrder オペレーションは、指定した各AmazonOrderIdの注文を最高50件まで返します。 GetOrder オペレーションには、PurchaseDateOrderStatusFulfillmentChannelLastUpdateDateなど、返された各注文の注文情報が含まれます。

購入者の連絡先と支払いの情報について

以下の表は、 GetOrder オペレーションが出品者出荷(MFN)の注文に対し、購入者の連絡先(BuyerEmailBuyerNameShippingAddress)と支払いの情報(OrderTotal)を返すタイミングを示しています。

表 1. 通常注文
通常注文の注文ステータス: …GetOrderオペレーションが返す購入者の連絡先と支払い情報のレスポンス要素:
Pending(保留中) なし
Unshipped(未出荷)、 PartiallyShipped(部分的に発送済み)、 Shipped(出荷済み) BuyerEmail(購入者のEメールアドレス)、BuyerName(購入者名)、 ShippingAddress(お届け先住所)、OrderTotal(注文の合計額)
表 2. 予約注文
予約注文の注文ステータス: …GetOrderオペレーションが返す購入者の連絡先と支払い情報のレスポンス要素:
PendingAvailability(予約注文)、 Pending(保留中) BuyerEmail(購入者のEメールアドレス)、BuyerName(購入者名)
Unshipped(未出荷)、 PartiallyShipped(部分的に発送済み)、 Shipped(出荷済み) BuyerEmail(購入者のEメールアドレス)、BuyerName(購入者名)、 ShippingAddress(お届け先住所)、OrderTotal(注文の合計額)
注: BuyerEmailは、FBAの予約注文の場合には返却されません。
注: PendingAvailabitityのステータスは、予約注文のみに表示されます。 予約注文は日本(JP)のみで有効です。

GetOrder オペレーションの最大リクエストクォータはリクエスト6回で、回復レートは1分ごとに1リクエストです。 スロットル用語の定義については、注文APIセクションについて知っておくべきことをご覧ください。

リクエストパラメータ

名前 説明 必須
AmazonOrderId AmazonOrderId値のリスト。 AmazonOrderIdはAmazonが定義した3-7-7フォーマットの注文IDです。 はい 最大: 50

タイプ:xs:string

レスポンス要素

名前 説明
LastUpdatedBefore LastUpdatedAfterリクエストパラメータを使用した場合に返される日付。 LastUpdatedBeforeリクエストパラメータも使用した場合、そのリクエストパラメータで指定した日付が返されます。 それ以外の場合は、LastUpdatedBeforeリクエストパラメータのデフォルト値が返されます。これはリクエストの時間から2分を引いた値です。

任意。 LastUpdatedBefore またはCreatedBeforeが返されます。

タイプ:xs:dateTime

CreatedBefore CreatedAfterリクエストパラメータを使用した場合に返される日付。 CreatedBeforeリクエストパラメータも使用した場合、そのリクエストパラメータで指定した日付が返されます。 それ以外の場合は、CreatedBeforeリクエストパラメータのデフォルト値が返されます。これはリクエストの時間から2分を引いた値です。

任意。 LastUpdatedBefore またはCreatedBeforeが返されます。

タイプ:xs:dateTime

Orders 注文のリスト。

タイプ: Orderのリスト

クエリリクエスト例

標準のリクエスト要件について詳しくは、必須のリクエストパラメーターを参照してください。

サンプルを表示するサンプルを隠す

https://mws.amazonservices.jp/Orders/2013-09-01
  ?AWSAccessKeyId=0PB842EXAMPLE7N4ZTR2
  &Action=GetOrder
  &AmazonOrderId.Id.1=902-3159896-1390916
  &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
  &SellerId=A2986ZQ066CH2F
  &Signature=ZQLpf8vEXAMPLE0iC265pf18n0%3D
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &LastUpdatedAfter=2017-02-01T18%3A12%3A21
  &Timestamp=2017-02-05T18%3A12%3A21.687Z
  &Version=2013-09-01

↑ Top

レスポンス例

標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。

サンプルを表示するサンプルを隠す

<?xml version="1.0"?>
<GetOrderResponse xmlns="https://mws.amazonservices.com/
    Orders/2013-09-01">
    <GetOrderResult>
        <Orders>
            <Order>
                <AmazonOrderId>902-3159896-1390916</AmazonOrderId>
                <PurchaseDate>2017-01-20T19:49:35Z</PurchaseDate>
                <LastUpdateDate>2017-01-20T19:49:35Z</LastUpdateDate>
                <OrderStatus>Pending</OrderStatus>
                <FulfillmentChannel>MFN</FulfillmentChannel>
                <NumberOfItemsShipped>0</NumberOfItemsShipped>
                <NumberOfItemsUnshipped>0</NumberOfItemsUnshipped>
                <PaymentMethod>Other</PaymentMethod>
                <PaymentMethodDetails>
                    <PaymentMethodDetail>CreditCard</PaymentMethodDetail>
                    <PaymentMethodDetail>GiftCerificate</PaymentMethodDetail>
                </PaymentMethodDetails>
                <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>>
                <ShipmentServiceLevelCategory>Standard
                </ShipmentServiceLevelCategory>
                <OrderType>StandardOrder</OrderType>
                <EarliestShipDate>2017-01-20T19:51:16Z</EarliestShipDate>
                <LatestShipDate>2017-01-25T19:49:35Z</LatestShipDate>	
                <IsBusinessOrder>false</IsBusinessOrder>
                <IsPrime>false</IsPrime>
                <IsPremiumOrder>false</IsPremiumOrder>	
            </Order>
        </Orders>
    </GetOrderResult>
    <ResponseMetadata>
        <RequestId>88faca76-b600-46d2-b53c-0c8c4533e43a</RequestId>
    </ResponseMetadata>
</GetOrderResponse>

↑ Top