Setting Up Avalara Integrations

This guide explains the steps to configure your aACE system for integration with Avalara services AvaTax and CertCapture. It is intended for system administrators.

Before configuring your system for the aACE+ AvaTax and aACE+ CertCapture Integrations, you should be familiar with aACE's tax profile functionality. The AvaTax integration can work with your tax profiles in various ways:

  • A single tax profile can be set as the default for all orders to rely on AvaTax exclusively.
  • Specific tax profiles can be set up for all states where you have nexus, drawing tax rates from AvaTax.
  • Additional tax profiles can be set up for jurisdictions where you are not responsible for collecting sales tax. These tax profiles should be set to 0% to prevent unnecessary requests to AvaTax. This can help reduce the expense of your AvaTax subscription.

Note: AvaTax also provides functionality to file your state taxes, which may affect your decisions for configuring this integration.

Additionally, CertCapture works with your Company records for organizations that have been flagged as tax exempt.

Steps for AvaTax and CertCapture Integration

aACE+ Avalara AvaTax integration addresses your sales tax challenges with a cloud-based service that calculates sales and use tax, files returns, and remits payments across North America and beyond. aACE+ Avalara CertCapture automates your exemption certificate management to ensure your documentation is always up-to-date.

For your aACE+ Avalara integration, proceed with the following steps: 

  1. Create your AvaTax account
  2. Configure aACE+ AvaTax settings
  3. Configure aACE office settings
  4. Configure aACE line item code settings
  5. Configure aACE tax profiles

Note: The purpose of this process is to help ensure you are not charged for unneeded tax data requests. Avalara charges for each request that is submitted. If a certain office, line item code, or tax profile should not be taxed, there is no need to request tax data for it. The time you invest in configuring your AvaTax integration can reduce your expenses.

1. Creating an AvaTax Account

Contact an Avalara representative to set up your AvaTax account at www.avalara.com. Explain that you require an "aACE Connector". Your account representative will provide this and other details on how to create your account and obtain the needed credentials. 

Note: After you receive your credentials (e.g. account number, license key, etc), keep the information secured. You will use it later in setting up your aACE+ AvaTax integration.

2. Configuring AvaTax Preferences

To enter your AvaTax credentials and basic setup information, navigate from Main Menu > System Admin > aACE Tax Automation > AvaTax:

Avalara Setup

  • Enable AvaTax — Mark this flag to set other integration details.
  • Test Button — After entering your credentials, you can click this button to verify your connection.
  • Test Mode — If you are working with aACE in a sandbox environment, you may need to activate Test Mode. Otherwise, leave this flag cleared. Test mode will not correctly access an AvaTax production account.
  • Account Number, License Key, and Company Identifier — Enter the Account Number and License Key, then press Get to populate the Company ID field.
    Note: The Company Identifier field is for the Avalara CertCapture integration and may be left blank when configuring aACE for the AvaTax integration.
  • Disable tax calculation — Mark this flag to turn off automatic tax calculations when saving orders and invoices.
  • Disable document recording — Mark this flag to get tax estimates without saving the invoice details in AvaTax.
  • Disable logging — Mark this flag to turn off automatic logging. When logging is enabled, aACE will store a complete log of the raw request sent to AvaTax and raw data received in response.
  • Use tax codes from order when invoicing — Mark this flag to pull the AvaTax code from the related order item instead of the line item code (LIC). This keeps the tax codes consistent between the order and the invoice, even if the LIC settings change between when an order is placed and when it is invoiced.
  • Enable CertCapture — Mark this flag to enable aACE's CertCapture integration.
  • Turn On Button — After entering your CertCapture credentials in the Company Identifier field above, you can click this button to turn on CertCapture.

Querying Tax Codes

In order to manually query the tax codes for a particular LIC or group of LICs, follow these steps:

  1. Enter the keyword for the LIC you wish to update in the Query Tax Codes field and click Search.
  2. The field below will populate with matching tax codes from your AvaTax account. Highlight the abbreviation of the relevant tax code and copy it to your clipboard. Then refer to the steps outline in "Configuring Line Items Codes" below.

Note: If you encounter difficulties with connecting to AvaTax, contact your Avalara representative.

3. Configuring Offices

You can set up multiple business entities to access your AvaTax account. aACE 'office' records correspond to AvaTax 'company' records. Note: This does not use your AvaTax Company ID. Instead, your Company Code can be found by logging in to your AvaTax portal and navigating to Company Settings.

After you have your AvaTax Company Code, navigate in aACE from Main Menu > Internal > Offices, then locate the desired office record. In the Setup tab, enter the AvaTax Company Code in the Tax Automation Code field:

Note: To reduce expenses, if one of your business entities does not collect taxes, do not enter a Tax Automation Code for it.

4. Configuring Line Item Codes

You must enable AvaTax for each LIC that should have sales tax automatically calculated.

Navigate from Main Menu > Order Setup > Line Item Codes. In the Setup tab for each applicable LIC, under the Preferences section, mark the flag to Enable AvaTax:

You can also set a tax code that AvaTax will use to calculate tax rates. (For details, contact your Avalara representative.)

System administrators can update the following settings for batches of LICs:

  1. At the Line Item Codes module, use the Quick Search bar to locate all the LICs you need to update.
  2. In the footer, click the Admin Actions icon ().
  3. Click the link for the desired update:
    • Update Tax Automation Setting for Line Item Codes in List — This changes the Enable Tax Automation preference for all LICs currently listed. Click Y-True to mark this flag or click Y-False to clear this flag.
    • Update Tax Code for Line Item Codes in List — This leverages the import process to update LICs. You can prepare an Excel spreadsheet with specific tax codes you receive from your Avalara representative, then import that data to modify the current records.

Note: To reduce your expenses, if certain LICs do not require sales tax, do not enable the AvaTax preference for them.

5. Configuring Tax Profiles

aACE tax profiles can be set up in different ways depending on your business needs. Navigate from Main Menu > Accounting > Tax Profiles, then locate the desired tax profile.

Any record linked to a tax profile that has the Enable for tax automation flag marked will be processed through AvaTax. Make sure the tax profile is linked to an appropriate GL Account to receive the tax values that come back from AvaTax.

The simplest implementation is often to have a single, default tax profile with AvaTax enabled, but additional tax profiles can be useful:

  • If you want the tax values calculated by AvaTax to be tracked in the general ledger (GL) using various criteria. For example, you may want a different GL Account for taxes for each state you do business in. This would require setting up a tax profile for each of these states.
  • If you want the AvaTax tax calculation to be disabled for a certain group of companies, such as those in a certain jurisdiction for which your AvaTax account is not set up to calculate.