Trading API865

BestOfferType

Details about a Best Offer.

Types that use BestOfferType:

Calls that use one or more fields of BestOfferType:

Fields


BestOfferCodeType ( see BestOfferTypeCodeType for possible values ) [1]
This value indicates whether the corresponding offer is an original Best Offer, or a counter offer to a Best Offer from the seller or buyer.
See the Field Index to learn which calls use BestOfferCodeType.

BestOfferID ( BestOfferIDType (string) ) [0..1]
An ID to distinguish this Best Offer from other Best Offers made on the item.
See the Field Index to learn which calls use BestOfferID.

Buyer ( UserType ) [1]
Information about the buyer who made the Best Offer.
See the Field Index to learn which calls use Buyer.

BuyerMessage ( string ) [0..1]
Text message that was provided by a buyer when placing a Best Offer.
See the Field Index to learn which calls use BuyerMessage.

CallStatus ( string ) [1]
The status of the call, either Success or Failure.
See the Field Index to learn which calls use CallStatus.

ExpirationTime ( dateTime ) [1]
Date and time (in GMT) the offer naturally expires (if the seller has not accepted or declined the offer).
See the Field Index to learn which calls use ExpirationTime.

ImmediatePayEligible ( boolean ) [0..1]
This flag indicates if the seller is able to require immediate payment from the buyer for a Best Offer. This flag will only be returned if the Best Offer is part of eBay's Best Offer Beta program (value of NewBestOffer is 'true').

If the Immediate Payment for Best Offers feature is enabled for a listing, and a buyer's Best Offer for the item is accepted by the seller, that buyer will be expected to pay immediately for the item, or that buyer will run the risk of losing the item to another buyer since that item will remain on sale until payment is made.

For more information about the Best Offer Beta feature, see the Best Offer Beta Help Page.
See the Field Index to learn which calls use ImmediatePayEligible.

NewBestOffer ( boolean ) [0..1]
The value of this boolean field will indicate whether or not the Best Offer is part of eBay's Best Offer Beta program, which allows sellers to require immediate payment from the buyer if both the seller and the buyer agree on a Best Offer. A 'true' value indicates that the Best Offer is part of the Best Offer Beta program, and a 'false' value indicates that the Best Offer is a standard Best Offer.

Currently, Immediate Payment for Best Offers will be supported by the Computers & Tablets, Jewelry & Watches, and Art categories, but this feature will get enabled in more categories going forward.

If the Immediate Payment for Best Offers feature is enabled for a listing, and a buyer's Best Offer for the item is accepted by the seller, that buyer will be expected to pay immediately for the item, or that buyer will run the risk of losing the item to another buyer since that item will remain on sale until payment is made.

For more information about the Best Offer Beta feature, see the Best Offer Beta Help Page.
See the Field Index to learn which calls use NewBestOffer.

Price ( AmountType (double) ) [1]
The amount of the Best Offer.
See the Field Index to learn which calls use Price.

Quantity ( int ) [1]
The number of items for which the buyer is making an offer.
See the Field Index to learn which calls use Quantity.

SellerMessage ( string ) [0..1]
Text response to buyer from seller.
See the Field Index to learn which calls use SellerMessage.

Status ( see BestOfferStatusCodeType for possible values ) [0..1]
The state of the offer. In the case of a PlaceOffer response that specified a Best Offer, Status may be "Accepted" if the Best Offer was at or above an auto-accept price.
See the Field Index to learn which calls use Status.

Copyright © 2005–2014 eBay, Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.