eBay Trading APIVersion 1085

VariationProductListingDetailsType

This type defines the VariationProductListingDetails container that is used to specify an EAN, an ISBN, a UPC value, or an ePID to identify a specific product variation in a multiple-variation listing. For multiple-variation listings, the same GTIN type(s) must be used for all product variations within the listing. For instance, if one product variation uses ISBNs, all product variations must use ISBN values.

Note: The ProductReferenceID field can only be used when listing in categories that are enabled with the Product-Based Shopping Experience. If this field is provided when listing in a category that doesn't support PBSE, the listing will be blocked.

Type that uses VariationProductListingDetailsType:

Calls that use VariationProductListingDetailsType:

Fields



EAN ( string ) [0..1]
This field is used if the seller wants to, or is required to identify each product variation within a multiple-variation listing by an EAN (European Article Number) value. An EAN is a unique 8 or 13-digit identifier that many industries (such as book publishers) use to identify products. The seller can use the GetCategoryFeatures or GetCategorySpecifics calls to see if an EAN is supported/required for a category.

This field is only applicable for multiple-variation listings. For a single-variation listing, if the category/product requires an EAN value, this value should be passed into the Item.ProductListingDetails.EAN field instead. Unlike single-variation listings, an eBay catalog product cannot be used to prefill product details for a multiple-variation listing.

Note: If the listing is being posted to a category that expects EAN values, but one doesn't exist for the product, the seller must pass in the text that can be found in the ProductDetails.ProductIdentifierUnavailableText field of the GeteBayDetails response. To get the ProductDetails container to return in the GeteBayDetails response, ProductDetails should be included as a DetailName value in the call request.
See the Field Index to learn which calls use EAN.

ISBN ( string ) [0..1]
This field is used if the seller wants to, or is required to identify each product variation within a multi-variation listing by an ISBN (International Standard Book Number) value. An ISBN is a unique identifer for books. Both 10 and 13-character ISBNs are supported. When specifying a 13-character ISBN, the value must begin with either '978' or '979'. The seller can use the GetCategoryFeatures or GetCategorySpecifics calls to see if an ISBN is supported/required for a category.

This field is only applicable for multiple-variation listings. For a single-variation listing, if the category/product requires an ISBN value, this value should be passed into the Item.ProductListingDetails.ISBN field instead. Unlike single-variation listings, an eBay catalog product cannot be used to prefill product details for a multiple-variation listing.

Note: If the listing is being posted to a category that expects ISBN values, but one doesn't exist for the product, the seller must pass in the text that can be found in the ProductDetails.ProductIdentifierUnavailableText field of the GeteBayDetails response. To get the ProductDetails container to return in the GeteBayDetails response, ProductDetails should be included as a DetailName value in the call request.
See the Field Index to learn which calls use ISBN.

NameValueList ( NameValueListType ) [0..*]
Not used by any call.

This container is for future use. If it used, it will be ignored.
See the Field Index to learn which calls use NameValueList.

ProductReferenceID ( string ) [0..1]
This field is used if the seller wants to, or is required to identify each product variation within a multiple-variation listing by an eBay Product ID (ePID). An ePID is a unique identifier of an eBay Catalog product. The seller can use the GetCategoryFeatures or GetCategorySpecifics calls to see if an ePID is supported/required for a category. Each variation within the listing must use a unique ePID or an error will occur.

Note: The ProductReferenceID field can only be used to specify an ePID for an eBay Catalog product that is part of the Product-Based Shopping Experience mandate. If an ePID is supplied for another eBay Catalog product that is not a part of the Product-Based Shopping Experience mandate, the listing may be blocked. For more information about PBSE, see the Product-Based Shopping Experience page. This field is also returned in GetItem if the product variations within the listing are associated with eBay Catalog products.
See the Field Index to learn which calls use ProductReferenceID.

UPC ( string ) [0..1]
This field is used if the seller wants to, or is required to identify each product variation within a multiple-variation listing by a UPC (Universal Product Code) value. A UPC is a commonly-used identifier for many different products. The seller can use the GetCategoryFeatures or GetCategorySpecifics calls to see if a UPC is supported/required for a category.

This field is only applicable for multiple-variation listings. For a single-variation listing, if the category/product requires a UPC value, this value should be passed into the Item.ProductListingDetails.UPC field instead. Unlike single-variation listings, an eBay catalog product cannot be used to prefill product details for a multiple-variation listing.

Note: If the listing is being posted to a category that expects UPC values, but one doesn't exist for the product, the seller must pass in the text that can be found in the ProductDetails.ProductIdentifierUnavailableText field of the GeteBayDetails response. To get the ProductDetails container to return in the GeteBayDetails response, ProductDetails should be included as a DetailName value in the call request.
See the Field Index to learn which calls use UPC.