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:TaxesType"
Namespace:
urn:ebay:apis:eBLBaseComponents
Content:
complex, 3 elements, elem. wildcard
Defined:
globally in Schema in ebaySvc.wsdl; see XML source
Includes:
definitions of 3 elements, elem. wildcard
Used:
at 2 locations
Component Diagram
XML Representation Summary
<...>
   
Content: 
ns:eBayReference?, ns:TotalTaxAmount?, ns:TaxDetails*, {any}*
</...>
All Direct / Indirect Based Elements (2):
ns:Taxes, ns:eBayCollectAndRemitTaxes
Known Usage Locations
Annotation
Type defining the Taxes container, which contains detailed tax information (sales tax and VAT) for an order line item. The information in this container supercedes/overrides the sales tax information in the ShippingDetails.SalesTax container.
XML Source (w/o annotations (4); see within schema source)
<xs:complexType name="TaxesType">
<xs:sequence>
<xs:element minOccurs="0" name="eBayReference" type="ns:eBayTaxReferenceValue"/>
<xs:element minOccurs="0" name="TotalTaxAmount" type="ns:AmountType"/>
<xs:element maxOccurs="unbounded" minOccurs="0" name="TaxDetails" type="ns:TaxDetailsType"/>
<xs:any maxOccurs="unbounded" minOccurs="0" processContents="lax"/>
</xs:sequence>
</xs:complexType>
Content Element Detail (all declarations defined in this component; 4/4)
ns:eBayReference
Type:
ns:eBayTaxReferenceValue, simple content
The value returned in this field is the VAT ID for eBay, and this value may vary based on the region or country. The eBayReference field's name attribute will show the type of VAT ID, such as IOSS, OSS, or ABN. This field will be returned if VAT tax is applicable for the order. See the eBayTaxReferenceValue type page for more information on the VAT tax type strings that may appear for the name attribute.

Note: The eBay VAT ID and buyer VATIN fields will not start getting returned until June 30, 2021.

Going forward after June 30, developers will need to use a Trading WSDL with a version number of 1211 (or newer) for the VAT ID/VATIN values to be returned in the new fields. Otherwise, the VAT information will be returned in the Order.ShippingAddress.Street2 field. Developers will also have the option of using an older version than 1211, but setting the X-EBAY-API-COMPATIBILITY-LEVEL header value to 1211 or higher.

On January 31, 2022, the Order.ShippingAddress.Street2 will stop being used to return VAT information regardless of WSDL version or compatibility level.
Component Diagram
XML Representation Summary
<ns:eBayReference
   
name
 = 
xs:string
   
>
   
Content: 
{ xs:string }
</ns:eBayReference>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="eBayReference" type="ns:eBayTaxReferenceValue"/>
ns:TaxDetails
Type:
ns:TaxDetailsType, complex content
Container consisting of detailed sales tax information for an order line item, including the tax type and description, sales tax on the item cost, and sales tax related to shipping and handling.
Component Diagram
XML Representation Summary
<ns:TaxDetails>
   
Content: 
ns:Imposition?, ns:TaxDescription?, ns:TaxAmount?, ns:TaxOnSubtotalAmount?, ns:TaxOnShippingAmount?, ns:TaxOnHandlingAmount?, ns:TaxCode?, ns:CollectionMethod?, {any}*
</ns:TaxDetails>
XML Source (w/o annotations (1); see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" name="TaxDetails" type="ns:TaxDetailsType"/>
ns:TotalTaxAmount
Type:
ns:AmountType, simple content
This value indicates the total tax amount for the order line item, for all tax types, which may include sales tax (seller-applied or 'eBay Collect and Remit'), 'Goods and Services' tax (for Australian or New Zealand sellers), or other fees like an electronic waste recycling fee.

Note: If the corresponding tax type is GST or SalesTax (if found under both the eBayCollectAndRemitTaxes and Taxes containers), the order is subject to 'eBay Collect and Remit' tax, and a change in logic has rolled out as of early November 2019. For orders that are subject to eBay 'Collect and Remit' tax, which includes US sales tax for numerous states, and 'Good and Services' tax that is applicable to Australian and New Zealand sellers, the tax amount in this field will be included in the Order.Total, Order.AmountPaid, and Transaction.AmountPaid fields.

Sellers should be aware that the sales tax that the buyer pays for the order will initially be included when the order funds are distributed to their PayPal account, but that PayPal will pull out the sales tax amount shortly after the payment clears, and will distribute the sales tax to the appropriate taxing authority. Previous to this change, PayPal would strip out the 'Collect and Remit' tax before distributing order funds to the seller's account.

This logic change does not apply to sellers who are in eBay managed payments, so the amount in this field will never reflect any 'Collect and Remit' tax, even if the order is subject to 'Collect and Remit' tax.
Component Diagram
XML Representation Summary
<ns:TotalTaxAmount
   
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:TotalTaxAmount>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="TotalTaxAmount" type="ns:AmountType"/>
{any element from any namespace}
XML Source (see within schema source)
<xs:any maxOccurs="unbounded" minOccurs="0" processContents="lax"/>
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.