Homeβ€ΊDocumentation

Documentation & Guides

Everything you need to install, configure, and maximise Tax & Duty King for your international customers.

Getting Started HS Codes UK–EU TCA IOSS De Minimis Widget Setup AI Agents
Step-by-Step

Getting Started with Tax & Duty King

Follow these five steps to go from installation to live import fee calculations in under 15 minutes.

1

Install from the App Store

Visit the Tax & Duty King listing and click Install. Approve the requested permissions β€” these allow the app to read your products for HS classification and write HS codes back to Shopify inventory items.

2

Configure Settings

Open the Settings tab. Set your Store Country of Origin β€” the country your goods are manufactured in or shipped from. This determines whether TCA, IOSS, or other trade agreements apply to your shipments.

3

Classify Your Products

Go to the HS Codes tab. Click Classify All with AI to run the AI classification engine. Review suggestions, approve correct ones, override any that need adjustment, then click Push All to Shopify to sync the codes.

4

Add the Widget to Your Theme

In Shopify Admin, go to Online Store β†’ Themes β†’ Customize. Navigate to your cart template. In the left panel, find the Apps section and add the Tax & Duty King block. Drag it to your preferred position and save.

5

Test & Go Live

Use a VPN set to a supported country (e.g. Germany or the USA) and add a product to your cart. You should see the import fee breakdown appear. If the widget isn't showing, see our Troubleshooting Guide.

Reference Guide

What Are HS Codes?

An HS code (Harmonized System code) is a 6-digit number used by customs authorities in every country to identify a product and determine the applicable import duty rate. The system is maintained by the World Customs Organization and used by 200+ countries.

For example, 9004.10 is the HS code for sunglasses. A pair of sunglasses shipped from Germany to the UK would attract a 2.7% UK import duty based on this code (unless TCA zero-duty applies).

Why HS Codes Matter for Your Store

  • Accurate duty calculations β€” Without the correct HS code, Tax & Duty King cannot calculate the precise duty rate. An incorrect code could mean overcharging or undercharging customers.
  • Shopify compliance β€” Shopify uses HS codes on inventory items for international shipping labels and customs declarations. Correct codes reduce delays at customs.
  • TCA eligibility β€” The UK–EU TCA zero-duty rate is applied at the HS code level. The correct code is required to determine whether a product qualifies for preferential rates.

HS Code Structure

An HS code is hierarchical. The first two digits are the chapter, the first four are the heading, and all six form the subheading used for duty determination.

LevelDigitsExampleMeaning
ChapterFirst 290Optical & photographic instruments
HeadingFirst 49004Spectacles, goggles and the like
SubheadingAll 69004.10Sunglasses
Trade Agreement

UK–EU Trade and Cooperation Agreement

How zero-duty rules work for EU-origin goods arriving in the UK.

The UK–EU Trade and Cooperation Agreement (TCA), which came into force on 1 January 2021, allows goods with proven EU origin to be imported into the UK with zero customs duty. Without TCA, most goods would attract UK Global Tariff rates of 6–12%.

βœ“ What Tax & Duty King does automatically

When a customer's delivery address is in the United Kingdom and your store's country of origin is set to an EU member state, Tax & Duty King applies TCA zero-duty logic automatically. The widget shows 0% customs duty for eligible products.

Rules of Origin

TCA zero-duty only applies if the goods genuinely originate in the EU. The key criteria:

  • β†’The product must be wholly obtained in an EU member state, or sufficiently processed there (substantial transformation).
  • β†’Products made from non-EU components may still qualify if processing meets the product-specific rules of origin for their HS code chapter.
  • β†’Goods manufactured outside the EU and simply warehoused there do not qualify. Set the correct country of origin per product in Settings.
⚠️ Compliance note: Applying TCA zero-duty to non-EU-origin goods is a customs compliance error. Use the multi-origin feature in Settings to assign the correct country of origin per product or vendor.
UK Sellers Shipping to the EU

Import One Stop Shop (IOSS)

The Import One Stop Shop (IOSS) is an EU VAT scheme for UK sellers shipping goods to EU customers. It applies to shipments valued at €150 or less. Under IOSS, the UK seller registers for EU VAT and collects it at the point of sale β€” EU customers receive their parcels without unexpected courier VAT bills at the door.

Note: IOSS covers VAT on UKβ†’EU shipments. It is separate from the UK–EU TCA, which covers import duty on EUβ†’UK shipments. Both may apply to the same product depending on the trade route.

❌ Without IOSS
  • Customer pays product price at checkout
  • Courier collects import VAT at delivery
  • Customer receives unexpected bill
  • Risk of refused delivery & returns
βœ“ With IOSS
  • VAT collected at checkout
  • No additional charges at delivery
  • Faster customs clearance
  • Better customer experience & fewer returns

Tax & Duty King handles IOSS by displaying the VAT-inclusive price in the cart widget for eligible shipments: UK seller shipping to an EU destination, order value under €150, and IOSS registration active in Settings. The widget shows the VAT amount as "collected at checkout" rather than as a separate import fee, preventing surprise charges at delivery.

Threshold Rules

De Minimis Thresholds by Country

The value below which imported goods are exempt from customs duty. Tax & Duty King applies these automatically.

CountryDuty-Free ThresholdVAT-Free ThresholdNotes
πŸ‡¬πŸ‡§ United KingdomΒ£135Β£0 (VAT always applies)IOSS applies for UK sellers
πŸ‡ͺπŸ‡Ί EU Member States€150€0 (VAT always applies)IOSS applies for registered sellers
πŸ‡ΊπŸ‡Έ United StatesSubject to changeN/AAI agent monitors for updates
πŸ‡¨πŸ‡¦ CanadaC$20C$20GST/HST applies above threshold
πŸ‡¦πŸ‡Ί AustraliaA$1,000A$0 (GST always applies)GST collected at checkout
πŸ‡¨πŸ‡­ SwitzerlandCHF 5CHF 65Swiss VAT rate: 8.1%
ℹ️ Note: De minimis thresholds are subject to change by governments. Tax & Duty King's AI agents monitor for threshold changes and update calculations automatically.
Setup Guide

Adding the Widget to Your Shopify Theme

The Tax & Duty King widget is added via the Shopify Theme Editor. It can be placed in the cart drawer, cart page, and product page.

1

Open Theme Editor

In Shopify Admin, go to Online Store β†’ Themes. Click Customize on your active theme.

2

Navigate to Cart Template

Use the page selector at the top of the editor to navigate to Cart. For the product page widget, navigate to Products β†’ Default product.

3

Add the App Block

In the left sidebar, click Add block. Scroll to the Apps section and select Tax & Duty King. Drag it to your preferred position.

4

Save & Test

Click Save. Test by using a VPN set to a supported country and adding a product to your cart. The import fee widget should appear.

Widget not showing? See the full troubleshooting guide β†’

Automation

AI Rate Monitoring Agents

Three autonomous agents keep your rate data accurate without any manual work.

πŸ“‹ AI VAT Rate Agent
Weekly Β· Mon 06:00 UTC

Monitors EU VAT rates via euvatrates.com and non-EU rates via GPT-4.1 AI research. Automatically updates the VAT rate database when changes are detected. Full change history with source citations available in the VAT Rates tab.

πŸ“¦ AI Duty Rate Agent
Weekly Β· Mon 06:05 UTC

Monitors WTO tariff schedules and trade agreement updates. Detects changes to duty rates for your specific HS codes and alerts you via the dashboard. Handles TCA, de minimis threshold changes, and trade policy updates.

πŸ’± Currency Rate Agent
Daily

Fetches live exchange rates for all 166 supported currencies daily. Import fees are always displayed in the customer's local currency using the most current rate. Full rate history available in the Currency Rates tab.

Still Have Questions?

Our support team is here to help you get set up correctly.