DOCS
HjemTil logistikudbydere Zonos Clarify Tjek compliance-krav

Tjek compliance-krav

Find ud af, hvilke compliance-programmer der gælder for en vare, og læs spørgeskemaet, du skal besvare.

GraphQL

Forespørgslen complianceRequirements er indgangspunktet til Zonos Clarify. Givet en vares HS-kode og rute returnerer den de compliance-programmer, der udløses, og lader dig gennemløbe hvert programs fulde spørgeskemastruktur — spørgsmål, valgmuligheder og forgreningslogik. Brug den til at afgøre, om en forsendelse har brug for compliance-svar, og til at gengive dit eget spørgeskema-UI.

Scope påkrævet

Denne forespørgsel kræver scope COMPLIANCE_READ. Se OAuth for autentificering af API-anmodninger.

Opdag relevante programmer 

Send en vares hsCode og shipToCountry for at finde ud af, hvilke programmer der gælder. Resultatet er en pagineret forbindelse af ComplianceRequirement-noder, hver med reference til det ComplianceProgram, den udløser.

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}

En shipFromCountry på null for et krav betyder, at programmet gælder uanset oprindelse. Når du angiver shipFromCountry i filteret, matches både oprindelsesspecifikke rækker og rækker med „enhver oprindelse“.

Filtrering og paginering 

complianceRequirements accepterer et ComplianceRequirementFilter plus standard cursor-pagineringsargumenter (first / after til fremadgående paginering, last / before til bagudgående paginering).

Filterfelt↕Type↕Noter↕
hsCodeStringEksakt HS-kodematch. Gensidigt udelukkende med hsCodePrefix.
hsCodePrefixStringPræfiks-match (kun cifre og punktummer, maks. 12 tegn). Gensidigt udelukkende med hsCode.
shipToCountryCountryCodeDestinationsland.
shipFromCountryCountryCodeOprindelsesland. Rækker med null oprindelse („enhver oprindelse“) matches også.
programTypes[ComplianceProgramType!]Match kun disse programtyper. Tom liste = intet filter.

For eksempel kan du liste alle PGA-krav for kosmetik-kapitel 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}

Læs et programs spørgeskema 

Hvert ComplianceProgram eksponerer sin currentVersion — det ACTIVE spørgeskema — og den versions questions i visningsrækkefølge. Hvert spørgsmål angiver sin answerType, om det er required, sine options (for valgtyper) og en valgfri displayCondition, der forgrener spørgeskemaet. Læs denne struktur for at gengive dit eget UI eller for at forstå præcis, hvad en importør skal angive.

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}

I eksemplet ovenfor vises contains_color_additives kun, når intended_use er lig med cosmetic — det er displayCondition, der er i spil. For den fulde forgreningsmodel og dynamiske (optionsSource) valgmuligheder, se Sådan fungerer det.

Næste trin 

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

ComplianceRequirementFilter

Var denne side nyttig?

Få support·Juridiske dokumenter·© 2026 Zonos
På denne side:
  • Tjek compliance-krav
  • Opdag relevante programmer
  • Filtrering og paginering
  • Læs et programs spørgeskema
  • Næste trin