Overview ↑ Back to top
Cross-Border by Avalara helps merchants that sell internationally calculate the Duty and Import Tax assessed at the border for their shipped products and process payment for those fees at checkout. This lets you reduce customs delay and remove unexpected fees, ensuring an optimal experience for international purchases as they pay all fees at checkout and receive their shipments on time as expected.
In this guide, we’ll walk through how to setup Cross-Border by Avalara so it can be used with WooCommerce AvaTax. For details about setting up and using WooCommerce AvaTax in general, please visit the WooCommerce AvaTax documentation.
Requirements ↑ Back to top
- WooCommerce AvaTax v1.10+
- All requirements for WooCommerce AvaTax
- A service entitlement enabled for your Avalara account; contact Avalara to get this setup
- You must enter prices exclusive of tax; click here for more information
Setup ↑ Back to top
There are two components to setup:
- Configuring target countries to identify the countries where you collect and sell to
- Classifying your product catalog so that Avalara knows your WooCommerce product IDs and the harmonized system / tariff codes (HS codes) for those products
Configure target countries ↑ Back to top
First, you’ll need to setup the countries that you want to sell to in your Avalara account. You’ll need to provide some information in Avalara about your status in these jurisdictions, such as:
- Do you have a permanent establishment in this jurisdiction?
- When shipping to this jurisdiction, who is the importer of record?
- Are you shipping using a Delivery Duty Paid (DDP) or Delivery at Place (DAP) service?
Follow the steps below to configure target countries:
- Login to your Avalara account and go to Settings > Where you collect tax.
- Select the Customs duty tab, then click Add a country where you want to collect customs duty.
- Select one or more countries to add and click Add selected countries.
- Find the newly-added country in the Nexus list and click Details.
- Update the country’s detail page as needed and click Save.
- Repeat steps 4-5 as needed for each country you’ve added.
- Now, go back to Settings > Where you collect tax and select the VAT / GST tab. Repeat steps 3-5 as needed.
Classify product catalog ↑ Back to top
Once your countries are configured, it’s time to ensure your product catalog is added to AvaTax with the harmonized tariff codes and classification codes required to get accurate landed cost estimates for your products in WooCommerce.
There are essentially two options for accomplishing this step:
Send products to Avalara via SFTP or API
You can import your products to Avalara with several methods. Click here for guides on how to send products to Avalara and map their tariff codes.
If you decide to send the products via SFTP, you must provide the products in the Google product feed format. We recommend creating a product export from WooCommerce by going to WooCommerce > Products > Export.
Here are some additional resources to assist with creating the Google product feed:
- AvaTax guidelines for importing Google product catalogs
- ⚠️ Please note that while this document recommends using the product SKU for the Google product feed’s id field, you must use the product ID from WooCommerce instead. This will allow the plugin to find the product in AvaTax based on the AvaTax Item Code.
- Guide to Google product feed / WooCommerce product export mapping
Add products to Avalara manually
Alternatively, you can also add products manually by following the steps below:
- Go to Settings > What you sell.
- Click Add an item.
- Update the item page with the following details:
- Enter the Item Code. ⚠️ The Item Code should match the WooCommerce product ID for this product.
- Enter the Item Description. This can be the product’s name.
- Update the Avalara tax code field.
- Under Harmonized tariff codes, click Add or update tariff codes and populate the country and tariff code fields.
- Repeat step 4 for every country that you want to sell this product in.
- Click Save and get attributes.
- Update the product attributes if required.
- Click Save.
Repeat steps 2-7 for every product you need to sell internationally.
When an order is placed on WooCommerce, the plugin will now be able to find the product’s based on their AvaTax Item Code and AvaTax can then return the proper rates based on the entered country and tariff codes.
Checkout experience ↑ Back to top
Once you’ve completed setup, WooCommerce AvaTax will automatically present tariffs and duties at checkout when all products in the cart have harmonized tariff codes set.
If you, as the merchant, are the importer of record, estimated fees and duties will be added to checkout. The presentation of these fees will vary based on the Display tax totals setting under WooCommerce > Settings > Tax.
If Display tax totals is set to “as a single total”, the fees and duties will be displayed at checkout under a single Import Fees item.
If Display tax totals is set to “itemized”, customers will see each cross-border duty or fee listed individually at checkout.
If you are not the importer of record, the fees will be estimated after the order is submitted and can be viewed on the transaction in your Avalara account.
Managing international orders ↑ Back to top
When viewing an order from the WooCommerce > Orders page, you will see line items for any cross-border fees and duties.User Switching plugin to do so from the frontend.
Refunding orders ↑ Back to top
If you need to process a refund for an order with cross-border fees and duties, please first do so in your Avalara account so you can determine the accurate amount for the cross-border fees. You can then use this information to process the refund through WooCommerce or with your payment processor.
Viewing orders in Avalara ↑ Back to top
You can view cross-border transactions and amounts in Avalara by going to Transactions > Transactions and selecting the order in question.
Cross-border reporting ↑ Back to top
To download a report on your cross-border transactions, login to Avalara, go to Reports > Transaction reports, and select “Cross border reports” from the Report Category drop-down menu. You can select other filters / limits as desired, and then click Generate and download report to create the report.
Frequently asked questions ↑ Back to top
Q: Why can’t I enter product prices inclusive of tax?
A: Avalara’s API does not yet support calculating tax from an inclusive price, so this isn’t possible right now in the plugin. We’ll continue to monitor this so we can support it in the plugin once possible in the API.
Q: I don’t see cross-border fees at checkout like I expect. What might be wrong?
A: It sounds like you may not be listed as the importer of record. Please ensure that the This company is the importer of record setting is enabled in Avalara for the country in question.
Troubleshooting ↑ Back to top
Having trouble? Please check these steps before posting a support request:
- Check the WooCommerce AvaTax documentation to ensure that the plugin is configured properly.
- Please ensure that you meet the requirements for Cross-Border and contact your Avalara representative to ensure they’ve enabled Cross-Border on your account.
- Check the FAQs to see if they address your question.
Questions & support
Have a question before you download? Please fill out this pre-sales form.
Already downloaded and need some assistance? Get in touch with support via the help desk.