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 Update and set up your company profile, install and configure AvaTax Update 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.


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 your integration

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

  1. In Avalara Account, go to Connectors.
  2. Click the arrow next to the name of your software to download the connector you need.
  3. In your Downloads folder, right-click the .zip file and extract the installation folder or file (.exe or .pdf or .msi). 

Install your integration

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 Update, open the PDF, 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 Update 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 activate this account.
    Avalara Credentials
    • Account ID: Enter your AvaTax Update 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 Update account.
    • Key: Enter your AvaTax Update license key. You received it in the same email as your account number when you signed up for your AvaTax Update account.
    • User Name: Enter your AvaTax Update user name. You received your username from Avalara in an email (subject line AvaTax Account Login) when you signed up for your AvaTax Update account.
    • Password: Enter the password you use when you log into AvaTax Update.
    • URL: If you have an AvaTax Update development account, enter If you have an AvaTax Update production account, enter
    • Company Code: Enter the company code you entered when you activated your AvaTax Update account. Every accounting software that works with AvaTax Update uses a company code to identify itself to AvaTax Update.
    Origin Address Enter the address used for calculating sales tax using AvaTax Update for your transactions.
    Address Validation Settings
    • Enable AvaTax address validation: Select to allow AvaTax Update to validate addressesHoverTT.png that you enter in Salesforce.
    • 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 Update ignore the shipping address and use the billing address to calculate sales tax.
    • Optional: Return address in upper case: Select to have address validation results returned in uppercase letters.
    Tax Calculation Settings
    • Enable AvaTax tax calculation: Select this checkbox to make AvaTax Update sales tax calculations work with Salesforce.
    • Optional: Save transaction as a Commit on AvaTax: Select to commit sales opportunities and sales quotes to AvaTax Update. Once a document is committed to AvaTax Update, you can't change some details, such as line amounts.
    • Optional: Save transaction as a UnCommitted Invoices on AvaTax: Select if you want AvaTax Update to calculate sales tax on a Salesforce opportunity or quote. As a result, Salesforce saves an uncommitted invoice to AvaTax Update. Clear to make AvaTax Update calculate sales tax on sales and sales quotes. This option doesn't save uncommitted invoices to AvaTax Update. 
    • Optional: Do you want Automatic Tax Calculation: Select both this and Enable Tax Calculations to have AvaTax Update 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 Update service if you select this because it increases the number of transactions that you send us.
    • Enable Tax Code Mapping: Select to allow AvaTax Update to map tax codes to an item
    • Optional: Use Account Name for Cust Identification: Select to have AvaTax Update use the account name instead of the account ID for the customer number in calculations. AvaTax Update 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: Select to allow Salesforce to send the entity/use code to AvaTax Update.
    • Optional: Allow Tax Override: Select to allow AvaTax Update to override the tax amount.
    • Shipping Code: Select to add shipping codes and send them to AvaTax Update.
    • Optional: Finalized Status/Stage: Select both Automatic Tax Calculation and Enable Commits to make an invoice commit to AvaTax Update 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 the UPC as the ItemCode.
  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 your 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 your 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
  • Was this article helpful?