Looking for the v10 manual? Visit our new user's guide!
Search Descriptions Version
This article applies to: MultiStore

Avalara Avatax Integration v9.2.0.0+

While AspDotNetStorefront supports manually configuring tax rates for your store, many stores will not want to take the time to set up and manage tax rates for all the areas they sell in. To help with this, we have integrated with the AvaTax service, from Avalara! With AvaTax, you can spend a few minutes setting up your taxes and then forget about them! Avalara handles all of the tax rate setup and updates for you. Note that you must be running on a current version of the MultiStore platform to use the Avalara Addin.

This page covers the setup of the Avalara Addin in version

NOTE: Although includes the Avalara connector, the storefront version is no longer fully supported and assistance from the free Help Desk is limited.

Setup is easy, and only takes a few minutes. It is broken into 2 main parts:

Installing the AddIn

1 - First, you'll need to get an account with Avalara. The service we integrate with is called 'AvaTax OnDemand', so make sure that's what you sign up for!

2 - Set the following AppConfig with information from your new Avalara account:

AvalaraTax.Account - This is your account number. It shows at the top left of the page while logged into your Avalara account.

AvalaraTax.License - This is the license key given to you by Avalara when you first sign up for your account.

AvalaraTax.ServiceUrl - This is the web service URL provided by Avalara that the system should call for live rates. The dev/test URL is https://development.avalara.net

AvalaraTax.CompanyCode - This is the the company code you create within your Avalara account, under the 'Organization' tab.

AvalaraTax.Enabled - This setting turns the Avalara integration on and off.

3 - (NOTE: Admins on version 9.3 or higher can skip to step 6 ) In the store admin site, navigate to Configuration -> Advanced -> AddIn Manager. Verify that there is an entry in the list of registered addins called 'ITaxRates'.

4 - On that same page, click the 'Rebuild Addin Cache' link at the upper left.

5 - Set the Addins.Enabled AppConfig to true.

6 - Set the RTShipping.Origin AppConfigs to the address you want to use as your 'origin' address when computing taxes. Note that if you are using realtime shipping rates, this step will already have been done.

7 - Set the Configuration - Taxes - Product Tax Classes Tax Code value to "FR" for the Shipping tax class.

8 - Click the 'Reset Cache' link in the admin console.

NOTE: The character length of your Customer Level names (if used) must not exceed 25 including spaces. Exceeding this length will throw an error when retrieving Avalara rates.

NOTE: You can map products to specific Avalara tax codes using the "Tax Code" field in the Product Tax Classes.

Configuring your Avalara Account

1 - First you will need to login to your Admin Console. For testing purposes you can use the URL of https://admin-development.avalara.net. Once there click on the Organization tab.

Next, we're going to need to setup an Organization from which to base our taxes on. This entity will possess quite a few possible configurations, depending on your company and business model. If at any time you are not sure about a specific value or configuration options, please consult a tax specialist or Avalara's support team to alleviate any unwanted side effects of incorrect taxation. AspDotNetStorefront cannot advise on the taxes you need to collect or how to configure your Avalara account.

2 - Click the 'New' button, which will begin a 'Company Setup Wizard'. Run through these prompts, entering the information for your company. Once that is complete, you should end up back on the Organizations tab, with an entry for the company you just set up.

3 - Click on the green N button under the 'Nexus' column for your new company, and you'll see the 'Edit' button. Click that, and you‟ll be taken to an area which allows you to choose which countries you'd like to apply tax for. By adding the United States (Check the box and save), you'll now have access to all 50 states and the ability to apply a nexus in each of them.

4 - Click the 'United States' hyperlink on the (AvaTax/GlobalNexus/NexusCountryList.aspx) page, and you'll be taken to this URL (AvaTax/GlobalNexus/NexusRegionList.aspx?CountryId=US). Click the 'Edit' button once more, and you will see a list of the US states.

5 - Check the states you'd like to have a nexus in and then save your selections.

6 - At this point, your Avalara Account should be configured for proper use.

You have now successfully installed the AvalaraTax AddIn. You can test it by going through the checkout process, and checking the tax values that are being returned for the Nexus regions you enabled.

NOTE: Be sure your Customer Level names are no longer than 25 characters in length including spaces, or Avalara could throw an error when the order is placed.