DOCS

Compliance-Anforderungen prüfen

StartseiteFür Logistikdienstleister Zonos Clarify Compliance-Anforderungen prüfen

Compliance-Anforderungen prüfen

Ermitteln Sie, welche Compliance-Programme für einen Artikel gelten, und lesen Sie den Fragebogen, den Sie ausfüllen müssen.

GraphQL

Die Abfrage complianceRequirements ist der Einstiegspunkt zu Zonos Clarify. Anhand des HS-Codes und der Route eines Artikels gibt sie die ausgelösten Compliance-Programme zurück und ermöglicht es Ihnen, die vollständige Fragebogenstruktur jedes Programms zu durchlaufen — Fragen, Optionen und Verzweigungslogik. Nutzen Sie sie, um zu entscheiden, ob eine Sendung Compliance-Antworten erfordert, und um Ihre eigene Fragebogen-UI zu rendern.

Erforderlicher Scope

Diese Abfrage erfordert den Scope COMPLIANCE_READ. Siehe OAuth zur Authentifizierung von API-Anfragen.

Zutreffende Programme ermitteln 

Übergeben Sie den hsCode und shipToCountry eines Artikels, um festzustellen, welche Programme gelten. Das Ergebnis ist eine paginierte Verbindung von ComplianceRequirement-Knoten, die jeweils auf das ausgelöste ComplianceProgram verweisen.

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}

Ein shipFromCountry von null bei einer Anforderung bedeutet, dass das Programm unabhängig vom Ursprungsland gilt. Wenn Sie shipFromCountry im Filter angeben, werden sowohl ursprungsspezifische Zeilen als auch Zeilen mit „beliebigem Ursprung" abgeglichen.

Filterung und Paginierung 

complianceRequirements akzeptiert einen ComplianceRequirementFilter sowie Standard-Cursor-Paginierungsargumente (first / after für Vorwärtspaginierung, last / before für Rückwärtspaginierung).

Filter field↕Type↕Notes↕
hsCodeStringExakte HS-Code-Übereinstimmung. Gegenseitig ausschließend mit hsCodePrefix.
hsCodePrefixStringPräfix-Übereinstimmung (nur Ziffern und Punkte, max. 12 Zeichen). Gegenseitig ausschließend mit hsCode.
shipToCountryCountryCodeBestimmungsland.
shipFromCountryCountryCodeUrsprungsland. Zeilen mit null-Ursprung („beliebiger Ursprung“) werden ebenfalls abgeglichen.
programTypes[ComplianceProgramType!]Nur diese Programmtypen abgleichen. Leere Liste = kein Filter.

Listen Sie beispielsweise jede PGA-Anforderung für das Kosmetik-Kapitel 3304 auf:

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}

Fragebogen eines Programms lesen 

Jedes ComplianceProgram stellt seine currentVersion — den ACTIVE-Fragebogen — bereit, sowie die questions dieser Version in Anzeigereihenfolge. Jede Frage deklariert ihren answerType, ob sie required ist, ihre options (bei Auswahltypen) und eine optionale displayCondition, die den Fragebogen verzweigt. Lesen Sie diese Struktur, um Ihre eigene UI zu rendern oder genau zu verstehen, was ein Importeur angeben muss.

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}

Im obigen Beispiel wird contains_color_additives nur angezeigt, wenn intended_use gleich cosmetic ist — das ist die displayCondition in Aktion. Für das vollständige Verzweigungsmodell und dynamische (optionsSource)-Optionen siehe So funktioniert es.

Nächste Schritte 

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

ComplianceRequirementFilter

Buchen Sie eine Demo

War diese Seite hilfreich?

Holen Sie sich Unterstützung·Rechtsdokumente·© 2026 Zonos
Auf dieser Seite:
  • Compliance-Anforderungen prüfen
  • Zutreffende Programme ermitteln
  • Filterung und Paginierung
  • Fragebogen eines Programms lesen
  • Nächste Schritte