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 AvaTax Update for your accounting software

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

  1. In AvaTax Update, go to Settings > Manage Account. Avalara Account opens in a new tab.
  2. In Avalara Account, go to Connectors.
  3. Click the arrow next to the name of your software to download the connector you need.
  4. In your Downloads folder, right-click the .zip file and extract the installation folder or file (.exe or .pdf or .msi). 

Install AvaTax Update 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 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 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 Update.
    • 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 Update.
    • URL: Enter if you have an AvaTax Update development account or if you have an AvaTax Update production account.
    • 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: If you disable address validation, AvaTax Update 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 Update 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 Update to calculate tax on transactions.
    • 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: Re-calculate Tax upon Invoice Editing: 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: 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 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: 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 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 a UPC instead of an item code to AvaTax Update. 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
  • Was this article helpful?