eBay Merchant Data API API Reference Version 661 Support     Knowledge Base     Forums     All Tutorials     All Code Samples Users Guide API Reference Making an API Call Tutorials Release Notes

List of All Calls Field Index Enumeration Index Type Index Errors by Number Output Samples Change History User Notes

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.

See also the reference documentation for these calls (in the Trading API API Reference):

• ReviseInventoryStatus - Enables a seller to change the price and quantity of currently active fixed-price items. Can be uploaded in bulk with Large Merchant Services.
• ReviseFixedPriceItem - Enables a seller to change the properties of a single currently active listing. Can be uploaded in bulk with Large Merchant Services.

Back to top

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).

See also Samples.

<?xml version="1.0" encoding="utf-8"?>
<ActiveInventoryReportResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- 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 here ... -->
    <LongMessage> string </LongMessage>
    <SeverityCode> SeverityCodeType </SeverityCode>
    <ShortMessage> string </ShortMessage>
  </Errors>
  <!-- ... more Errors nodes here ... -->
  <HardExpirationWarning> string </HardExpirationWarning>
  <Timestamp> dateTime </Timestamp>
  <Version> string </Version>
  <!-- Call-specific Output Fields -->
  <SKUDetails> SKUDetailsType 
    <BidCount> int </BidCount>
    <ItemID> ItemIDType (string) </ItemID>
    <Price> AmountType (double) </Price>
    <Quantity> int </Quantity>
    <ReserveMet> boolean </ReserveMet>
    <SKU> SKUType (string) </SKU>
    <Variations> MerchantDataVariationsType 
      <Variation> MerchantDataVariationType 
        <Price> AmountType (double) </Price>
        <Quantity> int </Quantity>
        <SKU> SKUType (string) </SKU>
        <VariationSpecifics> NameValueListArrayType 
          <NameValueList> NameValueListType 
            <Name> string </Name>
            <Value> string </Value>
            <!-- ... more Value nodes here ... -->
          </NameValueList>
          <!-- ... more NameValueList nodes here ... -->
        </VariationSpecifics>
      </Variation>
      <!-- ... more Variation nodes here ... -->
    </Variations>
  </SKUDetails>
  <!-- ... more SKUDetails nodes here ... -->
</ActiveInventoryReportResponse>

Back to top

New to making API calls? Please see Making an API Call.

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 megaonlinemerchant 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 (HTTP POST). Also available is the .txt version of this XML.

 
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,Quantity, and SiteID.

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. Also available is the .txt version of this XML.

<?xml version="1.0" encoding="utf-8"?>
<BulkDataExchangeResponsesxmlns="urn:ebay:apis:eBLBaseComponents">
  <ActiveInventoryReport>    
    <SKUDetails>
      <SKU></SKU>
      <Price currencyID="USD">50.00</Price>
      <Quantity>6</Quantity>
      <ItemID>110035808064</ItemID>
    </SKUDetails>
    <SKUDetails>
      <SKU></SKU>
      <Price currencyID="USD">50.00</Price>
      <Quantity>6</Quantity>
      <ItemID>110035808166</ItemID>
    </SKUDetails>
    <SKUDetails>
      <SKU></SKU>
      <Price currencyID="USD">50.00</Price>
      <Quantity>5</Quantity>
      <ItemID>110035808177</ItemID>
    </SKUDetails>
    <SKUDetails>
      <SKU></SKU>
      <Price currencyID="USD">50.00</Price>
      <Quantity>1</Quantity>
      <ItemID>110035808425</ItemID>
    </SKUDetails>
    <SKUDetails>
      <SKU></SKU>
      <Price currencyID="USD">50.00</Price>
      <Quantity>4</Quantity>
      <ItemID>110035808513</ItemID>
    </SKUDetails>
    <SKUDetails>
      <SKU></SKU>
      <Price currencyID="USD">65.00</Price>
      <Quantity>5</Quantity>
      <ItemID>110035817827</ItemID>
    </SKUDetails>
    <SKUDetails>
      <SKU></SKU>
      <Price currencyID="USD">5.00</Price>
      <Quantity>11</Quantity>
      <ItemID>110035817828</ItemID>
    </SKUDetails>
    <SKUDetails>
      <SKU></SKU>
      <Price currencyID="USD">50.00</Price>
      <Quantity>6</Quantity>
      <ItemID>110035817937</ItemID>
    </SKUDetails>
    <SKUDetails>
      <SKU></SKU>
      <Price currencyID="USD">55.00</Price>
      <Quantity>4</Quantity>
      <ItemID>110035817938</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>110036776036</ItemID>
    </SKUDetails>
    <SKUDetails>
      <SKU></SKU>
      <Price currencyID="USD">55.00</Price>
      <Quantity>4</Quantity>
      <ItemID>110036776039</ItemID>
    </SKUDetails>
    
  </ActiveInventoryReport>
</BulkDataExchangeResponses>

Back to top

Back to top

This document was generated with a customized version of the apireferencedocs tool.

© 2008–2010 eBay, Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.