Skip to main content
Published: December 14 2011, 4:18:00 PMUpdated: August 24 2022, 11:49:31 PM
Product

Are you having eBay Catalog issues?  Are you getting ErrorCode 21916689 "No Product Found..." ? OR Error Code 21916691"Invalid value for <UPC>"?  Please use the Product API call, addProducts, to add the missing product in the eBay catalog.

Summary
 

eBay keeps a large catalog of stock listing information (products).  The product contains partially filled out Item Specifics and other descriptive information from a catalog—collectively known as product details. Using product details gives sellers a faster way to fill in Item Specifics and other information about an item.  Many sellers may want to take advantage of products in order to quickly list items. 

However, from time to time, users may encounter errors when using the eBay catalog in the AddItem family of calls (including Large Merchant Service, AddFixedPriceItemJob).  It may be advantageous for sellers and developers alike, to have the best quality of data in the eBay catalog.  If you encounter errors or incorrect information regarding any of the products in eBay's catalog, please use the Product API call, addProducts to update the eBay catalog.

*NOTE - Not all categories accept product creation.  Make sure to use GetCategoryFeatures and check if the category accepts products.  Here is a link for more detail Product Creation.

 


Detailed Description

A product is an entry in an eBay catalog that defines well-known information about particular kinds of items. An example of a product would be information about a particular edition of "My Favorite Movie: The Sequel" on DVD, identified by a specific UPC. Other editions of the same movie would have different UPC values, and would therefore be considered separate products. Each product consists of pre-filled Item Specifics, additional descriptive information, plus a stock photo (if available).


Sample: Basic Call

Input

The product request must include the category ID (categoryId), and one or more product property name value pairs (addProductRequest.productPropertyValue.propertyName and addProductRequest.productPropertyValue.value) to describe the product. Retrieve compatibility search values for vehicle model (propertyName set to Model) from the Other Parts category (categoryId set to 6763). Limit the results to models for Honda make vehicles only (propertyFilter.propertyName set to Make andpropertyFilter.value.text.value set to Honda).

 

XML format (HTTP POST). Also available is the .txt version of this XML

<?xml version="1.0" encoding="UTF-8"?>
<addProductsRequest xmlns="http://www.ebay.com/marketplace/marketplacecatalog/v1/services">
   <addProductRequest>
      <invocationId>0123456789</invocationId>
      <categoryId>156955</categoryId>
      <productPropertyValue>
         <propertyName>Title</propertyName>
         <value>
            <text>
               <value>Long description </value>
            </text>
         </value>
      </productPropertyValue>
      <productPropertyValue>
         <propertyName>Brand</propertyName>
         <value>
            <text>
               <value>Belkin</value>
            </text>
         </value>
      </productPropertyValue>
      <productPropertyValue>
         <propertyName>Model</propertyName>
         <value>
            <text>
               <value>Belkin456</value>
            </text>
         </value>
      </productPropertyValue>
      <productPropertyValue>
         <propertyName>SKU</propertyName>
         <value>
            <text>
               <value>BelkSKUin123</value>
            </text>
         </value>
      </productPropertyValue>
      <productPropertyValue>
         <propertyName>GPS_Devices_GPS_Type</propertyName>
         <value>
            <text>
               <value>Automobile</value>
            </text>
         </value>
      </productPropertyValue>
      <productPropertyValue>
         <propertyName>GPS_Devices_Form_Factor</propertyName>
         <value>
            <text>
               <value>Logi1</value>
            </text>
         </value>
         <value>
            <text>
               <value>Logi2</value>
            </text>
         </value>
      </productPropertyValue>
      <productPropertyValue>
         <propertyName/>
         <value>
            <number>
               <value>2536</value>
               <unitOfMeasurement/>
            </number>
         </value>
      </productPropertyValue>
      <media>
         <mediaIdentifier>
            <url>http://www.botany.com/img/plants/dictionary-plants-flowers.jpg</url>
         </mediaIdentifier>
         <mediaType>Image</mediaType>
      </media>
   </addProductRequest>
   <clientBatchId>54321</clientBatchId>
</addProductsRequest>

Output

The response defaults to a tree format, in which each child property specifies a model name (e.g., (propertyValuesTree.childPropertyNameValue.value.text.value is Accord).

XML format. Also available is the .txt version of this XML.

<addProductsResponse xmlns="http://www.ebay.com/marketplace/marketplacecatalog/v1/services">
   <ack>Success</ack>
   <errorMessage/>
   <version>1.3.1</version>
   <timestamp>2011-05-02T20:14:22.569Z</timestamp>
   <addProducResponse>
      <errorMessage/>
      <invocationId>0123456789</invocationId>
      <status>
         <productSubmissionId>5000102408</productSubmissionId>
         <statusCode>Pending</statusCode>
      </status>
   </addProducResponse>
   <clientBatchId>54321</clientBatchId>
</addProductsResponse>

 

How well did this answer your question?
Answers others found helpful

Got thoughts? Click the feedback button – your insights help us improve!