complexType "ns:ReviseItemResponseType"

Overview

Namespace

WSDL

Schema

Component

Index

PREV C-TYPE NEXT C-TYPE

FRAMES NO FRAMES NS-Bindings

SUMMARY: XML REP | DERIVED | USE

DETAIL: DESC | XML SRC | TYPE | ATTR | CHILD

eBay Trading API

complexType "ns:ReviseItemResponseType"

Namespace:	urn:ebay:apis:eBLBaseComponents
Content:	complex, 24 elements, elem. wildcard
Defined:	globally in Schema in ebaySvc.wsdl; see XML source
Includes:	definitions of 9 elements
Used:	at 1 location

Component Diagram

XML Representation Summary

<...>

Content:

</...>

All Direct / Indirect Based Elements (1):

ns:ReviseItemResponse

Known Usage Locations

As direct type of elements (1):

ns:ReviseItemResponse

Annotation

The base response type for the ReviseItem call. The response includes the Item ID for the revised item, the SKU value for the item (if any), listing recommendations (if applicable), the estimated fees for the revised item (except the Final Value Fee, which isn't calculated until the item has sold), the start and end times of the listing, and other details.

Type Definition Detail

Type Derivation Tree

ns:AbstractResponseType (extension)

ns:ReviseItemResponseType

XML Source (w/o annotations (10); see within schema source)

<xs:complexType name="ReviseItemResponseType">

<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 minOccurs="0" name="VerifyOnly" type="xs:boolean"/>

<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; 9/25)

ns:Category2ID

Type:

xs:string, predefined, simple content

Unique identifier of the secondary eBay category for the revised listing. This field is returned if the secondary category was changed with the revision, and the secondary category can only be changed if a fixed-price listing has no sales/auction listing has no bids, and the listing does not end within 12 hours.

This field can also be returned if the Item.CategoryMappingAllowed field was included and set to true in the request and the category ID passed in the Item.PrimaryCategory field was mapped to a new category ID by eBay. If the primary category has not changed or it has expired with no replacement, this field is not returned.

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

Unique identifier of the primary eBay category for the revised listing. This field is returned if the primary category was changed with the revision, and the primary category can only be changed if a fixed-price listing has no sales/auction listing has no bids, and the listing does not end within 12 hours.

This field can also be returned if the Item.CategoryMappingAllowed field was included and set to true in the request and the category ID passed in the Item.PrimaryCategory field was mapped to a new category ID by eBay. If the primary category has not changed or it has expired with no replacement, this field is not returned.

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:

ns:DiscountReasonCodeType, simple content

This field is returned if an eBay special offer or promotion is applicable to the listing.

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 revised listing is scheduled to end based on the listing's start time and the listing duration value that was set for the listing. If the listing duration is 'GTC' (Good 'Til Cancelled), this value will be updated to 30 days in the future if the listing is automatically renewed after 30 days. GTC listings are automatically renewed if quantity still exists for the item. Note that GTC is not applicable to auction listings.

Note: Starting July 1, 2019, the Good 'Til Cancelled renewal schedule will be 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 revised 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 revised 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 ReviseItem call to relist 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:Fee*

</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

The unique identifier for the revised listing. Note that the ItemID value does not change when a listing is revised, so this will be the same ItemID value that was passed in the call request.

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

Provides a list of products recommended by eBay which match the item information provided by the seller.

Component Diagram

XML Representation Summary

<ns:ProductSuggestions>

Content:

ns:ProductSuggestion*, {any}*

</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

This timestamp indicates the date and time when the listing was created on the eBay site. This value doesn't change when a listing is revised.

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"/>

ns:VerifyOnly

Type:

xs:boolean, predefined, simple content

This field is returned if the VerifyOnly field was included in the call request and set to true.

If the listing was revised in 'Verify Only' mode, the active listing is not actually revised, but the same response is returned and the seller gets to see the expected fees based on the changes made, and can also view any listing recommendations if the Item.IncludeRecommedations boolean input field was included and set to true.

XML Representation Summary

<ns:VerifyOnly>

Content:

{ xs:boolean }

</ns:VerifyOnly>

XML Source (w/o annotations (1); see within schema source)

<xs:element minOccurs="0" name="VerifyOnly" type="xs:boolean"/>

Overview

Namespace

WSDL

Schema

Component

Index

PREV C-TYPE NEXT C-TYPE

FRAMES NO FRAMES NS-Bindings

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.