# Manage Tax Services (Avalara)

Sales Tax Automation services such as **Avalara provide sales tax automation software to get the business tax compliance done right**. It’s tax automation for businesses with real-time tax calculations.

Tax Automation services integration with Xoro will help your businesses manage the complex rules and regulations related to transactional and indirect taxes.

Currently, Xoro supports Avalara to get automatic Sales tax calculations. However, more services will be added in the future.

{% hint style="info" %}
To manage all your tax-related services, go to **Menu > Utilities > Manage Tax Services**
{% endhint %}

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

Let us find out how the Avalara Tax Service works within the Xoro system.

### Step 1: Generate Credentials

A license key is required to connect Xoro to Avalara Tax.\
If you generate a new license key, update it in Xoro because your old license key won’t work anymore.

To generate a License key follow the steps below:

* Login to your Avalara account.<br>

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

  <figure><img src="/files/ZcNPa3r7lUfOP4Vw7t0H" alt=""><figcaption></figcaption></figure>
* Add/Reset the License Key.<br>

  <div align="left"><figure><img src="/files/IXOWCPUvO5VYLlSXb0Ec" alt=""><figcaption></figcaption></figure></div>

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

  * You will receive the credentials through your registered email.

  Once the credentials are generated you can use them in Xoro for the integration process.

### Step 2: Integrating Avalara with Xoro

For setting up the “Tax Services” in Xoro, follow the steps underlined:

* Navigate to the “**Manage Tax Services**” module in Xoro.
* Under the “**Add Services**” tab, Connect Avalara.<br>

  <figure><img src="/files/RR4BF6MVnO7FJeYmcLXK" alt=""><figcaption></figcaption></figure>
* Fill in the Configuration details:

  * **Account Name:** Give a Name to the Avalara Account.
  * **Ava Tax Account ID:** Fill in the unique Ava Tax Account Id (Numeric).
  * **Ava Tax License Key:** Fill in the generated License key (Alpha-Numeric).
  * **Ava Tax Company Code:** Provide the Ava Tax Company Code.
  * **Connection Type:** Select the connection Type: Sandbox/Production.
  * **Enable Ava Tax:** Avatax will be used for filing the Tax in the system if this setting is enabled. If this toggle button is turned Off, the configuration details will still remain in the system, but the tax filing through Avalara will be disabled.
  * **Record Document:** Turn this setting ON, if recording the Sales Tax documents is required in Xoro.

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

The configuration details can be validated by testing the connection

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

* If the Account ID/Licence key/Connection Type details are correct, the Account connection would succeed.<br>

  <figure><img src="/files/R7WiZouTY4I0Px4yaT0t" alt=""><figcaption></figcaption></figure>
* Save the Avalara Tax Configuration.<br>

  <figure><img src="/files/iWcBXklTTsEpfDPSKrrF" alt=""><figcaption></figcaption></figure>
* Once Avalara is integrated into Xoro, it will be shown under the “Active Services”.<br>

  <figure><img src="/files/wKdQhSYoCPaHZ2LMiNVg" alt=""><figcaption></figcaption></figure>
* The saved configuration can be edited/deleted or set as inactive later if required.<br>

  <figure><img src="/files/9a7IMBrl31by4Q9UQ9Dr" alt=""><figcaption></figcaption></figure>
* On the other hand, if incorrect credentials are filled in, the system will give an error.<br>

  <div align="left"><figure><img src="/files/Tgnnd3cHyqivSA8oOKsm" alt=""><figcaption></figcaption></figure></div>

  <div align="left"><figure><img src="/files/BK1eIQb4ontXiKorGnZH" alt=""><figcaption></figcaption></figure></div>

### Step 3: Validate Workflow with the added Tax Services

When the Avalara Tax service is configured and enabled in Xoro, all the Tax calculations will be based only on the Avalara integration.

* The modules like Sales Order, Estimate, Sales Receipt, Invoice Credit Memo will have the option to calculate the Sales Tax based on the Avalara Tax codes.<br>

  <figure><img src="/files/jDa6qi93dl6Ds1Qd3pCP" alt=""><figcaption></figcaption></figure>
* In the Item module, under the “Tax Settings” tab, fill in the Tax Code. (Item taxable on Sale).<br>

  <figure><img src="/files/CW9XhhcAm8VulqSgx8Sw" alt=""><figcaption></figcaption></figure>
* While creating an Order **Calculate Tax before saving the Sales Order.**<br>

  <figure><img src="/files/6oexWXE8fcmWj7cmL3Pj" alt=""><figcaption></figcaption></figure>
* The system will automatically calculate the taxes.

The Customers can be set as Tax exempted or Taxable by defining the “Entity Use Code” under the Sales Tax tab of the Customer module.

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


---

# Agent Instructions: 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:

```
GET https://docs.xorosoft.com/xoroerp-1/utilities/manage-tax-services-avalara.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.