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

Deprecation Notice:

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 MWS ドキュメント

ListOrders

指定した期間内に作成または更新された注文情報を返します。

説明

ListOrders オペレーションは、指定した期間内に作成または更新された注文一覧を返します。 CreatedAfterパラメータまたはLastUpdatedAfterパラメータを使用して期間を定義します。 これらのパラメータは同時に使用できませんので、どちらかを使用してください。 また、フィルタをいくつか適用して、返される注文一覧を絞り込むことができます。 ListOrders オペレーションには、AmazonOrderIdOrderStatusFulfillmentChannelLastUpdateDateなど、返された各注文の注文情報が含まれます。

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

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

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

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

リクエストパラメータ

名前 説明 必須
CreatedAfter 特定の時間、または、その期間後に作成された注文を選択するISO8601フォーマットの日付です。 はい、ただしLastUpdatedAfterが指定されていない場合のみ必須です。

CreatedAfterLastUpdatedAfter両方を指定すると、エラーが返されます。

少なくともリクエストを送信する2分以上前でなければなりません。

タイプ:xs:dateTime

CreatedBefore

特定の時間、または、その期間の前に作成された注文を選択するISO8601フォーマットの日付です。 いいえ

CreatedAfterが指定されている場合のみに指定できます。

LastUpdatedAfterが指定されている場合は指定できません。

CreatedAfterより後でなければなりません。

少なくともリクエストを送信する2分以上前でなければなりません。

デフォルト: 今から2分を引いた時間

タイプ:xs:dateTime

LastUpdatedAfter 指定された時間、またはその時間の後に最終更新された注文を選択するのに使用されるISO8601の日付フォーマットの日付です。 更新とは、新しい注文の作成を含む、注文ステータスのすべての変更として定義されます。 Amazonと出品者が行った更新を含みます。 はい、ただしCreatedAfterが指定されていない場合のみ必須です。

CreatedAfterLastUpdatedAfter両方を指定すると、エラーが返されます。

LastUpdatedAfterが指定されている場合、BuyerEmailSellerOrderIdは指定できません。

少なくともリクエストを送信する2分以上前でなければなりません。

タイプ:xs:dateTime

LastUpdatedBefore 指定された時間、またはその時間の前に最終更新された注文を選択するのに使用されるISO8601の日付フォーマットの日付です。 更新とは、新しい注文の作成を含む、注文ステータスのすべての変更として定義されます。 Amazonと出品者が行った更新を含みます。 いいえ

LastUpdatedAfterが指定されている場合のみに指定できます。

CreatedAfterが指定されている場合は指定できません。

LastUpdatedAfterより後でなければなりません。

少なくともリクエストを送信する2分以上前でなければなりません。

デフォルト: 今から2分を引いた時間

タイプ:xs:dateTime

OrderStatus OrderStatus値のリスト。 指定したステータスのいずれかに一致する現在のステータスで注文を選択するために使用します。 いいえ OrderStatus値:
PendingAvailability
このステータスは、予約注文のみに表示されます。 注文が行われ、支払いが承認されず、商品がまだ発売されていません。 この注文はまだ出荷できません。Preorder(予約注文)は日本(JP) のみで有効なOrderType値です。
Pending
注文は入っているが支払いがまだ承認されていません。 この注文はまだ出荷できません。OrderTypeStandard(通常注文)の注文の場合、注文の最初のステータスはPending(保留中)になります。 OrderTypePreorder(日本(JP) のみで有効)の注文の場合、注文の最初のステータスはPendingAvailability(予約注文)になり、支払いの承認手続きが開始されるとステータスがPending (保留中)になります。
Unshipped
支払いが承認され、注文の発送準備ができていますが、注文の商品が発送されていません。
PartiallyShipped
1つまたは複数(しかしすべてではない)の注文の商品が発送されています。
Shipped
注文のすべての商品が発送されています。
InvoiceUnconfirmed
注文のすべての商品が発送されています。 請求書が購入者に発送されたことを出品者はまだAmazonに対して確認していません。 注意:この値は、中国(CN)のみで有効です。
Canceled
注文がキャンセルされました。
Unfulfillable
注文を出荷することができません。 このステータスは、Amazon直販部門のWebサイトに掲載されていないAmazonが出荷する注文にのみ適用されます。

UnshippedPartiallyShipped注文APIセクションのこのバージョンでは一緒に使用する必要があります。 片方だけを使用すると、エラーが返されます。

デフォルト: すべて

タイプ:xs:string
MarketplaceId MarketplaceId値のリスト。 指定したマーケットプレイスの注文のみを選択するために使用します。 はい 販売を行う出品者が登録されているすべてのマーケットプレイス。

値が、販売を行う出品者が登録されているマーケットプレイスでない場合は、エラーが返されます。

最大: 50

タイプ:xs:string
FulfillmentChannel 注文がどのように出荷されたかを示すリスト。 いいえ FulfillmentChannel値:
AFN
Amazonが出荷
MFN
出品者が出荷

デフォルト: すべて

タイプ:xs:string
PaymentMethod PaymentMethod値のリスト。 指定した支払い方法で支払われた注文を選択するために使用されます。 いいえ PaymentMethod値:
COD
代金引換決済
CVS
コンビニ決済
Other
COD またはCVS 以外の支払い方法と
注: CODおよびCVS 値は日本(JP)の場合のみ有効です。

デフォルト: すべて

タイプ:xs:string
BuyerEmail 購入者のEメールアドレス。 指定されたEメールアドレスが含まれている注文のみを選択するために使用します。 いいえ

BuyerEmailが指定されている場合、FulfillmentChannelOrderStatusPaymentMethodLastUpdatedAfterLastUpdatedBeforeSellerOrderIdは指定できません。

リクエストで提供するEメールアドレスは、(Amazonによって)匿名または非匿名となる場合があります。

デフォルト: すべて

タイプ:xs:string

SellerOrderId 出品者が指定した注文 ID。 Amazonの注文IDではありません。 出品者が指定した注文IDと一致している注文を選択するために使用します。 いいえ

SellerOrderIdが指定されている場合、FulfillmentChannelOrderStatusPaymentMethodLastUpdatedAfterLastUpdatedBeforeBuyerEmailは指定できません。

デフォルト: すべて

タイプ:xs:string

MaxResultsPerPage 1ページあたりに返される注文の最大数を示す数値。 いいえ 値は1-100でなければなりません。

デフォルト: 100

タイプ: xs:positiveInteger

TFMShipmentStatus TFMShipmentStatus値のリスト。 現在のステータスが、指定したステータスの値と一致する Amazon Transportation for Merchants(TFM - Amazon輸送サービス)の注文を選択するために使用されます。 TFMShipmentStatusを指定した場合、TFMの注文だけが返されます。

タイプ: xs:string

注意:TFMShipmentStatus リクエストパラメーターは、中国(CN)のみで有効です。
いいえ TFMShipmentStatus値:
PendingPickUp
Amazonは、出品者から荷物をまだ集荷していません。
LabelCanceled
出品者が集荷をキャンセルしました。
PickedUp
Amazonは、出品者から荷物を集荷しました。
AtDestinationFC
荷物がAmazonフルフィルメントセンターに到着しました。
Delivered
荷物が購入者に配送されました。
RejectedByBuyer
購入者が荷物の受領を拒否しました。
Undeliverable
荷物を配送できませんでした。
ReturnedToSeller
荷物が購入者に配送されず、出品者に返送されました。
Lost
配送業者が荷物を紛失しました。
タイプ:xs:string

レスポンス要素

名前 説明
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

↑ Top

レスポンス例

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

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

<?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>

↑ Top