Comment cela fonctionne
Une seule opération greenLightWorkflow contient trois mutations :
partyCreateWorkflow— Crée les parties d'origine et de destinationitemCreateWorkflow— Crée les articles expédiésgreenLightWorkflow— Exécute les contrôles de conformité sélectionnés sur les parties et articles créés dans la même opération
GreenLightWorkflowInput accepte six bascules booléennes pour activer ou désactiver chaque contrôle. Toutes sont true par défaut. Omettez tout contrôle dont vous n'avez pas besoin — les autres s'exécutent indépendamment.
Contrôles
Cohérence du code HS (hsCodeCoherence) — Vérifie si le code HS déclaré est cohérent avec la description de l'article à l'aide d'une classification par IA. Renvoie un confidenceScore (plus il est élevé, plus la confiance dans le code est grande, donc moins le risque est élevé) et hsCodeProvidedValidation, qui indique la cohérence aux niveaux du chapitre, de la position et de la sous-position.
Validation du pays d'origine (countryOfOriginValidation) — Vérifie l'origine de fabrication déclarée par rapport à l'origine prédite par l'IA via Zonos Country of Origin. Renvoie probabilityOfMisrepresentation — plus la valeur est élevée, plus il est probable que l'origine déclarée soit inexacte.
Validation de la valeur (valueValidation) — Compare les valeurs en douane déclarées aux valeurs de marché estimées par l'IA via Customs Value. Renvoie probabilityOfUnderValuation pour détecter une sous-évaluation.
Contrôle des restrictions (restrictionCheck) — Contrôle les articles par rapport aux listes de restrictions à l'importation, à l'exportation et spécifiques aux transporteurs via Restrict. Renvoie les restrictions avec une category, un summary, une confidence et un confidenceScore.
Contrôle des réglementations (regulationCheck) — Identifie les réglementations commerciales applicables et les certifications requises pour les articles. Renvoie les réglementations correspondantes avec un certificateType, un summary et un confidenceScore.
Contrôle des parties interdites (deniedPartyScreening) — Contrôle les parties à l'envoi par rapport aux listes internationales de parties interdites via Screen. Renvoie une action (NO_MATCHES, REVIEW ou BLOCK) et les détails des correspondances, notamment le nom, la localisation et les scores globaux.
Interpréter les résultats
La réponse contient deux objets de synthèse pour une évaluation rapide et globale :
itemRiskSummary— Agrège le risque sur l'ensemble des articles. ComprendmaxProbabilitypour la sous-évaluation,maxMisrepresentationProbabilitypour le pays d'origine,maxMiscoherenceProbabilityetworstOutcomepour la cohérence du code HS, ainsi que des totaux agrégés et les scores les plus défavorables pour les restrictions et les réglementations.partyScreeningSummary— Agrège les résultats du contrôle des parties. Renvoie l'actionglobale et lemaxDeniedPartyMatchScoresur l'ensemble des parties contrôlées.
itemResults et partyScreenings contiennent les détails par article et par partie lorsque vous devez identifier précisément quels articles ou parties ont déclenché un signalement.
Les scores de probabilité sont renvoyés sous forme de décimales comprises entre 0.0 et 1.0. Il n'existe pas de seuils universels LOW/MED/HIGH intégrés à l'API — calibrez vos seuils en fonction de votre propre trafic et de votre tolérance au risque.
Cas d'usage
Courtiers en douane : Exécutez Greenlight sur chaque envoi avant soumission pour identifier les articles mal classifiés, les déclarations d'origine incorrectes ou les marchandises sous-évaluées. Détectez les problèmes de conformité avant qu'ils n'entraînent des retards, sanctions ou audits.
Transitaires : Évaluez chaque colis entrant pour la préparation à l'exportation sans exiger de connaissances commerciales spécialisées du personnel de réception. Greenlight indique précisément quels articles nécessitent une attention et pourquoi, ce qui permet un traitement plus rapide avec moins d'erreurs.
Transporteurs et prestataires logistiques : Intégrez Greenlight dans les flux d'acceptation d'envois pour contrôler les colis au point de collecte ou de réception. Rejetez ou signalez les envois non conformes avant qu'ils n'entrent dans votre réseau, ce qui réduit le risque de blocages douaniers et les coûts associés.
Agences douanières : Utilisez Greenlight pour prioriser les inspections en ciblant les envois à risque élevé de fausse déclaration. Les envois à faible risque peuvent être accélérés, améliorant le débit tout en maintenant la précision du contrôle.
Guide API
L'exemple ci-dessous exécute les six contrôles. Définissez toute bascule sur false dans GreenLightWorkflowInput pour ignorer ce contrôle.
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 } } } }}Mise en route
Zonos Greenlight nécessite un abonnement. Pour en savoir plus sur l'accès, la tarification et l'intégration de l'API, contactez notre équipe commerciale.
Zonos Greenlight
Vérifiez que les envois sont conformes et prêts pour l'exportation.
Zonos Greenlight fournit une évaluation complète de la préparation à l'exportation pour les envois internationaux. Il exécute des contrôles alimentés par l'IA dans six domaines : cohérence des codes HS, validation du pays d'origine, vérification de la valeur en douane, restrictions produits, réglementations commerciales et contrôle des parties interdites.
La mutation
greenLightWorkflowregroupe la création de parties, la création d'articles et tous les contrôles de conformité en une seule opération GraphQL. Vous contrôlez les contrôles exécutés viaGreenLightWorkflowInput— tous les contrôles sont activés par défaut. La réponse inclut des résumés de haut niveau pour une décision rapide et des détails par article et par partie pour un examen approfondi.