Skip to main content
Avalara Help Center

Install and Configure Avalara AvaTax for Microsoft Dynamics AX 2012

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

Alter these settings when your business needs change.

During the install process, you must:

  • Repeat the installation process on every server that has the Microsoft Dynamics AX Application Object Server installed
  • Repeat the installation process on every server that has the Microsoft Dynamics AX batch processing application installed
  • Install on Terminal Service Servers (including Citrix) when the server is in Install Mode

Use the procedures below to download, install, and configure Microsoft Dynamics AX. If you've previously installed the integration, learn how to upgrade to the latest version.

Download your integration

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

Install Microsoft Dynamics AX 2012

Contact Avalara Professional Services to install and configure AvaTax for your accounting software.

Configure

The Configuration window opens after you complete the setup wizard, allowing you to edit and configure your settings.

Configuration settings

  1. Optional: If you're making changes after installation, to open the Configuration window, go to AvaTax > Area page, and then click Configuration Setting.
  2. To edit fields in the Account Credentials section, click Edit Settings, add or modify the following details, and then click Verify Credentials:
    Field Action
    • Account Number
    • License Key
    Use the account number and license key that you received from Avalara in an email when you signed up for your AvaTax account
    URL Enter https://admin-development.avalara.net if you have an AvaTax development account or https://admin-avatax.avalara.net if you have an AvaTax production account
    • User name
    • Password
    Use the same ones you use to log into your AvaTax account
    Company Code Select your AvaTax company code
  3. Complete or modify fields on the remaining tabs, using the following information, and then click Close to save your changes:
    • The General tab:
      Section Field and Description
      General Options
      • Display all warning messages: Select to enable warning messages. Error messages will always display.
      • Tax Mapping Code: Controls how tax codes are assigned to items. Select to enable the tax code mapping utility within the AvaTax menu.
      • User Defined 1: Identifies Microsoft Dynamics AX information to pass to AvaTax in the User Defined 1 field for reporting.
      • User Defined 2: Identifies Microsoft Dynamics AX information to pass to AvaTax in the User Defined 2 field for reporting.
      • Enable Entity Use Code: Select to enable the use of entity/use code to exempt customer records.
      • Send Item account to AvaTax: Select to enable to send the item account details to AvaTax.
      • Use UPC as Item Code: Select to enable sending UPC instead of the item code to maintain item taxability.
      Return Order Address

      Return Order Address: Select the address for return orders.

      Shipping Options Control the assignment of tax codes to additional charge items. Available additional charge items display on the left, and you can assign them to tax codes associated with freight or miscellaneous charge references found on the right.
      Adapter Options
      • Request Timeout (In seconds): Allows you to change the adapter timeout. We don't recommend changing this setting unless advised by Avalara Support.
      • Enable logging: Select to enable transaction logging for AvaTax. Typically used to assist with transaction troubleshooting. We don't recommend changing this setting unless advised by Avalara Support.
      • Extensive logging: Select to generate logs in local (AVALE) and log entry portal. We don't recommend changing this setting unless advised by Avalara Support.

     

    • The Tax Calculation tab:
      Section Field and Description
      General Options
      • Always check address before calculating tax: Select to force an address validation of the sales/billing document prior to tax calculation. Generally only recommended if you enter ship-to address on-the-fly during the Microsoft Dynamics AX sales transaction entry process.
      • Enable credit note / return order tax override date: Generally recommended if you want to override the tax details for a credit note / return order.
      Tax Area Code
      • Sales tax group: Identifies the default sales tax group. Update customer or vendor area sales tax group codes in order to process sales tax calculations using AvaTax for Microsoft Dynamics AX 2012. We recommend selecting the AVATAX sales tax group.
      • Tax Group Code Mass Update: Accesses a utility to perform a mass updates of the sales tax group code on a range of customers.

     

    • The Address Validation tab:
      Section Field and Description
      General Options

      Return Results in Uppercase: Select to have Microsoft Dynamics AX return address validation results in uppercase format.

      Perform Address Validation based on country names selected AvaTax only validates addresses in the United States and Canada.

     

    • The Consumer Use Tax tab:
      Section Field and Description
      Consumer Use Tax
      • Enable use tax assessment on vendor invoice: Select to enable consumer use tax assessment on your vendor invoices.
      • Mark vendor to assess: Click to select and mark vendors for consumer use tax assessment.
      Posting account
      • Use Tax liability account: Select the account to which the accrual amount is to be credited.
      • GL Account to Debit: Select the type of account from which the accrual amount is to be debited.
      • Use Tax Debit GL Account: If you select the Single Account option in GL account to Debit, select the associated account from which the accrual amount is to be debited.
      Taxability
      • Apply Avalara Goods & Service Code mapped on item group when it’s not available on an item: Select to apply Goods and Service tax codes to manage item taxability. Assigning product and product categories to items gives you important jurisdictional subtlety in taxability. Avalara has predefined system tax codes with a taxability profile in place for all US states.
      • Apply Avalara Goods & Service Code mapped on: Select the option appropriate to your business.
        • Item Code: The tax code sent to AvaTax will be Item code. If the Item code is missing, the Item group is sent. If both Item Code and Item group are missing, the Item Code is sent as blank. 
        • Procurement Category: The tax code sent to AvaTax will be Procurement Category. If the Procurement Category is missing, the Item Code is sent. If both Procurement Category and Item Code are missing, the Item Group is sent. 

     

    • The Project tab:
      Section Field and Description
      Project Invoice Address Project Invoice Address: Select the appropriate project address for your invoice