AvaTax tax code mapping

Element type: Required

Endpoints/models used: ListTaxCodes

Your integration is expected to include an item list that merchants can then map to Avalara tax codes to determine the item taxability. Products are taxed differently in different jurisdictions. Finding the correct tax code will ensure that AvaTax treats your product correctly everywhere. You can find the correct Avalara tax code for your product in one of two ways:

Look on Avalara's tax code search
Call the ListTaxCodes API to list available tax codes

In your integration, some users will choose to enter a tax code directly into the UI. Others will want to search for or be provided with a list of tax codes. A common use case is to show a dropdown text box with all available tax codes. In this example, when a customer starts typing the word C, your program can call ListTaxCodes to find all tax codes that begin with C. Below is an example showing how to call ListTaxCodes and filter on tax codes that start with C.

Example request

GET /api/v2/definitions/taxcodes/$filter=description startswith C

Example response

{
  "id": 56789,
  "companyId": 12345,
  "taxCode": "PF050101",
  "taxCodeTypeId": "P",
  "description": "Carbonated beverages",
  "parentTaxCode": "PF050001",
  "isPhysical": true,
  "goodsServiceCode": 0,
  "entityUseCode": "",
  "isActive": true,
  "isSSTCertified": true
}