eBay Trading API893

BestOfferType

Type defining the BestOffer container, which consists of information on one Best Offer or counter offer. This information includes the price of the offer, the expiration of the offer, and any messaging provided by the prospective buyer or seller.

Types that use BestOfferType:

Calls that use one or more fields of BestOfferType:

Fields



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

BestOfferID ( BestOfferIDType (string) ) [0..1]
Unique identifier for a Best Offer. This identifier is created once a prospective buyer makes a Best Offer on an item.
See the Field Index to learn which calls use BestOfferID.

Buyer ( UserType ) [0..1]
Container consisting of information about the prospective buyer who made the Best Offer.
See the Field Index to learn which calls use Buyer.

BuyerMessage ( string ) [0..1]
A prospective buyer has the option to include a comment when placing a Best Offer or making a counter offer to the seller's counter offer. This field will display that comment.
See the Field Index to learn which calls use BuyerMessage.

CallStatus ( string ) [0..1]
The value in this field ('Success' or 'Failure') will indicate whether or not the seller's attempt to accept, decline, or counter offer a Best Offer was successful. This field is only used by the RespondToBestOffer response.
See the Field Index to learn which calls use CallStatus.

ExpirationTime ( dateTime ) [0..1]
Timestamp indicating when a Best Offer will naturally expire (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) ) [0..1]
The amount of the Best Offer or counter offer.
See the Field Index to learn which calls use Price.

Quantity ( int ) [0..1]
The quantity of items for which the buyer is making a Best Offer.
See the Field Index to learn which calls use Quantity.

SellerMessage ( string ) [0..1]
A seller has the option to include a comment when making a counter offer to the prospective buyer's Best Offer. This field will display that comment.
See the Field Index to learn which calls use SellerMessage.

Status ( see BestOfferStatusCodeType for possible values ) [0..1]
The status of the Best Offer or counter offer. For PlaceOffer, the only applicable values are Accepted, AdminEnded, Declined, and Expired.
See the Field Index to learn which calls use Status.