How it works
Single greenLightWorkflow operation에는 3개 mutation이 포함됩니다:
partyCreateWorkflow— Origin 및 destination party 생성itemCreateWorkflow— Shipping item 생성greenLightWorkflow— 동일 operation에서 생성된 party 및 item에 selected compliance check 실행
GreenLightWorkflowInput은 individual check enable/disable용 6개 boolean toggle을 accept합니다. 모두 default true입니다. 불필요한 check는 omit하면 나머지는 independently 실행됩니다.
Checks
HS code coherence (hsCodeCoherence) — AI classification으로 declared HS code가 item description과 coherent한지 validate합니다. confidenceScore(higher = code confidence higher = risk lower) 및 chapter, heading, subheading level coherence를 보여주는 hsCodeProvidedValidation을 반환합니다.
Country of origin validation (countryOfOriginValidation) — Zonos Country of Origin AI-predicted origin 대비 declared manufacturing origin을 verify합니다. probabilityOfMisrepresentation 반환 — higher value는 declared origin inaccuracy 가능성이 더 높음을 나타냅니다.
Value validation (valueValidation) — Customs Value AI-estimated market value 대비 declared customs value를 compare합니다. Undervaluation catch용 probabilityOfUnderValuation을 반환합니다.
Restriction check (restrictionCheck) — Restrict으로 import, export, carrier-specific restriction list에 item을 screen합니다. category, summary, confidence, confidenceScore가 있는 restriction을 반환합니다.
Regulation check (regulationCheck) — Item에 applicable trade regulation 및 required certification을 식별합니다. certificateType, summary, confidenceScore가 있는 matched regulation을 반환합니다.
Denied party screening (deniedPartyScreening) — Screen으로 international denied party list에 shipment party를 screen합니다. action(NO_MATCHES, REVIEW, BLOCK) 및 name, location, overall score match detail을 반환합니다.
Interpreting results
Response에는 quick aggregate assessment용 2개 summary object가 포함됩니다:
itemRiskSummary— 모든 item risk를 rollup합니다. UndervaluationmaxProbability, country of originmaxMisrepresentationProbability, HS code coherencemaxMiscoherenceProbability및worstOutcome, restriction 및 regulation aggregate count 및 worst-case score를 포함합니다.partyScreeningSummary— Party screening result를 rollup합니다. Screened party 전체 overallaction및maxDeniedPartyMatchScore를 반환합니다.
Flag를 trigger한 item 또는 party를 정확히 식별해야 할 때 itemResults 및 partyScreenings에 per-item 및 per-party detail이 포함됩니다.
Probability score는 0.0~1.0 decimal로 반환됩니다. API에 universal LOW/MED/HIGH threshold는 없습니다 — 자체 traffic mix 및 risk tolerance에 맞게 cutoff를 calibrate하세요.
Use cases
Customs brokers: Submission 전 모든 shipment에 Greenlight를 실행하여 misclassified item, incorrect origin declaration, undervalued goods를 식별합니다. Delay, penalty, audit 전 compliance issue를 catch합니다.
Package forwarders: Intake staff specialized trade knowledge 없이 incoming package export readiness를 assess합니다. Greenlight는 attention이 필요한 item과 reason을 정확히 surface하여 error를 줄이고 faster processing을 enable합니다.
Carriers and logistics providers: Pickup 또는 intake 시점 package screen을 위해 shipment acceptance workflow에 Greenlight를 integrate합니다. Network 진입 전 non-compliant shipment를 reject 또는 flag하여 customs hold 및 associated cost risk를 줄입니다.
Customs agencies: High misrepresentation risk score shipment에 focus하여 inspection을 prioritize합니다. Low-risk shipment는 fast-track하여 enforcement accuracy를 유지하면서 throughput을 improve합니다.
API guide
아래 example은 6개 check를 모두 실행합니다. GreenLightWorkflowInput에서 toggle을 false로 설정하면 해당 check를 skip합니다.
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 } } } }}Getting started
Zonos Greenlight는 subscription이 필요합니다. Access, pricing, API integration에 대해 더 알아보려면 contact sales로 문의하세요.
Zonos Greenlight
Shipment이 compliant하고 export ready인지 verify합니다.
Zonos Greenlight는 international shipment에 대한 comprehensive export readiness assessment를 제공합니다. HS code coherence, country of origin validation, customs value verification, product restriction, trade regulation, denied party screening 6개 영역에서 AI-powered check를 실행합니다.
greenLightWorkflowmutation은 party creation, item creation, 모든 compliance check를 single GraphQL operation으로 bundle합니다.GreenLightWorkflowInput으로 실행 check를 제어하며 모든 check는 default enabled입니다. Response에는 quick decisioning용 high-level summary와 deeper review용 per-item 및 per-party detail이 포함됩니다.