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.
指定した期間内に作成または更新された注文情報を返します。
ListOrders オペレーションは、指定した期間内に作成または更新された注文一覧を返します。 CreatedAfterパラメータまたはLastUpdatedAfterパラメータを使用して期間を定義します。 これらのパラメータは同時に使用できませんので、どちらかを使用してください。 また、フィルタをいくつか適用して、返される注文一覧を絞り込むことができます。 ListOrders オペレーションには、AmazonOrderId、OrderStatus、FulfillmentChannel、LastUpdateDateなど、返された各注文の注文情報が含まれます。
以下の表は、 ListOrders オペレーションが出品者出荷(MFN)の注文に対し、購入者の連絡先(BuyerEmail、BuyerName、ShippingAddress)と支払いの情報(OrderTotal)を返すタイミングを示しています。
通常注文の注文ステータス: | …ListOrdersオペレーションが返す購入者の連絡先と支払い情報のレスポンス要素: |
---|---|
Pending(保留中) | なし |
Unshipped(未出荷)、 PartiallyShipped(部分的に発送済み)、 Shipped(出荷済み) | BuyerEmail(購入者のEメールアドレス)、BuyerName(購入者名)、 ShippingAddress(お届け先住所)、OrderTotal(注文の合計額) |
予約注文の注文ステータス: | …ListOrdersオペレーションが返す購入者の連絡先と支払い情報のレスポンス要素: |
---|---|
PendingAvailability(予約注文)、 Pending(保留中) | BuyerEmail(購入者のEメールアドレス)、BuyerName(購入者名) |
Unshipped(未出荷)、 PartiallyShipped(部分的に発送済み)、 Shipped(出荷済み) | BuyerEmail(購入者のEメールアドレス)、BuyerName(購入者名)、 ShippingAddress(お届け先住所)、OrderTotal(注文の合計額) |
ListOrders と ListOrdersByNextToken オペレーションはともに、最大リクエストクォータが6リクエストで、回復レートは1分ごとに1リクエストです。 スロットル用語の定義については、注文APIセクションについて知っておくべきことをご覧ください。
名前 | 説明 | 必須 | 値 |
---|---|---|---|
CreatedAfter | 特定の時間、または、その期間後に作成された注文を選択するISO8601フォーマットの日付です。 | はい、ただしLastUpdatedAfterが指定されていない場合のみ必須です。
CreatedAfter とLastUpdatedAfter両方を指定すると、エラーが返されます。 |
少なくともリクエストを送信する2分以上前でなければなりません。
タイプ:xs:dateTime |
CreatedBefore
|
特定の時間、または、その期間の前に作成された注文を選択するISO8601フォーマットの日付です。 | いいえ CreatedAfterが指定されている場合のみに指定できます。 LastUpdatedAfterが指定されている場合は指定できません。 |
CreatedAfterより後でなければなりません。 少なくともリクエストを送信する2分以上前でなければなりません。 デフォルト: 今から2分を引いた時間 タイプ:xs:dateTime |
LastUpdatedAfter | 指定された時間、またはその時間の後に最終更新された注文を選択するのに使用されるISO8601の日付フォーマットの日付です。 更新とは、新しい注文の作成を含む、注文ステータスのすべての変更として定義されます。 Amazonと出品者が行った更新を含みます。 | はい、ただしCreatedAfterが指定されていない場合のみ必須です。
CreatedAfterとLastUpdatedAfter両方を指定すると、エラーが返されます。 LastUpdatedAfterが指定されている場合、BuyerEmailとSellerOrderIdは指定できません。 |
少なくともリクエストを送信する2分以上前でなければなりません。
タイプ:xs:dateTime |
LastUpdatedBefore | 指定された時間、またはその時間の前に最終更新された注文を選択するのに使用されるISO8601の日付フォーマットの日付です。 更新とは、新しい注文の作成を含む、注文ステータスのすべての変更として定義されます。 Amazonと出品者が行った更新を含みます。 | いいえ LastUpdatedAfterが指定されている場合のみに指定できます。 CreatedAfterが指定されている場合は指定できません。 |
LastUpdatedAfterより後でなければなりません。
少なくともリクエストを送信する2分以上前でなければなりません。 デフォルト: 今から2分を引いた時間 タイプ:xs:dateTime |
OrderStatus | OrderStatus値のリスト。 指定したステータスのいずれかに一致する現在のステータスで注文を選択するために使用します。 | いいえ | OrderStatus値:
UnshippedとPartiallyShippedは注文APIセクションのこのバージョンでは一緒に使用する必要があります。 片方だけを使用すると、エラーが返されます。 デフォルト: すべて タイプ:xs:string |
MarketplaceId | MarketplaceId値のリスト。 指定したマーケットプレイスの注文のみを選択するために使用します。 | はい | 販売を行う出品者が登録されているすべてのマーケットプレイス。 値が、販売を行う出品者が登録されているマーケットプレイスでない場合は、エラーが返されます。 最大: 50 タイプ:xs:string |
FulfillmentChannel | 注文がどのように出荷されたかを示すリスト。 | いいえ | FulfillmentChannel値:
デフォルト: すべて タイプ:xs:string |
PaymentMethod | PaymentMethod値のリスト。 指定した支払い方法で支払われた注文を選択するために使用されます。 | いいえ | PaymentMethod値:
注: CODおよびCVS
値は日本(JP)の場合のみ有効です。
デフォルト: すべて タイプ:xs:string |
BuyerEmail | 購入者のEメールアドレス。 指定されたEメールアドレスが含まれている注文のみを選択するために使用します。 | いいえ BuyerEmailが指定されている場合、FulfillmentChannel、 OrderStatus、 PaymentMethod、 LastUpdatedAfter、 LastUpdatedBefore、 SellerOrderIdは指定できません。 |
リクエストで提供するEメールアドレスは、(Amazonによって)匿名または非匿名となる場合があります。
デフォルト: すべて タイプ:xs:string |
SellerOrderId | 出品者が指定した注文 ID。 Amazonの注文IDではありません。 出品者が指定した注文IDと一致している注文を選択するために使用します。 | いいえ SellerOrderIdが指定されている場合、FulfillmentChannel、 OrderStatus、 PaymentMethod、 LastUpdatedAfter、 LastUpdatedBefore、 BuyerEmailは指定できません。 |
デフォルト: すべて タイプ:xs:string |
MaxResultsPerPage | 1ページあたりに返される注文の最大数を示す数値。 | いいえ | 値は1-100でなければなりません。 デフォルト: 100 タイプ: xs:positiveInteger |
TFMShipmentStatus | TFMShipmentStatus値のリスト。 現在のステータスが、指定したステータスの値と一致する Amazon Transportation for Merchants(TFM - Amazon輸送サービス)の注文を選択するために使用されます。
TFMShipmentStatusを指定した場合、TFMの注文だけが返されます。
タイプ: xs:string 注意:TFMShipmentStatus リクエストパラメーターは、中国(CN)のみで有効です。 |
いいえ | TFMShipmentStatus値:
|
名前 | 説明 |
---|---|
NextToken | 次のリクエストに情報を渡すために生成された文字列。
NextTokenが返される場合は、NextTokenの値を
ListOrdersByNextTokenに渡します。 NextTokenが返されない場合、これ以上返すべき注文はないことを表します。
任意 タイプ: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=ListOrders &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &MarketplaceId.Id.1=ATVPDKIKX0DER &MarketplaceId.Id.2=A2Q3Y263D00KWC &MarketplaceId.Id.3=A1VC38T7YXB528 &FulfillmentChannel.Channel.1=MFN &PaymentMethod.Method.1=COD &PaymentMethod.Method.2=Other &OrderStatus.Status.1=Unshipped &OrderStatus.Status.2=PendingAvailability &SellerId=A2NEXAMPLETF53 &Signature=ZQLpf8vEXAMPLE0iC265pf18n0%3D &SignatureVersion=2 &SignatureMethod=HmacSHA256 &LastUpdatedAfter=2017-02-01T18%3A12%3A21 &Timestamp=2017-02-05T18%3A12%3A21.687Z &Version=2013-09-01
標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。
<?xml version="1.0"?> <ListOrdersResponse xmlns="https://mws.amazonservices.com/ Orders/2013-09-01"> <ListOrdersResult> <NextToken>2YgYW55IGNhcm5hbCBwbGVhc3VyZS4=</NextToken> <LastUpdatedBefore>2017-02-25T18%3A10%3A21.687Z</LastUpdatedBefore> <Orders> <Order> <AmazonOrderId>902-3159896-1390916</AmazonOrderId> <PurchaseDate>2017-02-20T19:49:35Z</PurchaseDate> <LastUpdateDate>2017-02-20T19:49:35Z</LastUpdateDate> <OrderStatus>Unshipped</OrderStatus> <FulfillmentChannel>MFN</FulfillmentChannel> <SalesChannel>Amazon.com</SalesChannel> <ShippingAddress> <Name>Buyer name</Name> <AddressLine1>1234 Any St.</AddressLine1> <City>Seattle</City> <PostalCode>98103</PostalCode> <CountryCode>US</CountryCode> <AddressType>Commercial</AddressType> </ShippingAddress> <OrderTotal> <CurrencyCode>USD</CurrencyCode> <Amount>25.00</Amount> </OrderTotal> <NumberOfItemsShipped>0</NumberOfItemsShipped> <NumberOfItemsUnshipped>1</NumberOfItemsUnshipped> <PaymentMethod>Other</PaymentMethod> <PaymentMethodDetails> <PaymentMethodDetail>CreditCard</PaymentMethodDetail> </PaymentMethodDetails> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <BuyerEmail>5vlhEXAMPLEh9h5@marketplace.amazon.com</BuyerEmail> <BuyerName>Buyer name</BuyerName> <BuyerTaxInfo> <CompanyLegalName>Company Name</CompanyLegalName> <TaxingRegion>US</TaxingRegion> <TaxClassifications> <TaxClassification> <Name>VATNumber</Name> <Value>XXX123</Value> </TaxClassification> </TaxClassifications> </BuyerTaxInfo> <OrderType>StandardOrder</OrderType> <EarliestShipDate>2017-02-20T19:51:16Z</EarliestShipDate> <LatestShipDate>2017-02-25T19:49:35Z</LatestShipDate> <IsBusinessOrder>true</IsBusinessOrder> <PurchaseOrderNumber>PO12345678</PurchaseOrderNumber> <IsPrime>false</IsPrime> <IsPremiumOrder>false</IsPremiumOrder> </Order> <Order> <AmazonOrderId>483-3488972-0896720</AmazonOrderId> <PurchaseDate>20178-02-20T19:49:35Z</PurchaseDate> <LastUpdateDate>2017-02-20T19:49:35Z</LastUpdateDate> <OrderStatus>Unshipped</OrderStatus> <FulfillmentChannel>MFN</FulfillmentChannel> <ShippingAddress> <Name>Buyer name</Name> <AddressLine1>1234 Avenida Qualquer</AddressLine1> <City>Sao Paulo</City> <PostalCode>08474-130</PostalCode> <CountryCode>BR</CountryCode> <AddressType>Residential</AddressType> </ShippingAddress> <OrderTotal> <CurrencyCode>BRL</CurrencyCode> <Amount>100.00</Amount> </OrderTotal> <NumberOfItemsShipped>0</NumberOfItemsShipped> <NumberOfItemsUnshipped>1</NumberOfItemsUnshipped> <PaymentMethod>Other</PaymentMethod> <PaymentMethodDetails> <PaymentMethodDetail>CreditCard</PaymentMethodDetail> </PaymentMethodDetails> <MarketplaceId>A2Q3Y263D00KWC</MarketplaceId> <BuyerEmail>5vlhEXAMPLEh9h5@marketplace.amazon.com.br</BuyerEmail> <BuyerName>John Jones</BuyerName> <BuyerCounty>Vila Olimpia</BuyerCounty> <BuyerTaxInfo> <TaxingRegion>BR</TaxingRegion> <TaxClassifications> <TaxClassification> <Name>CSTNumber</Name> <Value>XXX123</Value> </TaxClassification> </TaxClassifications> </BuyerTaxInfo> <EarliestShipDate>2017-02-20T19:51:16Z</EarliestShipDate> <LatestShipDate>2017-02-25T19:49:35Z</LatestShipDate> <IsBusinessOrder>false</IsBusinessOrder> <IsPrime>false</IsPrime> <IsPremiumOrder>false</IsPremiumOrder> </Order> <Order> <AmazonOrderId>058-1233752-8214740</AmazonOrderId> <PurchaseDate>2017-02-05T00%3A06%3A07.000Z</PurchaseDate> <LastUpdateDate>2017-02-07T12%3A43%3A16.000Z</LastUpdateDate> <OrderStatus>Unshipped</OrderStatus> <FulfillmentChannel>MFN</FulfillmentChannel> <ShipServiceLevel>Std JP Kanto8</ShipServiceLevel> <ShippingAddress> <Name>Jane Smith</Name> <AddressLine1>1-2-10 Akasaka</AddressLine1> <City>Tokyo</City> <PostalCode>107-0053</PostalCode> <CountryCode>JP</CountryCode> </ShippingAddress> <OrderTotal> <CurrencyCode>JPY</CurrencyCode> <Amount>1507.00</Amount> </OrderTotal> <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> <PaymentMethodDetails> <PaymentMethodDetail>COD</PaymentMethodDetail> </PaymentMethodDetails> <MarketplaceId>A1VC38T7YXB528</MarketplaceId> <BuyerEmail>5vlhEXAMPLEh9h5@marketplace.amazon.co.jp</BuyerEmail> <BuyerName>Jane Smith</BuyerName> <ShipmentServiceLevelCategory>Standard </ShipmentServiceLevelCategory> <OrderType>SourcingOnDemandOrder</OrderType> <IsBusinessOrder>false</IsBusinessOrder> <IsPrime>false</IsPrime> <IsPremiumOrder>false</IsPremiumOrder> <PromiseResponseDueDate>2017-08-31T23:58:44Z</PromiseResponseDueDate> <IsEstimatedShipDateSet>true</IsEstimatedShipDateSet> </Order> </Orders> </ListOrdersResult> <ResponseMetadata> <RequestId>88faca76-b600-46d2-b53c-0c8c4533e43a</RequestId> </ResponseMetadata> </ListOrdersResponse>