Intermodaal – HS-goederencodes: wat, waarom en hoe
HS-goederencodes toevoegen aan goederen voor douaneaangiften die aan de regels voldoen. Qargo biedt een doorzoekbare, centraal beheerde codedataset met regionale edities voor de EU, het VK en de VS. Douanekosten automatiseren op basis van het aantal HS-codes per order.
Inhoudsopgave
Inleiding
Wat zijn HS-goederencodes?
-
HS-codes (codes van het Geharmoniseerd Systeem) zijn internationaal gestandaardiseerde numerieke codes om verhandelde goederen bij grensoverschrijdend verkeer te classificeren.
-
Qargo biedt een centraal beheerde dataset met HS-codes, met regionale edities voor de EU, het VK en de VS.
-
Op goederenitems zijn twee optionele velden beschikbaar:
- HS-code: de basiscode voor import
- HS-code export overschrijven: te gebruiken wanneer de exportclassificatie van een goed afwijkt van de importclassificatie.
Waarom HS-codes in Qargo gebruiken?
- Zonder correcte classificatie van de goederen kunnen douaneaangiften niet correct worden gevalideerd of getarifeerd.
- Door codes rechtstreeks in Qargo te selecteren, blijft de douane-informatie in één systeem en zijn er minder manuele fouten.
- De doorzoekbare keuzelijst werkt op dezelfde manier als bij ADR. Zo vinden planners snel de juiste code, via de numerieke code of via een omschrijving in gewone taal.
Hoe werkt het?
- HS-codevelden zijn optionele standaardvelden op *goederenitems*. Ze moeten in de configuratie van de standaardvelden worden ingeschakeld voordat ze in het orderformulier verschijnen.
- Voor niet-ADR-goederen moet ook de feature flag *Verpakkingsitems* op tenantniveau actief zijn.
- Zodra de HS-codegegevens zijn ingevuld, worden ze automatisch doorgegeven aan DFS, PDF-documentsjablonen en orderimports.
Terminologie
| Term | Definitie |
|---|---|
| HS-code | Een code van het Geharmoniseerd Systeem: een internationaal gestandaardiseerde numerieke reeks om goederen voor douanedoeleinden te classificeren. Ook goederencode of tariefcode genoemd. |
| HS-code export overschrijven | Een alternatieve HS-code die wordt toegepast wanneer de exportclassificatie van een goed in een bepaalde regio afwijkt van de importclassificatie. Alleen nodig wanneer de twee codes niet dezelfde zijn. |
| Goederenitem | Een verpakt item binnen een handling unit op een order: het niveau waarop HS-codes worden geregistreerd. |
| Standaardvelden | Configuratie-instellingen die bepalen welke optionele velden zichtbaar zijn op goederen bij het aanmaken en bewerken van orders. |
| Regionale editie | Een regiospecifieke versie van de HS-codedataset (EU, VK of VS), die de lokale tariefschema’s weerspiegelt. Qargo beheert deze centraal. |
| Feature flag Verpakkingsitems | Een toggle op tenantniveau die details op itemniveau inschakelt voor niet-ADR-goederen. Nodig om HS-codevelden op niet-ADR-goederen te laten verschijnen. |
| Aantal HS-codes (automatisch) | Een metriek die de goederenitems op een order telt waarbij het veld HS-code is ingevuld |
| Aantal HS-codes (manueel) | Een metriek die een numeriek aantal HS-codes optelt dat per goederenlijn manueel in een extra veld is ingevoerd |
| Gestaffelde kost | Een prijsstructuur waarbij het tarief verandert op basis van een drempel (bv. eerste 3 codes aan £5, elke extra code aan £2) |
HS-codevelden inschakelen
HS-codevelden zijn optioneel en moeten worden geactiveerd voordat ze in het orderformulier verschijnen.
Stap 1: de feature flag Verpakkingsitems inschakelen (alleen niet-ADR-goederen)
- Om HS-codes op niet-ADR-goederen te laten verschijnen, moet de feature flag Verpakkingsitems op tenantniveau zijn ingeschakeld. Deze actie kan alleen een Qargo admin uitvoeren.
- HS-codes op ADR-goederen vereisen de feature flag Verpakkingsitems niet: ze zijn beschikbaar zodra de standaardvelden zijn ingeschakeld.
Stap 2: standaardvelden inschakelen
- Navigeren naar Configuratie > Extra velden
- De velden HS-code en HS-code export overschrijven zoeken in de lijst met velden voor goederenitems.
- Beide velden inschakelen met de toggle.
- De configuratie opslaan.

- Na het inschakelen verschijnen de velden HS-code en HS-code export overschrijven op goederenitems, zowel bij het aanmaken van een order als op de detailpagina van bestaande orders.
Een HS-code selecteren op een goederenitem
Bij het aanmaken van een order
- Openen: het invoerformulier voor orders openen en een goed toevoegen.
- Uitklappen: de sectie van het goederenitem uitklappen om het veld *HS-code* te tonen (en *HS-code export overschrijven*, indien van toepassing).
- Klikken: op het veld HS-code klikken om de zoekfunctie in de keuzelijst te openen.
- Zoeken: de numerieke HS-code of een omschrijving van de goederen in gewone taal invoeren. Het systeem toont overeenkomende codes met hun omschrijving uit de centrale dataset van Qargo.
- Selecteren: de juiste code in de resultaten selecteren. Voor elke code is een detailweergave beschikbaar om de volledige classificatie vóór het selecteren te controleren.

Op een bestaande order
- Navigeren naar de detailpagina van de order.
- Uitklappen: het betreffende goed in de sectie Lading uitklappen.
- Zoeken: het veld HS-code op het ladingitem zoeken.
- Klikken op het veld om de zoekfunctie in de keuzelijst te openen, de juiste code selecteren en opslaan.
HS-codes via orderimport
HS-codegegevens kunnen worden meegegeven bij het importeren van orders via de externe API of via een bestandsimport.
Twee methodes worden ondersteund:
- Rechtstreekse code-invoer: de exacte HS-code opgeven. Het systeem koppelt die rechtstreeks aan de dataset van Qargo.
- Opzoeken op omschrijving: een tekstomschrijving van het goed opgeven. Het systeem zoekt in de dataset en wijst de best overeenkomende HS-code toe.
Zowel de waarde van HS-code (import) als van HS-code export overschrijven kan in importbestanden worden opgenomen. Zo kan de volledige douaneclassificatie samen met de overige ordergegevens worden doorgegeven.
Metrieken voor prijsberekening met HS-codes
In de prijsberekeningsmodule zijn twee metrieken beschikbaar om douanekosten te automatiseren op basis van het aantal HS-goederencodes per order:
-
Aantal HS-codes (automatisch): telt automatisch de goederenitems op een order waarbij het bestaande veld HS-code is ingevuld.
- Beschikbaar wanneer het extra veld HS-code voor de tenant is ingeschakeld.
-
Aantal HS-codes (manueel): gebaseerd op een nieuw, in te schakelen extra standaardveld op Lading (Configuratie > Extra velden).
- Planners voeren per goederenlijn een numeriek aantal HS-codes in; Qargo telt die op tot op orderniveau.

Beide metrieken staan in de categorie Bestelde goederen in de prijsberekeningsmodule en kunnen als voorwaarde of als basis voor een gestaffelde kost worden gebruikt in verkoop- en aankoopprijslijsten.
De metrieken voor het aantal HS-codes gebruiken in een prijslijst
- Inschakelen: het betreffende extra veld inschakelen in Configuratie > Extra velden (super admin).
- Navigeren naar Tarieven > Prijslijsten klanten en de betreffende verkoop- of aankoopprijslijst openen.
- Toevoegen: een nieuwe berekening of voorwaarde toevoegen.
- Onder Bestelde goederen selecteren: Aantal HS-codes (automatisch) of Aantal HS-codes (manueel).
- Configureren: de gestaffelde tariefstructuur naar wens configureren (bv. staffels op basis van drempels).
- Opslaan: de prijslijst opslaan.
Beperkingen
- Beide metrieken zijn alleen beschikbaar voor prijsberekeningen en filters (niet voor kostenberekeningen).
- Een voorwaardelijke prijsberekening op basis van een specifiek douanedocumenttype (export / import / T-document / EUR-1) wordt momenteel niet ondersteund
- Er is geen automatische export van gegevens per goederenlijn naar externe systemen van douanekantoren.
HS-codes in documenten en DFS
Zodra een HS-code op een ladingitem is ingevuld, is die automatisch beschikbaar in:
- PDF-documentsjablonen: de HS-code (en de afwijkende exportcode, indien van toepassing) kan worden opgenomen in elk documentsjabloon dat naar velden van goederenitems verwijst, zoals douaneaangiften, CMR’s of handelsfacturen.
- DFS (Data Feed Service): zowel de import- als de export-HS-code wordt via DFS beschikbaar gesteld voor integratie met downstreamsystemen.
Naast het inschakelen van de velden is hiervoor geen extra configuratie nodig.
Waarom bestaat dit?
Grensoverschrijdende douanekosten zijn vaak gestaffeld op basis van het aantal goederenlijnen per order (bv. de eerste 3 codes aan een vast tarief, elke extra code aan een ander tarief). Qargo had geen metriek op orderniveau om deze berekening te automatiseren. Vervoerders moesten HS-codes manueel tellen en douanekosten met de hand toepassen.
Vereisten
-
Super admin: om een van beide metrieken te gebruiken, eerst het betreffende extra veld inschakelen via Configuratie > Extra velden:
- Voor Aantal HS-codes (automatisch): het veld HS-code op goederenitems inschakelen (niveau verpakt item).
- Voor Aantal HS-codes (manueel): het nieuwe veld Totaal aantal HS-codes per order (manueel) op Lading inschakelen (niveau goed).
Een tenant schakelt doorgaans een van de twee metrieken in, afhankelijk van of HS-codes in Qargo worden ingevuld of extern worden geteld.
Probleemoplossing
| Probleem | Oplossing |
|---|---|
| HS-codevelden zijn niet zichtbaar op goederenitems bij het aanmaken van een order | Controleren of HS-code en HS-code export overschrijven zijn ingeschakeld onder Configuratie > Extra velden > Verpakt item. |
| HS-codevelden zijn niet zichtbaar op niet-ADR-goederen | Naast het inschakelen van de standaardvelden moet de feature flag Verpakkingsitems op tenantniveau actief zijn. Voor het inschakelen contact opnemen met Qargo-support of de accountmanager. |
| De keuzelijst voor HS-codes geeft geen resultaten | Zoeken met een korter trefwoord of een gedeeltelijke code. Qargo beheert de dataset. Als een specifieke code ontbreekt of onjuist lijkt, contact opnemen met Qargo-support. |
| Het veld voor de afwijkende exportcode verschijnt niet | Controleren of het veld HS-code export overschrijven apart is ingeschakeld in de standaardvelden; het is een ander veld dan HS-code. |
| HS-codes verschijnen niet in PDF-documenten | Controleren of het documentsjabloon een veldmapping bevat voor het veld HS-code van het goederenitem. Mogelijk moet de sjabloonconfiguratie worden bijgewerkt om de nieuwe velden op te nemen. |
| De HS-code wordt niet ingevuld na een orderimport met opzoeken op omschrijving | De omschrijving moet specifiek genoeg zijn om één unieke overeenkomst op te leveren. Waar mogelijk de exacte HS-code in het importbestand opgeven voor een precieze koppeling. |
| De metrieken voor het aantal HS-codes zijn niet beschikbaar als tariefbasis | De extra velden zijn niet ingeschakeld. De velden inschakelen in Instellingen > Extra velden |
| De automatische telling geeft nul | De HS-codevelden op de goederenlijnen zijn leeg. De HS-codevelden op de goederenlijnen van de order invullen |
| De manuele telling komt niet overeen met de verwachting | De aantallen per goederenlijn zijn niet ingevoerd. Het aantal invoeren op elke goederenlijn van de order |
