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.
指定したAmazonOrderIdに基づいて注文商品を返します。
ListOrderItems オペレーションは、指定したAmazonOrderIdの注文商品情報を返します。 注文商品情報には、Title、ASIN、SellerSKU、ItemPrice、ShippingPrice、税金、プロモーション情報が含まれます。
まず、 ListOrders オペレーションを使用し、指定した期間内に作成または更新された注文商品情報を取得することができます。 返された各注文にはAmazonOrderIdが含まれています。 これらのAmazonOrderId値を ListOrderItems オペレーションで使用し、各注文に含まれる注文商品の詳細情報を取得できます。
注意:注文が保留中(注文されたが支払いがまだ承認されていない)状態の場合、 ListOrderItems オペレーションは注文にある商品の金額、消費税、配送料、ギフト包装料、またはプロモーションの情報を返しません。 支払いが実行され、注文が保留(Pending) の状態から未出荷(Unshipped)、一部出荷(Partially Shipped)、または出荷済み(Shipped)の状態になると、 ListOrderItems オペレーションは注文にある商品の金額、消費税、配送料、ギフト包装料、およびプロモーションの情報を返します。
以下のレスポンス要素は、保留(Pending)の状態にある注文には使用できませんが、未出荷(Unshipped)、一部出荷(Partially Shipped)、または出荷済み(Shipped)の状態の注文には使用できます。
ListOrderItems と ListOrderItemsByNextToken オペレーションはともに、最大リクエストクォータがリクエスト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
標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。
<?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>