Skip to main content
Avalara Help Center

Install and Configure Avalara AvaTax for Salesforce

This article applies to:Avalara AvaTax for Salesforce

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

Update these settings when your business needs change.


There are two software packages that enable you to calculate tax on Opportunities. There are also two optional packages: one for Quotes and the other for Orders.

Download AvaTax for your accounting software

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, .pdf, or .msi). 

Install AvaTax for your accounting software

Ensure that SDK and Core (Opportunities) packages are installed before you install/upgrade Quotes and/or Orders.

To download and install the package:

  1. Open the installation folder you downloaded from AvaTax, open the PDF, and then click the Package Location download link.
  2. On the Package Install page, select Install for All Users, and then click Install.
  3. On the Approve Third-Party Access screen, click Yes, grant access to these third-party web sites to access the AppExchange, and then click Continue.
  4. When the installation completes, click Done.
  5. Ensure that the user has full access permissions for Avalara custom objects (UDLs and UserMessages).


AvaTax for Salesforce is highly customizable and lets you set your own layout either automatically or manually.

Customize your account

To add account tabs and account details:

  1. On the Salesforce homepage, add a new tab to the menu by clicking + on the menu bar.
  2. If they aren't listed under Selected Tabs, select whichever of the following are missing, and then click the Add button:
    • Avalara
    • ShippingCodes
    • Entity/Use Code
    • Accounts
    • Contracts
    • Order
    • Products
    • Contact
  3. On the Avalara tab, click Go!.  
  4. To edit your account credentials, click Edit, add or modify the following, and then click Save:
    Section Field and action
    Avalara Account Detail
    • Avalara Account Name: Select AvaTax.
    • Active Avalara Setting: Select to enable.
    Avalara Credentials
    • Account ID and Key: Use the information provided in an email from Avalara (sent to the email account you used to activate your account). It must match what's saved in AvaTax.
    • User Name and Password: Use the information provided in an email from Avalara (sent to the email account you used to activate your account). It's the same credentials you use to log in to AvaTax.
    • URL: Enter if you have an AvaTax development account or if you have an AvaTax production account.
    • 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.
    Origin Address Enter the address used for calculating sales tax using AvaTax for your transactions.
    Address Validation Settings
    • Enable AvaTax address validation: If you disable address validation, AvaTax uses the customer's ship-to address to calculate the correct sales tax. Sales tax might be calculated incorrectly if this option is disabled.
    • Optional: Verify Validated Addresses: Select to manually replace unvalidated addresses with validated addresses in Salesforce. Clear to make validated addresses replace unvalidated addresses automatically.
    • Optional: Use Billing Address for Tax Calc: Select to have AvaTax ignore the shipping address and use the billing address to calculate sales tax.
    • Optional: Return address in upper case: Select to save all address validation results in uppercase format.
    Tax Calculation Settings
    • Enable AvaTax tax calculation: If you choose to disable tax calculation, your accounting software no longer uses AvaTax to calculate tax on transactions.
    • Optional: Save transaction as a Commit on AvaTax: Select to commit sales opportunities and sales quotes to AvaTax. Once a document is committed to AvaTax, you can't change some details, such as line amounts.
    • Optional: Save transaction as a UnCommitted Invoices on AvaTax: Select if you want AvaTax to calculate sales tax on a Salesforce opportunity or quote. As a result, Salesforce saves an uncommitted invoice to AvaTax. Clear to make AvaTax calculate sales tax on sales and sales quotes. This option doesn't save uncommitted invoices to AvaTax. 
    • Optional: Re-calculate Tax upon Invoice Editing: Select both this and Enable Tax Calculations to have AvaTax calculate sales tax when you save the quote or opportunity if a value that will affect the calculation changes, such as address, amount, or quantity. You may pay more for your AvaTax service if you select this because it increases the number of transactions that you send us.
    • Enable Tax Code Mapping: Enable to map items to Avalara tax codes to account for varying taxability of products and services. 
    • Optional: Use Account Name for Cust Identification: Select to have AvaTax use the account name instead of the account ID for the customer number in calculations. AvaTax calculations normally use the account ID (the last 15 digits in the URL on a page) for the customer code.
    • Optional: Enable Entity/Use Code: Enable to map entity/use codes for your customer addresses to flag them as exempt from sales tax.
    • Optional: Allow Tax Override: Select to allow AvaTax to override the tax amount.
    • Shipping Code: Select to add shipping codes and send them to AvaTax.
    • Optional: Finalized Status/Stage: Select both Automatic Tax Calculation and Enable Commits to make an invoice commit to AvaTax when you save and the status (Quotes) or state (Opportunities) settings are configured with this value. We recommend leaving this blank.
    • Optional: Enable UPC Code as ItemCode: Select to send a UPC instead of an item code to AvaTax. Using this feature may trigger additional fees. Talk to your Customer Account Manager (CAM) for more information.
  5. Click Test Connection, and then:
    • If you see a success message, click OK.
    • If you see any other message, correct the information in the fields, and then try again.
  6. To set up your tax profile, click Create Tax Profile, select the locations where you're registered to collect and remit tax, and then click Enable Tax Jurisdiction(s).
  7. Optional: To create an additional company, click Create Company, add the company details, and then click Setup Company Profile.
  8. Optional: To validate the origin address, click Validate Origin Address.

Customize page layout automatically

To automatically customize the page layout of the Quotes, Orders, Contracts, Opportunities, Accounts, and Products pages:

  1. On each page, click Page Layouts, and then:
    • To create a new layout, click New.
    • To edit an existing layout, click Edit
  2. After creating page layouts, to set and control the page layout displayed by default, click Page Layout Assignment. The table displays the page layout assignments for different profiles.
  3.  Click Edit Assignment button, select the row for System Administrator, and then, from the Page Layout To Use list, select Order (TaxNow) Layout.
  4. Click Save.

Customize page layout manually

To manually customize the page layout of the Quotes, Orders, Contracts, Opportunities, Accounts, and Products pages:

  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
    • S&H Tax
    • Avalara Status
    • Tax Now Status
    • Calculate Sales Tax
    • Finalize Quote
    • Validate BillTo
    • Validate ShipTo
    Quote Line Item
    • Sales Tax Amount
    • Sales Tax Details
    • Sales Tax Rate
    • Avalara Tax Code
    • Sales Tax
    • Shipping Tax
    • Non-Taxable
    • Shipping and Handling
    • Avalara Status
    • Tax Now Status
    • Calculate Sales Tax
    • Finalize Order
    • Validate Billing Address
    • Validate Shipping Address
    Order Product
    • Sales Tax Amount
    • Sales Tax Details
    • Sales Tax Rate
    • Sales Tax
    • Shipping Tax
    • Non-Taxable
    • Shipping and Handling
    • Avalara Status
    • Tax Now Status
    • Billing Contact
    • Shipping Contact
    • Calculate Sales Tax
    • Finalize Opportunity
    Opportunity Product
    • Sales Tax Amount
    • Sales Tax Details
    • Sales Tax Rate
    • Entity/use code
    • Exemption Number
    • Validate Billing Address
    • Validate Shipping Address
    • Tax Code 
    • UPC