DOCS

Verificare i requisiti di conformità

HomePer i fornitori di logistica Zonos Clarify Verificare i requisiti di conformità

Controllare i requisiti di conformità

Scopri quali programmi di conformità si applicano a un articolo e leggi il questionario dovrai rispondere.

GraphQL

IL complianceRequirements la query è il punto di ingresso a Zonos Clarify. Dato un codice e percorso HS dell'elemento, restituisce i programmi di conformità presenti attivato e ti consente di attraversare l'intera struttura del questionario di ciascun programma — domande, opzioni e logica di ramificazione. Usalo per decidere se effettuare una spedizione necessita di risposte di conformità e di fornire il proprio questionario UI.

Ambito richiesto

Questa query richiede il COMPLIANCE_READ portata. Vedere OAuth per autenticare le richieste API.

Scopri i programmi applicabili 

Passa un oggetto hsCode E shipToCountry per scoprire quali programmi si applicano. Il il risultato è una connessione impaginata di ComplianceRequirement nodi, ciascuno puntante al ComplianceProgram si innesca.

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}

UN shipFromCountry Di null su un requisito significa che il programma si applica indipendentemente dall'origine. Quando fornisci shipFromCountry nel filtro, entrambi le righe specifiche dell'origine e le righe "qualsiasi origine" vengono abbinate.

Filtraggio e impaginazione 

complianceRequirements accetta a ComplianceRequirementFilter più standard argomenti di impaginazione del cursore (first / after per l'avanzamento della paginazione, last / before for backward paging).

Campo filtro↕Tipo↕Note↕
hsCodeStringCorrispondenza esatta del codice HS. Si escludono a vicenda con hsCodePrefix.
hsCodePrefixStringCorrispondenza del prefisso (solo cifre e punti, massimo 12 caratteri). Si escludono a vicenda con hsCode.
shipToCountryCountryCodePaese di destinazione.
shipFromCountryCountryCodePaese d'origine. Righe con a null corrisponde anche origin ("qualsiasi origine").
programTypes[ComplianceProgramType!]Corrisponde solo a questi tipi di programmi. Elenco vuoto = nessun filtro.

For example, list every PGA requirement for cosmetics chapter 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}

Leggi il questionario di un programma 

Ciascuno ComplianceProgram espone il suo currentVersion - IL ACTIVE questionario

  • e quella versione questions in ordine di visualizzazione. Ogni domanda dichiara la sua answerType, se lo è required, suo options (per tipi selezionati) e un facoltativo displayCondition che ramifica il questionario. Leggi questa struttura per rendere il proprio UI o per capire esattamente cosa deve fornire un importatore.
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}

Nell'esempio sopra, contains_color_additives viene mostrato solo quando intended_use è uguale cosmetic - questo è il displayCondition al lavoro. Per il modello di ramificazione completo e dinamico (optionsSource) opzioni, vedere Come funziona.

Passaggi successivi 

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

ComplianceRequirementFilter

Prenota una demo

Questa pagina è stata utile?

Ottieni supporto·Documenti legali·© 2026 Zonos
In questa pagina:
  • Controllare i requisiti di conformità
  • Scopri i programmi applicabili
  • Filtraggio e impaginazione
  • Leggi il questionario di un programma
  • Passaggi successivi