Amazon Services China
亚马逊商城网络服务（亚马逊 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.

亚马逊 MWS 文档

ListInventorySupply

返回卖家库存状况信息。

描述

该 ListInventorySupply 操作可以返回卖家位于 亚马逊物流 和在当前入库货件中的库存的供应情况相关信息。您可以查看您的亚马逊物流库存当前的供应状态，还可以找到库存供应状态发生变化的时间。

此操作不会返回库存供应情况的信息，此库存位于：
  • 无法销售
  • 绑定买家订单

限制

该 ListInventorySupply 操作的最大请求限额为 30 个，恢复速率为每秒钟 2 个请求。 有关限制术语的定义以及限制的完整解释，请参阅亚马逊MWS开发者指南中的限制：针对提交请求频率的限制。

请求参数

名称 描述 必填项 有效值
SellerSkus 为您想知道库存供应情况的商品指定的卖家 SKU 列表。 是，如果未 指定 QueryStartDateTime 的值。

同时指定 QueryStartDateTime 和 SellerSkus 的值时，将返回一个错误。

为您已经发运至亚马逊配送中心的商品指定的卖家 SKU。

最大值：50

类型：xs:string
QueryStartDateTime 此日期用于选择您在某个指定日期后（或当时）已更改库存供应情况的商品，日期格式为 ISO 8601。 是，如果未指定 SellerSkus 的值。

同时指定 QueryStartDateTime 和 SellerSkus 的值时，将返回一个错误。

类型：xs:dateTime
ResponseGroup 指明您是否想执行 ListInventorySupply 操作以返回 SupplyDetail 元素。 否 ResponseGroup 值：
  • Basic - 不包括响应中的 SupplyDetail 元素
  • Detailed - 在响应中包含 SupplyDetail 元素

默认值：Basic

类型：xs:string

响应元素

名称 描述
NextToken 生成的字符串，用于将信息传递给下一请求。如果返回 NextToken，将 NextToken 的值传递给 ListInventorySupplyByNextToken。如果未返回 NextToken 值，则不会返回其他库存状况信息。

可选项

类型：xs:string
InventorySupplyList 亚马逊物流已为配送提供商品的结构列表，或将很快为配送提供商品的结构列表。即将运至亚马逊配送中心的商品当前位于亚马逊物流或入库货件中。每个商品包括 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" encoding="utf-8"?>
<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" encoding="utf-8"?>
<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>