Component 
SUMMARY: XML REP | DERIVED | USE
DETAIL: DESC | XML SRC | TYPE | ATTR | CHILD
eBay Trading API

complexType "ns:AddItemResponseType"
Namespace:
Content:
complex, 23 elements, elem. wildcard
Defined:
globally in Schema in ebaySvc.wsdl; see XML source
Includes:
definitions of 8 elements
Used:
Component Diagram
XML Representation Summary
<...>
   
Content: 
</...>
All Direct / Indirect Based Elements (1):
Known Usage Locations
Annotation
If the new listing is created successfully, the AddItem response includes the unique identifier of the new listing (ItemID) and the estimated values of any fees (such as insertion fee and any other listing upgrade fees) generated as a result of the listing being created.

Other response fields include the the start and end times of the listing, and any other applicable fields such as the product SKU (if defined by seller), listing recommendations (if applicable), or other details.
Type Definition Detail
Type Derivation Tree
ns:AbstractResponseType (extension)
  ns:AddItemResponseType
XML Source (w/o annotations (9); see within schema source)
<xs:complexType name="AddItemResponseType">
<xs:complexContent>
<xs:extension base="ns:AbstractResponseType">
<xs:sequence>
<xs:element minOccurs="0" name="ItemID" type="ns:ItemIDType"/>
<xs:element minOccurs="0" name="StartTime" type="xs:dateTime"/>
<xs:element minOccurs="0" name="EndTime" type="xs:dateTime"/>
<xs:element minOccurs="0" name="Fees" type="ns:FeesType"/>
<xs:element minOccurs="0" name="CategoryID" type="xs:string"/>
<xs:element minOccurs="0" name="Category2ID" type="xs:string"/>
<xs:element maxOccurs="unbounded" minOccurs="0" name="DiscountReason" type="ns:DiscountReasonCodeType"/>
<xs:element minOccurs="0" name="ProductSuggestions" type="ns:ProductSuggestionsType"/>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
Content Element Detail (all declarations defined in this component; 8/24)
ns:Category2ID
Type:
xs:string, predefined, simple content
Unique identifier of the secondary category in which the item was listed. This field is only returned if the Item.CategoryMappingAllowed boolean field is set to true in the request (or omitted) and the Category ID passed in as the secondary listing category was automatically mapped to a new Category ID by eBay. If the secondary category ID passed in the request is still active/valid, this field is not returned.

Note: The Item.CategoryMappingAllowed field value in the request now defaults to true if omitted. Previously, the default value was false, so a user had to include this field and set it to true in order for eBay to map an outdated Primary or Secondary Category ID to the updated Category ID.
XML Representation Summary
<ns:Category2ID>
   
Content: 
{ xs:string }
</ns:Category2ID>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="Category2ID" type="xs:string"/>

ns:CategoryID
Type:
xs:string, predefined, simple content
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 set to true in the request (or omitted) and the Category ID passed in as the primary listing category was automatically mapped to a new Category ID by eBay. If the primary category ID passed in the request is still active/valid, this field is not returned.

Note: The Item.CategoryMappingAllowed field value in the request now defaults to true if omitted. Previously, the default value was false, so a user had to include this field and set it to true in order for eBay to map an outdated Primary or Secondary Category ID to the updated Category ID.
XML Representation Summary
<ns:CategoryID>
   
Content: 
{ xs:string }
</ns:CategoryID>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="CategoryID" type="xs:string"/>

ns:DiscountReason
Type:
This container is an array of one or more listing fee/upgrade discount types being offered by eBay to the seller.
XML Representation Summary
<ns:DiscountReason>
   
Content: 
{ enumeration of xs:token }
</ns:DiscountReason>
Simple Content
Enumeration:
"SpecialOffer"
 - 
An offer that applies to a limited number of listings during the offering period. Example: "There is no insertion fee for up to 5 auctions when listing between 12/1 and 12/10."
"Promotion"
 - 
An offer that applies to an unlimited number of listings during the offering period. Example: "Get subtitle for $0.10 in Tech category when listing between 12/25 and 12/28. No limit to the number of items listed during this period."
"CustomCode"
 - 
Reserved for future use
XML Source (w/o annotations (1); see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" name="DiscountReason" type="ns:DiscountReasonCodeType"/>

ns:EndTime
Type:
xs:dateTime, predefined, simple content
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 one month ahead of the start time, and this value will continue to be updated one month ahead each time the GTC listing needs to be renewed. Fixed-price listings get renewed automatically as long as there is still a quantity of 1 or above, or even if the quantity is 0, but the 'out-of-stock control' feature is enabled.

Note that GTC is not a supported listing duration for auction listings, but is the only supported listing duration for fixed-price listings except for a few motor vehicle categories on eBay Motors US, eBay UK, and eBay Italy.

Note: As of July 1, 2019, the Good 'Til Cancelled renewal schedule has been modified from every 30 days to once per calendar month. For example, if a GTC listing is created July 5, the next monthly renewal date will be August 5. If a GTC listing is created on the 31st of the month, but the following month only has 30 days, the renewal will happen on the 30th in the following month. Finally, if a GTC listing is created on January 29-31, the renewal will happen on February 28th (or 29th during a 'Leap Year'). See the Good 'Til Cancelled listings update in the Spring 2019 Seller Updates for more information about this change.
XML Representation Summary
<ns:EndTime>
   
Content: 
{ xs:dateTime }
</ns:EndTime>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="EndTime" type="xs:dateTime"/>

ns:Fees
Type:
ns:FeesType, complex content
This container is an array of fees associated with the creation of the listing. The fees in this container will not include any fees that are based on the purchase price (such as Final Value Fee) and only come into play when the listing has a sale.

All listing fee types are returned, even if those fees are not applicable for the new listing and are '0.0'.

Note: The currency used for all fees returned under the Fees container reflects the currency used for the listing site, and not necessarily in the seller's default/home currency. For example, if a Canadian seller is using the AddItem call to list an item on the eBay US site, the currency type shown for each fee will be USD and not CAD.
Component Diagram
XML Representation Summary
<ns:Fees>
   
Content: 
</ns:Fees>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="Fees" type="ns:FeesType"/>

ns:ItemID
Type:
ns:ItemIDType, simple content
Unique identifier for the new listing. This field is returned as long as the listing was successfully created.
XML Representation Summary
<ns:ItemID>
   
Content: 
{ xs:string }
</ns:ItemID>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="ItemID" type="ns:ItemIDType"/>

ns:ProductSuggestions
Type:
ns:ProductSuggestionsType, complex content
This container holds an array of one or more products in the eBay product catalog that appear to match the product being listed, just based on the information in the listing. This container will not be returned if no similar products were found in the eBay product catalog.
Component Diagram
XML Representation Summary
<ns:ProductSuggestions>
   
Content: 
</ns:ProductSuggestions>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="ProductSuggestions" type="ns:ProductSuggestionsType"/>

ns:StartTime
Type:
xs:dateTime, predefined, simple content
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).
XML Representation Summary
<ns:StartTime>
   
Content: 
{ xs:dateTime }
</ns:StartTime>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="StartTime" type="xs:dateTime"/>

 Component 
SUMMARY: XML REP | DERIVED | USE
DETAIL: DESC | XML SRC | TYPE | ATTR | CHILD
eBay Trading API

WSDL documentation generated with FlexDoc/XML 1.13 using FlexDoc/XML WSDLDoc 1.2.5 template set. All XSD diagrams generated by FlexDoc/XML DiagramKit.