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.
AmazonマーケットプレイスWebサービス(Amazon MWS)の注文APIセクションでは、必要な注文の情報のみを取得する単純なアプリケーションを構築できます。 これにより、注文の同期、注文情報分析、オンデマンド意思決定支援ツールなどの分野で、高速で柔軟かつカスタムアプリケーションの開発が可能になります。
注文APIセクションには、以下のオペレーションが含まれます。
オペレーション | 簡単な説明 |
---|---|
ListOrders | 指定した期間内に作成または更新された注文情報を返します。 |
ListOrdersByNextToken | NextTokenパラメータを使用して、注文情報の次のページを返します。 |
GetOrder | 指定したAmazonOrderId値に基づいて注文を返します。 |
ListOrderItems | 指定したAmazonOrderIdに基づいて注文商品を返します。 |
ListOrderItemsByNextToken | NextTokenパラメータを使用して、注文商品の次ページを返します。 |
GetServiceStatus | 注文APIセクションの動作ステータスを返します。 |
まず、 ListOrders オペレーションを使用し、指定した期間内に作成または更新された注文商品情報を取得することができます。 返された各注文にはAmazonOrderIdが含まれています。 これらのAmazonOrderId値を ListOrderItems オペレーションで使用し、各注文に含まれる注文商品の詳細情報を取得できます。
注文APIセクションへリクエストの送信先URLを特定するには、出品者が登録されているマーケットプレイスのエンドポイントに"/Orders/2013-09-01"を付け足してください。 例えば、出品者が登録されているマーケットプレイスが日本の場合、URLはhttps://mws.amazonservices.jp/Orders/2013-09-01です。
以下の表には、このAPIセクションの用語が定義されています。
用語 | 定義 |
---|---|
Order item | 商品と数量。 例えば、カスタマーがある本を3冊購入した場合、注文商品は1つで、数量は3になります。
そのうちの1冊をギフトラッピングする場合は、注文には以下2つの注文商品が含まれることになります。
|
Order | 以下の二種類の注文が考えられます。
|
Pre-order | 発売日前の予約商品が含まれている注文。予約注文は日本(JP)のみで有効です。 |
Standard order | 在庫がある商品に入った注文。 |
FBAマルチチャネルサービスを利用しているフルフィルメントby Amazon(FBA)出品者への注意:返送/所有権の放棄依頼を送信時にShippingAddressを入力しなかった場合、注文APIセクションはその注文に対してShippingAddressを返しません。 FBAマルチチャネルサービスについて詳しくは、マーケットプレイスのAmazonセラーセントラルWebサイトにある出品者用ヘルプページを参照してください。
Amazon MWSスロットルの概念の説明は以下のとおりです。
注文APIセクションは、リアルタイムで注文更新の取得、注文リサーチ、データ同期用に最適化されています。 注文のデータの一括レポートは、レポートAPIセクションを参照して注文レポートを作成する必要があります。 レポートAPIセクションの詳細については、レポートAPIセクションマニュアルを参照してください。