Cómo funciona
Una sola operación greenLightWorkflow contiene tres mutaciones:
partyCreateWorkflow— Crea partes de origen y destinoitemCreateWorkflow— Crea los artículos que se envíangreenLightWorkflow— Ejecuta las comprobaciones de cumplimiento seleccionadas sobre las partes y artículos creados en la misma operación
El GreenLightWorkflowInput acepta seis interruptores booleanos para habilitar o deshabilitar comprobaciones individuales. Todos tienen true por defecto. Omita cualquier comprobación que no necesite; el resto se ejecuta de forma independiente.
Comprobaciones
Coherencia del código HS (hsCodeCoherence) — Valida si el código HS declarado es coherente con la descripción del artículo mediante clasificación con IA. Devuelve un confidenceScore (mayor = más confianza en el código = menos riesgo) y hsCodeProvidedValidation que muestra la coherencia a nivel de capítulo, partida y subpartida.
Validación del país de origen (countryOfOriginValidation) — Verifica el origen de fabricación declarado frente al origen predicho por IA mediante Zonos Country of Origin. Devuelve probabilityOfMisrepresentation; valores más altos indican que el origen declarado es más probable que sea inexacto.
Validación de valor (valueValidation) — Compara los valores aduaneros declarados con valores de mercado estimados por IA mediante Customs Value. Devuelve probabilityOfUnderValuation para detectar subvaluación.
Comprobación de restricciones (restrictionCheck) — Revisa artículos frente a listas de restricciones de importación, exportación y específicas de transportistas mediante Restrict. Devuelve restricciones con category, summary, confidence y confidenceScore.
Comprobación de regulaciones (regulationCheck) — Identifica regulaciones comerciales aplicables y certificaciones requeridas para los artículos. Devuelve regulaciones coincidentes con certificateType, summary y confidenceScore.
Revisión de partes denegadas (deniedPartyScreening) — Revisa las partes del envío frente a listas internacionales de partes denegadas mediante Screen. Devuelve una action (NO_MATCHES, REVIEW o BLOCK) y detalles de coincidencias que incluyen nombre, ubicación y puntuaciones generales.
Interpretación de resultados
La respuesta contiene dos objetos de resumen para una evaluación rápida y agregada:
itemRiskSummary— Consolida el riesgo de todos los artículos. IncluyemaxProbabilitypara subvaluación,maxMisrepresentationProbabilitypara país de origen,maxMiscoherenceProbabilityyworstOutcomepara coherencia del código HS, y recuentos agregados y puntuaciones del peor caso para restricciones y regulaciones.partyScreeningSummary— Consolida los resultados de revisión de partes. Devuelve laactiongeneral ymaxDeniedPartyMatchScorede todas las partes revisadas.
itemResults y partyScreenings contienen detalles por artículo y por parte cuando necesita identificar exactamente qué artículos o partes activaron una alerta.
Las puntuaciones de probabilidad se devuelven como decimales entre 0.0 y 1.0. No hay umbrales universales LOW/MED/HIGH integrados en la API; calibre los puntos de corte según su propia mezcla de tráfico y tolerancia al riesgo.
Casos de uso
Agentes de aduanas: Ejecute Greenlight en cada envío antes de la presentación para identificar artículos mal clasificados, declaraciones de origen incorrectas o mercancías subvaluadas. Detecte problemas de cumplimiento antes de que resulten en retrasos, sanciones o auditorías.
Reenviadores de paquetes: Evalúe cada paquete entrante para preparación de exportación sin requerir conocimientos comerciales especializados del personal de recepción. Greenlight indica exactamente qué artículos necesitan atención y por qué, permitiendo un procesamiento más rápido con menos errores.
Transportistas y proveedores logísticos: Integre Greenlight en los flujos de aceptación de envíos para revisar paquetes en el punto de recogida o recepción. Rechace o marque envíos no conformes antes de que entren en su red, reduciendo el riesgo de retenciones aduaneras y costos asociados.
Agencias aduaneras: Use Greenlight para priorizar inspecciones centrándose en envíos con puntuaciones altas de riesgo de tergiversación. Los envíos de bajo riesgo pueden acelerarse, mejorando el rendimiento sin sacrificar la precisión de la aplicación.
Guía de API
El ejemplo siguiente ejecuta las seis comprobaciones. Establezca cualquier interruptor en false en GreenLightWorkflowInput para omitir esa comprobación.
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 } } } }}Comenzar
Zonos Greenlight requiere una suscripción. Para obtener más información sobre acceso, precios e integración API, contacte con ventas.
Zonos Greenlight
Verifique que los envíos cumplan la normativa y estén listos para exportación.
Zonos Greenlight ofrece una evaluación integral de preparación para exportación de envíos internacionales. Ejecuta comprobaciones impulsadas por IA en seis áreas: coherencia del código HS, validación del país de origen, verificación del valor aduanero, restricciones de productos, regulaciones comerciales y revisión de partes denegadas.
La mutación
greenLightWorkflowagrupa la creación de partes, la creación de artículos y todas las comprobaciones de cumplimiento en una sola operación GraphQL. Usted controla qué comprobaciones se ejecutan medianteGreenLightWorkflowInput; todas están habilitadas por defecto. La respuesta incluye resúmenes de alto nivel para decisiones rápidas y detalles por artículo y por parte para una revisión más profunda.