Skip to main content
Avalara Help Center

Install and Configure Avalara AvaTax for Salesforce CPQ

This article applies to:Avalara AvaTax for Salesforce CPQ

After you activate AvaTax and set up your company profile, install and configure AvaTax for your accounting software. During configuration, customize your setup to fit your unique business needs for things like:

  • Tax calculation settings for various tax types
  • Exemption settings if you have exempt customers
  • Product taxability settings

Alter these settings when your business needs change.

Install AvaTax for Salesforce CPQ

Use information in the following sections to download and install AvaTax for Salesforce CPQ.


To connect your accounting software to AvaTax, download your integration software. 

  1. In AvaTax, on the Home tab, click Get Started.
  2. In the Download and Install Your Integration Software section, click Download Software
  3. In the Download Your AvaTax Connector Software window, click the arrow next to the name of your software, and then download the latest version of your integration. If the file isn't available for download, clear your browser's cache, and log back into AvaTax.
  4. Save the .zip file somewhere on your computer that's easy to find.
  5. Right-click the .zip file and extract the installation folder or file (.exe or .pdf or .msi). 

Install AvaTax for Salesforce CPQ

To download and install the AvaTax for Salesforce CPQ package:

  1. Open the installation folder you downloaded from AvaTax, open the PDF, and then click the package download link.
  2. On the Package Install page, select Install for All Users, and click Install.
  3. Click Done to complete the installation.


Configure AvaTax for Salesforce CPQ to work best for your business.

Configure AvaTax for Salesforce CPQ

To configure the AvaTax integration:

  1. On the Salesforce CPQ homepage, add a new tab to the menu by clicking + on the menu bar.
  2. Click Customize My Tab, add the AvaTax and Entity/Use Code tabs to the Selected Tabs field if they aren't already there, and then click Save.
  3. Click Setup. Search for Custom Settings and from the search results, click Custom Settings.
  4. In the Custom Settings page, go to AvaTax Salesforce Integration Setting row and click Manage. In the AvaTax Salesforce Integration Setting page, go to Default Organization Level Value, click New to add or Edit to modify the details, and then click Save.
    Field  Action
    Account Number Enter your AvaTax account number. You received it from Avalara in an email (subject line Important! Your AvaTax Production Account Number & License Key) when you signed up for your AvaTax account.
    License Key Enter your AvaTax license key. You received it in the same email as your account number when you signed up for your AvaTax account.
    Sandbox The default account type is Production. This selection changes the account type from Production to Sandbox.
    Company Code Enter the company code you entered when you activated your AvaTax account. Every accounting software that works with AvaTax uses a company code to identify itself to AvaTax.
    Address Enter the address details used for calculating sales tax for your transactions:
    • Street
    • City
    • State
    • Postal Code 
    • Country
    Active Select this checkbox to turn on sales tax calculations.
    Enable AvaTax address validation Select to allow AvaTax to validate addressesHoverTT.png that you enter in Salesforce CPQ.
    Note Note to test the AvaTax connection.
  5. In the AvaTax Salesforce Integration Setting page, go to Setup Owner to create multiple Salesforce CPQ profiles/organizations/users.
  6. On the AvaTax tab, click Test Connection, and then,
    • If you see a success message, then the configuration is successful.
    • If you see any other message, verify your account credentials and then try again.

Configure Salesforce CPQ layout

Configure the page layout of the Accounts, Products, and Quotes pages so that Salesforce CPQ displays fields necessary for AvaTax to calculate tax:

  1. On each page, click Edit Layout, and then click Fields.
  2. In the Detail section of each page, add the following fields and buttons:
    Page Fields Buttons
    Account Layout
    • Entity/Use Code
    • Exemption Number
    • Validate Addresses
    Product Layout
    • Tax Code
    • Sales Tax Amount
    • Calculate Tax
    • Validate Addresses
    Quote Line Detail
    • Sales Tax Amount
    • Sales Tax Details