eBay Trading APIVersion 1085

AddItemResponseContainerType

Type defining the AddItemResponseContainer containers that are returned in an AddItems call. An AddItemResponseContainer container is returned for each item created through an AddItems call. Each item being created through an AddItems call is identified through a unique AddItemRequestContainer.MessageID value that is defined by the seller. To match up the AddItemResponseContainer to the AddItemRequestContainer, look for a AddItemResponseContainer.CorrelationID value that matches the AddItemRequestContainer.MessageID value in the request.

Type that uses AddItemResponseContainerType:

Call that uses AddItemResponseContainerType:

Fields



Category2ID ( string ) [0..1]
Unique identifier of the secondary category in which the item was listed. This field is only returned if a secondary category was used, the Item.CategoryMappingAllowed boolean field is included and set to true in the request, and the Category ID passed in as the secondary listing category was mapped to a new Category ID by eBay. If the secondary category has not changed or it has expired with no replacement, this field is not returned.
See the Field Index to learn which calls use Category2ID.

CategoryID ( string ) [0..1]
The unique identifier of the primary category in which the item was listed. This field is only returned if the Item.CategoryMappingAllowed boolean field is included and set to true in the request and the Category ID passed in as the primary listing category was mapped to a new Category ID by eBay. If the primary category has not changed, or if it has expired with no replacement, this field is not returned.
See the Field Index to learn which calls use CategoryID.

CorrelationID ( string ) [0..1]
Most Trading API calls support a MessageID element in the request and a CorrelationID element in the response. With AddItems, a unique MessageID value is required for each AddItemRequestContainer container that is used in the request. The CorrelationID value returned under each AddItemResponseContainer container is used to correlate each item request container with its corresponding response container. The same MessageID value that you pass into a request will be returned in the CorrelationID field in the response.
See the Field Index to learn which calls use CorrelationID.

DiscountReason ( DiscountReasonCodeType ) [0..*]
This container is an array of one or more listing fee/upgrade discount types being offered by eBay to the seller.
See the Field Index to learn which calls use DiscountReason.

EndTime ( dateTime ) [0..1]
Date and time when the new listing is scheduled to end based on the start time and the listing duration value that was set in the ListingDuration field at listing time. If the value of ListingDuration was set to GTC (Good 'Til Cancelled) this value will be set 30 days ahead of the start time, although this value will be updated if the GTC listing is still alive and automatically renewed 30 days after start time.
See the Field Index to learn which calls use EndTime.

Errors ( ErrorType ) [0..*]
This container is an array of one or more errors and/or warnings (if any) that occurred when eBay processed the request.

Errors may occur due to problems with business-level data on the client side or on the eBay server side. For example, an error would occur if the request contains an invalid combination of fields, or it is missing a required field, or the value of the field is not recognized. An error could also occur if eBay encountered a problem in our internal business logic while processing the request.

This container is only returned if there were one or more warnings or errors.
See the Field Index to learn which calls use Errors.

Fees ( FeesType ) [0..1]
This container is an array of one or more fees associated with the creation of the listing. The fees do not include the Final Value Fee (FVF), which cannot be determined until an item is sold.
See the Field Index to learn which calls use Fees.

ItemID ( ItemIDType (string) ) [0..1]
Unique identifier for the new listing. This field is returned as long as the listing was successfully created.
See the Field Index to learn which calls use ItemID.

ListingRecommendations ( ListingRecommendationsType ) [0..1]
Container consisting of one or more Recommendation containers. Each Recommendation container provides a message to the seller on how a listing can be improved or brought up to standard in regards to top-rated seller/listing requirements, mandated or recommended Item Specifics, picture quality requirements, pricing and/or listing format recommendations, recommended keywords and/or Item Specifics in a Title, and/or a recommendation to offer fast handling (same-day handling or handling time of 1 day) and/or a free shipping option in order to qualify the listing for a Fast 'N Free badge.

This container is only returned if the IncludeRecommendations flag was included and set to 'true' in the AddItems request, and if at least one listing recommendation exists for the newly created listing. If one or more listing recommendations are returned for one or more of the newly created listings, it will be at the seller's discretion about whether to revise the item(s) based on eBay's listing recommendation(s).
See the Field Index to learn which calls use ListingRecommendations.

Message ( string ) [0..1]
Supplemental information from eBay, if applicable. May elaborate on errors or provide useful hints for the seller. This data can accompany the call's normal data result set or a result set that contains only errors. The string can return HTML, including TABLE, IMG, and HREF elements. In this case, an HTML- based application should be able to include the HTML as-is in the HTML page that displays the results. A non-HTML application would need to parse the HTML and convert the table elements and image references into UI elements particular to the programming language used. Because this data is returned as a string, the HTML markup elements are escaped with character entity references (e.g.,<table><tr>...).
See the Field Index to learn which calls use Message.

StartTime ( dateTime ) [0..1]
Starting date and time for the new listing. This value is based on the time the listing was received and processed, or the time the item will be listed if the seller included the Item.ScheduleTime field in the request and set a custom start time of the listing (in the future).
See the Field Index to learn which calls use StartTime.