Skip to main content
Avalara Help Center

Install and Configure Avalara AvaTax for NetSuite

This article applies to:Avalara AvaTax for NetSuite

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

Update these settings when your business needs change.

Install AvaTax for your accounting software

  1. Log in to NetSuite, and go to Customization > Suitebundler > Search & Install Bundles.
  2. On the Search & Install Bundle menu, in the Keywords field, type AvaTax, and then click Search.
  3. Choose AvaTax Basic or AvaTax OneWorld.
  4. On the Bundle Details page, click Install. The Preview Bundle Install page shows items to be added by the AvaTax bundle.
  5. In the Preference dialog box, find potential conflicts with elements or add-ons, and then select appropriate actions from the drop-down menus.
  6. Click Install Bundle
  7. To see the progress of the installation, go to Customization > Suitebundler > Search & Install Bundles > List.

Create a tax code in NetSuite

AvaTax calculates sales tax in the United States and Canada. These steps are for the US; the steps are slightly different for Canada.

  1. To create a tax code in NetSuite, go to Setup > Accounting > Tax Codes > New, and then select United States. The Tax Code page opens.
  2. Fill in the following, and then click Save:
    Field Action
    Tax Name Type AVATAX.
    Display Name/Code Type Sales Tax.
    Rates Type 0.00.
    Tax Agency

    Choose Avalara. If Avalara isn't in the list:

    1. Click +.
    2. From the Category list, click Tax Agency.
    3. In the Company Name field, type Avalara, and then click Save.
    Tax Account Choose the tax control account where sales tax payable should accrue. If there's no tax control account, create a tax control account in NetSuite, and then select it.

Create a tax code in NetSuite OneWorld

AvaTax calculates sales tax in the United States and Canada. These steps are for the US; the steps are slightly different for Canada.

  1. To create a tax code in NetSuite, go to Setup > Accounting > Tax Codes > New, and then select the country you want the new tax code to apply to. The Tax Code page opens.
  2. Fill in the following, and then click Save:
    Field Action
    Tax Name Type AVATAX.
    Display Name/Code Type Sales Tax.
    Rates Type 0.00.
    Subsidiaries Choose one subsidiary per tax code. Create more tax codes if you want to calculate tax for multiple subsidiaries.
    Tax Agency

    Choose Avalara. If Avalara isn't in the list:

    1. Click +.
    2. From the Category list, click Tax Agency.
    3. In the Company Name field, type Avalara, and then click Save.
    Tax Account Choose the tax control account where sales tax payable should accrue. If there's no tax control account, create a tax control account in NetSuite, and then select it.

Configure AvaTax for your accounting software

To configure your company settings:

  1. Go to Avalara > Setup > Configure Avalara.
  2. On the Setup Assistant page, fill in the following, and then click Validate:
    Field Action
    • Account Number
    • License 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.
    • Username 
    • 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.
    Service URL Select Development if you have an AvaTax development account or Production if you have an AvaTax production account.
  3. If the correct AvaTax Company Code/Name doesn't automatically appear in the drop-down, choose the correct company, and then click Next. Don't click Create Company, because you created a company when you activated AvaTax.
  4. Complete or modify fields on the Avalara Configuration page, using the following information, and then click Save:
    • The General tab:
      Section Field and description
      Item Specific
      • Enable Tax Code Mapping: Enable to map items to Avalara tax codes to account for varying taxability of products and services. In the list, if you select the blank option, AvaTax for NetSuite doesn't automatically change the taxability of the customer transactions. If this option isn't visible, follow the steps mentioned below.
      • Override AvaTax TaxCode: Enable if you want to override your assigned Avalara tax code and send NT for non-taxable items. If this option is disabled, the assigned Avalara tax code is sent. In the list, if you select the blank option, AvaTax for NetSuite doesn't automatically change the tax code of the customer transactions if it already exists.
      • Optional: User Defined 1 and 2: Select the type of data you want to send to AvaTax.
      • Send Item Account to Avalara: Select to send general-ledger account information for an item to AvaTax.
      Customer/Vendor Specific
      • Customer Code: Selected value is sent to AvaTax and appears as the customer code on transactions. Most customers select Customer Internal ID.
      • Vendor Code: Selected value is sent to AvaTax and appears as the vendor code on consumer use transactions. Most customers select Vendor Internal ID.
      • Default Customers to Taxable: Select the default option that makes customers in NetSuite taxable when you add or save their customer record.
      • Default Tax Code To: Select the customers you'd like to consider taxable when you add or save customer records.
      • Optional: Enable Entity/Use Code: Enable to map entity/use codes for your customer addresses to flag them as exempt from sales tax.
      Miscellaneous Settings
      • Default Shipping Code: {[F30}} Before you select this option, ensure that the shipping codes are set up by going to Avalara > Setup > Shipping Codes. Ignore this field if your company doesn't use NetSuite’s shipping functionality.
      • Show Warnings/Errors: Determines what is displayed on error logs.
      • Optional: Billable Time Name: If you select Billable Time, AvaTax records billable time for items that you select instead of the item name mapped to a tax code.
      • Optional: Extensive Logging: Select to automatically log AvaTax activities and save the details in a local log file.
    • The Tax Calculation tab:
      Field and Description
      • Optional: Disable Tax Calculation: If you choose to disable tax calculation, your accounting software no longer uses AvaTax to calculate tax on transactions.
      • Optional: Disable Tax Calculation for Quotes: If you choose to disable tax calculation for quotes, NetSuite no longer uses AvaTax to calculate tax on quotes.
      • Optional: Disable Tax Calculation for Sales Order: If you choose to disable tax calculation for sales orders, NetSuite no longer uses AvaTax to calculate tax on sales orders.
      • Optional: Disable Tax Calculation at line level: This setting affects only the frequency of tax calculations. If the Multiple Shipping Routes option is enabled in NetSuite, AvaTax for NetSuite can source lines on transactions to different addresses, regardless of this setting.
      • Optional: Enable Logging: This function is primarily used for troubleshooting issues. If you choose to enable logging, all success, warning, and error messages are included in the log. Only enable logging if you've been instructed to do so by Avalara Support, because it can significantly slow down your service.
      • Optional: Calculate Tax on Demand: Select to display a Calculate Tax button in sales documents in Edit view. Click this button to perform an instant sales tax calculation.
      • Optional: Tax Included Capability: Select to add a checkbox to include sales tax in the Total Price field on sales documents. This reverses the tax amount from the line total and updates the line amount to reflect this. The total price on the invoice doesn't change even after tax is added.
      • Optional: Use Posting Period as Transaction Date during Tax Calls: Select to send the posting date as the transaction date instead of the header invoice date. The posting period is the first day of the selected month.
      • Optional: Disable Location Code:
        • In NetSuite, if this is disabled, the default address on this tab is sent as the origin address for transactions.
        • In NetSuite OneWorld, if this is disabled, the subsidiary address on this tab is sent as the the origin address for transactions.
        • If this option is enabled, the location code for a transaction is sent based on the following conditions:
          • If the location code is added only at the header-level, the location name is sent as the location code for the transaction.
          • If the location code is added only at the line-level, the location name of the 1st line is sent as the location code for the transaction.
          • If the location code is added at both the header-level and the line-level, the location name of the 1st line is sent as the location code for the transaction.
      • Optional: Enable UPC Code as Item Code: Select to send a UPC instead of an item code to AvaTax. Using this feature may trigger additional fees. Talk to your Customer Account Manager (CAM) for more information.
      • Optional: Enable Discount Mechanism: Select to map discounts to an Avalara tax code. This is useful if you need to use nontaxable discounts, which don't affect the taxable amount of a line.
      • Discount Mapping: Select whether you want to discount the gross or net amount when you use the Enable Discount mechanism.
      • Discount Tax Code: Select to be able to select a tax code for discounts--in most cases, NT for non-taxable.
      • Tax Rate: Select Show Base Rate to control whether the tax rate displayed factors in exemptions and partial taxability.
      • Optional: Round-Off Tax Percentage (Decimal Places): Select to control the number of decimal places that display in a calculated tax rate--by default, 2 places.
      • Default Tax Code: In NetSuite OneWorld, select the company-specific tax code for each subsidiary.
      • Default Tax Code Rate: In NetSuite OneWorld, select the company-specific tax code rate for each subsidiary.
      • Addressee: Type the addressee address details. The Address field shows a consolidated view of the addressee address.
      • Validate Address: Click to validate the addressee address.
      • Abort Save Operation on Tax Calculation Errors: Select to stop tax calculations that fail from saving the document for the following operations:
        • Bulk Billing
        • User Interfaces
        • Webservices
        • CSV Imports
        • Scheduled Scripts
        • Suitelets
        • Workflow action scripts
    • The Consumer Use Tax / Input VAT tab:
      Using this feature may cause you to incur additional fees. Talk to your Customer Account Manager (CAM) for more information. Consumer use tax doesn't apply to Canadian purchase transactions.
      Section Field and description
      Consumer Use Tax Assessment Settings
      Accrue Consumer Use Tax when a Vendor Bill is approved Optional: Select to enable accrual of consumer use tax when a vendor bill is approved, and then post to AvaTax.
      Auto Self Assess on Imported Vendor Bills Optional: Select to enable self-assessment of consumer use tax on vendor bills imported from the webservices in order to automatically compare the tax calculated by your vendor with the tax calculated by AvaTax.
      Item for Tax Paid to Vendor Optional: Select the item that represents the vendor-paid sales tax on vendor bills. This item amount is treated as the vendor-paid sales tax and used to compare with the tax calculated by AvaTax.
      Input VAT Verification Settings Optional: Enable Input VAT Verification on Vendor Bill: Enable to verify the VAT amount calculated by a vendor.
    • The Address Validation tab:
      Field and description
      • Optional: Disable address validation: If you disable address validation, AvaTax 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: Enable address validation on transaction(s): Select to create buttons for validating bill-to and ship-to addresses on transactions.
      • Optional: Track previously validated addresses: If enabled, AvaTax informs you when an address has previously been validated.
      • Optional: Result in upper case: Select to save all address validation results in uppercase format.
      • Batch processing:
        • Automatic - Automatically accept address validation results when you process batches of transactions.
        • Manual - Manually approve the address validation results.
    • The About Avalara tab contains technical information about your connector/integration and your AvaTax account.

Configure for item to tax code mapping

Before you map an item to a tax code, ensure the AvaTax Tax Code option is displayed. If this option isn't visible, follow these steps:

  1. In NetSuite, go to Customization > Forms > Entry Forms.
  2. Select the appropriate Entry Form from the list and click Edit next to the form name. For example, if you're importing inventory items, select Edit next to Custom Inventory Part Form. The name could be different based on the form you're using or any customizations.
  3. Select the Fields tab, and then select the Custom sub-tab.
  4. Find AvaTax Tax Code, and then select the checkbox in the Show column.
  5. Save the record.
  • Was this article helpful?