Table of Contents

Avalara: Overview & Setup

Kristen Fiddes Updated by Kristen Fiddes

Read Time: 7 mins

Avalara is not yet universally available within Sonar V2 currently, but will be coming soon! This article is available to read more on the feature ahead of its release.

What is Avalara?

Avalara helps automate all of your tax compliance within Sonar. It's a tax automation tool for businesses that automatically calculates in real-time tax calculation and automatic returns filing.

For additional resources from Avalara, check out the links below:

Avalara Basic Explanation Video:

Avalara API documentation:

Why Would You Want to Use Avalara?

While Sonar does offer the capability to calculate and manage taxes within your instance, this could quickly become a very involved and manual process due to ever-changing tax jurisdictions. 

It’s still your responsibility to keep up with the ever-changing tax jurisdictions across the various countries and regions where you offer service to customers. Anytime one of those tax jurisdictions makes a change, you’re responsible for updating it within your instance in order to stay compliant. As your company grows and expands coverage, it can become a hassle to keep track of everything while remaining compliant, and manual tax compliance can cost your business thousands of dollars in time and effort.

Avalara makes it easy to stay compliant, no matter how big or small your company is. Their platform works on a global scale to keep track of tax rates and taxability rules for millions of products and services in real-time for more than 12,000 tax jurisdictions.

However, calculating taxes is just one part of the equation. You are also required to file and remit payments back to the proper jurisdictions by individual deadlines - Avalara handles and automates this part of the process as well.

How Much Does Avalara Cost?

Avalara operates on a volume-based pricing model designed to scale with your business. For more information on pricing and plans offered by Avalara, check out their Products & Pricing FAQ.

How to Configure Avalara in Your Instance

The steps needed to implement Avalara in your instance are outlined further below.

T/S Pair is a set of two number pairs that Avalara uses to determine the tax rates. Sonar refers to the pair as "Tax Type"

How to Apply Avalara to Companies

Whether you have a single company configured in your instance or multiple, you will need to set the ISP Type for each using Avalara. The type should match whatever is defined with your Avalara account.

  1. Navigate to Settings > Companies.
  2. Click on the Edit button alongside the applicable company title.
  3. In the new modal, locate ISP Type and use the dropdown below it to select the type.
Avalara only defines two ISP types (ILEC and non-ILEC); further specificity is provided within Sonar, however, any selection made from the list that is not "ILEC" will be treated as "non-ILEC" for Avalara.

How to Add Avalara as a Tax Provider

Navigate to Settings > Billing > Tax Providers and then click on Create Tax Provider

The Create Tax Provider window will then appear, where you'll need to fill out the tax provider information. An overview of this window and the fields contained within it is provided below.

  1. If you have multiple tax options set up in your instance, the Name will help distinguish them when you're tying services to a Tax Type.
  2. The Type field is where you'll select Avalara, and if the intent is for this to become the default method within your instance then you would also check the "Enabled" box.
  3. Selecting States to Include in Tax Calculation provides a dropdown where you will select all applicable states.
  4. The fields below Tax Provider Credential are where your Avalara credentials are to be input - these would be the same credentials you use to access Avalara's login page.
  5. The two options available in the dropdown for Avalara service type are "Primarily Local" and "Primarily Long Distance" - here you would select whichever you were directed to use by Avalara.
  6. The check boxes alongside Avalara facilities based, Avalara franchise agreement and Avalara regulated are to be used as directed by Avalara.

How to Apply Avalara to Services

Each service you intend to use with Avalara needs to be configured individually - this can be done as you create a new service or when editing an existing service.

Avalara should be consulted when attaching "Tax Types" as the T/S Pair used are dependent on the type of service.
  1. Navigate to Settings > Billing > Services.
  2. Open the modal by clicking Edit Service alongside the service (or by using the creation button at the top of the modal, if you are creating a new service).
  3. Scroll to the bottom of the modal to locate Tax Type and Discount Tax Type; this is where you will input the applicable tax types as determined by Avalara. Any custom bundles created in your instance are able to be used here too. For more information on creating Avalara custom bundles, please refer to the section below.
The "Taxes" field is different from "Tax Type" and should only be used when not using Avalara. You should only have one or the other in use at a time.

  1. Click on Save.
Creating an Avalara Custom Bundle

Custom Bundles are built by Avalara dependent on specific classifications. When used, a custom T/S Pair is provided by Avalara to be added to your instance. The steps below detail how to do this so that it can be leveraged on customer accounts.

  1. Navigate to Settings > Billing > Avalara Custom Bundles.
  2. Click on Create Avalara Custom Bundle.
  3. In the new modal, add a name for the bundle and then input the Avalara-provided T/S Pair under Service Type.
  4. Click on Create.

How to Apply Avalara to Voice Services

  1. Navigate to Settings > Billing > Services.
  2. Locate the applicable voice service and then click on the gray GP button found on the same line as the service.
  3. In the newly populated table, click on Edit Generic Parameter.
  4. Underneath Tax Type, add in the appropriate types as directed by Avalara.
  5. Click on Save.

Viewing Taxes on a Customer Account

  1. While in a customer account, navigate to Billing > Transactions.
  2. At a glance, the tax charged is visible under the Amount column (shown underneath the service charge and in a smaller font size).
  3. For a further breakdown, click on the corresponding date to expand another menu.
  4. With the newly populated menu visible, select Tax Transactions.
  5. Here, we can identify which tax types were included in this transaction and get a breakdown of each types charge if there are multiple included.
In the event of a transaction reversal, only the service charge is required to be input. The tax charged is automatically calculated and reimbursed by Avalara.

Viewing and Adding Tax Exemptions

Tax Exemptions may be required in certain circumstances, such as servicing a non-profit; in this event, you will need to add an exemption to the customer account.

  1. While in a customer account, navigate to Billing > Avalara.
  2. Click on Create.
  3. In the new modal, add a name that best reflects the tax exemption. Use the dropdown below Jurisdictions to select the appropriate inclusions. And finally, use the dropdown underneath Categories to select the tax types they are exempt from.
  4. Once complete with the modal, click Create.

To view existing exemptions on an account, navigate to Billing > Avalara and you will see a list detailing the exemption name, the jurisdictions, and the tax provider. Exemptions can be edited using the Edit button alongside the line item, or deleted by clicking on the downward arrow and selecting Delete.

Where to Locate Error Logs

Error Logs can be found in two separate locations within your instance; on each customer account and within your instance settings.

For the customer account-specific errors, navigate to Billing > Avalara. Underneath the header Tax Provider Errors, you will see a list including the detailed error message along with date and time of the error.

The complete list of errors in your instance can be found by navigating to Settings > Tax Provider Errors. Each line item includes a message detailing the error, a link to the associated customer account, and the date and time of the error.

How did we do?

Usage Based Billing Policy Free Periods: Overview and Usage