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

ListInventorySupply

出品者の在庫状況に関する情報を返します。

説明

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 - レスポンスにSupplyDetail要素を含まない
  • Detailed - レスポンスにSupplyDetail要素を含む

デフォルト: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>

↑ トップへ戻る