Come funziona
Una singola operazione greenLightWorkflow contiene tre mutazioni:
partyCreateWorkflow— Crea le parti di origine e di destinazioneitemCreateWorkflow— Crea gli articoli da spediregreenLightWorkflow— 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. IncludemaxProbabilityper sottovalutazione,maxMisrepresentationProbabilityper il paese di origine,maxMiscoherenceProbabilityeworstOutcomeper 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 totaleactionemaxDeniedPartyMatchScoresu 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.
mutation GreenLightWorkflow($partyInput: [PartyCreateWorkflowInput!]!$itemInput: [ItemCreateWorkflowInput!]!$greenLightInput: GreenLightWorkflowInput!) { partyCreateWorkflow(input: $partyInput) { id type location { countryCode } } itemCreateWorkflow(input: $itemInput) { id name hsCode countryOfOrigin } greenLightWorkflow(input: $greenLightInput) { id organizationId createdAt createdBy itemRiskSummary { itemCount underValuation { maxProbability } countryOfOriginMisrepresentation { maxMisrepresentationProbability } hsCodeCoherence { maxMiscoherenceProbability worstOutcome } restriction { matchedCount affectedItemCount worstCategory worstConfidence maxConfidenceScore } regulation { matchedCount affectedItemCount maxConfidenceScore } } partyScreeningSummary { partyCount action maxDeniedPartyMatchScore } itemResults { item { id name hsCode countryOfOrigin amount currencyCode } classification { id customsDescription confidenceScore hsCodeProvidedValidationScore hsCodeProvidedValidation { code } } valueValidation { id probabilityOfUnderValuation value currency } countryOfOriginValidation { id probabilityOfMisrepresentation countryOfOrigin } appliedRestrictions { id itemHsCode restrictions { id category confidence confidenceScore summary url imposingCountryCode measureDirection } } appliedRegulations { id itemHtsCode certificateType regulations { id referenceId summary confidenceScore } } } partyScreenings { id action party { id type } matches { scores { overall name location } name companyName countryCode deniedParty { id name companyName countryCode source sourceUrls } } } }}Per iniziare
Zonos Greenlight richiede un abbonamento. Per saperne di più su accesso, prezzi e integrazione API, contattare l'ufficio vendite.
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
greenLightWorkflowraggruppa 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 tramiteGreenLightWorkflowInput—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.