complexType "ns:VariationProductListingDetailsType"
Namespace: |
|
Content: |
|
Defined: |
|
Includes: |
|
Used: |
|
XML Representation Summary |
<...> |
|
|
</...> |
All Direct / Indirect Based Elements (1):
-
This type defines the VariationProductListingDetails container that is used to specify a Global Trade Item Number (GTIN), such as an EAN, an ISBN, or a UPC value, to identify a specific product variation in a multiple-variation listing. For a multiple-variation listing, the same GTIN type(s) must be used for all product variations within the same listing. For instance, if specify an ISBN value for one product variation within the listing, an ISBN value (and not an EAN or UPC value) must be specified for all product variations within the listing.
XML Source (w/o annotations (6); see within schema source)
<xs:sequence>
<xs:element minOccurs="0" name="ISBN" type="xs:string"/>
<xs:element minOccurs="0" name="UPC" type="xs:string"/>
<xs:element minOccurs="0" name="EAN" type="xs:string"/>
<xs:any maxOccurs="unbounded" minOccurs="0" processContents="lax"/>
</xs:sequence>
</xs:complexType>
|
Content Element Detail (all declarations defined in this component; 6/6)
ns:EAN
-
Type: |
xs:string, predefined, simple content
|
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.
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.
XML Representation Summary
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="EAN" type="xs:string"/>
|
ns:ISBN
-
Type: |
xs:string, predefined, simple content
|
This field is used if the seller wants to, or is required to identify each product variation within a multiplge-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.
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.
XML Representation Summary
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="ISBN" type="xs:string"/>
|
ns:NameValueList
-
This container is for future use. If it used, it will be ignored.
Component Diagram
XML Representation Summary
<ns:NameValueList> |
|
|
</ns:NameValueList> |
|
XML Source (w/o annotations (1); see within schema source)
ns:ProductReferenceID
-
Type: |
xs:string, predefined, simple content
|
Note: DO NOT USE.
Currently, sellers cannot associate an eBay catalog product with single variations within a multiple-variation listing for any eBay category. If the seller attempts to supply an eBay Product Identifier (ePID) at the variation level, a warning will get returned in the response stating that, 'Specifying a product identifier on a variant is not allowed in this category.'.
The ProductReferenceID field was originally added as part of the Product-Based Shopping Experience (PBSE) mandate, and eBay was going to allow and even require ePIDs to be specified for some leaf categories. However, with the rollback of the PBSE mandate, this field is not currently applicable or supported.
XML Representation Summary
<ns:ProductReferenceID> |
|
|
</ns:ProductReferenceID> |
|
XML Source (w/o annotations (1); see within schema source)
ns:UPC
-
Type: |
xs:string, predefined, simple content
|
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.
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.
XML Representation Summary
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="UPC" type="xs:string"/>
|
{any element from any namespace}
-
XML Source (see within schema source)
<xs:any maxOccurs="unbounded" minOccurs="0" processContents="lax"/>
|