DOCS
StartpaginaVoor logistieke dienstverleners Zonos Clarify Compliancevereisten controleren

Compliancevereisten controleren

Ontdek welke complianceprogramma's voor een item gelden en lees de vragenlijst die u moet beantwoorden.

GraphQL

De complianceRequirements-query is het startpunt voor Zonos Clarify. Op basis van de HS-code en route van een item retourneert deze de complianceprogramma's die worden geactiveerd, en kunt u de volledige vragenlijststructuur van elk programma doorlopen — vragen, opties en vertakkingslogica. Gebruik deze query om te bepalen of een zending compliance-antwoorden nodig heeft en om uw eigen vragenlijst-UI te renderen.

Scope vereist

Deze query vereist de COMPLIANCE_READ-scope. Zie OAuth voor het authenticeren van API-verzoeken.

Toepasselijke programma's ontdekken 

Geef de hsCode en shipToCountry van een item door om te bepalen welke programma's van toepassing zijn. Het resultaat is een gepagineerde connectie van ComplianceRequirement-nodes, die elk verwijzen naar het ComplianceProgram dat wordt geactiveerd.

1query ComplianceRequirements($filter: ComplianceRequirementFilter!) {
2 complianceRequirements(filter: $filter, first: 10) {
3 totalCount
4 pageInfo {
5 hasNextPage
6 endCursor
7 }
8 edges {
9 cursor
10 node {
11 id
12 hsCode
13 shipToCountry
14 shipFromCountry
15 program {
16 id
17 code
18 name
19 programType
20 authority
21 jurisdiction
22 status
23 strictness
24 currentVersion {
25 id
26 version
27 status
28 }
29 }
30 }
31 }
32 }
33}

Een shipFromCountry met de waarde null bij een requirement betekent dat het programma ongeacht de herkomst van toepassing is. Wanneer u shipFromCountry opgeeft in het filter, worden zowel herkomstspecifieke rijen als rijen voor „willekeurige herkomst” gematcht.

Filteren en paginering 

complianceRequirements accepteert een ComplianceRequirementFilter plus standaard cursorpagineringsargumenten (first / after om vooruit te pagineren, last / before om achteruit te pagineren).

Filterveld↕Type↕Opmerkingen↕
hsCodeStringExacte HS-codematch. Sluit hsCodePrefix uit.
hsCodePrefixStringPrefixmatch (alleen cijfers en punten, max. 12 tekens). Sluit hsCode uit.
shipToCountryCountryCodeBestemmingsland.
shipFromCountryCountryCodeLand van herkomst. Rijen met een null-herkomst („willekeurige herkomst”) komen ook overeen.
programTypes[ComplianceProgramType!]Alleen overeenkomst met deze programmatypes. Lege lijst = geen filter.

Toon bijvoorbeeld alle PGA-requirements voor cosmeticahoofdstuk 3304:

1query PgaRequirements($filter: ComplianceRequirementFilter!) {
2 complianceRequirements(filter: $filter, first: 25) {
3 totalCount
4 edges {
5 node {
6 hsCode
7 shipToCountry
8 program {
9 code
10 name
11 }
12 }
13 }
14 }
15}

Vragenlijst van een programma lezen 

Elk ComplianceProgram biedt zijn currentVersion — de ACTIVE vragenlijst — en de questions van die versie in weergavevolgorde. Elke vraag definieert zijn answerType, of deze required is, zijn options (voor selectietypes) en een optionele displayCondition die de vragenlijst vertakt. Lees deze structuur om uw eigen UI te renderen of om precies te begrijpen wat een importeur moet aanleveren.

1query QuestionnaireStructure($filter: ComplianceRequirementFilter!) {
2 complianceRequirements(filter: $filter, first: 1) {
3 edges {
4 node {
5 program {
6 code
7 name
8 currentVersion {
9 version
10 status
11 questions {
12 code
13 prompt
14 helpText
15 answerType
16 required
17 section
18 displayOrder
19 optionsSource
20 options {
21 value
22 label
23 displayOrder
24 }
25 displayCondition {
26 questionCode
27 operator
28 values
29 }
30 }
31 }
32 }
33 }
34 }
35 }
36}

In het voorgaande voorbeeld wordt contains_color_additives alleen weergegeven wanneer intended_use gelijk is aan cosmetic — dat is de displayCondition in actie. Zie voor het volledige vertakkingsmodel en dynamische (optionsSource) opties Hoe het werkt.

Volgende stappen 

GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

ComplianceRequirementFilter

Was deze pagina nuttig?

Krijg ondersteuning·Juridische documenten·© 2026 Zonos
Op deze pagina:
  • Compliancevereisten controleren
  • Toepasselijke programma's ontdekken
  • Filteren en paginering
  • Vragenlijst van een programma lezen
  • Volgende stappen