Waarom een complete douanebeschrijving belangrijk is
Elke cross-border zending heeft een HS-code nodig, en die code is maar zo goed als de beschrijving waaruit die komt. HS-classificatie stuurt de inklaring en de berekening van invoerrechten en belastingen, dus de beschrijving op uw handelsfactuur moet duidelijk vermelden wat het item is en waar het van gemaakt is.
Is een beschrijving vaag of dubbelzinnig, dan moet classificatie hiaten opvullen met een aanname — en een aangenomen detail kan leiden tot de verkeerde HS-code. Een verkeerde code betekent verkeerde invoerrechten en belastingen, en verhoogt het risico op vertragingen bij inklaring, boetes en andere complianceproblemen.
Met Customs Description Validation vangt u een zwakke beschrijving vooraf op, op het moment van gegevensinvoer, in plaats van het probleem te ontdekken nadat een item al op een gok is geclassificeerd. Ontbreekt iets, dan vertelt het precies welk detail u de klant moet vragen — zodat u de beschrijving kunt corrigeren vóór classificatie. Wilt u de beschrijving zelf genereren, zie Customs Description; voor de HS-code, zie Classify.
Hoe het werkt
U dient de beschrijvende velden in die u voor een item hebt — name, description, material en categories. Validatie beoordeelt of die informatie specifiek genoeg is om op één HS-code uit te komen zonder een niet-gesteld feit aan te nemen, zoals vezelgehalte, of een stof gebreid of geweven is, of het beoogde gebruik van het item.
Het retourneert een status die aangeeft hoe gereed de beschrijving is, en — wanneer iets ontbreekt — een clarifications-lijst die precies vertelt wat u moet vragen.
Validatie classificeert het item niet en retourneert geen HS-code. De status is adviserend: u beslist wat ermee te doen op basis van uw eigen beleid — doorgaan met classificeren, waarschuwen, de klant om meer detail vragen of het item afwijzen.
Twee optionele velden breiden de controle uit:
existingItemId— valideer een item dat u al hebt opgeslagen in plaats van velden inline door te geven. Velden die u ook opgeeft overschrijven opgeslagen waarden.shipToCountry— wanneer opgegeven controleert validatie ook of de beschrijving specifiek genoeg is om de landspecifieke tariefregel van de bestemming te kiezen, niet alleen de zescijferige HS-subheading.
Readiness-statussen
Het veld status retourneert een van vier waarden.
| Status↕ | Wat het betekent↕ | Aanbevolen actie↕ |
|---|---|---|
READY | De informatie is voldoende om met vertrouwen de HS-code te bepalen zonder aannames. clarifications is leeg. | Doorgaan met classificeren. |
INCOMPLETE | Het item is identificeerbaar, maar kiezen tussen plausibele HS-subheadings vereist een niet-gesteld detail aan te nemen. | Vraag de klant om het detail in clarifications, valideer of classificeer opnieuw. |
READY_TO_SUBHEADING | De zescijferige subheading is met vertrouwen bepaald, maar een detail ontbreekt nog voor de juiste landspecifieke tariefregel. Alleen mogelijk wanneer shipToCountry is opgegeven. | Optioneel het extra detail verzamelen voor precieze invoerrechten, of doorgaan op subheading-niveau. |
UNRECOGNIZABLE | De tekst maakt niet duidelijk wat het item fundamenteel is — bijvoorbeeld een lege waarde, een kale SKU of interne code, of onzin. | Vraag de klant het item opnieuw in te voeren. |
Clarifications
Wanneer de status niet READY is, bevat de clarifications-lijst korte, specifieke zinnen over wat aan de beschrijving moet worden toegevoegd — bijvoorbeeld "state the primary fiber content". Deze zinnen zijn geschreven om direct aan een klant te tonen; toon ze bij gegevensinvoer en vraag om het ontbrekende detail vóór u verdergaat.
Wanneer de status READY is, is clarifications leeg.
Een douanebeschrijving valideren
Gebruik de customsDescriptionValidate-mutatie. Geef de itemvelden direct op, of verwijs naar een opgeslagen item met existingItemId. Neem minimaal één beschrijvend veld op.
mutation CustomsDescriptionValidate($input: CustomsDescriptionValidationInput!) { customsDescriptionValidate(input: $input) { status clarifications content { name description material categories } }}In het bovenstaande voorbeeld is het item duidelijk identificeerbaar als blouse, maar kleding wordt deels geclassificeerd op materiaal en constructie — dus de juiste HS-code kiezen vereist een aanname. De status is INCOMPLETE en clarifications vertelt precies wat u de klant moet vragen. Zodra deze details zijn toegevoegd, valideert hetzelfde item als READY.
Een READY-voorbeeld bekijken
Een beschrijving die de beslissende attributen al bevat, valideert als READY zonder clarifications.
{ "input": { "name": "Men's crew-neck t-shirt", "material": "100% combed cotton, knit", "categories": [ "Apparel", "Tops" ] }}Een landspecifiek voorbeeld bekijken
Door shipToCountry toe te voegen wordt de gereedheid gecontroleerd tot aan de tariefregel van de bestemming. Hier is de zescijferige subheading al bepaald, dus de status is READY_TO_SUBHEADING en de clarifications beschrijven wat nog nodig is om de exacte tariefregel te kiezen.
{ "input": { "name": "Pullover sweater", "material": "100% cotton, knit", "categories": [ "Apparel", "Tops" ], "shipToCountry": "US" }}
Customs Description Validation
Controleer of de beschrijving van een item compleet genoeg is om het met vertrouwen te classificeren — vóór u classificeert.