Skip to main content
Avalara Help Center

Install and Configure Avalara AvaTax for Salesforce

Install and configure your integration after you activate AvaTax and set up your company profile.

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.
  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 (Opportunities) 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.
    1 SF Add Menu_tab 2.png
  3. Click the Avalara tab, and then click Go!.  
  4. To edit your account credentials, click Edit to add or modify the following details:

    Avalara Account Detail:

    • Avalara Account Name: Select AvaTax.
    • Avalara Account Detail: Check the box next to Active Avalara Setting.
     Select Tab

    Avalara Credentials:

    • Account ID: You received your AvaTax account number from Avalara in an email when you signed up for your AvaTax account. The subject of that email is, Important! Your AvaTax Production Account Number & License Key.
    • Key: You received your AvaTax license key in the same email as your account number when you signed up for your AvaTax account.
    • User Name: Your AvaTax user name. You received your username from Avalara in an email (subject line AvaTax Account Login) when you signed up for your AvaTax account.
    • Password: The password you use when you log into the AvaTax Admin Console.
    • URL: If you have an AvaTaxdevelopment account, use https://development.avalara.net. If you have an AvaTax production account, use https://avatax.avalara.net.
    • Company Code: This is the 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. Here's some help if you can't find your company code in Salesforce.
    Origin Address: This is the address used for calculating sales tax using AvaTax for your transactions.

    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.

    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 Account Name for Cust Identification: AvaTax calculations normally use the account ID (the last 15 digits in the URL on a page) for the customer code. Select 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.
  5. 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. On the next page, next to Test Connect Returned, if you see a Success message, you have configured AvaTax for Salesforce correctly. Click OK.
  6. 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).
  7. When you set up AvaTax, you created your initial company. To create an additional 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.
  8. 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
  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.