DOCS

Kontroller samsvarskrav

HjemFor logistikkselskaper Zonos Clarify Kontroller samsvarskrav

Kontroller samsvarskrav

Oppdage 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 svarssvar og gjengi ditt eget spørreskjema brukergrensesnitt.

Omfang kreves

Dette 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 HS-kodekamp. Gjensidig eksklusiv med hsCodePrefix.
hsCodePrefixStringPrefiksendring (siffer og punkter bare, 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 den versjons questions i visningsrekkefølge. Hvert spørsmål erklærer sitt answerType, enten det er required, dets options (for valg typer), 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 på jobb. For det fulle forgreningsmodellen og dynamisk (optionsSource) alternativer, se Hvordan det fungerer.

Neste trinn 

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

ComplianceRequirementFilter

Bestill en demo

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