Configure the AvaTax integration

The Avalara AvaTax integration is the default tax processor integration.

This section applies to Open Storefront Framework (OSF) and Storefront Classic.

Commerce uses the tax processing settings you add when you configure the integration when it communicates with Avalara during tax calculations. See Understand tax processor integrations for overview information about all tax processor integrations.

You must have an active AvaTax account to use this integration. To learn how to sign up for an account and configure it, go to http://www.avalara.com.

Important: As a merchant, it is your responsibility to add the appropriate nexus jurisdictions to your AvaTax company tax profile. (You configure your company profile in your Avalara AvaTax Admin console.) Nexus jurisdictions tell AvaTax where and when to calculate and report tax. All sales that occur in jurisdictions you have not configured in AvaTax result in a tax calculation that returns a value of zero tax. Commerce is not responsible for configuring or validating nexus jurisdictions. Visit the Avalara Help Center at https://help.avalara.com to learn about nexus jurisdictions.

Before you begin, make sure you have the following information for your AvaTax account:

• The company code.
• The account number.
• The license key.

To configure the Avalara tax processing settings, follow these steps:

1. Click the Settings icon, then select Tax Processing.
2. Select Avalara from the Tax Processor list.

   By default, the Enable Tax Processor checkbox is selected for Avalara.

3. (Optional) Select Show Tax Summary to display an order’s tax amount in the cart, checkout, and order summary pages, or deselect it to hide the tax summary. This checkbox is selected by default.

   If your store’s prices include tax, such as VAT, you likely do not want to display the tax summary. However, if prices to not include tax, you should always display a tax summary.

   This setting has no effect on the display of the tax summary in the emails your store sends to customers. To learn how to remove the tax summary line from the order summaries in emails, see Customize tax display in templates.

4. Enter your Avalara Account Information.
5. Click Save.

The following table describes the Avalara Account Information properties.

Property	Description
Merchant ID	The company code for your Avalara AvaTax account.
Username	The account number for your Avalara AvaTax account.
Password	The license key for your Avalara AvaTax account.
URL	The web service URL for Avalara AvaTax.