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(購入者のEメールアドレス)、BuyerName(購入者名)
Unshipped(未出荷)、 PartiallyShipped(部分的に発送済み)、 Shipped(出荷済み)	BuyerEmail(購入者のＥメールアドレス)、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のリスト

名前

説明

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

レスポンス例

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