Usage
How it works
Section titled “How it works”When the delivery address (or the shipping estimator on the cart page) is in a country covered by an active rule and the goods ship from another country, the cart shows one line:
Import duties & fees (estimated) with a small breakdown (duty, handling fee, VAT).
- DDP rules add the amount to the total. The line shows in the cart, at checkout, on the order page, in the order e-mail and on the invoice.
- DAP rules show the line as “estimated, not included in the total”: the customer pays on delivery.
Every order keeps its lines and a snapshot of the customs data of each item (description, HS code, origin, quantity, value, weight). The order page shows a Customs data block.
Rules reference
Section titled “Rules reference”Defaults shipped with the add-on. Check each source yourself: the add-on gives estimates, not customs advice.
| Region | Rule | In force | Official source |
|---|---|---|---|
| EU | EUR 3 customs duty per item on low-value consignments (up to EUR 150) from outside the EU; temporary until 1 July 2028 | 1 July 2026 | European Commission, EU customs reform (Council Regulation (EU) 2026/382) |
| EU | EUR 2 Union handling fee. The Commission page confirms the fee; whether it counts per customs item or per parcel is set by Delegated Regulation (EU) 2026/2152, which you should read. The add-on counts per customs item by default: move the amount to “Fee per parcel” if you need the other reading | 1 November 2026 | European Commission, EU customs reform |
| EU | IOSS: VAT on distance sales of goods up to EUR 150 from outside the EU is declared through the Import One-Stop Shop; your IOSS number goes on the documents. The VAT itself comes from your tax rates; the add-on does not file IOSS returns | since 2021 | EU VAT One-Stop-Shop |
| UK | Consignments up to GBP 135 sold directly to Great Britain: the seller charges UK VAT at the point of sale and may need to register. Shipped as a rule that is off by default (VAT rate 20%, check it) | in force | GOV.UK, VAT and overseas goods sold directly to customers in the UK |
| UK | The GBP 135 customs duty relief is being removed; GOV.UK gives no effective date yet. Adjust or disable the rule when the date is set | announced | GOV.UK, reforming customs rules for low-value imports |
| US | Duty-free de minimis treatment (USD 800) is suspended for all countries and all modes including mail; goods need formal or informal entry. Gifts and traveller exemptions stay. A DAP estimate rule ships off: enter your duty % or HS rates, then switch it on or make it DDP | suspended | CBP, e-commerce FAQs |
Dates and amounts change. Edit the rules instead of waiting for an update: every number is a table value.
Common tasks
Section titled “Common tasks”Set up the add-on in five minutes
Section titled “Set up the add-on in five minutes”- Open the add-on settings and enter your Ship-from country; enter your IOSS / UK VAT / EORI numbers if you have them.
- Open Orders → Cross-border duties → Rules. Check that EUR and GBP exist in Administration → Currencies; the setup check at the top tells you.
- Press Add to documents.
- Add an HS code and origin to your products (below).
- Put a product in the cart, estimate shipping to Germany: the duty line appears.
Add customs data to products
Section titled “Add customs data to products”- One product: the product form has HS code, Country of origin, Customs description and Ships from under the SKU field.
- Many products: Bulk edit → Download all products (CSV), fill
hs_code,origin_country(two letters),customs_description,ship_from_country, upload it again. Empty cells keep the stored value; a single-clears it. - A category: Bulk edit → Apply to a category sets the values on every product of the category and its subcategories (optionally only empty fields).
Find products without data
Section titled “Find products without data”Audit lists active products without an HS code or origin (filter, search, CSV of the products to complete).
Export customs data for postal and carrier forms
Section titled “Export customs data for postal and carrier forms”CN22 / CN23 export shows cross-border orders of a period, one row per item (sender and recipient country, Incoterm, description, HS code, origin, quantity, value, net weight in kg, IOSS and EORI numbers) and downloads them as CSV. The order page has a download link for that order.
Switch a US estimate to a collected amount
Section titled “Switch a US estimate to a collected amount”On the Rules tab set the US rule’s mode to DDP, enter the duty % (or HS rates), save. The amount is then part of the order total.