Como funciona
Uma única operação greenLightWorkflow contém três mutações:
partyCreateWorkflow— Cria partes de origem e destinoitemCreateWorkflow— Cria os artigos que são enviadosgreenLightWorkflow— Executa as verificações de conformidade selecionadas sobre as partes e os artigos criados na mesma operação
O GreenLightWorkflowInput aceita seis interruptores booleanos para ativar ou desativar verificações individuais. Todos têm true por omissão. Omita qualquer verificação que não necessite; o resto é executado de forma independente.
Verificações
Coerência do código HS (hsCodeCoherence) — Valida se o código HS declarado é coerente com a descrição do artigo através de classificação por IA. Devolve um confidenceScore (maior = mais confiança no código = menos risco) e hsCodeProvidedValidation que mostra a coerência a nível de capítulo, posição e subposição.
Validação do país de origem (countryOfOriginValidation) — Verifica a origem de fabrico declarada contra a origem preditora por IA por Zonos Country of Origin. Devolve probabilityOfMisrepresentation; valores mais elevados indicam que é mais provável que a origem declarada seja inexata.
Validação de valor (valueValidation) — Compara os valores aduaneiros declarados com valores de mercado estimados por IA por Customs Value. Devolve probabilityOfUnderValuation para detectar subavaliação.
Verificação de restrições (restrictionCheck) — Consultar artigos contra listas de restrições de importação, exportação e específicas de transportadores através de Restrict. Devolve restrições com category, summary, confidence e confidenceScore.
Verificação de regulamentos (regulationCheck) — Identifica regulamentos comerciais aplicáveis e certificações exigidas para os artigos. Devolve regulamentos coincidentes com certificateType, summary e confidenceScore.
Revisão de partes recusadas (deniedPartyScreening) — Rever as partes do envio contra listas internacionais de partes recusadas por Screen. Devolve uma action (NO_MATCHES, REVIEW ou BLOCK) e detalhes de coincidências que incluem nome, localização e escores gerais.
Interpretação dos resultados
A resposta contém dois objetos de resumo para uma avaliação rápida e agregada:
itemRiskSummary— Consolida o risco de todos os artigos. IncluimaxProbabilitypara subavaliação,maxMisrepresentationProbabilitypara país de origem,maxMiscoherenceProbabilityeworstOutcomepara coerência do código HS, e contagens agregados e pontuações do pior caso para restrições e regulamentos.partyScreeningSummary— Consolida os resultados de revisão de partes. Devolve aactiongeral emaxDeniedPartyMatchScorede todas as partes revistas.
itemResults e partyScreenings contêm detalhes por artigo e por parte quando você precisa identificar exatamente quais artigos ou partes ativaram um alerta.
Os escores de probabilidade são devolvidos como decimais entre 0.0 e 1.0. Não há limiares universais LOW/MED/HIGH integrados na API; calibre os pontos de corte segundo sua própria mistura de tráfego e tolerância ao risco.
Casos de utilização
Agentes aduaneiros: Execute Greenlight em cada remessa antes da apresentação para identificar artigos mal classificados, declarações de origem incorretas ou mercadorias subvalorizadas. Identifique problemas de conformidade antes que resultem em atrasos, penalizações ou auditorias.
Reenviadores de pacotes: Avalie cada pacote recebido quanto à preparação para exportação sem necessitar de conhecimentos comerciais especializados por parte do pessoal de receção. Greenlight indica exatamente quais artigos precisam de atenção e porquê, permitindo um processamento mais rápido com menos erros.
Transportadoras e fornecedores logísticos: Integre Greenlight nos fluxos de aceitação de remessas para revisar pacotes no ponto de recolha ou receção. Rejeite ou assinale remessas não conformes antes que entrem na sua rede, reduzindo o risco de retenções aduaneiras e custos associados.
Agências aduaneiras: Use Greenlight para priorizar inspeções, concentrando-se em remessas com escores elevados de risco de distorção. As remessas de baixo risco podem ser aceleradas, melhorando o desempenho sem sacrificar a precisão da fiscalização.
Guia de API
O exemplo seguinte executa as seis verificações. Defina qualquer interruptor em false em GreenLightWorkflowInput para omitir essa verificação.
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 } } } }}Como começar
Zonos Greenlight requer uma assinatura. Para mais informações sobre acesso, preços e integração API, contate as vendas.
Zonos Greenlight
Verifique se as remessas cumprem as regras e estão prontas para exportação.
Zonos Greenlight fornece uma avaliação abrangente de preparação para exportação de remessas internacionais. Executa verificações impulsionadas por IA em seis áreas: coerência do código HS, validação do país de origem, verificação do valor aduaneiro, restrições de produtos, regulamentos comerciais e revisão de partes recusadas.
A mutação
greenLightWorkflowagrupa a criação de partes, a criação de artigos e todas as verificações de conformidade numa única operação GraphQL. Você controla quais verificações são executadas medianteGreenLightWorkflowInput; todas estão habilitadas por defeito. A resposta inclui resumos de alto nível para decisões rápidas e detalhes por artigo e por parte para uma revisão mais profunda.