eBay Merchant Data APIVersion 1255
 

TaxesType

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.

Type that uses TaxesType:

Call that uses TaxesType:

Fields

eBayReference ( eBayTaxReferenceValue (string) ) [0..1]
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: For all VAT ID/VATIN values to be returned (except for France), developers will need to use a Trading WSDL with a version number of 1211 (or newer). For French VAT ID/VATIN values to be returned, developers will need to use a Trading WSDL with a version number of 1225 (or newer). Otherwise, the VAT information will be returned in the Order.ShippingAddress.Street2 field. Developers will also have the option of using older version, but setting the X-EBAY-API-COMPATIBILITY-LEVEL header value to 1211 or 1225 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.

See the Field Index to learn which calls use eBayReference.

TaxDetails ( TaxDetailsType ) [0..*]
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.
See the Field Index to learn which calls use TaxDetails.

TotalTaxAmount ( AmountType (double) ) [0..1]
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.
See the Field Index to learn which calls use TotalTaxAmount.