AbanteCart/TaxJar Integration extension

Important Notes:
1. Starting with extension version 1.2.15 we have adopted a license key for all our extensions. Your extension will only work if you have a validated license key entered for the location where your extension is installed. Refer to here for more details on how license keys work.
2. In our opinion AbanteCart v 1.2.14 is extremely problematic and requires a large number of patch files to work correctly. Our recommendation is to upgrade v 1.2.14 to AbanteCart v 1.2.15.
This extension v 1.2.15 is tested to work with AbanteCart v 1.2.15. It may work with AbanteCart v 1.2.14 if all the patch files have been updated but we don't recommend you using AbanteCart v 1.2.14.

AbanteCart Version(s) 1.2.6-1.2.15 use TaxJar Integration extension v 1.2.15.

This extension helps you calculate tax rates by using TaxJar service, also transmits the order to TaxJar for filing returns and accumulating sales to determine if Nexus has been reached.
Features included:
• Tax rate calculation.
• Transmit orders to TaxJar Service.
• Customer tax exempt.

Important Notes:
• The tax rate calculation is made only when customer arrives at checkout/confirm or checkout/guest_step_3 page to reduce the number of API calls. Recalculation will be done if customer adds a new product, updates the current product quantity or changes the zip code.
• You need to turn OFF Taxes in Extensions -> Order Totals.
• You need to turn OFF System -> Settings -> Checkout -> Display Prices with Tax.
• You need to turn OFF Tax class in shipping extensions.
• Subtotal calculation should precede TaxJar Integration Total calculation order. Check this in Extensions -> Order Totals.
• TaxJar Integration Total sort order and calculation order must be set to 5. Check this in Extensions -> Order Totals.

Recommendation: Use our Sales By State Report. It is an ideal way to keep track of your potential economic nexus by Remote or Online Sellers. Economic nexus does have thresholds that trigger your requirement to collect and remit taxes.

Getting Started:

Before you can start using TaxJar Integration in AbanteCart, you need to have an account with TaxJar and your company setup. Click here to create a new account and follow the instructions here for the steps. And you can directly setup the extension if you already have a Live API Token.

Obtain API Token

Register:

1. Enter your email address.
2. Enter your desired password.
3. Click Sign Up.

First step:

1. Enter your business name.
2. Select the total of orders that you process each month.
3. Click Save & continue.

Second step:

1. Click the SmartCalcs API (For Developers) button.

Third step:

1. Click the get started button.

Fourth step:

1. Click the get started button.

Last step:

1. Copy the live API Token into field no 6 in the setup page below.
Important Notes: number 2 is available for TaxJar PRO account only.
2. Copy the Sandbox API Token into field no 5 in the setup page below.
3. Click the edit button to edit your business profile where it will be used as the primary address.
4. Click this button if you want to add new state with Nexus.

Setup

Once you have installed the integration you will see this page – or find it in your Admin Panel Extensions > TaxJar integration, select the Edit link on the far right side.
1. This is the manual link.
2. This is extension quick note.
3. Turn ON to use the extension.
4. Enter you license code. Refer to How to obtain license code section for more information.
5. Sandbox Mode: Turn ON to use sandbox mode. This mode is only available for TaxJar PLUS account.
6. Sandbox API Token: Enter the sandbox API Token that was provided by TaxJar. This is only available for TaxJar Plus account. Sandbox mode must be turned ON prior using the mode.
7. API Token: Enter the Live API Token that was provided by TaxJar.
8. Tax Name: Enter the desired tax name (label name) to be shown to the customer in the totals section.
8. Street Address: Enter your street address.
10. City: Enter your City name.
11. State Code: Enter your (two letters) State code.
12. ZIP/Postal code: Enter your ZIP/Postal Code.
13. Country Code: Enter your (two letters) Country code.
14. Enable TaxJar tax calculations: If enabled, the extension will calculate all sales tax for your store.
Important notes: No 15-17 will be shown only if you turned ON Enable TaxJar tax calculations and after you SAVE the settings, the extension will download the nexus addresses that you have set in TaxJar dashboard, and generate fallback tax rate field for each of nexus address. The fallback tax rate will be used to calculate tax rate in every other page than checkout/confirm or checkout/guest_step_3 page.
15. Sync Nexus Addresses: Click this to sync TaxJar Nexus addresses into your cart. You only need to click this if you add new or remove Nexus address and wait for about 5 minutes after adding the new or remove Nexus address.
16. Manage Nexus Locations: Click this to go to TaxJar Nexus addresses management.
18. Fallback tax rate for (state code): This field is generated according to your Nexus address(es). So if you have 2 Nexus address, then it will show 2 fields. And this field value will be used as the fallback tax rate calculation for checkout/cart page.
19. Enable export orders to TaxJar: If enabled, the extension will export your orders to TaxJar for reporting.
Important notes: No 20-25 will be shown only if you enable export orders to TaxJar and after you

SAVE

the settings.
20. Transmit order to TaxJar: If turned ON, the order will be transmitted at specified order status.
21. Transmit on order status: If the order status is the same as this order status, the order will be transmitted to TaxJar.
22. Delete TaxJar order: If turned ON, the order will be deleted at specified order status.
23. Delete on order status: If the order status is the same as this order status, the order on TaxJar will be deleted.
24. Refund TaxJar order: If turned ON, the order will set to refund at specified order status.
25. Refund on order status: If the order status is the same as this order status, the order on TaxJar will set to refund.
26. Debug API response: Turn ON if you want to get the API response for debugging purpose. The API response will be written to System -> Logs -> Error Logs.
27. Run Order: Leave it blank if you don't want to set the sort order.
28. Test Connection: Click this button to test if the API Token is set correctly and able to connect to TaxJar. You need to enter the required fields prior testing the connection.
29. SAVE - do this prior to testing.
30. Click this to remove your current settings.
Important notes: In order to have your order transmitted to TaxJar when you update the order status via the order grid, you have to make sure that the order status is the same with your settings.

Adding taxcode to each product:

On Admin dashboard - Catalog > Products - click on the edit icon for one product, click on the TaxJar integration tab
Notes: You may use 11111 as the product code if TaxJar category type doesn't suit your category. If you leave the product tax code empty, the extension will use 11111 as the default tax code and products will be fully taxable.
Next - find the correct tax code for your product. If you do not already know it, click on the Find Tax Code button to be taken to TaxJar codes.

Once you find the desired code, copy only the code number, then paste it into your product page. Save the page.

Handling sales tax exempt customers:

If you have exempt customers you will have already set up your AbanteCart customer groups and established your requirement parameters for the exemption(s). When customer register in your store or in profile edit page he can set Entity/Use Code to claim exempt. However, it will work only after store administrator manually review it and set status to Approved.

On Admin dashboard - Sales Customers - click on the edit icon for customer, click on customer details. Click on the TaxJar integration tab.
1. Exemption status - is Pending, Approved, or Declined. Only Approved, as selected by the Administrator, will exempt customer from taxes.
2. Exemption number - recommended you input customer info for qualified exemption status.
3. Entity/Use Code – select on of the TaxJar exemption codes from the dropdown list.
4. SAVE the page.

Administrator can review or add manually Exemption Number or Entity/Use Code in Sales > Customers > Edit Customer page > TaxJar integration tab. If you exempt customers from tax with exemption numbers or exemption type, keep organized records for all exempt purchases.