Skip to main content
Avalara Help Center

Import transactions to AvaTax

This article applies to:AvaTax

When you import transactions for tax types other than sales and use tax, you need to set some general rules for how Avalara handles your import file and match the columns from your spreadsheet to the values Avalara uses to process transactions. 

When you're done, save your configuration as a template and use it to upload transaction data next time.

Tip icon

For instructions on importing using a template—either Avalara Import Template or one you made previously—see Import Transactions (legacy).



  1. In Avalara, go to Transactions > Import transactions.
  2. Choose to Use a template or Upload your own file. If you're using an existing template, you'll upload the file and simply check everything to be sure it's correct. If you Upload your own file, complete the next steps. 
  3. Select Upload Transaction Data, and then select the .xlxs, .xls, or .csv file you want to upload. 
  4. Choose your settings for document type, process code, and, if you sell internationally, importer of record. For each field, there are two options:
    • Match a column from your template: Choose a column from your transactions file to map to document type or process code.
    • Assign the same value to all transactions: Assign the same code to all transactions, and edit them later if needed.
  5. Select Next when you've finished your import settings. 
  6. Map your Required columns by selecting the corresponding column from your spreadsheet. This is required for Avalara to process your transactions. When you're done, select Next
    • For example, map the column where you store the date of each transaction to the Document Date column. 
  7. In the Add attributes screen, complete the attributes that fit with your transactions. If you need more or different attributes, you can Add or edit attributes, or Remove them as needed. Based on your configuration, attributes you likely need are already selected. When you're done, select Next
    Tip icon Attributes send more information about the products you sell to more accurately calculate tax. To learn more, see Product and service attribute guidelines.
  8. Map any additional columns from your transaction data.
    1. If you've added certain process codes, there can be required columns that you must add in this step. Click Remind me what those are to make sure you have all the required columns. 
    2. Other than the process code columns, this information isn't needed for tax calculation, but it makes your data more complete.
    3. Any columns you don't map aren't imported.
    4. When you're done, select Next.
  9. Look over your import settings, mappings and attributes, and select Edit if you need to make changes.
  10. To be able to use this mapping for later transaction imports, select Save This Mapping as a Template and enter a name for the template. 
  11. Select Finish.

After you click finish, your transactions begin processing. You can check the status by choosing Follow your import’s progress. Otherwise, you can import more transactions or go back to the Home screen.

If you get any errors in your file, they're displayed in the first column. You can learn how to fix them with Fix transaction import errors.

  • Was this article helpful?