> For the complete documentation index, see [llms.txt](https://docs.commercelayer.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.commercelayer.io/core-api-reference/avalara_accounts.md).

# Avalara accounts

Configure your [Avalara](https://www.avalara.com/us/en/index.html) account to automatically compute tax calculations for the orders of the associated market.

<details>

<summary><strong>Configuration guide</strong></summary>

Avalara [AvaTax ](https://www.avalara.com/us/en/products/calculations.html)is a cloud-based solution automating transaction tax calculations and the tax filing process. Avalara provides real-time tax calculation using tax content from more than 12,000 US taxing jurisdictions and over 200 countries, ensuring your transaction tax is calculated based on the most current tax rules.

AvaTax is integrated with Commerce Layer as a [tax calculator](/core-api-reference/tax_calculators.md) that connects to one or more markets. Once connected, every order placed in that market is taxed by Avalara in real time.

{% hint style="info" icon="image" %}
The screens below are taken directly from the Commerce Layer [Dashboard](https://dashboard.commercelayer.io/)'s *Settings* area.
{% endhint %}

{% stepper %}
{% step %}

### &#x20;Connect to AvaTax

In Commerce Layer, AvaTax is added as a tax calculator from the organization's *Settings*:

* Go to *Settings › Tax calculators*.
* Click *+ New*, then select the *Avalara* tile from the list of integrated tax calculators.
* Enter your Avalara AvaTax credentials and click *Create*.

<figure><img src="/files/KUbh4TkCpPJhwoDW4Ldu" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="189.2890625">Field</th><th>Description</th></tr></thead><tbody><tr><td><strong>Account ID</strong></td><td>The Avalara account number provided during your AvaTax account activation.</td></tr><tr><td><strong>License Key</strong></td><td>The Avalara software license key provided during activation.</td></tr><tr><td><strong>Company code</strong></td><td>The company profile identifier configured in the AvaTax Admin Console.</td></tr><tr><td><strong>Record sales invoice on Avalara</strong></td><td>When enabled, transactions are posted and committed to the AvaTax Admin Console for record keeping (equivalent to <em>Enable Document Committing / Submission</em>).</td></tr><tr><td><strong>Delivered Duty Paid</strong></td><td>Enable when the merchant, rather than the customer, is responsible for import duties and taxes on cross-border shipments.</td></tr></tbody></table>

{% hint style="warning" icon="circle-exclamation" %}
Once created, the credentials cannot be viewed or edited from the Dashboard. To change them, delete the tax calculator and add a new one.
{% endhint %}
{% endstep %}

{% step %}

### Assign the tax calculator to a market

AvaTax only calculates tax for orders placed in a [market](/core-api-reference/markets.md) that has this tax calculator assigned. Go to *Settings › Markets*, open a market, click *Edit*, and select the *Avalara* tax calculator under *Automation*.

<figure><img src="/files/mzsLcmG776Bu0j9Dd0CU" alt=""><figcaption></figcaption></figure>

{% hint style="info" icon="arrows-repeat" %}
Repeat this step for every market that should use Avalara for tax calculation.
{% endhint %}
{% endstep %}

{% step %}

### Configure Avalara AvaTax

Once connected, open *Settings › Tax calculators* and select the account to review its configuration.

<figure><img src="/files/yPQdU5yDsHN3nK6MmRor" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
This screen confirms the tax calculator type (Avalara), the Account ID, and which options are enabled — in this example, *Record sales invoice* is active.&#x20;
{% endhint %}

{% hint style="info" icon="pen-nib-slash" %}
The *Credentials* section is read-only after creation, by design.
{% endhint %}
{% endstep %}

{% step %}

### Assign an AvaTax System Tax Code to a product

Commerce Layer maps individual [SKUs](/core-api-reference/skus.md) to Avalara tax codes through [tax categories](/core-api-reference/tax_categories.md), managed from the same tax calculator's *Tax categories* tab. This is the equivalent of assigning a product-level tax code in AvaTax.

<figure><img src="/files/sZ2KUdEjc4xxC4wDuBqA" alt=""><figcaption></figcaption></figure>

To create a new tax category from the Dashboard:

* Click *+ Category*.
* Enter the SKU code to categorize.
* Enter the corresponding AvaTax System Tax Code.
* Click *Create*.

<figure><img src="/files/CxZXtwuJ0Nq0qVLrsZM6" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Check [this page](https://taxcode.avatax.avalara.com) for the full listing of available AvaTax System Tax Codes. Any SKU without an assigned tax category uses the tax calculator's default tax treatment.
{% endhint %}

{% hint style="warning" %}
Tax category assignment lives on the tax calculator resource rather than on the product edit screen itself — there is no *Tax code* field on the SKU edit form in the dashboard.
{% endhint %}
{% endstep %}
{% endstepper %}

### Tax exemptions and address validation

Commerce Layer does not expose dedicated *tax exempt category* or *validate address* controls on the customer record in the Dashboard. Address validation and exemption handling happen as part of the real-time AvaTax calculation call made at checkout for every order in a connected market.&#x20;

{% hint style="info" %}
Businesses that need to manage exemption certificates directly can do so in Avalara's own [Exemption Certificate Management](https://www.avalara.com/us/en/products/exemption-certificate-management-pro.html) product, using the Company code shown on the tax calculator detail page to match records.
{% endhint %}

### Avalara AvaTax in action

Once a market is connected to the Avalara tax calculator, every order placed in that market shows a real, Avalara-calculated taxes line in its summary — no manual tax entry is required.

<figure><img src="/files/mo1OTMa7OMNHFkUnk2zN" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
In this example order, Avalara calculated $4.57 of tax on a $62.00 taxable amount (product subtotal plus shipping), based on the customer's delivery address and the product's tax category.
{% endhint %}

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.commercelayer.io/core-api-reference/avalara_accounts.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.