eBay Trading APIVersion 1349
 

BestOfferDetailsType

Type defining the BestOfferDetails container, which consists of Best Offer details associated with a listing. The BestOfferEnabled field in this container is used by Add/Revise/Relist calls to enable the Best Offer feature on a listing.

Type that uses BestOfferDetailsType:

Calls that use BestOfferDetailsType:

Fields



BestOffer ( AmountType (double) ) [0..1]
This is the amount of the buyer's current Best Offer. This field will not appear in the GetMyeBayBuying response if the buyer has not made a Best Offer. This field is also not applicable to the Add/Revise/Relist calls.
See the Field Index to learn which calls use BestOffer.

BestOfferCount ( int ) [0..1]
The number of Best Offers made for this item, if any. In other words, if there are no Best Offers made, this field will not appear in the response. This field is not applicable to the Add/Revise/Relist calls.
See the Field Index to learn which calls use BestOfferCount.

BestOfferEnabled ( boolean ) [0..1]
This field indicates whether or not the Best Offer feature is enabled for the listing. A seller can enable the Best Offer feature for a listing as long as the category supports the Best Offer feature. To see if an eBay category supports the Best Offer feature, run a GetCategoryFeatures call, including BestOfferEnabled as a FeatureID value in the call request payload.

A listing enabled with the Best Offer feature allows a buyer to bargain with the seller and make a lower-priced offer than the fixed price or the starting bid price for an auction listing. The seller can then decide whether to accept the buyer's Best Offer price or propose a counter offer higher than the Best Offer price, but lower than the fixed price or starting bid price.

Note: The Best Offer feature is now available for auction listings on the following sites: US, Canada, UK, Germany, Australia, France, Italy, and Spain. However, sellers must choose between offering Best Offer or Buy It Now on an auction listing, as both features cannot be enabled on the same auction listing. If an auction listing is enabled with Best Offer, this feature will no longer be applicable once the listing receives its first qualifying bid. Note: Best Offer is not available for multi-variation listings.
See the Field Index to learn which calls use BestOfferEnabled.

BestOfferStatus ( BestOfferStatusCodeType ) [0..1]
This enumeration value indicates the status of the latest Best Offer from the buyer. This field is only applicable to the GetMyeBayBuying call, and will not appear in the response if the buyer has not made a Best Offer.
See the Field Index to learn which calls use BestOfferStatus.

BestOfferType ( BestOfferTypeCodeType ) [0..1]
Not used by any call.

Note: this field is no longer used. The Best Offer type is only returned in the BestOfferCodeType field of the GetBestOffers call, and the applicable values for Best Offer type (BuyerBestOffer, BuyerCounterOffer, SellerCounterOffer, etc.) are defined in BestOfferTypeCodeType.
See the Field Index to learn which calls use BestOfferType.

NewBestOffer ( boolean ) [0..1]
Not used by any call.

This field is deprecated.
See the Field Index to learn which calls use NewBestOffer.