In a CSV response file, a separate row is returned for each specified Channel ID/Category ID pair. In an XML request file, a separate <categoryMetadata>
container is returned for each specified Channel ID/Category ID pair.
Note: If no valid leaf category IDs are passed in through an XML input file, a CSV response file with the error message will be returned. If an XML input file has one or more valid leaf category IDs, but also one or more invalid leaf category IDs, Item Specifics will be returned for the valid categories, but not for the invalid categories. For invalid categories, a categoryMetadata
container will be returned but only with the categoryID
and channelID
fields.
Sample feed response files:
Note: The fields in the table below are ordered according to their order in the CSV file. The parent is provided for XML fields in order to make it easier to locate that field in the XML file.
Field name |
Description |
Notes |
---|---|---|
CSV: XML: |
The unique identifier of the eBay leaf category within the eBay marketplace. Occurrence: Always Returned |
If multiple Channel ID/Category ID pairs were submitted in the request feed file, these categories will be returned in the same order they were passed in through the request file. |
CSV: XML: |
The unique identifier of the eBay marketplace for which Item Specifics metadata will be retrieved. Values include Occurrence: Always Returned |
|
CSV: XML: |
The name of an attribute that is valid for the leaf category. An attribute is often referred to an Item Specific or a product aspect. Example values include Brand, Model, Type, Color, and Features. The number of defined attributes vary by category, and some categories have much more than others. The typical values for each attribute name are returned in the Attribute Value fields. Occurrence: Always Returned |
In XML responses, an attribute container is returned for every defined attribute for the category, and this container include the attribute name, type, usage, and corresponding values. Required attributes are returned first in the response, followed by preferred attributes, and then optional attributes |
CSV: XML: |
The type of attribute. Valid values are Occurrence: Always Returned |
|
CSV: XML: |
Indicates whether the aspect is It is always possible that Preferred Item Specifics will become required at some point, so the seller should also check the Expected Required By Date field to see if a specific Preferred Item Specific is expected to become required soon. Occurrence: Always Returned |
Required attributes are returned first in the response, followed by preferred attributes, and then optional attributes. |
CSV: XML: |
The expected date after which a Preferred Item Specific may become required. Occurrence: Conditionally Returned |
This field should generally only be returned for Preferred Item Specifics. As its name implies, any dates returned in this field should not be assumed to be 100 percent accurate. |
CSV: XML: |
A list of valid values for the corresponding Attribute Name. For example, if the Item Specific was Occurrence: Always Returned |
For CSV response files, all values are returned under one Attribute Values column, and each value is delimited with a pipe (|) symbol. For XML response files, a separate For both file types, values are generally returned in alphabetical order. |
CSV: XML: Not returned in XML response |
This field will indicate the type/category of error or warning if any are triggered when the response file is being generated. Occurrence: Conditionally Returned |
It is only returned in CSV files if an error or warning is triggered. Errors or warning informaton is not returned in XML response files. |
CSV: XML: Not returned in XML response |
The unique identifier of the error or warning. Occurrence: Conditionally Returned |
It is only returned in CSV files if an error or warning is triggered. Errors or warning informaton is not returned in XML response files. |
CSV: XML: Not returned in XML response |
The actual message type of the error or warning. This message should assist sellers in troubleshooting the issue. Occurrence: Conditionally Returned |
It is only returned in CSV files if an error or warning is triggered. Errors or warning informaton is not returned in XML response files. |