NAME
eBay::API::XML::DataType::ListingDetailsType
DESCRIPTION
Various details about a listing. Some of the details are calculated or derived after an item is listed. The details in this type include the start and end time and the converted (localized) prices. The details in this type also include input values applicable to the Best Offer feature. Additional details in this type include flags indicating if a seller specified fields whose values are not visible to the requesting user.
SYNOPSIS
INHERITANCE
eBay::API::XML::DataType::ListingDetailsType inherits from the eBay::API::XML::BaseDataType class
Subroutines:
setAdult()
If true, the item is listed in a Mature category. Users must accept the Mature Category agreement on the eBay site to retrieve items listed in Mature categories. (Users do not need to sign this agreement to be able to list items in Mature Categories.)
# Argument: 'xs:boolean'
isAdult()
Calls: GetBidderList
Returned: Always
Calls: GetItem
Returned: Always
Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll
Calls: GetItemTransactions
GetSellerTransactions
Returned: Conditionally
Details: DetailLevel: ReturnAll
Calls: GetSellerList
Returned: Conditionally
Details: DetailLevel: ItemReturnDescription, ReturnAll
GranularityLevel: Medium, Fine# Returns: 'xs:boolean'
setBestOfferAutoAcceptPrice()
The price at which best offers are automatically accepted. Similar in use to MinimumBestOfferPrice. If a buyer submits a best offer that is above this value, the offer is automatically accepted by the seller. Applies only to items listed in categories that support the BestOfferAutoAcceptPrice feature. Best Offer must be enabled for the item, and only the seller who listed the item will see BestOfferAutoAcceptPrice in a call response. On the US eBay Motors site (site ID 100), you cannot use the API to add a minimum best offer price. For a ReviseItem call with site ID 100, prior use of a minimum best offer price on eBay.com is ignored.
Calls: AddItem
ReviseItem
RelistItem
VerifyAddItem
RequiredInput: No# Argument: 'ns:AmountType'
getBestOfferAutoAcceptPrice()
Calls: GetItem
Returned: Conditionally
Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll
Calls: GetSellerList
Returned: Conditionally
Details: DetailLevel: ItemReturnDescription, ReturnAll# Returns: 'ns:AmountType'
setBindingAuction()
Applicable for Real Estate auctions only. If true, buyers and sellers are expected to follow through on the sale. If false, bids for the Real Estate auction are only expressions of interest.
# Argument: 'xs:boolean'
isBindingAuction()
Calls: GetBidderList
Returned: Always
Calls: GetItem
Returned: Always
Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll
Calls: GetItemTransactions
GetSellerTransactions
Returned: Conditionally
Details: DetailLevel: ReturnAll
Calls: GetSellerList
Returned: Conditionally
Details: DetailLevel: ItemReturnDescription, ReturnAll
GranularityLevel: Medium, Fine# Returns: 'xs:boolean'
setBuyItNowAvailable()
Indicates whether Buy It Now is available for the listing (for Chinese and Dutch auctions). As a general rule, once a Chinese auction has bids (and the high bid exceeds the reserve price, if any), the listing is no longer eligible for Buy It Now. <br><br> On some sites, the Buy It Now price for a Chinese auction may remain available for certain categories even after a bid is placed. See the "Longer Lasting Buy It Now" link below for more details and the latest list of eBay US categories that support this behavior. The eBay Spain site supports this behavior for all categories.
SeeLink: URL: http://forums.ebay.com/db1/thread.jspa?threadID=2000449591&anticache=1207252776668 Title: Longer Lasting Buy It Now
# Argument: 'xs:boolean'
isBuyItNowAvailable()
Calls: GetBidderList
Returned: Conditionally
Calls: GetItem
Returned: Conditionally
Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll# Returns: 'xs:boolean'
setCheckoutEnabled()
Indicates whether checkout is enabled for this item. If true, indicates that the seller elects to allow the item purchase to go through the checkout process, if the buyer chooses to do so.
SeeLink: URL: http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=Checkout Title: Checkout
# Argument: 'xs:boolean'
isCheckoutEnabled()
Calls: GetBidderList
Returned: Always
Calls: GetItem
Returned: Always
Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll
Calls: GetItemTransactions
GetSellerTransactions
Returned: Conditionally
Details: DetailLevel: ReturnAll
Calls: GetSellerList
Returned: Conditionally
Details: DetailLevel: ItemReturnDescription, ReturnAll
GranularityLevel: Medium, Fine# Returns: 'xs:boolean'
setConvertedBuyItNowPrice()
Converted value of the BuyItNowPrice in the currency of the site that returned this response. For active items, refresh this value every 24 hours to pick up the current conversion rates.
# Argument: 'ns:AmountType'
getConvertedBuyItNowPrice()
Calls: GetCategoryListings
Returned: Conditionally
Calls: GetItemTransactions
GetSellerTransactions
Returned: Conditionally
Details: DetailLevel: ReturnAll
Calls: GetSellerList
Returned: Conditionally
Details: DetailLevel: ItemReturnDescription, ReturnAll
GranularityLevel: Medium, Fine
Calls: GetMyeBayBuying
Returned: Conditionally
Details: DetailLevel: none, ReturnSummary, ReturnAll
Context: SecondChanceOffer
Calls: GetMyeBaySelling
Returned: Conditionally
Details: DetailLevel: none, ReturnSummary, ReturnAll
Context: ScheduledList
SoldList
UnsoldList
DeletedFromSoldList
DeletedFromUnsoldList
Calls: GetBidderList
Returned: Always
Calls: GetItem
Returned: Always
Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll
Calls: GetSearchResults
Returned: Conditionally
Details: DetailLevel: ItemReturnAttributes, ItemReturnCategories, none, ReturnAll
GranularityLevel: Coarse# Returns: 'ns:AmountType'
setConvertedReservePrice()
Converted value of the ReservePrice in the currency of the site that returned this response. Only returned for listings with a reserve price when the requesting user is the listing's seller. For active items, refresh this value every 24 hours to pick up the current conversion rates. Not applicable to Fixed Price and Store Inventory listings.
# Argument: 'ns:AmountType'
getConvertedReservePrice()
Calls: GetBidderList
Returned: Conditionally
Calls: GetMyeBaySelling
Returned: Conditionally
Details: DetailLevel: none, ReturnSummary, ReturnAll
Context: ScheduledList
SoldList
UnsoldList
DeletedFromSoldList
DeletedFromUnsoldList
Calls: GetItemTransactions
GetSellerTransactions
Returned: Conditionally
Details: DetailLevel: ReturnAll
Calls: GetSellerList
Returned: Conditionally
Details: DetailLevel: ItemReturnDescription, ReturnAll
GranularityLevel: Fine
Calls: GetItem
Returned: Conditionally
Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll# Returns: 'ns:AmountType'
setConvertedStartPrice()
Converted value of the StartPrice in the currency of the site that returned this response. For active items, refresh this value every 24 hours to pick up the current conversion rates.
# Argument: 'ns:AmountType'
getConvertedStartPrice()
Calls: GetSearchResults
Returned: Conditionally
Details: DetailLevel: ItemReturnAttributes, ItemReturnCategories, none, ReturnAll
Calls: GetItemTransactions
GetSellerTransactions
Returned: Conditionally
Details: DetailLevel: ReturnAll
Calls: GetSellerList
Returned: Conditionally
Details: DetailLevel: ItemReturnDescription, ReturnAll
GranularityLevel: Fine
Calls: GetMyeBayBuying
Returned: Conditionally
Details: DetailLevel: none, ReturnSummary, ReturnAll
Context: BidList
LostList
WonList
DeletedFromWonList
DeletedFromLostList
Calls: GetMyeBaySelling
Returned: Conditionally
Details: DetailLevel: none, ReturnSummary, ReturnAll
Context: ScheduledList
SoldList
UnsoldList
DeletedFromSoldList
DeletedFromUnsoldList
BidList
Calls: GetBidderList
Returned: Always
Calls: GetItem
Returned: Always
Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll# Returns: 'ns:AmountType'
setEndTime()
Time stamp (in GMT) when the listing is scheduled to end (calculated based on the values of StartTime and ListingDuration) or the actual end time if the item has ended. In GetSearchResults, for StoresFixedPrice items which are "Good Till Canceled," this value is 5 minutes later than the actual end time of the item. The discrepancy is intended to facilitate renewal every 30 days of such items' end times.
# Argument: 'xs:dateTime'
getEndTime()
Calls: GetBidderList
GetDispute
Returned: Always
Calls: GetItem
Returned: Always
Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll
Calls: GetItemTransactions
GetSellerTransactions
Returned: Conditionally
Details: DetailLevel: ReturnAll
Calls: GetSellerList
Returned: Conditionally
Details: DetailLevel: none, ItemReturnDescription, ReturnAll
Calls: GetBestOffers
Returned: Conditionally
Details: DetailLevel: none, ReturnAll
Calls: GetCategoryListings
GetItemsAwaitingFeedback
GetMemberMessages
Returned: Conditionally
Calls: GetSearchResults
Returned: Conditionally
Details: DetailLevel: ItemReturnAttributes, ItemReturnCategories, none, ReturnAll
GranularityLevel: Coarse
Calls: GetMyeBayBuying
Returned: Conditionally
Details: DetailLevel: none, ReturnSummary, ReturnAll
Context: BidList
LostList
SecondChanceOffer
WatchList
WonList
DeletedFromWonList
DeletedFromLostList
Calls: GetMyeBaySelling
Returned: Conditionally
Details: DetailLevel: none, ReturnSummary, ReturnAll
Context: SoldList
UnsoldList
DeletedFromSoldList
DeletedFromUnsoldList
BidList
Calls: GetSellerEvents
Returned: Conditionally
Details: DetailLevel: none, ReturnAll
Calls: GetProducts
Returned: Conditionally# Returns: 'xs:dateTime'
setHasPublicMessages()
Indicates whether the item has any publicly displayed messages. Use GetMemberMessages to retrieve public messages for the item if this flag indicates that there are any.
# Argument: 'xs:boolean'
isHasPublicMessages()
Calls: GetBidderList
Returned: Always
Calls: GetItem
Returned: Always
Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll
Calls: GetItemTransactions
GetSellerTransactions
Returned: Conditionally
Details: DetailLevel: ReturnAll
Calls: GetSellerList
Returned: Conditionally
Details: DetailLevel: ItemReturnDescription, ReturnAll# Returns: 'xs:boolean'
setHasReservePrice()
If true, the seller specified a value in ReservePrice.
# Argument: 'xs:boolean'
isHasReservePrice()
Calls: GetBidderList
Returned: Always
Calls: GetItem
Returned: Always
Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll
Calls: GetItemTransactions
GetSellerTransactions
Returned: Conditionally
Details: DetailLevel: ReturnAll
Calls: GetSellerList
Returned: Conditionally
Details: DetailLevel: ItemReturnDescription, ReturnAll
GranularityLevel: Medium, Fine
Calls: GetMyeBayBuying
Returned: Conditionally
Details: DetailLevel: none, ReturnSummary, ReturnAll
Context: WonList
DeletedFromWonList# Returns: 'xs:boolean'
setHasUnansweredQuestions()
Indicates whether the item has any unanswered questions. Use GetMemberMessages to retrieve unanswered questions for the item if this flag indicates that there are any.
# Argument: 'xs:boolean'
isHasUnansweredQuestions()
Calls: GetBidderList
Returned: Always
Calls: GetItem
Returned: Always
Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll
Calls: GetItemTransactions
GetSellerTransactions
Returned: Conditionally
Details: DetailLevel: ReturnAll
Calls: GetSellerList
Returned: Conditionally
Details: DetailLevel: ItemReturnDescription, ReturnAll# Returns: 'xs:boolean'
setLocalListingDistance()
Specifies a distance (in miles) used as the radius of the area about the supplied postal code that constitutes the local market. Use GetCategoryFeatures to determine the local listing distances supported by a given site, category, and Local Market subscription level.
Calls: AddItem
GetItemRecommendations
RequiredInput: Conditionally# Argument: 'xs:string'
getLocalListingDistance()
# Returns: 'xs:string'
setMinimumBestOfferMessage()
Specifies the message sent from the seller to the buyer when a submitted best offer is automatically declined by the seller. A best offer is automatically declined if it does not meet the minimum acceptable best offer price specified by the seller with MinimumBestOfferPrice. Applies only to items listed in categories that support the Best Offer Auto-Decline feature. Best Offer must be enabled for the item. To remove this value when revising or relisting an item, use DeletedField.
DeprecationDetails: NoOp DeprecationVersion: 547 UseInstead: Calls: AddItem GetItemRecommendations ReviseItem RelistItem VerifyAddItem RequiredInput: No
# Argument: 'xs:string'
getMinimumBestOfferMessage()
Calls: GetItem
Returned: Conditionally
Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll
Calls: GetItemTransactions
GetSellerTransactions
Returned: Conditionally
Details: DetailLevel: ReturnAll
Calls: GetSellerList
Returned: Conditionally
Details: DetailLevel: ItemReturnDescription, ReturnAll# Returns: 'xs:string'
setMinimumBestOfferPrice()
Specifies the minimum acceptable best offer price. If a buyer submits a best offer that is below this value, the offer is automatically declined by the seller. Applies only to items listed in categories that support the Best Offer Auto-Decline feature. Best Offer must be enabled for the item, and only the seller who listed the item can see this value. To remove this value when revising or relisting an item, use DeletedField.
Calls: AddItem
GetItemRecommendations
ReviseItem
RelistItem
VerifyAddItem
RequiredInput: No# Argument: 'ns:AmountType'
getMinimumBestOfferPrice()
Calls: GetItem
Returned: Conditionally
Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll
Calls: GetItemTransactions
GetSellerTransactions
Returned: Conditionally
Details: DetailLevel: ReturnAll
Calls: GetSellerList
Returned: Conditionally
Details: DetailLevel: ItemReturnDescription, ReturnAll# Returns: 'ns:AmountType'
setPayPerLeadEnabled()
If true as an input or output field, the item is pay-per-lead-enabled. This field applies to the pay-per-lead feature, which is planned for availability on the US site in upcoming months.
Default: false
Calls: AddItem
ReviseItem
RelistItem
VerifyAddItem
RequiredInput: No# Argument: 'xs:boolean'
isPayPerLeadEnabled()
Calls: GetItem
Returned: Conditionally
Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll
Calls: GetSellerList
Returned: Conditionally
Details: DetailLevel: ItemReturnDescription, ReturnAll# Returns: 'xs:boolean'
setRelistedItemID()
Indicates the new item ID for a re-listed item. When an item is re-listed, the item ID for the new (re-list) item is added to the old (expired) listing to provide buyers a means to navigate to the new listing. This value only appears when the old listing is retrieved. Output only.
# Argument: 'ns:ItemIDType'
getRelistedItemID()
Calls: GetBidderList
Returned: Conditionally
Calls: GetItem
Returned: Conditionally
Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll
Calls: GetItemTransactions
GetSellerTransactions
Returned: Conditionally
Details: DetailLevel: ReturnAll
Calls: GetSellerList
Returned: Conditionally
Details: DetailLevel: ItemReturnDescription, ReturnAll# Returns: 'ns:ItemIDType'
setSecondChanceOriginalItemID()
The item ID for the original listing from which a second chance offer is made. This value is only returned when the data for the second chance offer listing is retrieved. Output only.
# Argument: 'ns:ItemIDType'
getSecondChanceOriginalItemID()
Calls: GetBidderList
Returned: Conditionally
Calls: GetItem
Returned: Conditionally
Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll# Returns: 'ns:ItemIDType'
setSellerBusinessType()
Type of seller account. This value is not returned for most sites. This value is not returned for the German site (site ID 77) or eBay Motors site (site ID 100).
# Argument: 'ns:SellerBusinessCodeType'
getSellerBusinessType()
Calls: GetSearchResults
Returned: Conditionally
Details: DetailLevel: ItemReturnAttributes, ItemReturnCategories, none, ReturnAll# Returns: 'ns:SellerBusinessCodeType'
setStartTime()
The StartTime value returned by non-search calls such as GetItem is the time stamp (in GMT) for when the item was listed. The StartTime value returned by search calls such as GetSearchResults and GetCategoryListings may vary from the value returned by GetItem. The time value is the same value in the following: The StartTime value returned by GetSearchResults, the StartTime value returned by GetCategoryListings, and the time the item became available for search on the eBay site.
# Argument: 'xs:dateTime'
getStartTime()
Calls: GetBidderList
GetDispute
Returned: Always
Calls: GetItem
Returned: Always
Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll
Calls: GetCategoryListings
GetMemberMessages
GetProducts
Returned: Conditionally
Calls: GetSearchResults
Returned: Conditionally
Details: DetailLevel: ItemReturnAttributes, ItemReturnCategories, none, ReturnAll
GranularityLevel: Coarse
Calls: GetItemTransactions
GetSellerTransactions
Returned: Conditionally
Details: DetailLevel: ReturnAll
Calls: GetSellerList
Returned: Conditionally
Details: DetailLevel: none, ItemReturnDescription, ReturnAll
Calls: GetMyeBayBuying
Returned: Conditionally
Details: DetailLevel: none, ReturnSummary, ReturnAll
Context: BestOfferList
BidList
LostList
WatchList
WonList
DeletedFromWonList
DeletedFromLostList
Calls: GetMyeBaySelling
Returned: Conditionally
Details: DetailLevel: none, ReturnSummary, ReturnAll
Context: ActiveList
ScheduledList
SoldList
UnsoldList
DeletedFromSoldList
DeletedFromUnsoldList
BidList
Calls: GetSellerEvents
Returned: Conditionally
Details: DetailLevel: none, ReturnAll# Returns: 'xs:dateTime'
setTCROriginalItemID()
Indicates the item ID of the original item listing from which a Transaction Confirmation Request (TCR) was created. This value is only returned when the data for a TCR is retrieved.
# Argument: 'ns:ItemIDType'
getTCROriginalItemID()
Calls: GetItem
Returned: Conditionally
Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll
Calls: GetItemTransactions
GetSellerTransactions
Returned: Conditionally
Details: DetailLevel: ReturnAll
Calls: GetSellerList
Returned: Conditionally
Details: DetailLevel: none, ItemReturnDescription, ReturnAll
Calls: GetBidderList
Returned: Conditionally# Returns: 'ns:ItemIDType'
setViewItemURL()
The URL of the Web page where a user can view the listing. On the US site, this is called the "View Item" page. If you enabled affiliate tracking in a search-related call (for example, if you used the AffiliateTrackingDetails container in an applicable call), ViewItemURL contains a string that includes affiliate tracking information (see the <a href="https://www.ebaypartnernetwork.com" target="_blank">eBay Partner Network</a>). For GetSearchResultsExpress, the ViewItemURL field is returned only if you specified AffiliateTrackingDetails in the request.
# Argument: 'xs:anyURI'
getViewItemURL()
Calls: GetBidderList
Returned: Always
Calls: GetItem
Returned: Always
Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll
Calls: GetCategoryListings
GetProducts
Returned: Conditionally
Calls: GetMyeBayBuying
Returned: Conditionally
Details: DetailLevel: none, ReturnSummary, ReturnAll
Context: WatchList
Calls: GetSearchResults
Returned: Conditionally
Details: DetailLevel: ItemReturnAttributes, ItemReturnCategories, none, ReturnAll
GranularityLevel: Coarse
Calls: GetItemTransactions
GetSellerTransactions
Returned: Conditionally
Details: DetailLevel: ReturnAll
Calls: GetSellerList
Returned: Conditionally
Details: DetailLevel: ItemReturnDescription, ReturnAll# Returns: 'xs:anyURI'
setViewItemURLForNaturalSearch()
This URL takes you to the same View Item page as ViewItemURL, but this URL is optimized to support natural search. That is, this URL is designed to make items on eBay easier to find via popular Internet search engines. For example, this URL specifies the item title, and it is optimized for natural search: "_W0QQ" is like "?" (question mark), "QQ" is like "&" (ampersand), and "Z" is like "=" (equals sign). <br> <br> <span class="tablenote"><b>Note</b>: This URL may include additional query parameters that don't appear in ViewItemURL and vice versa. You should not modify the query syntax. For example, eBay won't recognize the URL if you change QQ to ?.</span>
# Argument: 'xs:anyURI'
getViewItemURLForNaturalSearch()
Calls: GetSearchResults
Returned: Conditionally
Details: DetailLevel: ItemReturnAttributes, ItemReturnCategories, none, ReturnAll
GranularityLevel: Coarse
Calls: GetCategoryListings
Returned: Conditionally
Calls: GetBidderList
Returned: Conditionally
Calls: GetItem
Returned: Conditionally
Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll
Calls: GetItemTransactions
GetSellerTransactions
Returned: Conditionally
Details: DetailLevel: ReturnAll
Calls: GetSellerList
Returned: Conditionally
Details: DetailLevel: ItemReturnDescription, ReturnAll
Calls: GetProducts
Returned: Conditionally# Returns: 'xs:anyURI'