DOCS

Kontrollera efterlevnadskrav

HemFör logistikleverantörer Zonos Clarify Kontrollera efterlevnadskrav

Kontrollera efterlevnadskrav

Upptäck vilka efterlevnadsprogram som gäller för en artikel, och läs den enkät ni behöver besvara.

GraphQL

Frågan complianceRequirements är startpunkten till Zonos Clarify. Givet en artikels HS-kod och rutt returnerar den de efterlevnadsprogram som utlöses, och låter er gå igenom varje programs fulla enkätstruktur — frågor, alternativ och branching-logik. Använd den för att avgöra om en sändning behöver efterlevnadssvar och för att rendera er egen enkät-UI.

Scope krävs

Den här frågan kräver scopet COMPLIANCE_READ. Se OAuth för autentisering av API-begäranden.

Upptäck tillämpliga program 

Ange en artikels hsCode och shipToCountry för att hitta vilka program som gäller. Resultatet är en paginerad connection av ComplianceRequirement-noder, där varje nod pekar på det ComplianceProgram den utlö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}

Ett shipFromCountry med värdet null på ett krav betyder att programmet gäller oavsett ursprung. När ni anger shipFromCountry i filtret matchas både ursprungsspecifika rader och rader med ”valfritt ursprung”.

Filtrering och paginering 

complianceRequirements tar emot ett ComplianceRequirementFilter plus standardargument för cursor-paginering (first / after för framåt-paginering, last / before för bakåt-paginering).

Filterfält↕Typ↕Anteckningar↕
hsCodeStringExakt HS-kodsmatchning. Ömsesidigt uteslutande med hsCodePrefix.
hsCodePrefixStringPrefixmatchning (endast siffror och punkter, max 12 tecken). Ömsesidigt uteslutande med hsCode.
shipToCountryCountryCodeDestinationsland.
shipFromCountryCountryCodeUrsprungsland. Rader med null-ursprung (”valfritt ursprung”) matchas också.
programTypes[ComplianceProgramType!]Matcha endast dessa programtyper. Tom lista = inget filter.

Till exempel, lista varje PGA-krav för kosmetikakapitlet 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 ett programs enkät 

Varje ComplianceProgram exponerar sin currentVersion — den ACTIVE enkäten — och den versionens questions i visningsordning. Varje fråga anger sin answerType, om den är required, sina options (för select-typer) och ett valfritt displayCondition som branchar enkäten. Läs den här strukturen för att rendera er egen UI eller för att förstå exakt vad en importör måste ange.

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 exemplet ovan visas contains_color_additives endast när intended_use är lika med cosmetic — det är displayCondition i praktiken. För den fulla branching-modellen och dynamiska (optionsSource) alternativ, se Så fungerar det.

Nästa steg 

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

ComplianceRequirementFilter

Boka en demo

Var den här sidan till hjälp?

Få support·Juridiska dokument·© 2026 Zonos
På den här sidan:
  • Kontrollera efterlevnadskrav
  • Upptäck tillämpliga program
  • Filtrering och paginering
  • Läs ett programs enkät
  • Nästa steg