Overview 
Namespace 
WSDL 
Schema 
 Component 
Index 
PREV C-TYPE   NEXT C-TYPE
FRAMES   NO FRAMES NS-Bindings
SUMMARY: XML REP | DERIVED | USE
DETAIL: DESC | XML SRC | TYPE | ATTR | CHILD
eBay Trading API
complexType "ns:RespondToBestOfferRequestType"
Namespace:
urn:ebay:apis:eBLBaseComponents
Content:
complex, 16 elements, elem. wildcard
Defined:
globally in Schema in ebaySvc.wsdl; see XML source
Includes:
definitions of 6 elements
Used:
at 1 location
Component Diagram
XML Representation Summary
<...>
   
Content: 
ns:DetailLevel*, ns:ErrorLanguage?, ns:MessageID?, ns:Version?, ns:EndUserIP?, ns:ErrorHandling?, ns:InvocationID?, ns:OutputSelector*, ns:WarningLevel?, ns:BotBlock?, {any}*, ns:ItemID?, ns:BestOfferID*, ns:Action?, ns:SellerResponse?, ns:CounterOfferPrice?, ns:CounterOfferQuantity?
</...>
All Direct / Indirect Based Elements (1):
ns:RespondToBestOfferRequest
Known Usage Locations
Annotation
This call enables the seller to accept or decline a buyer's Best Offer on an item, or make a counter offer to the buyer's Best Offer. A seller can decline multiple Best Offers with one call, but the seller cannot accept or counter offer multiple Best Offers with one call. Best Offers are not applicable to auction listings.

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 are 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.
Type Definition Detail
Type Derivation Tree
ns:AbstractRequestType (extension)
  ns:RespondToBestOfferRequestType
XML Source (w/o annotations (7); see within schema source)
<xs:complexType name="RespondToBestOfferRequestType">
<xs:complexContent>
<xs:extension base="ns:AbstractRequestType">
<xs:sequence>
<xs:element minOccurs="0" name="ItemID" type="ns:ItemIDType"/>
<xs:element maxOccurs="unbounded" minOccurs="0" name="BestOfferID" type="ns:BestOfferIDType"/>
<xs:element minOccurs="0" name="Action" type="ns:BestOfferActionCodeType"/>
<xs:element minOccurs="0" name="SellerResponse" type="xs:string"/>
<xs:element minOccurs="0" name="CounterOfferPrice" type="ns:AmountType"/>
<xs:element minOccurs="0" name="CounterOfferQuantity" type="xs:int"/>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
Content Element Detail (all declarations defined in this component; 6/17)
ns:Action
Type:
ns:BestOfferActionCodeType, simple content
The enumeration value that the seller passes in to this field will control whether the seller accepts or make a counter offer to a single buyer's Best Offer, or declines one or more buyers' Best Offers. A seller can decline multiple Best Offers with one call, but the seller cannot accept or counter offer multiple Best Offers with one call.
XML Representation Summary
<ns:Action>
   
Content: 
{ enumeration of xs:token }
</ns:Action>
Simple Content
Enumeration:
"Accept"
 - 
This value should be passed in to the Action field to accept the Best Offer identified in the BestOfferID field. Note that only one Best Offer may be accepted in a single RespondToBestOffer call.
"Decline"
 - 
This value should be passed in to the Action field to decline one or more Best Offers identified by one or more BestOfferID fields. Note that multiple Best Offers may be declined in a single RespondToBestOffer call.
"Counter"
 - 
This value should be passed in to the Action field to counter a buyer's Best Offer or Counter Offer. Note that a seller may only counter one Best Offer in a single RespondToBestOffer call. If a seller is using the RespondToBestOffer call to counter a Best Offer, the counter offer price must be specified in the CounterOfferPrice field, and the quantity of items in the Best Offer must be specified in the CounterOfferQuantity field.
"CustomCode"
 - 
Reserved for internal or future use.
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="Action" type="ns:BestOfferActionCodeType"/>
ns:BestOfferID
Type:
ns:BestOfferIDType, simple content
The unique identifier of a buyer's Best Offer for the order line item. This ID is created once the buyer makes a Best Offer. It is possible that a seller will get multiple Best Offers for an order line item, and if that seller would like to decline multiple/all of the Best Offers with one RespondToBestOffer call, the seller would pass in each of these identifiers in a separate BestOfferID field. However, the seller can only accept or counter offer one Best Offer at a time.
XML Representation Summary
<ns:BestOfferID>
   
Content: 
{ xs:string }
</ns:BestOfferID>
XML Source (w/o annotations (1); see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" name="BestOfferID" type="ns:BestOfferIDType"/>
ns:CounterOfferPrice
Type:
ns:AmountType, simple content
The seller inserts counter offer price into this field. This field is conditionally required and only applicable when the Action value is set to Counter, The counter offer price cannot exceed the Buy It Now price for a single quantity item. However, the dollar value in this field may exceed the Buy It Now price if the buyer is requesting or the seller is offering multiple quantity of the item (in a multiple-quantity listing). The quantity of the item must be specified in the CounterOfferQuantity field if the seller is making a counter offer.
Component Diagram
XML Representation Summary
<ns:CounterOfferPrice
   
currencyID
 = 
("AFA" | "ALL" | "DZD" | "ADP" | "AOA" | "ARS" | "AMD" | "AWG" | "AZM" | "BSD" | "BHD" | "BDT" | "BBD" | "BYR" | "BZD" | "BMD" | "BTN" | "INR" | "BOV" | "BOB" | "BAM" | "BWP" | "BRL" | "BND" | "BGL" | "BGN" | "BIF" | "KHR" | "CAD" | "CVE" | "KYD" | "XAF" | "CLF" | "CLP" | "CNY" | "COP" | "KMF" | "CDF" | "CRC" | "HRK" | "CUP" | "CYP" | "CZK" | "DKK" | "DJF" | "DOP" | "TPE" | "ECV" | "ECS" | "EGP" | "SVC" | "ERN" | "EEK" | "ETB" | "FKP" | "FJD" | "GMD" | "GEL" | "GHC" | "GIP" | "GTQ" | "GNF" | "GWP" | "GYD" | "HTG" | "HNL" | "HKD" | "HUF" | "ISK" | "IDR" | "IRR" | "IQD" | "ILS" | "JMD" | "JPY" | "JOD" | "KZT" | "KES" | "AUD" | "KPW" | "KRW" | "KWD" | "KGS" | "LAK" | "LVL" | "LBP" | "LSL" | "LRD" | "LYD" | "CHF" | "LTL" | "MOP" | "MKD" | "MGF" | "MWK" | "MYR" | "MVR" | "MTL" | "EUR" | "MRO" | "MUR" | "MXN" | "MXV" | "MDL" | "MNT" | "XCD" | "MZM" | "MMK" | "ZAR" | "NAD" | "NPR" | "ANG" | "XPF" | "NZD" | "NIO" | "NGN" | "NOK" | "OMR" | "PKR" | "PAB" | "PGK" | "PYG" | "PEN" | "PHP" | "PLN" | "USD" | "QAR" | "ROL" | "RUB" | "RUR" | "RWF" | "SHP" | "WST" | "STD" | "SAR" | "SCR" | "SLL" | "SGD" | "SKK" | "SIT" | "SBD" | "SOS" | "LKR" | "SDD" | "SRG" | "SZL" | "SEK" | "SYP" | "TWD" | "TJS" | "TZS" | "THB" | "XOF" | "TOP" | "TTD" | "TND" | "TRL" | "TMM" | "UGX" | "UAH" | "AED" | "GBP" | "USS" | "USN" | "UYU" | "UZS" | "VUV" | "VEB" | "VND" | "MAD" | "YER" | "YUM" | "ZMK" | "ZWD" | "ATS" | "CustomCode")
   
>
   
Content: 
{ xs:double }
</ns:CounterOfferPrice>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="CounterOfferPrice" type="ns:AmountType"/>
ns:CounterOfferQuantity
Type:
xs:int, predefined, simple content
The seller inserts the quantity of items in the counter offer into this field. This field is conditionally required and only applicable when the Action value is set to Counter, The counter offer price must be specified in the CounterOfferPrice field if the seller is making a counter offer. This price should reflect the quantity of items in the counter offer. So, if the seller's counter offer 'unit' price is 15 dollars, and the item quantity is '2', the dollar value passed into the CounterOfferPrice field would be 30.0.
XML Representation Summary
<ns:CounterOfferQuantity>
   
Content: 
{ xs:int }
</ns:CounterOfferQuantity>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="CounterOfferQuantity" type="xs:int"/>
ns:ItemID
Type:
ns:ItemIDType, simple content
The unique identifier of the listing to which the seller is responding to a Best Offer.
XML Representation Summary
<ns:ItemID>
   
Content: 
{ xs:string }
</ns:ItemID>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="ItemID" type="ns:ItemIDType"/>
ns:SellerResponse
Type:
xs:string, predefined, simple content
This optional text field allows the seller to provide more details to the buyer about the action being taken against the buyer's Best Offer.
XML Representation Summary
<ns:SellerResponse>
   
Content: 
{ xs:string }
</ns:SellerResponse>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="SellerResponse" type="xs:string"/>
Overview 
Namespace 
WSDL 
Schema 
 Component 
Index 
PREV C-TYPE   NEXT C-TYPE
FRAMES   NO FRAMES NS-Bindings
SUMMARY: XML REP | DERIVED | USE
DETAIL: DESC | XML SRC | TYPE | ATTR | CHILD
eBay Trading API
WSDL documentation generated with FlexDoc/XML 1.13 using FlexDoc/XML WSDLDoc 1.2.5 template set. All XSD diagrams generated by FlexDoc/XML DiagramKit.