DOCS
HomePer i fornitori di logistica Greenlight

Zonos Greenlight

Verifica che le spedizioni siano conformi e pronte per l'esportazione.

Zonos Greenlight fornisce una valutazione completa della preparazione all'esportazione per le spedizioni internazionali. Esegue controlli basati sull'intelligenza artificiale in sei aree: coerenza del codice HS, convalida del paese di origine, verifica del valore doganale, restrizioni sui prodotti, normative commerciali e screening delle parti negate.

La mutazione greenLightWorkflow raggruppa la creazione delle parti, la creazione degli articoli e tutti i controlli di conformità in un'unica operazione GraphQL. Sei tu a controllare quali controlli vengono eseguiti tramite GreenLightWorkflowInput—tutti i controlli sono abilitati per impostazione predefinita. La risposta include sia riepiloghi di alto livello per decisioni rapide, sia dettagli per articolo e per parte per una revisione più approfondita.

Come funziona 

Una singola operazione greenLightWorkflow contiene tre mutazioni:

  1. partyCreateWorkflow — Crea le parti di origine e di destinazione
  2. itemCreateWorkflow — Crea gli articoli da spedire
  3. greenLightWorkflow — Esegue i controlli di conformità selezionati rispetto alle parti e agli elementi creati nella stessa operazione

Il GreenLightWorkflowInput accetta sei interruttori booleani per abilitare o disabilitare i singoli controlli. Il valore predefinito per tutti è true. Ometti i controlli non necessari: il resto viene eseguito in modo indipendente.

Controlli

Coerenza del codice HS (hsCodeCoherence) — Verifica se il codice HS dichiarato è coerente con la descrizione dell'articolo utilizzando la classificazione AI. Restituisce un confidenceScore (più alto = più fiducia nel codice = meno rischi) e hsCodeProvidedValidation mostrando coerenza a livello di capitolo, titolo e sottotitolo.

Convalida del paese di origine (countryOfOriginValidation) — Verifica l'origine di fabbricazione dichiarata rispetto all'origine prevista dall'AI tramite Zonos Country of Origin. Restituisce probabilityOfMisrepresentation—valori più elevati indicano che l'origine dichiarata è più probabilmente imprecisa.

Convalida del valore (valueValidation) — Confronta i valori doganali dichiarati con i valori di mercato stimati dall'AI tramite Customs Value. Restituisce probabilityOfUnderValuation per cogliere la sottovalutazione.

Verifica delle restrizioni (restrictionCheck) — Analizza gli articoli rispetto a elenchi di restrizioni di importazione, esportazione e specifici del corriere tramite Restrict. Restituisce le restrizioni con un category, summary, confidence, e confidenceScore.

Verifica delle normative (regulationCheck) — Identifica le normative commerciali applicabili e le certificazioni richieste per gli articoli. Restituisce i regolamenti corrispondenti con un certificateType, summary, e confidenceScore.

Screening delle parti negate (deniedPartyScreening) — Analizza le parti della spedizione rispetto agli elenchi internazionali delle parti negate tramite Screen. Restituisce un action (NO_MATCHES, REVIEW, o BLOCK) e i dettagli della corrispondenza, inclusi nome, posizione e punteggi complessivi.

Interpretazione dei risultati

La risposta contiene due oggetti di riepilogo per una valutazione rapida e aggregata:

  • itemRiskSummary: aggrega il rischio su tutti gli elementi. Include maxProbability per sottovalutazione, maxMisrepresentationProbability per il paese di origine, maxMiscoherenceProbability e worstOutcome per la coerenza del codice HS e conteggi aggregati e punteggi nel caso peggiore per restrizioni e normative.
  • partyScreeningSummary — Riepiloga i risultati dello screening delle parti. Restituisce il totale action e maxDeniedPartyMatchScore su tutte le parti sottoposte a screening.

itemResults e partyScreenings contengono dettagli per articolo e per parte quando è necessario identificare esattamente quali articoli o parti hanno attivato una segnalazione.

I punteggi di probabilità vengono restituiti come decimali tra 0.0 e 1.0. Non esistono soglie universali BASSE/MEDIE/ALTE integrate nell'API: calibra i limiti rispetto al tuo mix di traffico e alla tua tolleranza al rischio.

Casi d'uso 

Intermediari doganali: esegui Greenlight su ogni spedizione prima dell'invio per identificare articoli classificati erroneamente, dichiarazioni di origine errate o merci sottovalutate. Individua i problemi di conformità prima che si traducano in ritardi, sanzioni o controlli.

Spedizionieri di pacchi: valuta ogni pacco in arrivo per verificarne la preparazione all'esportazione senza richiedere conoscenze commerciali specializzate al personale di accettazione. Greenlight evidenzia esattamente quali elementi richiedono attenzione e perché, consentendo un'elaborazione più rapida con meno errori.

Trasportatori e fornitori di servizi logistici: integra Greenlight nei flussi di lavoro di accettazione delle spedizioni per controllare i pacchi nel punto di ritiro o accettazione. Rifiuta o contrassegna le spedizioni non conformi prima che entrino nella tua rete, riducendo il rischio di trattenute doganali e i costi associati.

Agenzie doganali: utilizza Greenlight per dare priorità alle ispezioni concentrandosi sulle spedizioni con punteggi elevati di rischio di falsa dichiarazione. Le spedizioni a basso rischio possono essere accelerate, migliorando la produttività e mantenendo l'accuratezza dell'applicazione.

Guida API 

L'esempio seguente esegue tutti e sei i controlli. Imposta qualsiasi interruttore su false in GreenLightWorkflowInput per saltare quel controllo.

1mutation GreenLightWorkflow(
2$partyInput: [PartyCreateWorkflowInput!]!
3$itemInput: [ItemCreateWorkflowInput!]!
4$greenLightInput: GreenLightWorkflowInput!
5) {
6 partyCreateWorkflow(input: $partyInput) {
7 id
8 type
9 location {
10 countryCode
11 }
12 }
13 itemCreateWorkflow(input: $itemInput) {
14 id
15 name
16 hsCode
17 countryOfOrigin
18 }
19 greenLightWorkflow(input: $greenLightInput) {
20 id
21 organizationId
22 createdAt
23 createdBy
24 itemRiskSummary {
25 itemCount
26 underValuation {
27 maxProbability
28 }
29 countryOfOriginMisrepresentation {
30 maxMisrepresentationProbability
31 }
32 hsCodeCoherence {
33 maxMiscoherenceProbability
34 worstOutcome
35 }
36 restriction {
37 matchedCount
38 affectedItemCount
39 worstCategory
40 worstConfidence
41 maxConfidenceScore
42 }
43 regulation {
44 matchedCount
45 affectedItemCount
46 maxConfidenceScore
47 }
48 }
49 partyScreeningSummary {
50 partyCount
51 action
52 maxDeniedPartyMatchScore
53 }
54 itemResults {
55 item {
56 id
57 name
58 hsCode
59 countryOfOrigin
60 amount
61 currencyCode
62 }
63 classification {
64 id
65 customsDescription
66 confidenceScore
67 hsCodeProvidedValidationScore
68 hsCodeProvidedValidation {
69 code
70 }
71 }
72 valueValidation {
73 id
74 probabilityOfUnderValuation
75 value
76 currency
77 }
78 countryOfOriginValidation {
79 id
80 probabilityOfMisrepresentation
81 countryOfOrigin
82 }
83 appliedRestrictions {
84 id
85 itemHsCode
86 restrictions {
87 id
88 category
89 confidence
90 confidenceScore
91 summary
92 url
93 imposingCountryCode
94 measureDirection
95 }
96 }
97 appliedRegulations {
98 id
99 itemHtsCode
100 certificateType
101 regulations {
102 id
103 referenceId
104 summary
105 confidenceScore
106 }
107 }
108 }
109 partyScreenings {
110 id
111 action
112 party {
113 id
114 type
115 }
116 matches {
117 scores {
118 overall
119 name
120 location
121 }
122 name
123 companyName
124 countryCode
125 deniedParty {
126 id
127 name
128 companyName
129 countryCode
130 source
131 sourceUrls
132 }
133 }
134 }
135 }
136}

Per iniziare 

Zonos Greenlight richiede un abbonamento. Per saperne di più su accesso, prezzi e integrazione API, contattare l'ufficio vendite.

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

GreenLightWorkflowInput ItemCreateWorkflowInput PartyCreateWorkflowInput

MUTATIONS

greenLightWorkflow itemCreateWorkflow partyCreateWorkflow

Questa pagina è stata utile?

Ottieni supporto·Documenti legali·© 2026 Zonos
In questa pagina:
  • Zonos Greenlight
  • Come funziona
  • Casi d'uso
  • Guida API
  • Per iniziare