DOCS
HjemFor logistikkselskaper Zonos Clarify Kontroller samsvarskrav

Kontroller samsvarskrav

Oppdag hvilke samsvarsprogrammer som gjelder for en vare, og les spørreskjemaet du må svare på.

GraphQL

complianceRequirements-spørringen er startpunktet for Zonos Clarify. Gitt en vares HS-kode og rute, returnerer den samsvarsprogrammene som utløses, og lar deg traversere hver programs fulle spørreskjemastruktur — spørsmål, alternativer og forgreningslogikk. Bruk den til å avgjøre om en forsendelse trenger samsvarssvar og til å gjengi ditt eget brukergrensesnitt for spørreskjemaet.

Omfang kreves

Denne spørringen krever COMPLIANCE_READ-omfanget. Se OAuth for autentisering av API-forespørsler.

Oppdag gjeldende programmer 

Send en vares hsCode og shipToCountry for å finne hvilke programmer som gjelder. Resultatet er en paginert forbindelse av ComplianceRequirement-noder, som hver peker på 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}

En shipFromCountry på null på et krav betyr at programmet gjelder uavhengig av opprinnelse. Når du oppgir shipFromCountry i filteret, samsvares både opprinnelsesspesifikke rader og rader for «enhver opprinnelse».

Filtrering og paginering 

complianceRequirements aksepterer et ComplianceRequirementFilter pluss standard markørpaginering-argumenter (first / after for fremover paging, last / before for bakover paging).

Filterfelt↕Type↕Merknader↕
hsCodeStringEksakt samsvar med HS-kode. Gjensidig eksklusiv med hsCodePrefix.
hsCodePrefixStringPrefikssamsvar (kun sifre og punktum, maks 12 tegn). Gjensidig eksklusiv med hsCode.
shipToCountryCountryCodeDestinasjonsland.
shipFromCountryCountryCodeOpprinnelsesland. Rader med en null opprinnelse («enhver opprinnelse») samsvarer også.
programTypes[ComplianceProgramType!]Samsvarer kun disse programtypene. Tom liste = ingen filter.

For eksempel, list alle PGA-krav for kosmetikk-kapittel 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}

Les et programs spørreskjema 

Hver ComplianceProgram avslører sin currentVersion — det ACTIVE-spørreskjemaet — og denne versjonens questions i visningsrekkefølge. Hvert spørsmål erklærer sitt answerType, om det er required, sine options (for valgtyper), og et valgfritt displayCondition som forgrener spørreskjemaet. Les denne strukturen for å gjengi ditt eget brukergrensesnitt eller for å forstå nøyaktig hva en importør må gi.

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 er contains_color_additives bare vist når intended_use tilsvarer cosmetic — det er displayCondition i aksjon. For den fulle forgreningsmodellen og dynamiske (optionsSource) alternativer, se Hvordan det fungerer.

Neste trinn 

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

ComplianceRequirementFilter

Var denne siden nyttig?

Få støtte·Juridiske dokumenter·© 2026 Zonos
På denne siden:
  • Kontroller samsvarskrav
  • Oppdag gjeldende programmer
  • Filtrering og paginering
  • Les et programs spørreskjema
  • Neste trinn