Element type: Suggested

Endpoints/models used: N/A

Your integration should store VAT codes returned by the AvaTax engine. This code can then be passed to an ERP system. This requirement is handled through your back end and not directly via an AvaTax API call.

VAT code formatting

The VAT code is a series of characters generated by the AvaTax engine and describes the nature of a transaction. The code is formatted as follows:

CC D T VVV G DD SS

CC: 2-digit ISO country code

D: Document type. Available types include:

T: Transaction type. Available types include:
- C: Reverse charge (RC) (EU) (art. 196)
- I: Intra-Community (IC)
- L: Domestic (LOCAL) (with Sales: LOCAL SALES, with purchase: LOCAL)
- M: Domestic reverse charge (LOCAL RV) (Art. 194)
- T: Triangulation (TRIN)
- V: Postponement of VAT (in case of import)
- E: Exempt (in case of importation or Export) (EXPORT)
- Z: Outside the scope of VAT
- N: Reverse charge (non-EU) (art. 196)
- A: Distance sale
- 4: Deemed export GB-NI
- 0: IOSS
- 5: Deemed Import for XI

VVV: The 3-digit VAT rate. A VAT rate of 196, for example, would be 19.6%.

G: The type of goods. Available types vary for purchases and sales.
- Purchase:
  - C: Commodities
  - S: Services
- Sales:
  - C: Commodities
  - D: Services

DD: The percentage deductible VAT rate. This value is blank if the transaction is 100% deductible and is 00 if nothing is deductible.

SS: The 2-character ISO code for the ship-from country. This is only applicable for certain sales documents.

Display and store the VAT code in responses