ActiveInventoryReport

Note: You must wrap the file to be uploaded within BulkDataExchangeRequest tags, which will also be returned in the response. This container is not shown in the standard Output section for this call, but is shown in the Samples. For additional information, see XML data files overview in the LMS Feed API Guide. A report that contains price and quantity information for all of the active listings for a specific seller. A seller can use this information to maintain their inventory on eBay.

The eBay servers read the token information passed in by the seller's application to determine which seller's data to retrieve.

Output

See also Samples.

The box below lists all fields that might be returned in the response. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

<?xml version="1.0" encoding="utf-8"?>
<ActiveInventoryReport xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Output Fields -->
  <SKUDetails> SKUDetailsType
    <BidCount> int </BidCount>
    <ItemID> ItemIDType (string) </ItemID>
    <Price currencyID="CurrencyCodeType"> AmountType (double) </Price>
    <Quantity> int </Quantity>
    <ReserveMet> boolean </ReserveMet>
    <SKU> SKUType (string) </SKU>
    <Variations> MerchantDataVariationsType
      <Variation> MerchantDataVariationType
        <Price currencyID="CurrencyCodeType"> AmountType (double) </Price>
        <Quantity> int </Quantity>
        <SKU> SKUType (string) </SKU>
        <VariationSpecifics> NameValueListArrayType
          <NameValueList> NameValueListType
            <Name> string </Name>
            <Value> string </Value>
            <!-- ... more Value values allowed here ... -->
          </NameValueList>
          <!-- ... more NameValueList nodes allowed here ... -->
        </VariationSpecifics>
      </Variation>
      <!-- ... more Variation nodes allowed here ... -->
    </Variations>
  </SKUDetails>
  <!-- ... more SKUDetails nodes allowed here ... -->
  <!-- Standard Output Fields -->
  <Ack> AckCodeType </Ack>
  <Build> string </Build>
  <CorrelationID> string </CorrelationID>
  <Errors> ErrorType
    <ErrorClassification> ErrorClassificationCodeType </ErrorClassification>
    <ErrorCode> token </ErrorCode>
    <ErrorParameters ParamID="string"> ErrorParameterType
      <Value> string </Value>
    </ErrorParameters>
    <!-- ... more ErrorParameters nodes allowed here ... -->
    <LongMessage> string </LongMessage>
    <SeverityCode> SeverityCodeType </SeverityCode>
    <ShortMessage> string </ShortMessage>
  </Errors>
  <!-- ... more Errors nodes allowed here ... -->
  <HardExpirationWarning> string </HardExpirationWarning>
  <Timestamp> dateTime </Timestamp>
  <Version> string </Version>
</ActiveInventoryReport>

Samples

Note: Some item IDs, user IDs, or other data in these samples might no longer be active on eBay. If necessary, you can substitute current eBay data in your requests.

Lists the active inventory for a specific seller ID (ID associated with the auth token). This sample represents a data file that you will download using the Bulk Data Exchange Service and File Transfer Service.

Description

User m****************t wants to see a list of her active inventory on the eBay site. She sends a Bulk Data Exchange startDownloadJob request with the ActiveInventoryReport parameter, uses a Bulk Data Exchange getJobStatus request to see if her report is ready to download, and then sends a File Transfer Service downloadJob request to retrieve the report data.

Input

Since a Large Merchant Services report returns a pre-determined set of elements, there is no input request for a report. Instead, the report type is specified as a parameter of a Bulk Data Exchange startDownloadJob call.

XML format.

 
Do not send a request file for reports. See description above.

Output

The response returns the SKU Details, which include: ItemID and/or SKU, Price, and Quantity.

If you need to change the price and quantity data that you see in this report, you can use the ReviseInventoryStatus call in eBay's Trading API, which lets you change the price and quantity of currently active fixed-price listings.

XML format.
<?xml version="1.0" encoding="utf-8"?>
<BulkDataExchangeResponses xmlns="urn:ebay:apis:eBLBaseComponents">
  <ActiveInventoryReport>    
    <SKUDetails>
      <SKU></SKU>
      <Price currencyID="USD">50.00</Price>
      <Quantity>6</Quantity>
      <ItemID>1**********4</ItemID>
    </SKUDetails>
    <SKUDetails>
      <SKU></SKU>
      <Price currencyID="USD">50.00</Price>
      <Quantity>6</Quantity>
      <ItemID>1**********6</ItemID>
    </SKUDetails>
    <SKUDetails>
      <SKU></SKU>
      <Price currencyID="USD">50.00</Price>
      <Quantity>5</Quantity>
      <ItemID>1**********7</ItemID>
    </SKUDetails>
    <SKUDetails>
      <SKU></SKU>
      <Price currencyID="USD">50.00</Price>
      <Quantity>1</Quantity>
      <ItemID>1**********5</ItemID>
    </SKUDetails>
    <SKUDetails>
      <SKU></SKU>
      <Price currencyID="USD">50.00</Price>
      <Quantity>4</Quantity>
      <ItemID>1**********3</ItemID>
    </SKUDetails>
    <SKUDetails>
      <SKU></SKU>
      <Price currencyID="USD">65.00</Price>
      <Quantity>5</Quantity>
      <ItemID>1**********7</ItemID>
    </SKUDetails>
    <SKUDetails>
      <SKU></SKU>
      <Price currencyID="USD">5.00</Price>
      <Quantity>11</Quantity>
      <ItemID>1**********8</ItemID>
    </SKUDetails>
    <SKUDetails>
      <SKU></SKU>
      <Price currencyID="USD">50.00</Price>
      <Quantity>6</Quantity>
      <ItemID>1**********7</ItemID>
    </SKUDetails>
    <SKUDetails>
      <SKU></SKU>
      <Price currencyID="USD">55.00</Price>
      <Quantity>4</Quantity>
      <ItemID>1**********8</ItemID>
    </SKUDetails>
    
    <!-- Items just added with AddFixedPriceItem data file upload
    (using AddFixedPriceItem sample) have a SoldReport with data
     similar to this -->
    
    <SKUDetails>
      <SKU></SKU>
      <Price currencyID="USD">40.00</Price>
      <Quantity>6</Quantity>
      <ItemID>1**********6</ItemID>
    </SKUDetails>
    <SKUDetails>
      <SKU></SKU>
      <Price currencyID="USD">55.00</Price>
      <Quantity>4</Quantity>
      <ItemID>1**********9</ItemID>
    </SKUDetails>
    
  </ActiveInventoryReport>
</BulkDataExchangeResponses>

Change History