Tax amount by tax type override

After calculating customs duty and import tax and then shipping an item, you should expect a customs document from the country of authority that is receiving the item. This document may show a difference or variance between the amount of tax that you calculated and the amount of tax that they charge. In order to maintain correct tax amounts for a transaction, AvaTax provides ataxAmountByTaxTypes TaxOverride. This allows you to specify the total tax amount to override per tax type applicable at the line level in a customs document.

Advice:taxAmountByTaxTypes can be used only at the line level.

Typical workflow

A typical workflow for using thetaxAmountByTaxTypes override is as follows:

Calculate customs duty and import tax in a sales invoice.
Ship the item.
Review customs document after the item goes through customs.
Create a sales order (quote) to retrieve the appropriate tax types from the original transaction.
Convert the sales order to a customs invoice.

taxAmountByTaxTypes fields

When a tax override type oftaxAmountByTaxTypes is specified, the table below describes the fields that must be included in the TransactionLineTaxAmountByTaxType model. You can retrieve these values by running a quote and viewing the response details.

Advice: When viewing the quote response to retrieve the returned tax type IDs, the returned tax type ID may not be an actual mapping to what is required for thetaxTypeId in the tax override. Specifically:

ForInput orOutput tax, useI in the tax override.
ForSales tax, useS in the tax override.
ForUse tax, useU in the tax override.
ForConsumer Use tax, useC in the tax override.

taxAmountByTaxTypes response fields

For every line in a transaction that utilizes ataxAmountByTaxTypes override, the following reporting fields are available.

Example

The following example shows how to use thetaxAmountByTaxType override.

{
    "lines": [
        {
            "number": "1",
            "quantity": 1,
            "amount": 950,
            "itemCode": "SKU 1000.6",
            "taxCode": "P00000000",
            "description": "Cuban Links",
            "category": "Man > Jewelry ; Gold > Braclet",
            "taxIncluded" : false,  
            "hsCode": "6204420090",
            "taxOverride": {
                "type": "TaxAmountByTaxType",
                "reason": "Capture shipping receipt details",
                "taxAmountByTaxTypes": [
                    {
                        "taxTypeId": "LandedCost", 
                        "taxAmount": 50
                    },
                    {
                        "taxTypeId": "I", 
                        "taxAmount": 50
                    }
                ]
            }
        }
    ],
...
}

Field	Attributes	Description
`taxTypeId`	string	Specify the name of the tax type or types. This information is available in the output of the initial order.
`taxAmount`	number ($double)	Specify the tax override amount.

Field	Description
`taxTypeId`	This shows the name of the tax type(s).
`taxAmount`	This shows the amount of the tax override.