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

ListOrderItems

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

説明

ListOrderItems オペレーションは、指定したAmazonOrderIdの注文商品情報を返します。 注文商品情報には、TitleASINSellerSKUItemPriceShippingPrice、税金、プロモーション情報が含まれます。

まず、 ListOrders オペレーションを使用し、指定した期間内に作成または更新された注文商品情報を取得することができます。 返された各注文にはAmazonOrderIdが含まれています。 これらのAmazonOrderId値を ListOrderItems オペレーションで使用し、各注文に含まれる注文商品の詳細情報を取得できます。

注意:注文が保留中(注文されたが支払いがまだ承認されていない)状態の場合、 ListOrderItems オペレーションは注文にある商品の金額、消費税、配送料、ギフト包装料、またはプロモーションの情報を返しません。 支払いが実行され、注文が保留(Pending) の状態から未出荷(Unshipped)、一部出荷(Partially Shipped)、または出荷済み(Shipped)の状態になると、 ListOrderItems オペレーションは注文にある商品の金額、消費税、配送料、ギフト包装料、およびプロモーションの情報を返します。

以下のレスポンス要素は、保留(Pending)の状態にある注文には使用できませんが、未出荷(Unshipped)、一部出荷(Partially Shipped)、または出荷済み(Shipped)の状態の注文には使用できます。

  • ItemTax
  • GiftWrapPrice
  • ItemPrice
  • PromotionDiscount
  • GiftWrapTax
  • ShippingTax
  • ShippingPrice
  • ShippingDiscount

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

リクエストパラメータ

名前 説明 必須
AmazonOrderId Amazonが定義した3-7-7フォーマットの注文ID。 はい タイプ:xs:string

レスポンス要素

名前 説明
NextToken 次のリクエストに情報を渡すために生成された文字列。 NextTokenが返される場合は、NextTokenの値を ListOrderItemsByNextTokenに渡します。 NextTokenが返されない場合、これ以上返される注文商品はありません。

任意

タイプ:xs:string

AmazonOrderId Amazonが定義した3-7-7フォーマットの注文ID。

タイプ:xs:string

OrderItems 注文商品のリスト

タイプ: OrderItemのリスト

クエリリクエスト例

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

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

https://mws.amazonservices.jp/Orders/2013-09-01
  ?AWSAccessKeyId=0PB842EXAMPLE7N4ZTR2
  &Action=ListOrderItems
  &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
  &SellerId=A1XEXAMPLE5E6
  &AmazonOrderId=058-1233752-8214740
  &Signature=ZQLpf8vEXAMPLE0iC265pf18n0%3D
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &Timestamp=2013-09-05T18%3A12%3A21.687Z
  &Version=2013-09-01 

↑ Top

レスポンス例

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

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

<?xml version="1.0"?>
<ListOrderItemsResponse xmlns="https://mws.amazonservices.com
    /Orders/2013-09-01">
    <ListOrderItemsResult>
        <NextToken>MRgZW55IGNhcm5hbCBwbGVhc3VyZS6=</NextToken>
        <AmazonOrderId>058-1233752-8214740</AmazonOrderId>
        <OrderItems>
            <OrderItem>
                <ASIN>BT0093TELA</ASIN>
                <OrderItemId>68828574383266</OrderItemId>
                <BuyerCustomizedInfo>
                    <CustomizedURL>https://zme-caps.amazon.com/t/bR6qHkzSOxuB/
                        J8nbWhze0Bd3DkajkOdY-XQbWkFralegp2sr_QZiKEE/1</CustomizedURL>
                </BuyerCustomizedInfo>
                <SellerSKU>CBA_OTF_1</SellerSKU>
                <Title>Example item name</Title>
                <QuantityOrdered>1</QuantityOrdered>
                <QuantityShipped>1</QuantityShipped>
                <ProductInfo>
                    <NumberOfItems>12</NumberOfItems>
                </ProductInfo>
                <PointsGranted>
                    <PointsNumber>10</PointsNumber>
                    <PointsMonetaryValue>
                        <CurrencyCode>JPY</CurrencyCode>
                        <Amount>10.00</Amount>
                    </PointsMonetaryValue>
                </PointsGranted>
                <ItemPrice>
                    <CurrencyCode>JPY</CurrencyCode>
                    <Amount>25.99</Amount>
                </ItemPrice>
                <ShippingPrice>
                    <CurrencyCode>JPY</CurrencyCode>
                    <Amount>1.26</Amount>
                </ShippingPrice>
                <ScheduledDeliveryEndDate>2013-09-09T01:30:00.000-06:00 </ScheduledDeliveryEndDate>
                <ScheduledDeliveryStartDate>2013-09-071T02:00:00.000-06:00 </ScheduledDeliveryStartDate>
                <CODFee>
                    <CurrencyCode>JPY</CurrencyCode>
                    <Amount>10.00</Amount>
                </CODFee>
                <CODFeeDiscount>
                    <CurrencyCode>JPY</CurrencyCode>
                    <Amount>1.00</Amount>
                </CODFeeDiscount>
                <IsGift>false</IsGift>
                <GiftMessageText>For you!</GiftMessageText>
                <GiftWrapPrice>
                    <CurrencyCode>JPY</CurrencyCode>
                    <Amount>1.99</Amount>
                </GiftWrapPrice>
                <GiftWrapLevel>Classic</GiftWrapLevel>
                <PriceDesignation>BusinessPrice</PriceDesignation>
            </OrderItem>
            <OrderItem>
                <ASIN>BCTU1104UEFB</ASIN>
                <OrderItemId>79039765272157</OrderItemId>
                <SellerSKU>CBA_OTF_5</SellerSKU>
                <Title>Example item name</Title>
                <QuantityOrdered>2</QuantityOrdered>
                <ItemPrice>
                    <CurrencyCode>JPY</CurrencyCode>
                    <Amount>17.95</Amount>
                </ItemPrice>
                <PromotionIds>
                    <PromotionId>FREESHIP</PromotionId>
                </PromotionIds>
                <ConditionId>Used</ConditionId>
                <ConditionSubtypeId>Mint</ConditionSubtypeId>
                <ConditionNote>Example ConditionNote</ConditionNote>
                <IsGift>false</IsGift>
                <PriceDesignation>BusinessPrice</PriceDesignation>
                <TaxCollection>
                    <Model>MarketplaceFacilitator</Model>
                    <ResponsibleParty>Amazon Services, Inc.</ResponsibleParty>
                </TaxCollection>
            </OrderItem>
        </OrderItems>
    </ListOrderItemsResult>
    <ResponseMetadata>
        <RequestId>88faca76-b600-46d2-b53c-0c8c4533e43a</RequestId>
    </ResponseMetadata>
</ListOrderItemsResponse>

↑ Top