## Zoho Billing - Product, solutions, integrations, support, and resources Index

Access the complete documentation index at:
https://www.zoho.com/us/billing/llms.txt

Use this file to discover all available documentation pages before proceeding.

# Avalara AvaTax Integration

Avalara is a tax service that helps you calculate the right sales tax for every sale. It uses your customer’s location, what you’re selling, and the latest tax rules to get the correct rates. This means you don’t have to check tax rates manually or track changes yourself.

If your business sells in multiple states or regions, tax rates can vary often. Managing this manually takes time and increases the probability for errors. When you connect Avalara with Zoho Billing, it automatically applies the correct tax rates and exemptions for each sale, helping you stay compliant with tax laws effortlessly.

## How Avalara Works

*   First, connect Avalara to your Zoho Billing organization by entering the required credentials.
*   When you add or edit an item, choose the correct **Tax Code** from the dropdown.
*   When you add or update a customer, ensure you enter a valid address to ensure correct tax calculations. If the customer is **Tax-Exempt**, add their **Exemption Number** or select the appropriate **Entity Code**. For customers outside the USA, enter their **Tax ID** and country details to fetch their tax information for transactions. This tax information includes the **Tax Rules**, **Rates**, **Exemptions**, and tax registration details based on the customer’s country. Zoho Billing then uses this information to calculate taxes correctly, apply, or exempt taxes on transactions according to local tax laws.
*   When you create sales transactions like _Quotes_, _Invoices_, or _Sales Orders_ and add items, Avalara automatically checks if each item is taxable, verifies the customer’s tax status, and applies the correct tax rate based on the customer’s address. You can adjust tax settings directly within the transaction form if needed. In the _Tax Details_ section, you can review the tax rates Avalara applied and update them manually for individual items or the whole transaction. You can also change the **Entity Code** while creating the transaction, but this change applies only to that specific transaction. To update the **Entity Code** for a customer permanently, go to the _Customer Details_ page and edit it there.

* * *

## Set Up Avalara in Zoho Billing

**Prerequisites:**

*   Keep your Avalara account’s **Account Number**, **License Key**, and **Company Code** (if available) ready before you start setting up Avalara in Zoho Billing. If you don’t have an account already, [set up your Avalara AvaTax account](https://knowledge.avalara.com/bundle/dqa1657870670369_dqa1657870670369/page/License_keys.html#:~:text=During%20onboarding%3A%20From%20the%20Welcome,select%20Get%20a%20license%20key.&text=Go%20to%20Settings%20%3E%20Integrations%2C%20then,then%20select%20Generate%20new%20key.) and continue with the following steps.
*   Avalara cannot be enabled if you’ve enabled the Sales Receipts module in Zoho Billing. This is because **Sales Receipts** record the sale and payment together, and Avalara needs to calculate taxes before the sale is completed. Ensure you’ve disabled Sales Receipts before you enable Avalara. To disable this module, go to **Settings** > **General** > under **Select the modules you would like to enable**, uncheck **Sales Receipts**, and click **Save**.
*   Also, make sure to enter **State** and **ZIP code** in _Profile_ under _Organization_ in the _Organization Settings_ pane before enabling Avalara.

To set up Avalara in Zoho Billing:

*   Log in to your Zoho Billing organization.
*   Go to **Settings**.
*   Select **Other Apps** under _Integrations & Marketplace_ in the _Extension and Developer Data_ pane.
*   Click **Connect** next to _Avalara AvaTax_.
*   In the _Integrate with Avalara_ popup, complete the following details:
    *   **Account Number:** Enter your Avalara account number. You can find it in your [Avalara Dashboard](https://identity.avalara.com/Account/Login) or in the welcome email sent when your account was created.
    *   **License Key:** Enter your Avalara license key. This key is unique to your account and required for integration. You need separate license keys for **Production** and **Development** accounts.
    *   **Company Code:** Enter the company code provided by Avalara. This code links the correct company in your Avalara account to this integration.
    *   **Mode of Connection:** Select **Development** to test the integration in a sandbox environment or **Production** to make it live.
*   Check **I understand how the Avalara integration works** to confirm the integration details and acknowledge how it functions in Zoho Billing.
*   Click **Integrate**.

**Insight:** When you set up the integration, Zoho Billing shares your **Address**, **Country**, and **Account Details** safely with Avalara AvaTax. AvaTax is Avalara’s cloud service that automatically calculates sales tax for every transaction. It checks where your customer is, what you are selling, and the latest tax rules to give you the correct tax amount.

**Note:** Avalara may apply charges for tax computations performed through Hosted Payment Pages.

* * *

## Select a Customer Address to Apply Taxes

For accurate tax calculations, Avalara needs to know which customer address to use when applying tax rates. By default, Zoho Billing uses the customer’s billing address, but you can change this based on your business needs. To choose a different address:

*   Go to **Settings**.
*   Select **Taxes** under _Taxes & Compliance_ in the _Organization Settings_ pane.
*   In the _Taxes_ pane on the right, select **Avalara**.
*   Under _Configure Integration_, click **Change** next to _Applicable For_ field and choose one of the following:
    *   **Use Billing Address:** Selected by default. Applies taxes based on the customer’s billing address.
    *   **Use Shipping Address:** Apply taxes based on the customer’s shipping address.
*   Click **Save**.

The selected address will now be used to fetch accurate taxes for transactions through Avalara.

* * *

## Apply Discounts in Transactions

When you integrate Zoho Billing with Avalara for automatic tax calculation, it’s important to handle discounts carefully because they directly affect how tax is calculated. Discounts can reduce the taxable amount, and Avalara needs to know how these discounts apply to ensure accurate tax rates. To support this, Zoho Billing allows you to apply discounts in three ways:

*   **At Line Item Level:** The discount is applied directly to individual line items.
*   **At Transaction Level:** The discount is applied proportionately across all items in the transaction.
*   **At transaction level with item selection:** If you check **Enable discount preference at the line item level**, a new _Apply Discount_ column appears in the item table of your transactions. You can then choose which line items to apply the transaction-level discount to. By default, the discount applies to all items.

This flexibility ensures that tax is calculated correctly based on how discounts are applied within each transaction. Learn [how to configure discounts for your organization](/billing/help/settings/preferences/general.html#general).

**Notes:**

*   If you choose _At the Line Item Level_, item rates cannot be **Tax-Inclusive**.
*   The **Discount**, **Amount**, **Sub Total**, and **Total** will be recalculated by Avalara after you save the transaction. As a result, the discount amount might take some time to appear in the **Item Table**.

* * *

## Automate Tax Calculation With Avalara

### Enter a Tax Code for an Item

After integrating Avalara with Zoho Billing, enter a **Tax Code** to each item to tell Avalara how to tax it in different locations. Avalara will then automatically check if the item is taxable and apply the correct tax rate in your transactions. To enter a tax code:

*   Go to **Items** under _Product Catalog_.
*   Click **\+ New** in the top right corner or edit an existing item by clicking the **Edit** icon in the top right corner of the _Details_ page.
*   In the _New Item_ or _Edit Item_ page, enter the **Tax Code** and fill in the other required details.

**Pro Tips:**

*   You can import multiple items into Zoho Billing in bulk with their **Avalara Tax Codes**. Just add a column named **Avalara Tax Code** in your import file, enter the tax codes for each item, and import the file into Zoho Billing.
*   For items you’ve already added, export the list of items, add a column for **Avalara Tax Code**, update the tax codes in the file, and re-import it to update them all at once. During the import, choose **Duplicate Handling** as **Overwrite Items**. This will replace the existing item details in Zoho Billing with the updated details from your file. This helps you quickly update tax codes for multiple items without editing them one by one.

*   Click **Save**.

Once you enter a tax code for an item, Zoho Billing will apply taxes based on that tax code in any transaction that includes the item. Later, when creating new items, you can select the same tax code from the dropdown if you want to use it again.

* * *

### Assign an Entity/Use Code and Exemption Number to a Customer (If Applicable)

Avalara automatically calculates tax based on the customer’s address. If a customer is tax-exempt, you’ll need to assign an Entity/Use Code and Exemption Number. To do this:

*   Go to **Customers**.
*   Click **\+ New** to add a new customer or edit an existing one by clicking **Edit** in the top right corner of the _Details_ page.
*   In the _New Customer_ or _Edit Customer_ page, go to the _Other Details_ tab and complete the following fields:
    *   **Entity/Use Code:** Choose the correct entity/use code if the customer is **Tax-Exempt** (e.g., a religious or charitable organization).
    *   **Exemption Number:** If the customer has a government-issued tax exemption certificate, enter the exemption number to make them tax-exempt in Zoho Billing.
*   Click the _Address_ tab at the bottom and enter a valid **Billing** and **Shipping** address. Avalara verifies the addresses using [Geolocation Technology](https://www.avalara.com/us/en/learn/whitepapers/zip-codes-the-wrong-tool-for-the-job.html) to ensure accurate tax rates.

**Insights:**

*   If the address is not verified, you will see **Not Verified** below the address. In this case, tax rates will be fetched using the **Zip Code**, but accuracy may be affected.
*   To verify the address, click **Verify Address** next to the **Address** field. Avalara then checks the address, corrects errors, and formats it according to postal standards. This ensures the most accurate sales tax rates based on the verified location. If the address is invalid or incomplete, you’ll be prompted to update it.

**Note:** Avalara uses the **Tax ID** and **Country Details** during customer creation to assign the required tax rates for the customers. Enter the other necessary details, and click **Save**.

* * *

### Modify the Entity/Use Code in a Transaction

You can modify an item’s tax status or a customer’s tax exemption code directly within a transaction for exceptions like:

*   A normally taxable customer needing tax exemption for a specific transaction.
*   A different shipping address affects tax rates.

To modify the _Entity/Use Code_ in a transaction:

*   Go to _Sales_ and select the transaction you want to create for the customer.
*   Click **\+ New** to create a new transaction.
*   In the _New Transaction_ page, choose the customer from the **Customer Name** dropdown.
*   In the _Entity/Use Code_ field, click the **Edit** icon to update the **Entity/Use Code**.

The _Entity/Use Code_ you have updated will now be applied to the customer for that specific transaction.

* * *

### Add Shipping Charges as a Line Item in a Transaction

Adding shipping charges as a line item ensures they’re included in tax calculations where applicable. If Zoho Billing is integrated with Avalara, it determines whether shipping is taxable based on the customer’s location. To add shipping charges as a line item in a transaction:

*   Go to _Sales_ and select the transaction you want to create.
*   Click **\+ New** in the top right corner.
*   Enter the required details. Next, in the _Item Table_, select the items for the transaction.
*   Click **\+ Add New Row** and enter **Shipping Charges** as the item name. In the _TAX CODE_ column, enter the relevant tax code for the item.
*   Click **Save as Draft** to save it as a draft, or **Save and Send** to send it to the customer.

The **Shipping Charges** item will now be automatically applied based on the selected tax code.

Alternatively, you can simplify the process by creating **Shipping Charges** as an item and then adding it to the transaction. To do this:

*   Go to **Items** under _Product Catalog_.
*   Click **\+ New** in the top right corner.
*   Under _Sales Information_, choose the account as **Shipping Charge** and fill in the other details.
*   Click **Save**.

Now, you can simply add **Shipping Charges** to any transaction by selecting it from the _Item Table_.

* * *

## Update Your Avalara Credentials

If your Avalara credentials expire, change, or you need to switch the connection mode while keeping the integration active, you’ll need to update your credentials in Zoho Billing. Also, credentials can become outdated if your Avalara password or API key is updated, the connection environment changes (like moving from sandbox to production), or if Avalara requires a security reset. To update your credentials:

*   Go to **Settings**.
*   Select **Taxes** under _Taxes & Compliance_ in the _Organization Settings_ pane.
*   In the _Taxes_ pane on the right, select **Avalara**.
*   Click **Update Credentials** in the top right corner.
*   Click **Save**.

Your Avalara credentials will now be updated.

* * *

## Disable the Integration

You can disable the Avalara integration at three levels:

*   **Disable Tax Calculation:** Taxes will not be calculated on any transaction created once this option is disabled.
*   **Disable Address Verification:** Avalara will no longer verify the addresses of the contacts to ensure accurate tax rates.
*   **Disable Avalara Integration:** The integration with Avalara will be completely disabled. You can then go back to using the sales tax rates you set up manually in Zoho Billing.

* * *

### Disable Tax Calculation

To disable tax calculation for Avalara:

*   Go to **Settings**.
*   Select **Taxes** under _Taxes & Compliance_ in the _Organization Settings_ pane.
*   In the _Taxes_ pane on the right, select **Avalara**.
*   Under _Configure Integration_, disable the **Tax Calculation** toggle.

Taxes will no longer be calculated on any new transactions created after this change.

* * *

### Disable Address Verification

To disable address verification:

*   Go to **Settings**.
*   Select **Taxes** under _Taxes & Compliance_ in the _Organization Settings_ pane.
*   In the _Taxes_ pane on the right, select **Avalara**.
*   Under _Configure Integration_, disable the **Address Verification** toggle.

Avalara will no longer verify your customers’ addresses.

* * *

### Disable the Entire Integration

To disable the entire integration:

*   Go to **Settings**.
*   Select **Taxes** under _Taxes & Compliance_ in the _Organization Settings_ pane.
*   In the _Taxes_ pane on the right, select **Avalara**.
*   Click **Disable Avalara Integration** in the top right corner.
*   In the popup that follows, click **Yes** to confirm.

The integration will be completely disabled, and you’ll be reverted back to [sales tax](/us/billing/help/sales-tax/) for tax calculations in your organization.