Skip to main content
Avalara Help Center

Install and Configure Avalara AvaTax for Salesforce

Now that you've activated your AvaTax account and set up your tax profile, it's time to install and configure your integration. At the end of this process, you'll send a test transaction to confirm that AvaTax is calculating tax the way you expect. After running a successful test, you'll be able to start using AvaTax!

Install

Start by installing 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. You'll get more detail in the steps below.

Download your integration

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

  1. In the Admin Console, 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 the Admin Console.
    Integration - download_install 2.png
  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 your integration

Ensure that SDK and Core packages are installed before you install/upgrade Quotes and/or Order.

  1. To download and install the package, click the package download link in the .pdf in the package.
  2. On the Package Install page, select Install for All Users and click Install.
  3. On the Approve Third-Party Access screen, at the bottom, click Yes, grant access to these third-party web sites to access the AppExchange, and then click Continue.
  4. While it is installing, the following message is displayed:

    Salesforce_Install3.png

  5. Click Done.
  6. Verify the installed packages.

    Salesforce_Install5.png

  7. When you finish the installation, you'll see a page that says Installed Packages, and it's time to configure AvaTax for Salesforce.

Configure

After you install AvaTax for Salesforce, you need to configure and customize your integration. Salesforce is highly customizable and lets you set your own layout either automatically or manually.

Customize your account

This section walks you through the steps to add account tabs and account details.

  1. On the Salesforce homepage, add a new tab to the menu by clicking +.
     

    Add a Tab
     

  2. If this is your first installation of AvaTax for Salesforce, add Avalara, ShippingCodes, Entity/Use Code, Accounts, Contracts, Order, Products, and Contact tabs. If you've previously installed AvaTax for Salesforce, make sure that the Avalara, ShippingCodes, and Entity/Use Code tabs are added.
    Select Tab
  3. Click the Avalara tab, and then click Go!
  4. Under Avalara Account Name, click AvaTax.
  5. On the Avalara Detail page, next to Avalara Account Detail, click Edit.
  6. In the Avalara Edit page, under Avalara Account Detail, check the box next to Active Avalara Setting
  7. Under Avalara Information, fill in all the fields except the Last Validated field.
  8. Under Address Validation Settings and Tax Calculation Settings, be sure to enable AvaTax Tax Calculation. Enable tax calculation and some of the other fields are described below:
    • Some Address Validation Settings
      • Enable Address Validation: Select this checkbox to allow AvaTax to validate addressesHoverTT.png that you enter in Salesforce.
      • Verify Validated Addresses: Select this checkbox to manually replace unvalidated addresses with validated addresses in Salesforce. Clear this checkbox to make validated addresses replace unvalidated addresses automatically.
      • Use Billing Address for Tax Calc: Select this checkbox to have AvaTax ignore the shipping address. In this case, AvaTax uses the billing address for the destination address to calculate sales tax.
    • Some Tax Calculation Settings
      • Enable AvaTax tax Calculation: Select this checkbox to make AvaTax sales tax calculations work with Salesforce.
      • Save transaction as a Commit on AvaTax: Select this checkbox to commit sales opportunities and sales quotes to AvaTax. Once a document is committed to AvaTax, you can't change some details like line amounts.
      • Save transaction as a UnCommitted Invoices on AvaTax: Select this checkbox if you want AvaTax to calculate sales tax on a Salesforce opportunity or quote. As a result, Salesforce saves an uncommitted invoice to the Admin Console. Clear this checkbox to make AvaTax calculate sales tax on sales and sales quotes. This option doesn't save uncommitted invoices to the Admin Console. 
      • Do you want Automatic Tax Calculation: If you select both this and the Enable Tax Calculations checkbox, AvaTax calculates sales tax when you save the quote or opportunity if a value that will affect the calculation such as address, amount, or quantity changes. You may pay more for your AvaTax service if you select this checkbox because it increases the number of transaction that you send us.
      • Enable Tax Code Mapping: Select this checkbox to allow AvaTax to map tax codes to an item
      • Use Acct Name for Avalara Cust Num: AvaTax calculations normally use the account ID (the last 15 digits in the URL on a page) for the customer code. Select this checkbox to have AvaTax use the account name instead of the account ID for the customer number in calculations.
      • Enable Entity/Use Code : Select this checkbox to allow Salesforce to send the entity/use code to AvaTax.
      • Allow Tax override: Select this checkbox to allow AvaTax to override the tax amount.
      • Shipping Codes: Select this checkbox to add shipping codes and send it to AvaTax.
      • Finalized Status/Stage: Select both the Automatic Tax Calculation and Enable Commits checkboxes 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.
      • Enable UPC Code as ItemCode: Select this checkbox to send the UPC as the ItemCode.
      • Enable Log:  Select this checkbox to log the activity and error messages.
  9. At the bottom, click Save, and at the top of the page, click Test Connection. Ensure that you have entered the correct Company Code before you test the connection.
  10. On the next page, next to Test Connect Returned, if you see a Success message, you have configured AvaTax for Salesforce correctly. Click OK.
  11. To set up your tax profile, click Create Tax Profile.
    1. On the Nexus page, select the locations where you're registered to collect and remit tax.
    2. Click Enable Tax Jurisdiction(s).
  12. To create a new company, click Create Company. On the Company Profile page, add the address details, Business Tax Identification Number (TIN), and contact details. Click Setup Company Profile. You can verify the new company details in the Admin Console.
  13. To validate the origin address, click Validate Origin Address.

Customize your page layout automatically

Follow these steps to automatically customize your page layout for Quotes, Orders, Contracts, Opportunities, Accounts, and Products. If you want to customize your page layout manually, see the section below.

  1. On the Salesforce toolbar, click the User menu, and then click Setup.
  2. For Quotes, go to App Setup > Customize > Quotes. Click the Page Layouts option.

    Autocustomization

  3. This page lets you create page layouts to display Order data. To create a new layout, click New or to edit an existing layout, click Edit. After creating page layouts, click the Page Layout Assignment button to set and control the page layout displayed by default.
  4. The table displays the page layout assignments for different profiles. Click Edit Assignment button.
  5. Select the row for System Administrator and from the Page Layout To Use drop-down list, select Order (TaxNow) Layout. Click Save.

    Autocustomization

  6. For Opportunities, go to App Setup > Customize > Opportunities. Click Page Layouts option and follow steps 3 to 5.
  7. For Orders, go to App Setup > Customize > Orders. Click Page Layouts option and follow steps 3 to 5.
  8. For Contracts, go to App Setup > Customize > Contracts. Click Page Layouts option and follow steps 3 to 5.
  9. For Accounts, go to App Setup > Customize > Accounts. Click Page Layouts option and follow steps 3 to 5.
  10. For Products, go to App Setup > Customize > Products. Click Page Layouts option and follow steps 3 to 5.

Customize your page layout manually

Follow these steps to manually customize page layout for:

Opportunities

  1. On the Salesforce toolbar, click the Opportunities tab.
  2. Click any opportunity and on that opportunity’s page, at the upper right, click Edit Layout.
  3. In the Opportunity Layout pane, click Fields, and then drag the following fields to the Opportunity Detail pane:
    • Sales Tax
    • Shipping Tax
    • Non-Taxable
    • Shipping Address
    • Shipping and Handling
      AvaTaxforSalesforce-OpportunityDetail-pane.gif
  4. In the Opportunity Layout pane, click Buttons and then drag the following buttons to the Custom Buttons section of the Opportunity Detail pane:
    • Calculate Sales Tax
    • Finalize Opportunity
    • Validate Billing Address
    • Validate Shipping Address
  5. In the Opportunity Layout pane, click Save.
  6. In the Opportunity pane, under Products, click any product.
  7. In the Opportunity Product page, click Edit Layout.
  8. In the Opportunity Product Layout pane, drag the following fields to the Opportunity Product Detail pane:
    • Sales Tax Amount
    • Sales Tax Details
    • Sales Tax Rate
  9. In the Opportunity Product Layout pane, click Save.

Quotes

  1. In the opportunity’s page, scroll down to the Quotes section.
  2. Click any quote, and in the Quote page, click Edit Layout.
  3. In the Quote Layout pane, click Fields, and drag the S&H Tax field to the Quote Detail pane below.
  4. In the Quote Layout pane, click Buttons, and drag the following buttons to the Custom Buttons section of the Quote Detail pane below:
    • Calculate Sales Tax
    • Finalize Quote
    • Validate BillTo
    • Validate ShipTo
  5. In the Quote Layout pane, click Save.
  6. Under Quote Line Items, click any item.
  7. In the Quote Line Item page, click Edit Layout.
  8. In the Quote Line Item Layout pane, click Fields and then drag the following fields to the Quote Line Item Detail pane below:
    • Sales Tax Amount
    • Sales Tax Details
    • Sales Tax Rate
    • Avalara Tax Code
  9. In the Quote Line Item Layout pane, click Save.

Orders

  1. On the Salesforce toolbar, click the Orders tab.
  2. Click any order and then, click Edit Layout.
  3. In the Order Layout pane, click Fields, and then drag the following fields to the Order Detail pane:
    • Sales Tax
    • Shipping Tax
    • Non-Taxable
    • Shipping Address
    • Shipping and Handling
  4. In the Order Layout pane, click Buttons and then drag the following buttons to the Custom Buttons section of the Order Detail pane:
    • Calculate Sales Tax
    • Finalize Order
    • Validate Billing Address
    • Validate Shipping Address
  5. In the Order Layout pane, click Save.
  6. In the Order pane, under Products, click any product.
  7. In the Order Product page, click Edit Layout.
  8. At the top, in the Order Product Layout pane, drag the following fields to the Order Product Detail pane:
    • Sales Tax Amount
    • Sales Tax Details
    • Sales Tax Rate
  9. In the Order Product Layout pane, click Save.

Accounts

  1. On the Salesforce toolbar, click Accounts.
  2. Click any account, and in the account page, click Edit Layout.
  3. In the Account Layout pane, click Fields, and then drag the following fields to the Account Detail pane:
    • Entity/use code
    • Exemption Number
  4. In the Account Layout pane, click Buttons, and then drag the following buttons to the Custom Buttons area of the Account Detail pane below:
    • Validate Billing
    • Validate Shipping

Products

  1. On the Salesforce toolbar, click the All Tabs (+) button.
  2. In the All Tabs page, click Products.
  3. In the Products page, under Recent Products, click any product.
  4. In the product page, click Edit Layout.
  5. In the Product Layout pane, click Fields, and then drag the following fields to the Product Detail pane:
    • Tax Code 
    • UPC
  6. In the product page, under Product Detail, in the Tax Code text box, type the tax code for the product, and then click Save.