NAME
eBay::API::XML::DataType::OfferType
DESCRIPTION
Contains information pertaining to an offer made on an item listing and the current bidding or purchase state of the listing.
SYNOPSIS
INHERITANCE
eBay::API::XML::DataType::OfferType inherits from the eBay::API::XML::BaseDataType class
Subroutines:
setAction()
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 counter-offer, etc.), 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.
Calls: PlaceOffer
RequiredInput: Yes
OnlyTheseValues: Bid, Purchase, Accept, Counter, Decline, Offer
# Argument: 'ns:BidActionCodeType'
getAction()
Calls: GetAllBidders
GetHighBidders
Returned: Always
# Returns: 'ns:BidActionCodeType'
setBestOfferID()
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 counteroffer (and is not required for a buyer's offer or counteroffer).
Calls: PlaceOffer
RequiredInput: No
# Argument: 'ns:BestOfferIDType'
getBestOfferID()
# Returns: 'ns:BestOfferIDType'
setBidCount()
Total number of offers the user has made on the item.
# Argument: 'xs:int'
getBidCount()
# Returns: 'xs:int'
setConvertedPrice()
Localized amount for the item's current price.
# Argument: 'ns:AmountType'
getConvertedPrice()
Calls: GetAllBidders
GetHighBidders
Returned: Conditionally
# Returns: 'ns:AmountType'
setCurrency()
Numeric ID for the currency for the auction. Valid values are enumerated in the CurrencyCodeType code list.
# Argument: 'ns:CurrencyCodeType'
getCurrency()
Calls: GetAllBidders
GetHighBidders
Returned: Always
# Returns: 'ns:CurrencyCodeType'
setHighestBid()
Amount the highest bidder had bid on the item. Applicable only to competitive-bidding listings (Chinese and Dutch auctions) where there is progressive bidding and winning bidders are determined based on the highest bid.
# Argument: 'ns:AmountType'
getHighestBid()
Calls: GetAllBidders
Returned: Always
# Returns: 'ns:AmountType'
setItemID()
The unique identifier of an item listed on the eBay site. Returned by eBay when the item is created.
MaxLength: 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits)
# Argument: 'ns:ItemIDType'
getItemID()
# Returns: 'ns:ItemIDType'
setMaxBid()
Amount of the offer placed. For competitive-bidding 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 competitive-bidding 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.
Calls: PlaceOffer
RequiredInput: Yes
# Argument: 'ns:AmountType'
getMaxBid()
Calls: GetAllBidders
GetHighBidders
Returned: Always
# Returns: 'ns:AmountType'
setMessage()
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.).
Calls: PlaceOffer
RequiredInput: No
# Argument: 'xs:string'
getMessage()
# Returns: 'xs:string'
setQuantity()
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 Chinese auctions and other listing formats that only allow one item per listing, 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.
Calls: PlaceOffer
RequiredInput: Yes
# Argument: 'xs:int'
getQuantity()
Calls: GetAllBidders
GetHighBidders
Returned: Always
# Returns: 'xs:int'
setSecondChanceEnabled()
Indicates the user's preference to accept second chance offers. If true, the user is willing to be the recipient of second chance offers.
# Argument: 'xs:boolean'
isSecondChanceEnabled()
Calls: GetAllBidders
Returned: Always
# Returns: 'xs:boolean'
setSiteCurrency()
Unique ID identifying the currency in which the localized offer amounts are expressed.
# Argument: 'ns:CurrencyCodeType'
getSiteCurrency()
Calls: GetAllBidders
GetHighBidders
Returned: Always
# Returns: 'ns:CurrencyCodeType'
setTimeBid()
Date and time the offer or bid was placed.
# Argument: 'xs:dateTime'
getTimeBid()
Calls: GetAllBidders
GetHighBidders
Returned: Always
# Returns: 'xs:dateTime'
setTransactionID()
The unique identifier of the transaction. The transaction is created when a winning bidder commits to purchasing an item, even before the bidder has paid.
MaxLength: 19 (Note: The eBay database specifies 38. Currently, transaction IDs are usually 9 to 12 digits.)
# Argument: 'xs:string'
getTransactionID()
# Returns: 'xs:string'
setUser()
Bidder information. See the schema documentation for UserType for details on its properties and their meanings.
# Argument: 'ns:UserType'
getUser()
Calls: GetAllBidders
GetHighBidders
Returned: Always
# Returns: 'ns:UserType'
setUserConsent()
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.
Calls: PlaceOffer
RequiredInput: No
# Argument: 'xs:boolean'
isUserConsent()
# Returns: 'xs:boolean'