Prev Documentation Feedback Next
Welcome » Inventory API Reference » Inventory API Operations » ListUpdatedInventorySupply

ListUpdatedInventorySupply

Description

The ListUpdatedInventorySupply operation gets information about the supply of merchant-owned inventory in Amazon's fulfillment network that has had recent changes in inventory status. This operation provides the most efficient means for clients to maintain local copies of their inventory supply data.

Call this operation to begin pagination and to retrieve the first set of results. Use ListUpdatedInventorySupplyByNextToken to request additional sets of results (as indicated by the HasNext element in the operation response). The type of inventory data returned by this operation is the same as GetInventorySupply returns.

[Tip]Tip

We recommend that you use the ListUpdatedInventorySupply operation for frequent, near-real-time updates of your Amazon fulfilled inventory levels. If you need less frequent updates (daily or weekly, for example) we recommend that you use the Amazon Fulfilled Inventory Report in the Inventory Reports page.

[Important]Important

This ListUpdatedInventorySupply operation occasionally reports SKUs as having updates when actual inventory levels have not changed. This is intentional. Systems based on update events will lose accuracy over time if updates are not processed correctly when they occur (for example, service outage, errors in update processing logic).

To ensure that any missed updates are corrected, SKUs are periodically reported as having been updated, without a triggering inventory event. Inventory levels returned by ListUpdatedInventorySupply will accurately reflect current availability regardless of whether the SKU's inventory level has changed.

Request Parameters

NameDescriptionRequired

NumberOfResultsRequested

The number of results you want returned each time you call this and any subsequent ListUpdatedInventorySupplyByNextToken operation.

Type: Integer

Default: None

Constraints: Any number from 1 to 50.

Yes

QueryStartDateTime

The date and time to start the query. The returned results include all changes to inventory from this date through the current date.

Type: String

Constraints: The format must be based on the RFC3339 profile of ISO8610 as follows: [YYYY]-[MM]-[DD]T[HH]:[MM]:[SS][TZ] where:

  • YYYY—Indicates the year

  • MM—Indicates the month

  • DD—Indicates the day

  • T—Indicates the start of the required time section

  • HH—Indicates the hour

  • MM—Indicates the minute

  • TZ—Indicates the time zone

Yes

ResponseGroup

Specifies the type of the ResponseGroup you want returned:

  • Basic—Everything but the SupplyDetail element. The SupplyDetail list will be empty.

  • Detailed—Returns all MerchantSKUSupply elements, including the SupplyDetail list and all elements in the Basic ResponseGroup.

Type: String

Valid values: Basic | Detailed

Default: Basic

No

Response Elements

NameDescription

HasNext

Boolean to indicate whether there are more items returned. True means there are more items to retrieve using the next token version of this operation. False means there are no more items to retrieve.

Type: Boolean

NextToken

Text string used to support pagination. Use the NextToken to perform an additional operation if the HasNext parameter is True.

Type: String

MerchantSKUSupply

Represents merchant-owned inventory for a single SKU. There will be one MerchantSKUSupply element for each SKU that has been has been updated within the timeframe you specified in your request.

Type: MerchantSKUSupply

[Note]Note

Inventory items returned as InStock might not be immediately pickable. For example, inventory in reserve locations may take up to 12 hours to become pickable.

Examples

Example SOAP Request

<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soapenv:Header>
    <aws:AWSAccessKeyId
      soapenv:actor="http://schemas.xmlsoap.org/soap/actor/next"
      soapenv:mustUnderstand="0"
      xmlns:aws="http://security.amazonaws.com/doc/2007-01-01/"
      >0QY05JR56ZA8E56XPG82</aws:AWSAccessKeyId>
    <aws:Signature soapenv:actor="http://schemas.xmlsoap.org/soap/actor/next"
      soapenv:mustUnderstand="0"
      xmlns:aws="http://security.amazonaws.com/doc/2007-01-01/"
      >NsfzVEPTTDf41L75dAl567CUwFc=</aws:Signature>
    <aws:Timestamp soapenv:actor="http://schemas.xmlsoap.org/soap/actor/next"
      soapenv:mustUnderstand="0"
      xmlns:aws="http://security.amazonaws.com/doc/2007-01-01/"
      >2009-10-12T17:28:29Z</aws:Timestamp>
  </soapenv:Header>
  <soapenv:Body>
    <ListUpdatedInventorySupply
      xmlns="http://fba-inventory.amazonaws.com/doc/2009-07-31/">
      <NumberOfResultsRequested>7</NumberOfResultsRequested>
      <QueryStartDateTime>2009-09-01T07:00:00Z</QueryStartDateTime>
      <ResponseGroup>Detailed</ResponseGroup>
    </ListUpdatedInventorySupply>
  </soapenv:Body>
</soapenv:Envelope>

Example Query Request

https://fba-inventory.amazonaws.com/
?Action=ListUpdatedInventorySupply
&Version=2009-07-31
&AWSAccessKeyId=0QY05JR56ZA8E56XPG82
&Signature=NsfzVEPTTDf41L75dAl567CUwFc=
&Timestamp=2009-10-12T17:28:29Z
&NumberOfResultsRequested=7
&QueryStartDateTime=2009-09-01T07:00:00Z
&ResponseGroup=Detailed

Example Response

<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope
  xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
  <soapenv:Body>
    <ns1:ListUpdatedInventorySupplyResponse      
      xmlns:ns1="http://fba-inventory.amazonaws.com/doc/2009-07-31/">
      <ns1:ListUpdatedInventorySupplyResult>
        <ns1:NextToken>H4sIAAAAAAAAADXPzW6CMAAA4FcxXDl0IPKTjCUtVihIEWHAvE
          FQtmFFWhoIT+8u+97ge/8RTb+ZW+4qE5dXZcMmVwkMQeA/X6dpKr0UIR/Yw+zoT5a
          3dblNiyVsloHBsk2FzO/10blpI20E3q7Jp/NghnlFQ8xqSjLck8ZIHp0huXbQVxCu
          rCgOV+zVeyyDwvcz/FXdy18NNkea9BHVNPqNzA7gJauSaleJUx4gSwvp1gKldc4ka
          cdpt8fnUb/wzvBGh9WLBDaKo6WBT5z1kAfMurSSt2ZcdPbsT/OByJwsgIM43SFBn9
          H5RirTelNVX5jqjD2vGE4Q4r+06yrg4wX/KO6eHAEAAA==</ns1:NextToken>
        <ns1:HasNext>true</ns1:HasNext>
        <ns1:MerchantSKUSupply>
          <ns1:MerchantSKU>TESTCASE15</ns1:MerchantSKU>          
          <ns1:FulfillmentNetworkSKU>TESTCASE15</ns1:FulfillmentNetworkSKU>
          <ns1:ASIN>TESTCASE15</ns1:ASIN>
          <ns1:Condition />
          <ns1:TotalSupplyQuantity>0</ns1:TotalSupplyQuantity>          
          <ns1:InStockSupplyQuantity>0</ns1:InStockSupplyQuantity>
        </ns1:MerchantSKUSupply>
        <ns1:MerchantSKUSupply>
          <ns1:MerchantSKU>TESTCASE11</ns1:MerchantSKU>       
          <ns1:FulfillmentNetworkSKU>TESTCASE11</ns1:FulfillmentNetworkSKU>
          <ns1:ASIN>TESTCASE11</ns1:ASIN>
          <ns1:Condition />
          <ns1:TotalSupplyQuantity>0</ns1:TotalSupplyQuantity>          
          <ns1:InStockSupplyQuantity>0</ns1:InStockSupplyQuantity>
        </ns1:MerchantSKUSupply>
        <ns1:MerchantSKUSupply>
          <ns1:MerchantSKU>TESTCASE12</ns1:MerchantSKU>         
          <ns1:FulfillmentNetworkSKU>TESTCASE12</ns1:FulfillmentNetworkSKU>
          <ns1:ASIN>TESTCASE12</ns1:ASIN>
          <ns1:Condition />
          <ns1:TotalSupplyQuantity>0</ns1:TotalSupplyQuantity>          
          <ns1:InStockSupplyQuantity>0</ns1:InStockSupplyQuantity>
        </ns1:MerchantSKUSupply>
        <ns1:MerchantSKUSupply>
          <ns1:MerchantSKU>TESTCASE14</ns1:MerchantSKU>          
          <ns1:FulfillmentNetworkSKU>TESTCASE14</ns1:FulfillmentNetworkSKU>
          <ns1:ASIN>TESTCASE14</ns1:ASIN>
          <ns1:Condition />
          <ns1:TotalSupplyQuantity>0</ns1:TotalSupplyQuantity>          
          <ns1:InStockSupplyQuantity>0</ns1:InStockSupplyQuantity>
        </ns1:MerchantSKUSupply>
        <ns1:MerchantSKUSupply>
          <ns1:MerchantSKU>NewAFNOffering-OfDoom</ns1:MerchantSKU>
          <ns1:FulfillmentNetworkSKU>X0000000E6</ns1:FulfillmentNetworkSKU>
          <ns1:ASIN>B00005MF9U</ns1:ASIN>
          <ns1:Condition>NewItem</ns1:Condition>
          <ns1:TotalSupplyQuantity>0</ns1:TotalSupplyQuantity>
          <ns1:InStockSupplyQuantity>0</ns1:InStockSupplyQuantity>
        </ns1:MerchantSKUSupply>
        <ns1:MerchantSKUSupply>
          <ns1:MerchantSKU>TESTCASE10</ns1:MerchantSKU>
          <ns1:FulfillmentNetworkSKU>TESTCASE10</ns1:FulfillmentNetworkSKU>
          <ns1:ASIN>TESTCASE10</ns1:ASIN>
          <ns1:Condition />
          <ns1:TotalSupplyQuantity>0</ns1:TotalSupplyQuantity>
          <ns1:InStockSupplyQuantity>0</ns1:InStockSupplyQuantity>
        </ns1:MerchantSKUSupply>
        <ns1:MerchantSKUSupply>
          <ns1:MerchantSKU>TESTCASE13</ns1:MerchantSKU>
          <ns1:FulfillmentNetworkSKU>TESTCASE13</ns1:FulfillmentNetworkSKU>
          <ns1:ASIN>TESTCASE13</ns1:ASIN>
          <ns1:Condition />
          <ns1:TotalSupplyQuantity>0</ns1:TotalSupplyQuantity>
          <ns1:InStockSupplyQuantity>0</ns1:InStockSupplyQuantity>
        </ns1:MerchantSKUSupply>
      </ns1:ListUpdatedInventorySupplyResult>
      <ns1:ResponseMetadata>       
        <ns1:RequestId>
          479527b9-53e2-455e-9d05-f948292e7ff0
        </ns1:RequestId>
      </ns1:ResponseMetadata>
    </ns1:ListUpdatedInventorySupplyResponse>
  </soapenv:Body>
</soapenv:Envelope>

Related Operations

ListUpdatedInventorySupplyByNextToken

GetInventorySupply

Prev Copyright Information Next
 Home