Epicor Tax Connect Configuration Epicor ERP 10
Epicor Tax Connect Configuration Epicor ERP 10
Epicor ERP 10
Disclaimer
This document is for informational purposes only and is subject to change without notice. This document and its
contents, including the viewpoints, dates and functional content expressed herein are believed to be accurate as of its
date of publication. However, Epicor Software Corporation makes no guarantee, representations or warranties with
regard to the enclosed information and specifically disclaims any applicable implied warranties, such as fitness for a
particular purpose, merchantability, satisfactory quality or reasonable skill and care. As each user of Epicor software is
likely to be unique in their requirements in the use of such software and their business processes, users of this document
are always advised to discuss the content of this document with their Epicor account manager. All information contained
herein is subject to change without notice and changes to this document since printing and other important information
about the software product are made or published in release notes, and you are urged to obtain the current release
notes for the software product. We welcome user comments and reserve the right to revise this publication and/or
make improvements or changes to the products or programs described in this publication at any time, without notice.
The usage of any Epicor software shall be pursuant to an Epicor end user license agreement and the performance of
any consulting services by Epicor personnel shall be pursuant to Epicor's standard services terms and conditions. Usage
of the solution(s) described in this document with other Epicor software or third party products may require the purchase
of licenses for such other products. Where any software is expressed to be compliant with local laws or requirements
in this document, such compliance is not a warranty and is based solely on Epicor's current understanding of such laws
and requirements. All laws and requirements are subject to varying interpretations as well as to change and accordingly
Epicor cannot guarantee that the software will be compliant and up to date with such changes. All statements of
platform and product compatibility in this document shall be considered individually in relation to the products referred
to in the relevant statement, i.e., where any Epicor software is stated to be compatible with one product and also
stated to be compatible with another product, it should not be interpreted that such Epicor software is compatible
with both of the products running at the same time on the same platform or environment. Additionally platform or
product compatibility may require the application of Epicor or third-party updates, patches and/or service packs and
Epicor has no responsibility for compatibility issues which may be caused by updates, patches and/or service packs
released by third parties after the date of publication of this document. Epicor is a registered trademark and/or
trademark of Epicor Software Corporation in the United States, certain other countries and/or the EU. All other
trademarks mentioned are the property of their respective owners. Copyright Epicor Software Corporation 2014.
All rights reserved. No part of this publication may be reproduced in any form without the prior written consent of
Epicor Software Corporation.
Epicor ERP 10
Revision: April 25, 2014 9:51 a.m.
Total pages: 14
sys.ditaval
Contents
Contents
1 Welcome and Introduction.................................................................................................4
2 Before You Begin.................................................................................................................5
3 Configure Epicor Tax Connect............................................................................................5
3.1 Set Up Company Configuration.................................................................................................................5
3.2 Set Up Tax Liabilities..................................................................................................................................7
3.2.1 Set Up Tax Liabilities for Sales Tax (If Needed)..................................................................................7
3.2.2 Set Up Tax Liabilities for Consumer Use Tax (If Needed)....................................................................8
3.3 Validate Addresses.....................................................................................................................................8
3.3.1 Validate Customer Addresses...........................................................................................................9
3.3.2 Validate Company Address..............................................................................................................9
3.3.3 Validate Site Address.....................................................................................................................10
3.3.4 Validate Warehouse Address.........................................................................................................10
3.3.5 Use Bulk Address Validation...........................................................................................................11
4 Configure Avalara..............................................................................................................12
4.1 Configure AvaTax....................................................................................................................................12
5 Test Configurations...........................................................................................................12
Epicor ERP 10
Epicor ERP 10
Log on to EPICweb and go to the customer portal website. Navigate to Products > Epicor ERP version 10
> Downloads.
You can use this link: https://epicweb.epicor.com/products/epicor-erp/downloads.
2.
3.
Obtain from Epicor and activate the desired Epicor Tax Connect license.
4.
5. Use the following key fields and buttons to define multiple settings and default Tax Connect parameters:
Tax Connect Enabled - Select this check box to activate Epicor Tax Connect for the current company.
If you have selected the Tax Calculation Enabled and the Address Validation Enabled check boxes,
selecting the Tax Connect Enabled check box allows AvaTax to calculate taxes for transactions and to
validate addresses which are sent to it by Epicor.
Debug Mode - Enable this mode to assist Epicor Technical Support personnel with the diagnosis of
problems that you encounter. Selecting this check box causes the Epicor application to capture to a folder
on your server all of the communications for Tax Connect-related actions that require it to work with
AvaTax (for example, tax calculations, address validations, invoice or credit memo postings, or deletions).
Reviewing the captured xml data allows you to see the transaction and tax calculation details exchanged
Epicor ERP 10
between Epicor and AvaTax; this information may provide important clues that aid in determining the
root cause of problems encountered.
Test Connection - Click this button to test if Epicor is currently able to communicate with AvaTax. After
the connection is tested, a window displays indicating if the connection was successful. If the connection
did not work, an error message displays explaining the reason why a connection could not be established.
If assistance is needed with any errors received, contact Epicor Technical Support.
URL - The URLs (website addresses) that you can potentially receive from Avalara to access AvaTax from
Epicor include https://avatax.avalara.net (Production / Live) and https://development.avalara.net
(Development / Testing).
Request Timeout - Determines the number of seconds that may elapse before Epicor stops trying to
communicate with AvaTax for any reason, after which a timeout-related error message is then generated.
Epicor's Tax Connect Support team recommends using a setting of 300 (5 minutes) to accommodate
internet performance-related slowdowns which may occur from time to time.
Account User Name and Key/Password - Provided by Avalara Inc. and are supplied here to allow
Epicor to access your AvaTax environment for the purpose of handling tax calculations, address validations,
invoice postings, and unposted invoice deletions which may occur.
Note Only credentials which allow an administrator level of access to the AvaTax Admin Console
should be used. Avalara provides different credentials for Production and Development.
Text Case - Controls the case of address data received by Epicor from Avalara when addresses are
validated. Possible settings include Default, Mixed, and Upper.
Note The actual case of the characters in Epicor addresses that are processed for validation has
no effect on the case of the suggested address data that is returned to Epicor by Avalara.
Address Validation Enabled - For tax calculations to occur, valid addresses are required. Select this
check box so that individual addresses can be sent to Avalara for validation from multiple Epicor
maintenance screens, such as Company Configuration, Site Maintenance, Warehouse Maintenance, and
Customer Maintenance. Enabling Address Validation also allows ranges of addresses to be validated by
the Bulk Address Validation process.
Tax Calculation Enabled - Selecting this check box causes tax calculations to be handled by Tax Connect
/ AvaTax instead of by the internal tax engine that is included in Epicor.
Tax ID Prefix - Used by Tax Connect for any Tax Type records that it automatically creates as needed
when taxes are calculated for transactions. This prefix helps to differentiate Tax Connect-created Tax
Types from any Tax Types which may have been manually created in the past by Epicor customer sites
that formerly used the internal Epicor tax engine and functionality before acquiring the Tax Connect
module.
Default Tax Category - Specifies the product tax category that is to be used by default with sales order,
invoice, and credit memo lines that do not have one defaulted in for the applicable part or miscellaneous
charge, or manually entered by users.
Note If a Product Tax Category is defined as the default by selecting the Default check box on
the Detail sheet of Product Tax Category Maintenance , Epicor uses it in preference to the
Default Tax Category specified here for transaction lines which reference parts that do not have
a Tax Category defined on Part Maintenance. An exception is sales order lines for parts which have
a Product Group specified in Part Maintenance. If the part does not have a Tax Category defined
but its Product Group does, Epicor uses the Product Group's Tax Category in preference to all
others. This exception does not apply to miscellaneous AR invoices and credit memos since they
are not created from sales order shipments.
Epicor ERP 10
Epicor ERP 10
the Tax Connect Calculation check box on international tax liabilities to exclude transactions which reference
them from tax calculations and from AvaTax screens and reports.
3.2.2 Set Up Tax Liabilities for Consumer Use Tax (If Needed)
If you need to calculate self-assessed consumer use taxes for supplier AP invoice transactions, use Tax Liability
Maintenance to create Use Tax calculation-capable Tax Liability codes, and then assign them to suppliers to
automatically enable by default Use Tax calculations for their AP invoices.
1. Select Financial Management > Accounts Payable > Setup > Tax Liability.
2. In Tax Liability Maintenance, click New. Create a new Tax Liability for consumer use tax. For example, in
the Tax Liability field, enter AVA, and in the Description field, enter Use Tax Capable.
Note You can also select an existing Tax Liability to use with Tax Connect. To do this, click the Tax
Liability button. Search for and select a tax liability code with a description indicating it was set up
for Use Tax, Tax Connect, or AvaTax.
Epicor ERP 10
Site
Warehouse
You can manually validate addresses for each individual Sold To customer, Ship To customer, company, site, and
warehouse or use the Bulk Address Validation screen to validate multiple addresses at the same time.
6. Navigate to Ship To > List and select a ship to for which you want to validate the address. Review the
address on the Ship To > Detail sheet and enter any corrections that may be needed.
7. Verify the Exclude from address validation check box is cleared.
8. From the Actions menu, select Tax Connect > Validate Ship To Address. When the Address Validation
window appears, review the results of the validation and update the Ship To address if needed.
Note The Address Validation window displays an error on the Messages > Detail sheet if the existing
address is incomplete or invalid. If the submitted address was found in the address database either
with or without suggested changes, you may click the Update Original button then click OK to accept
suggested changes, then click Save on the main screen or click the OK or Cancel button to close the
window without accepting changes.
9. Repeat these steps for each customer address and each customer ship to address you want to validate.
Epicor ERP 10
3. From the Actions menu, select Tax Connect > Validate Address. When the Address Validation window
appears, review the results of the validation and update the Company address if needed.
Note The Address Validation window displays an error on the Messages > Detail sheet if the existing
address is incomplete or invalid. If the submitted address was found in the address database either
with or without suggested changes, you may click the Update Original button then click OK to accept
suggested changes, then click Save on the main screen or click the OK or Cancel button to close the
window without accepting changes.
10
Epicor ERP 10
9. Navigate to the path on the Epicor server where the Bulk Address Validation log file is located. Open the
BulkAddressValidation.csv file or your own log file if you chose to override the default file name before
executing the process. Review the address validation results for error messages and address changes that
you may need to act on.
Epicor ERP 10
11
Configure Avalara
4 Configure Avalara
Use this section to configure your AvaTax system.
5 Test Configurations
Create test transactions and review the tax calculation results to verify the configurations before enabling Tax
Connect in your live/production Epicor environment. Please review the following information before testing your
configurations:
AvaTax only allows each AR invoice number to be used once per Epicor company per AvaTax account, therefore
care must be taken to avoid consuming the same series of AR invoice numbers by the same Epicor company in
the same AvaTax account. If you try to use the same AR invoice numbers more than once for the same Epicor
company in the same AvaTax account, a "DocStatus is invalid for this operation" message is received in Epicor
and taxes are not calculated for the second and any other subsequent attempts to use the same invoice numbers,
which also prevents the invoices from being printed and posted.
Consider the following options while preparing to pilot or test Tax Connect:
Ask Avalara personnel to provide a development/testing account and URL (https://development.avalara.net)
that is separate from the live account and URL (https://avatax.avalara.net) you already have (a fee may apply).
If this option is used, the test Epicor company would be pointed to its own development/testing AvaTax URL
12
Epicor ERP 10
Test Configurations
and account and its test transactions would therefore not be co-mingled in AvaTax with the transactions
which you send to it for your live/production company.
Note If the pilot/test DB is refreshed by overwriting it with a current copy of the live DB, it inherits the
live DB's Starting AR invoice number value that is specified on the Accounts Receivable tab of the
Company Configuration screen in Epicor. Whenever this is done, be sure to increment the Starting AR
invoice number value on the Accounts Receivable tab of the Company Configuration screen in the test
DB to a value that causes it to consume a series of invoice numbers which have not been consumed
before by that same Epicor company and AvaTax URL/account combination
Note If the pilot/test DB is refreshed by overwriting it with a current copy of the live DB, it also inherits
the live DB's Avalara URL (https://Avatax.avalara.net), Account User Name and Key/Password. It is
important to remember to revert each of these back to the correct values for your pilot/test DB so test
transactions that you create do not get added to your live/production Avalara account/environment.
Use only one AvaTax account and URL (https://avatax.avalara.net) for both your test transactions and for your
live/production transactions. If this option is used, the test transactions can be kept segregated from the
live/production transactions by using one or both of the following methods:
Segregate by Company: Create and test with an Epicor company that is different from the live/production
company so test and live/production transactions are kept separate within the same AvaTax account by
company.
Segregate by invoice number range: Assign different Starting AR invoice number values on the Accounts
Receivable tab of the Company Configuration screen in Epicor for the test company and for the live
company. Using this method by itself (not in concert with the one mentioned above) is perhaps the most
risky, least desirable choice that can be made.
You may use the Void button on the Transactions screen of the AvaTax Admin Console to void any undesired
test transactions which have been selected; this prevents them from appearing on AvaTax reports. Take
extreme care to not void any transactions which came from your live/production Epicor database!
Note There is no transaction deletion capability in AvaTax. Transactions are only deleted from AvaTax
when they are deleted from Epicor; only unposted transactions may be deleted from Epicor.
Epicor ERP 10
13