OfferType

Contains information pertaining to an offer made on an item listing and the current bidding or purchase state of the listing.

Types that use OfferType:

Calls that use one or more fields of OfferType:

Fields

Action ( BidActionCodeType )
BestOfferID ( BestOfferIDType (string) )
BidCount
ConvertedPrice ( AmountType (double) )
Currency ( CurrencyCodeType )
HighestBid ( AmountType (double) )
ItemID
MaxBid ( AmountType (double) )
Message ( string )
MyMaxBid ( AmountType (double) )
Quantity ( int )
SecondChanceEnabled ( boolean )
SiteCurrency ( CurrencyCodeType )
TimeBid ( dateTime )
TransactionID
User ( UserType )
UserConsent ( boolean )

Action ( see BidActionCodeType for possible values ) [1]
Indicates the type of offer being made on the specified listing. If the item is Best Offer enabled and the buyer makes a Best Offer (or a counter offer), then after the PlaceOffer call, the buyer can get the status of the Best Offer (and of a possible seller-counter-offer, etc.) using the GetBestOffers call. See the Trading Web Services Guide for information about best-offer enabled items and about GetBestOffers.
See the Field Index to learn which calls use Action.

BestOfferID ( BestOfferIDType (string) ) [0..1]
The ID of a Best Offer on an item. Must be specified as input to PlaceOffer only if a buyer is accepting or declining a seller's counter offer (and is not required for a buyer's offer or counter offer).
See the Field Index to learn which calls use BestOfferID.

BidCount
Not used by any call.

ConvertedPrice ( AmountType (double) ) [0..1]
Localized amount for the item's current price.
See the Field Index to learn which calls use ConvertedPrice.

Currency ( see CurrencyCodeType for possible values ) [1]
Three-digit currency code for the currency used for the auction. Valid values can be viewed in the CurrencyCodeType code list.
See the Field Index to learn which calls use Currency.

HighestBid ( AmountType (double) ) [1]
Amount the highest bidder has bid on the item. Applicable to only auction listings where there is progressive bidding and winning bidders are determined based on the highest bid.
See the Field Index to learn which calls use HighestBid.

ItemID
Not used by any call.

MaxBid ( AmountType (double) ) [1]
Amount of the offer placed. For auction listings, the amount bid on the item (subject to outbid by other buyers). For fixed-price listings, the fixed sale price at which the item is purchased. For auction listings with an active Buy It Now option, this amount will be either the Buy It Now price for purchase or the amount of a bid, depending on the offer type (as specified in Action). For PlaceOffer, the CurrencyID attribute is ignored if provided. Regarding Value-Added Tax (VAT): Even if VAT applies, you do not need to add VAT to the MaxBid value. If VAT applies to the listing, the seller can specify a VAT percent value when they list the item.
See the Field Index to learn which calls use MaxBid.

Message ( string ) [0..1]
A message from the buyer to the seller. Applies if the buyer is using PlaceOffer to perform a best-offer-related action (Best Offer, counter offer, etc.).
See the Field Index to learn which calls use Message.

MyMaxBid ( AmountType (double) ) [0..1]
Maximum bid placed by the user making the call.
See the Field Index to learn which calls use MyMaxBid.

Quantity ( int ) [1]
Specifies the number of items from the specified listing the user tendering the offer intends to purchase, bid on, or make a Best Offer on. For auctions, the value may not exceed one. For multi-item listings, must be greater than zero and not exceeding the number of items offered for sale in the listing.
See the Field Index to learn which calls use Quantity.

SecondChanceEnabled ( boolean ) [1]
Indicates the user's preference to accept second chance offers. If true, the user is willing to be the recipient of second chance offers.
See the Field Index to learn which calls use SecondChanceEnabled.

SiteCurrency ( see CurrencyCodeType for possible values ) [1]
Unique ID identifying the currency in which the localized offer amounts are expressed.
See the Field Index to learn which calls use SiteCurrency.

TimeBid ( dateTime ) [1]
Date and time the offer or bid was placed.
See the Field Index to learn which calls use TimeBid.

TransactionID
Not used by any call.

User ( UserType ) [1]
Bidder information. See the schema documentation for UserType for details on its properties and their meanings.
See the Field Index to learn which calls use User.

UserConsent ( boolean ) [0..1]
If true, confirms that the bidder read and agrees to eBay's privacy policy. Applies if the subject item is in a category that requires user consent. If user consent (that is, confirmation that a bidder read and agrees to eBay's privacy policy) is required for a category that the subject item is in, this value must be true for a bid to occur.
See the Field Index to learn which calls use UserConsent.

Copyright © 2005–2013 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.