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.
出品者の在庫状況に関する情報を返します。
ListInventorySupplyオペレーションは、Amazonフルフィルメントネットワークおよび現在の納品手続き中の商品内に出品者が持っている在庫の状況に関する情報を返します。自分のAmazonフルフィルメントネットワーク在庫の現在の状況を確認したり、在庫状況が変わったときに気づいたりすることができます。
このオペレーションはすべてのマーケットプレイスで利用できます。
MarketplaceIdパラメーターは、北米のマーケットプレイス(アメリカ、カナダおよびメキシコ)でのみ利用可能です。
このListInventorySupplyオペレーションの最大リクエストクォータは30回、回復レートは毎秒2リクエストです。 スロットリング用語の定義およびスロットリングの詳しい説明については、Amazon MWS開発者ガイドのスロットリング: リクエストを送信できる頻度を制限するを参照してください。
| 名前 | 説明 | 必須 | 値 |
|---|---|---|---|
| SellerSkus | 在庫状況の情報が必要な商品の出品者SKUのリスト。 | QueryStartDateTimeを指定しない場合は必須。 QueryStartDateTimeおよびSellerSkusの両方を指定するとエラーが返されます。 |
Amazonフルフィルメントセンターに出荷済みの商品の出品者SKU。 最大：50 タイプ：xs:string |
| QueryStartDateTime | 指定した日時以降に在庫状況が変わった商品を選択するために使用する日付。 | ISO 8601日時フォーマット タイプ：xs:dateTime |
|
| ResponseGroup | ListInventorySupplyオペレーションでSupplyDetail要素を返してほしいかどうかを示します。 | 不要 | ResponseGroupの値：
デフォルト：Basic タイプ：xs:string |
|
MarketplaceId (NAのみ) |
Amazonが定義したマーケットプレイスIDを暗号化したもの。リクエストやレスポンスの範囲を特定のマーケットプレイスに限定するために使用します。 | 不要 MarketplaceIdが指定されていない場合のデフォルト値を想定します。 |
MarketplaceIdの値： MarketplaceIdの値の一覧は、Amazon MWS開発者ガイドのAmazonマーケットプレイスWebサービスエンドポイントを参照してください。 デフォルト：出品者の自国のマーケットプレイスとして割り当てられているMarketplaceId。 タイプ：xs:string |
| 名前 | 説明 | 必須 | 値 |
|---|---|---|---|
| NextToken | 次のリクエストへの情報引き渡しに使用するために生成された文字列。NextTokenが返された場合、NextTokenの値をListInventorySupplyByNextTokenに引き渡します。NextTokenが返されない場合、それ以上返される在庫状況の情報はありません。 |
任意 |
タイプ：xs:string |
| InventorySupplyList | Amazonフルフィルメントネットワークによるフルフィルメントに利用可能、または近々利用可能になる予定の商品の構造化されたリスト。各商品は現在、AmazonフルフィルメントネットワークまたはAmazonフルフィルメントセンターへの納品の中にあります。各商品について、SKU、ASIN、状態、数量および在庫状況の情報が入っています。 | 必須 |
タイプ：リスト - InventorySupply |
標準のリクエスト要件について詳しくは、必須のリクエストパラメーターを参照してください。
https://mws.amazonservices.com/FulfillmentInventory/2010-10-01 ?Action=ListInventorySupply &Version=2011-03-01 &AWSAccessKeyId=AKIAJGUEXAMPLEE2NVUA &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &SignatureVersion=2 &SignatureMethod=HmacSHA256 &Signature=ZRA9DR5rveSuz%2F1D18AHvoipg2BAev8yblPQ1BbEbfU%3D &Timestamp=2010-10-01T02:40:36Z &SellerId=A2NKEXAMPLEF53 &SellerSkus.member.1=SampleSKU1 &SellerSkus.member.2=SampleSKU2 &ResponseGroup=Basic
標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。
<?xml version="1.0"?>
<ListInventorySupplyResponse xmlns="http://mws.amazonaws.com/FulfillmentInventory/2010-10-01">
<ListInventorySupplyResult>
<InventorySupplyList>
<member>
<SellerSKU>SampleSKU1</SellerSKU>
<ASIN>B00000K3CQ</ASIN>
<TotalSupplyQuantity>20</TotalSupplyQuantity>
<FNSKU>X0000000FM</FNSKU>
<Condition>NewItem</Condition>
<SupplyDetail/>
<InStockSupplyQuantity>15</InStockSupplyQuantity>
<EarliestAvailability>
<TimepointType>Immediately</TimepointType>
</EarliestAvailability>
</member>
<member>
<SellerSKU>SampleSKU2</SellerSKU>
<ASIN>B00004RWQR</ASIN>
<TotalSupplyQuantity>0</TotalSupplyQuantity>
<FNSKU>X00008FZR1</FNSKU>
<Condition>UsedLikeNew</Condition>
<SupplyDetail/>
<InStockSupplyQuantity>0</InStockSupplyQuantity>
</member>
</InventorySupplyList>
</ListInventorySupplyResult>
<ResponseMetadata>
<RequestId>e8698ffa-8e59-11df-9acb-230ae7a8b736</RequestId>
</ResponseMetadata>
</ListInventorySupplyResponse>
標準のリクエスト要件について詳しくは、必須のリクエストパラメーターを参照してください。
http://mws.amazonaws.com/FulfillmentInventory/2010-10-01/ ?Action=ListInventorySupply &Version=2010-10-01 &AWSAccessKeyId=1QZHP81N5R44N89PFAKE &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &SignatureVersion=2 &SignatureMethod=HmacSHA256 &Signature=VY6sqvdk01VEG0V+h4oj3FBFAKE= &Timestamp=2010-10-01T02:40:36Z &SellerId=1234567890 &QueryStartDateTime=2011-05-03T06%3A00%3A00Z &ResponseGroup=Detailed
標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。
<?xml version="1.0"?>
<ListInventorySupplyResponse xmlns="http://mws.amazonaws.com/FulfillmentInventory/2010-10-01/">
<ListInventorySupplyResult>
<NextToken>H4sIAAAAAAAAADXQzW6CMAAA4FcxXD3AgE5J5pLSiBTQ8Sc
SblCB0Ap2LSL49O6y7xGr05WbPW8ip3SlDdZK6t3CmuKTH8d9B/0mhCR7gcV
E3gpuDaR8850n239tjC17Z3Gg2PmsZJNa14izwUtQAMYp6tOH4NHl/gN492S
YVU0P5F0OYwUwmYI0d/YHnMSgDPUF0mvxTPNofZkXr6ww39SIBYJUTlUMNwI
WaduUNr/MZYmaySPqugvxiQaTs2Rxgs1gFENKcUV7Ry/8BSUECjcj2sQ7bLT
nBvYPd9/ksLbmV5ydt+HUWFx1QMQgD7O5Ey96mZzNZypKo7V9nBUtPNp/Azt
F/X4Di21K/SkBAAA=</NextToken>
<InventorySupplyList>
<member>
<SellerSKU>SampleSKU3</SellerSKU>
<ASIN>BT008FQ92Q</ASIN>
<TotalSupplyQuantity>18</TotalSupplyQuantity>
<FNSKU>X0000000EY</FNSKU>
<Condition>NewItem</Condition>
<SupplyDetail>
<member>
<EarliestAvailableToPick>
<TimepointType>Immediately</TimepointType>
</EarliestAvailableToPick>
<Quantity>5</Quantity>
<LatestAvailableToPick>
<TimepointType>Immediately</TimepointType>
</LatestAvailableToPick>
<SupplyType>InStock</SupplyType>
</member>
<member>
<EarliestAvailableToPick>
<TimepointType>DateTime</TimepointType>
<DateTime>2011-05-04T23:00:00Z</DateTime>
</EarliestAvailableToPick>
<Quantity>13</Quantity>
<LatestAvailableToPick>
<TimepointType>DateTime</TimepointType>
<DateTime>2011-05-04T23:00:00Z</DateTime>
</LatestAvailableToPick>
<SupplyType>InStock</SupplyType>
</member>
</SupplyDetail>
<InStockSupplyQuantity>4</InStockSupplyQuantity>
</member>
</InventorySupplyList>
</ListInventorySupplyResult>
<ResponseMetadata>
<RequestId>e26d8d21-8e5c-11df-9acb-230ae7a8b736</RequestId>
</ResponseMetadata>
</ListInventorySupplyResponse>