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

Verificare i requisiti di conformità

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

GraphQL

La query complianceRequirements è il punto di ingresso di Zonos Clarify. Dato il codice HS e il percorso di un articolo, restituisce i programmi di conformità attivati e ti consente di esplorare l'intera struttura del questionario di ciascun programma — domande, opzioni e logica di ramificazione. Usala per decidere se una spedizione richiede risposte di conformità e per generare la tua interfaccia del questionario.

Ambito richiesto

Questa query richiede l'ambito COMPLIANCE_READ. Consulta OAuth per autenticare le richieste API.

Scopri i programmi applicabili 

Passa hsCode e shipToCountry di un articolo per scoprire quali programmi si applicano. Il risultato è una connessione impaginata di nodi ComplianceRequirement, ciascuno dei quali punta al ComplianceProgram da esso attivato.

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 null in un requisito significa che il programma si applica indipendentemente dall'origine. Quando specifichi shipFromCountry nel filtro, vengono trovate corrispondenze sia per le righe specifiche dell'origine sia per quelle con «qualsiasi origine».

Filtraggio e paginazione 

complianceRequirements accetta un ComplianceRequirementFilter più i consueti argomenti di paginazione a cursore (first / after per la paginazione in avanti, last / before per la paginazione all'indietro).

Campo filtro↕Tipo↕Note↕
hsCodeStringCorrispondenza esatta del codice HS. Incompatibile con hsCodePrefix.
hsCodePrefixStringCorrispondenza per prefisso (solo cifre e punti, massimo 12 caratteri). Incompatibile con hsCode.
shipToCountryCountryCodePaese di destinazione.
shipFromCountryCountryCodePaese di origine. Corrispondono anche le righe con origine null («qualsiasi origine»).
programTypes[ComplianceProgramType!]Filtra solo questi tipi di programma. Elenco vuoto = nessun filtro.

Ad esempio, elenca tutti i requisiti PGA per il capitolo cosmetici 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 

Ogni ComplianceProgram espone la propria currentVersion — il questionario ACTIVE — e le questions di quella versione nell'ordine di visualizzazione. Ogni domanda dichiara il proprio answerType, se è required, le proprie options (per i tipi a selezione) e un displayCondition facoltativo che ramifica il questionario. Leggi questa struttura per generare la tua interfaccia utente 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 precedente, contains_color_additives viene mostrato solo quando intended_use è uguale a cosmetic — è il displayCondition in azione. Per il modello completo di ramificazione e le opzioni dinamiche (optionsSource), consulta Come funziona.

Passaggi successivi 

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

ComplianceRequirementFilter

Questa pagina è stata utile?

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