eBay Trading APIVersion 1119

SellingManagerProductSpecificsType

This type is used by the AddSellingManagerProduct and ReviseSellingManagerProduct calls to add/revise listing-level Item Specifics and/or to define multiple variations for a new or existing Selling Manager Product record.

This type is also used by the respone of the GetSellingManagerInventory call.

Types that use SellingManagerProductSpecificsType:

Calls that use SellingManagerProductSpecificsType:

Fields

ItemSpecifics ( NameValueListArrayType ) [0..1]
This container is used to define/revise listing-level Item Specifics for a single-variation or multiple-variation listing. Item Specifics give sellers a structured way to describe details of their items through name-value pairs.

Each Item Specific requires its own ItemSpecifics.NameValueList container, and it is possible that a single Item Specific can more than one applicable value. An example of this would be a 'Features' Item Specific. A product can have multiple features, hence multiple features can be passed in through multiple ItemSpecifics.NameValueList.Value fields.

Many listing categories have mandatory Item Specifics, and just about all listing categories have recommended Item Specifics. To retrieve mandatory and recommended Item Specifics for a category, the GetCategorySpecifics call can be used.

This container is returned in a GetSellingManagerInventory call only if Item Specifics are defined for the Selling Manager Product.
See the Field Index to learn which calls use ItemSpecifics.

PrimaryCategoryID ( string ) [0..1]
This optional field sets the primary eBay listing category for the Selling Manager Product. If the primary eBay listing category ID is not specified with AddSellingManagerProduct or ReviseSellingManagerProduct call, the seller can pass in this information with a subsequent AddSellingManagerTemplate call.

The GetSuggestedCategories or GetCategories call can be used to retrieve eBay leaf category IDs.

This field is returned in a GetSellingManagerInventory call only if it is defined for the Selling Manager Product.
See the Field Index to learn which calls use PrimaryCategoryID.

Variations ( VariationsType ) [0..1]
This container is used to define/revise multiple variations for a new or existing Selling Manager Product record. This container is only applicable if the new or existing Selling Manager Product record will ultimately be converted to a multiple-variation, fixed-price listing on an eBay Marketplace.

Note that Item Specifics that all product variations share are actually set in the ItemSpecifics container, the Variations.Pictures container is used to specify URLs for all pictures that will end up in the listing, the Variations.VariationSpecificsSet container is used to set all available options for the aspects that all product variations share (such as 'Color' and 'Size'), and a Variations.Variation container is need to define each variation, including its defining aspects (such as 'Blue, Large'), quantity available, price, SKU value (if applicable) and any eBay Product ID (ePID) or GTIN (UPC, EAN, ISBN) value asssociated with the variation.

Not all eBay listing categories support multiple-variation listings, so it might be a good idea to run a GetCategoryFeatures call on one or more categories, and include a FeatureID filter set to a value of ItemSpecificsEnabled. If the listing category supports multiple-variation listings, a ItemSpecificsEnabled tag will get returned for the category with a value of Enabled.

This container is returned in a GetSellingManagerInventory call only if variations are defined in the Selling Manager Product.
See the Field Index to learn which calls use Variations.