Professional Documents
Culture Documents
User Guide
Version 13.3
Avalara may have patents, patent applications, trademarks, copyrights, or other intellectual property
rights governing the subject matter in this document. Except as expressly provided in any written
license agreement from Avalara, the furnishing of this document does not give you any license to
these patents, trademarks, copyrights, or other intellectual property.
Avalara, AvaTax Calc, AvaTax Returns, AvaTax Certs, AvaRates, TrustFile, BPObridge,
Laserbridge+, Sales Taxll, Sales TaxPC, SalestaxPC+, StatetaxII, and StatetaxPC are either
registered trademarks or trademarks of Avalara, Inc. in the United States or other countries.
Contents
Overview ....................................................................................................................................................... 3
Transaction Import Scenarios ....................................................................................................................... 4
Reasons to Use Transaction Import ............................................................................................................. 5
Importing Transactions .................................................................................................................................. 7
Transaction Import File Format ................................................................................................................. 7
Transaction Record Format Table ......................................................................................................... 7
Import Transactions ................................................................................................................................. 17
To Import Transactions ........................................................................................................................ 17
The Upload Process ............................................................................................................................ 19
Troubleshooting an Unsuccessful Transaction Import ........................................................................ 20
Tips for Successful Transaction Imports.............................................................................................. 21
Viewing Imported Transactions ........................................................................................................... 22
Avalara Support .......................................................................................................................................... 24
Overview
This guide is for persons responsible for importing Transactions into AvaTax Calc or using the results of
the Transaction import. Importing Transactions allows an AvaTax Admin Console user to quickly add
many Transactions for a variety of purposes.
NOTE
This guide covers importing Transactions in the AvaTax Admin Console. This guide is not intended as a
technical implementation resource for developers.
In addition to this User Guide, you may want to refer to the AvaTax Admin Console User Guide.
1. Transactions exist in the accounting, ERP, e-commerce, m-commerce, or POS application but have no
tax associated with them. In this scenario, the tax calculation is requested for the Transaction from
AvaTax Calc and recorded there.
2. Transactions exist in the accounting, ERP, e-commerce, m-commerce, or POS application and have
tax associated with them. In this scenario, the tax calculation has already been applied to the
document, but Transactions are not yet recorded in AvaTax Calc.
In either scenario, Transactions are imported to AvaTax Calc and the results of the import are available in
the AvaTax Admin Console. See Viewing Imported Transactions.
NOTE
Imported Transactions do not update your accounting, ERP, e-commerce, m-commerce, or POS
application.
NOTE
Importing Transactions is not done through any "connector." It is a process used to get Transactions
into AvaTax Calc.
You may find the import of Transactions into AvaTax Calc helpful in the following cases:
1. Transactions exist in the accounting, ERP, e-commerce, m-commerce, or POS application, but do not
have tax associated with them. Importing Transactions calculates the tax and generates an output file
(Result.csv) containing the tax for each Transaction. The results from importing Transactions answers
the question "If I had a number of invoices without tax, how would I get that information?".
Results can be entered into the accounting, ERP, e-commerce, m-commerce, or POS application either
manually or programmatically.
The Transaction number used in both the accounting, ERP, e-commerce, m-commerce, or POS
application and in AvaTax Calc is the DocCode. Taxes display in TotalTax. Taxes may be broken out
by jurisdiction into:
CountryTax Other1Tax
StateTax (includes province taxes) Other2Tax
CountyTax Other3Tax
CityTax Other4Tax
2. Transactions exist in the accounting, ERP, e-commerce, m-commerce, or POS application, but do not
have tax associated with them, and are not committed in AvaTax Calc. Importing Transactions
calculates the tax, commits the Transaction, and generates an output file (Result.csv) containing the tax
for each Transaction.
3. Transactions do not exist in the accounting, ERP, e-commerce, m-commerce, or POS application, but
do exist in some other application. The output file (Result.csv) from the Transaction import process is
used to enter information into the accounting, ERP, e-commerce, m-commerce, or POS application.
Transactions imported into AvaTax Calc have either:
o tax calculated
o tax calculated and the Transaction is committed in AvaTax Calc
4. Transactions exist in the accounting, ERP, e-commerce, m-commerce, or POS application, but do not
exist in AvaTax Calc. This situation can occur if the transmission of the Transaction from the
"connector" is interrupted for some reason. This may result in a posted Transaction in the accounting,
ERP, e-commerce, m-commerce, or POS application that cannot be edited, but the Transaction is not
yet in AvaTax Calc.
5. Transactions exist in the accounting, ERP, e-commerce, m-commerce, or POS application, and in
AvaTax Calc, but an Exemption Certificate is received and is not the reflected in the Transaction in
either system. To have a proper audit trail, resolve a situation like this by:
The initial credit nets out to the original Transaction, and the leftover amount is the new Transaction
with the appropriate Exemption Certificate information now applied. This is essentially how the
Transaction would have shown up if the Exemption Certificate information was available at the time of
the original Transaction.
6. Consumer Use Transactions are not entered in the accounting, ERP, e-commerce, m-commerce, or
POS application, but are imported to AvaTax Calc. This may be the case if the sales tax is not paid on
Transactions with a vendor. In this case, Consumer Use Transactions for a period are imported into
AvaTax Calc and resolved at one time.
NOTE
Imported Transactions do not update your accounting, ERP, e-commerce, m-commerce, or POS
application, regardless of the state of the Transaction.
Importing Transactions
Importing Transactions allows you to add many Transactions to the AvaTax Admin Console without
repeatedly typing or selecting values for each field. Once imported, Transactions are managed in the
AvaTax Admin Console in the same manner as any other Transaction.
The following Transaction format table is for reference only. To save time and increase the accuracy of
your Transactions, use the predefined import file templates provided. Templates in Microsoft® Excel®
(.xls) and Comma Separated Value (.csv) file formats are available after logging in to the AvaTax Admin
Console. Click Help and in the Help window, click Search and search on “transaction import format” to
access the import templates.
Typically, two different types of customers import Transactions into AvaTax Calc:
Avalara customers with no direct integration link between their accounting, ERP, e-commerce, m-
commerce, or POS application and the AvaTax service
These customers use a batch file to upload Transactions directly from the AvaTax Admin Console.
Avalara customers with a direct integration of the AvaTax service into their accounting, ERP, e-
commerce, m-commerce, or POS application to generate sales tax calculations
These customers import new Transactions or update existing Transactions. The end result of the import
is the same as performing a Transaction adjustment using the user interface provided on the
Transactions tab of the AvaTax Admin Console. Importing Transactions does not update information
within the accounting, ERP, e-commerce, m-commerce, or POS application.
NOTE
The number of records allowed in one file is 100,000.
The column headings in the import file must use the labels exactly as shown below. The individual data
fields must conform to the Type (Size) and Use restrictions listed.
The table below contains one row for each column of the Transaction import file. References to “column”
in a description refer to the column in the header row of the Transaction import file.
NOTE
ProcessCode 0 requires the
DocCode, DocType, and
CompanyCode of the existing
document to be voided. No other
column values are required for a
voided transaction.
For ProcessCode 1 or 2, input the
tax override amount desired in the
TotalTax column (column AP).
For ProcessCodes 5 and 6, input the
accrued tax override amount desired
in the TotalTax column (column AP)
and enter 0 in the Amount column
(column N).
B DocCode String (50) Required The invoice, credit memo, or return number
Examples:
12/30/2012 for mm/dd/yyyy format
2012-12-30 for yyyy-mm-dd format
E CompanyCode Text (25) Optional The Company Code used by AvaTax Calc.
Examples:
12/30/2012 for mm/dd/yyyy format
2012-12-30 for yyyy-mm-dd format
NOTE
The TaxDate override functionality is
typically used on Return Invoice
(credit memo) transactions requiring
a tax calculation date reflecting the
original invoice date, and a
transaction date reflecting the
current reporting period.
K ItemCode Text (50) Conditional The item code or SKU identifying the product,
service, or charge
NOTE
Quantity is not used as a multiplier
for the amount field. Quantity is used
to calculate the per-item sales
amount (unit price) for sales tax caps
and thresholds.
N Amount Number Required The total sale amount (extended amount) for the
Document Line item (Quantity * Unit Price)
NOTE
Enter the Amount as a negative
value for return invoices (DocType 5
– column C).
NOTE
SST Sellers are required to use
ECMS generated Exemption
Certificates to cover exemptions for
SST States
V DestRegion Text (2) Required The destination or ship-to state or province two
character abbreviation
W DestPostalCode Text (10) Required The destination or ship-to Postal Code
Use the:
five digit ZIP Code (12345)
nine digit ZIP+4 Code (12345-6789)
six character Canadian Postal Code
(A1B 2C3)
Use the:
five digit ZIP Code (12345)
nine digit ZIP+4 Code (12345-6789)
six character Canadian Postal Code
(A1B 2C3)
NOTE
ExchangeRate is for reference only.
AI ExchangeRateEffDate Date (10) Optional The effective date of the exchange rate
Examples:
12/30/2012 for mm/dd/yyyy format
2012-12-30 for yyyy-mm-dd format
Use:
E) Excise tax rate
S) Sales tax rate
U) Seller Use tax rate
2. On the New: File Import screen, select the Type of file to import.
3. Select a Company.
4. Click Browse to select the file to import. You can import files with .xls, .xslx, and .csv extensions. All
other file types cause an error message to appear.
5. Click Upload.
NOTES
The time required to import Transactions varies depending on the number of records imported.
The number of records allowed in one file is 100,000.
Importing Transactions does not update your accounting, ERP, e-commerce, m-commerce, or POS
application.
An unsuccessful file import results in a Status of Errors, an Error hyperlink, and possibly a Result
hyperlink in the File column. Click the Error hyperlink to open the Error.csv file and view the error
message in the last column for each Transaction that failed to import. Click the Result hyperlink to open
the Result.csv file and view tax information for each Transaction that imported successfully.
In either case, the format of the Result.csv or the Error.csv reflects the fields used in the Transaction
import.
NOTE
The Import Status screen displays information for both file imports and AvaTax Certs updates. The File
Name column in the Import Status List displays:
2. On the Import Status screen, click the Error hyperlink in the File column for an imported file. Open
Error.csv and view the error message in the last column for each record that failed to import.
3. Make the necessary corrections to the records and delete the last column of error messages.
4. Save the file with a new name.
5. Import the file.
2. On the Import Status screen, click the Action Menu button for an Import Type of
TransactionImport.
3. Click View.
4. The Transaction screen displays all records with the Batch Code of the imported Transactions file.
NOTES
Transactions imported into the AvaTax Admin Console are not added to your accounting, ERP, e-
commerce, m-commerce, or POS application.
The maximum number of Transactions that can be imported from one file is 100,000.
Avalara Support
If you have questions about AvaTax, please contact Avalara Support with our toll free number (1-877)
780-4848, option 2. Standard support hours are 7:00 a.m. to 4:00 p.m. Pacific, Monday through Friday.
Requests for assistance can also be placed online via the AvaTax Admin Console (https://admin-
avatax.avalara.net/ ).
Log in to the AvaTax Admin Console, and select Chat or Submit A Case from the Home tab.