eBay Trading APIVersion 1039

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.

Note: Historically, the Best Offer feature has not been available for auction listings, but beginning with Version 1027, scheduled to roll out the first week in August 2017, sellers in the US, UK, and DE sites will be able to offer the Best Offer feature in auction listings. Once this new capability rolls out, the seller can offer Buy It Now or Best Offer in an auction listing, but not both.

Types that use 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 fixed-price or classified ad 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. 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.

For a ReviseItem or ReviseFixedPriceItem call, this boolean value can only be changed (enable or disable) in a fixed-price listing if the listing has not had any sales (Best Offer or standard purchase), the listing does not have any Best Offer or counter offers pending, and the listing is not scheduled to end within 12 hours. Some large merchant accounts are enabled to revise this field through a Revise call even within 12 hours of the listing's scheduled end time, but these sellers are still subject to the other two rules - no sales of any kind for the listing, and no Best Offers or counter offers pending.

Note: Historically, the Best Offer feature has not been available for auction listings, but beginning with Version 1027, sellers in the US, UK, and DE sites will be able to offer the Best Offer feature in auction listings. The seller can offer Buy It Now or Best Offer in an auction listing, but not both features.
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.