GetInventorySupply

Description

The GetInventorySupply operation gets information about the supply of merchant-owned inventory in Amazon's fulfillment network. This operation does not return inventory that is unsellable or that is already bound to a customer order or bound to internal fulfillment center processing (for example, labeling).

Programming Note

	Programming Note
Some API operations take lists of parameters. These lists are specified using the `param.n` notation. Values of n are integers starting from 1. Use this notation for Query requests. For SOAP requests, add another element for each additional parameter value. For example, in Query a parameter list looks like this: &Attribute.1=this &Attribute.2=that In SOAP, a parameter list looks like this: <Attribute>this<Attribute> <Attribute>that<Attribute>

Some API operations take lists of parameters. These lists are specified using the param.n notation. Values of n are integers starting from 1. Use this notation for Query requests. For SOAP requests, add another element for each additional parameter value. For example, in Query a parameter list looks like this:

&Attribute.1=this
&Attribute.2=that

In SOAP, a parameter list looks like this:

<Attribute>this<Attribute>
<Attribute>that<Attribute>

Request Parameters

Name Description Required

Name	Description	Required
`MerchantSKU`	The merchant stock keeping unit (SKU) is the unique product identifier you assign for each product in your inventory. The SKU must be distinct from any other product you list. Type: String Default: None	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

MerchantSKU

The merchant stock keeping unit (SKU) is the unique product identifier you assign for each product in your inventory. The SKU must be distinct from any other product you list.

Type: String

Default: None

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

Response Elements

Name Description

Name	Description
`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

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

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/"
      >UJIZB2tUoMLFkP7040OJ6AXzLts=</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-13T20:10:30Z</aws:Timestamp>
  </soapenv:Header>
  <soapenv:Body>
    <GetInventorySupply
      xmlns="http://fba-inventory.amazonaws.com/doc/2009-07-31/">
      <MerchantSKU>511882770-1155751404029</MerchantSKU>
      <MerchantSKU>1172529050-B0009VBTP02</MerchantSKU>
      <ResponseGroup>Detailed</ResponseGroup>
    </GetInventorySupply>
  </soapenv:Body>
</soapenv:Envelope>

Example Query Request

https://fba-inventory.amazonaws.com/
?Action=GetInventorySupply
&Version=2009-07-31
&AWSAccessKeyId=0QY05JR56ZA8E56XPG82
&Signature=NsfzVEPTTDf41L75dAl567CUwFc=
&Timestamp=2009-10-12T17:28:29Z
&MerchantSKU.1=511882770-1155751404029
&MerchantSKU.2=1172529050-B0009VBTP02
&ResponseGroup=Detailed

Example Response

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
  <soapenv:Body>
    <ns1:GetInventorySupplyResponse
      xmlns:ns1="http://fba-inventory.amazonaws.com/doc/2009-07-31/">
      <ns1:GetInventorySupplyResult>
        <ns1:MerchantSKUSupply>
          <ns1:MerchantSKU>511882770-1155751404029</ns1:MerchantSKU>
          <ns1:FulfillmentNetworkSKU>X000002NR9</ns1:FulfillmentNetworkSKU>
          <ns1:ASIN>B00005JM5E</ns1:ASIN>
          <ns1:Condition>NewItem</ns1:Condition>
          <ns1:TotalSupplyQuantity>4000</ns1:TotalSupplyQuantity>
          <ns1:InStockSupplyQuantity>4000</ns1:InStockSupplyQuantity>
          <ns1:EarliestAvailability>
            <ns1:TimepointType>Immediately</ns1:TimepointType>
          </ns1:EarliestAvailability>
          <ns1:SupplyDetail>
            <ns1:Quantity>4000</ns1:Quantity>
            <ns1:SupplyType>InStock</ns1:SupplyType>
            <ns1:EarliestAvailableToPickDateTime>
              <ns1:TimepointType>Immediately</ns1:TimepointType>
            </ns1:EarliestAvailableToPickDateTime>
            <ns1:LatestAvailableToPickDateTime>
              <ns1:TimepointType>Immediately</ns1:TimepointType>
            </ns1:LatestAvailableToPickDateTime>
          </ns1:SupplyDetail>
        </ns1:MerchantSKUSupply>
        <ns1:MerchantSKUSupply>
          <ns1:MerchantSKU>1172529050-B0009VBTP02</ns1:MerchantSKU>
          <ns1:TotalSupplyQuantity>0</ns1:TotalSupplyQuantity>
          <ns1:InStockSupplyQuantity>0</ns1:InStockSupplyQuantity>
        </ns1:MerchantSKUSupply>
      </ns1:GetInventorySupplyResult>
      <ns1:ResponseMetadata>
        <ns1:RequestId>
          d0fcc134-fdd1-4ff8-b1a9-62920f49ff36
        </ns1:RequestId>
      </ns1:ResponseMetadata>
    </ns1:GetInventorySupplyResponse>
  </soapenv:Body>
</soapenv:Envelope>

ListUpdatedInventorySupply

ListUpdatedInventorySupplyByNextToken