eBay Trading APIVersion 1131

TaxDetailsType

Type used by the TaxDetails container, which consists of detailed tax information for an order line item, including the tax type and description, tax on the item cost, and tax related to shipping and handling. The information in this container supercedes/overrides the sales tax information in the ShippingDetails.SalesTax container (if returned).

Type that uses TaxDetailsType:

Calls that use TaxDetailsType:

Fields



CollectionMethod ( CollectionMethodCodeType ) [0..1]
This field indicates the collection method used to collect the 'Collect and Remit' or 'Good and Services' tax for the order. This field is always returned for orders subject to 'Collect and Remit' or 'Good and Services' tax, and its value is always NET.

Note: Although the CollectionMethod field is returned for all orders subject to 'Collect and Remit' sales tax or 'Good and Services' tax, the CollectionMethod field and CollectionMethodCodeType are not currently of any practical use, although this field may have use in the future. If and when the logic of this field is changed, this note will be updated and a note will also be added to the Release Notes.
See the Field Index to learn which calls use CollectionMethod.

Imposition ( TaxTypeCodeType ) [0..1]
This field indicates the tax type. A separate TaxDetails container is returned for each unique imposition (tax type).
See the Field Index to learn which calls use Imposition.

TaxAmount ( AmountType (double) ) [0..1]
This value is the total amount of sales tax for the order line item for the corresponding impositiion (tax type).

TaxAmount = TaxOnSubtotalAmount + TaxOnShippingAmount + TaxOnHandlingAmount

Note: If the corresponding tax type is GST or SalesTax (if found under both the eBayCollectAndRemitTaxes.TaxDetails and Taxes.TaxDetails containers), the order is subject to 'eBay Collect and Remit' tax, and a change in logic has been 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.
See the Field Index to learn which calls use TaxAmount.

TaxCode ( string ) [0..1]
This value is the actual tax ID for the buyer. This field will generally only be returned if a seller on the Italy or Spain sites required that the buyer supply a tax ID during the checkout process. If the Order.BuyerTaxIdentifier container is returned, the type of tax ID can be found in the BuyerTaxIdentifier.Type field.
See the Field Index to learn which calls use TaxCode.

TaxDescription ( TaxDescriptionCodeType ) [0..1]
This enumeration indicates the type of tax.
See the Field Index to learn which calls use TaxDescription.

TaxOnHandlingAmount ( AmountType (double) ) [0..1]
This value is the amount of sales tax applied based on handling costs for the order line item for the corresponding impositiion (tax type).
See the Field Index to learn which calls use TaxOnHandlingAmount.

TaxOnShippingAmount ( AmountType (double) ) [0..1]
This value is the amount of sales tax applied based on shipping costs for the order line item for the corresponding impositiion (tax type).
See the Field Index to learn which calls use TaxOnShippingAmount.

TaxOnSubtotalAmount ( AmountType (double) ) [0..1]
This value is the amount of sales tax applied based on the unit cost of the order line item for the corresponding impositiion (tax type).
See the Field Index to learn which calls use TaxOnSubtotalAmount.