DOCS
홈물류 제공업체용 Greenlight

Zonos Greenlight

배송이 규정을 준수하고 수출 준비가 되었는지 확인하세요.

Zonos Greenlight는 국제 배송에 대한 종합적인 수출 준비성 평가를 제공합니다. HS 코드 일치성, 원산지 검증, 관세 가치 확인, 품목 제한, 무역 규정, 거래 제한 대상자 심사까지 6가지 영역에서 AI 기반 검사를 실행합니다.

greenLightWorkflow mutation은 당사자 생성, 품목 생성, 모든 규정 준수 검사를 하나의 GraphQL 작업으로 묶어서 처리합니다. GreenLightWorkflowInput을 통해 실행할 검사를 직접 제어할 수 있으며, 기본적으로 모든 검사가 활성화되어 있습니다. 응답에는 빠른 의사 결정을 위한 상위 수준 요약과, 더 깊은 검토를 위한 품목별·당사자별 세부 정보가 모두 포함됩니다.

작동 방식 

하나의 greenLightWorkflow 작업에는 세 가지 mutation이 포함됩니다:

  1. partyCreateWorkflow — 발송지와 도착지 당사자를 생성합니다
  2. itemCreateWorkflow — 배송할 품목을 생성합니다
  3. greenLightWorkflow — 동일한 작업에서 생성된 당사자 및 품목을 대상으로 선택한 규정 준수 검사를 실행합니다

GreenLightWorkflowInput은 개별 검사를 활성화 또는 비활성화할 수 있는 6개의 boolean 토글을 지원합니다. 모든 값은 기본적으로 true입니다. 필요하지 않은 검사는 생략할 수 있으며, 나머지 검사는 독립적으로 실행됩니다.

검사 항목

HS 코드 일치성 (hsCodeCoherence) — AI 분류를 사용하여 신고된 HS 코드가 품목 설명과 일치하는지 검증합니다. confidenceScore(값이 높을수록 코드에 대한 신뢰도가 높고 위험도가 낮음)와, chapter·heading·subheading 수준의 일치성을 보여주는 hsCodeProvidedValidation을 반환합니다.

원산지 검증 (countryOfOriginValidation) — Zonos Country of Origin을 통해 AI가 예측한 원산지와 신고된 제조 원산지를 대조하여 검증합니다. probabilityOfMisrepresentation을 반환하며, 값이 높을수록 신고된 원산지가 부정확할 가능성이 높음을 나타냅니다.

가치 검증 (valueValidation) — Customs Value를 통해 신고된 관세 가치를 AI가 추정한 시장 가치와 비교합니다. 저가 신고를 포착하기 위한 probabilityOfUnderValuation을 반환합니다.

제한 검사 (restrictionCheck) — Restrict를 통해 수입, 수출 및 운송업체별 제한 목록에 대해 품목을 심사합니다. category, summary, confidence, confidenceScore가 포함된 제한 정보를 반환합니다.

규정 검사 (regulationCheck) — 품목에 적용되는 무역 규정과 필요한 인증을 식별합니다. certificateType, summary, confidenceScore가 포함된 일치 규정을 반환합니다.

거래 제한 대상자 심사 (deniedPartyScreening) — Screen을 통해 배송 당사자를 국제 거래 제한 대상자 목록과 대조하여 심사합니다. action(NO_MATCHES, REVIEW, BLOCK 중 하나)과 이름, 위치, 종합 점수를 포함한 일치 정보를 반환합니다.

결과 해석하기

응답에는 빠르고 종합적인 평가를 위한 두 가지 요약 객체가 포함됩니다:

  • itemRiskSummary — 모든 품목의 위험을 종합합니다. 저가 신고에 대한 maxProbability, 원산지에 대한 maxMisrepresentationProbability, HS 코드 일치성에 대한 maxMiscoherenceProbability 및 worstOutcome, 그리고 제한 및 규정에 대한 집계 건수와 최악의 점수를 포함합니다.
  • partyScreeningSummary — 당사자 심사 결과를 종합합니다. 심사된 모든 당사자에 대한 종합 action과 maxDeniedPartyMatchScore를 반환합니다.

정확히 어떤 품목 또는 당사자가 플래그를 발생시켰는지 확인해야 할 때는 itemResults와 partyScreenings에서 품목별·당사자별 세부 정보를 확인할 수 있습니다.

확률 점수는 0.0에서 1.0 사이의 소수로 반환됩니다. API에는 범용적인 LOW/MED/HIGH 기준값이 내장되어 있지 않으므로, 자체 트래픽 구성과 위험 허용 범위에 맞게 기준값을 조정하세요.

사용 사례 

통관 중개인: 제출 전 모든 배송에 Greenlight를 실행하여 잘못 분류된 품목, 잘못된 원산지 신고, 저가 신고된 물품을 식별하세요. 지연, 벌금, 감사로 이어지기 전에 규정 준수 문제를 미리 포착할 수 있습니다.

배송 대리인: 접수 담당자에게 전문적인 무역 지식이 없어도 들어오는 각 패키지의 수출 준비 상태를 평가할 수 있습니다. Greenlight는 어떤 품목에 주의가 필요한지, 그 이유까지 정확히 알려주어 오류를 줄이고 더 빠른 처리를 지원합니다.

운송업체 및 물류 제공업체: Greenlight를 배송 접수 워크플로에 통합하여 픽업 또는 접수 시점에 패키지를 심사하세요. 네트워크에 진입하기 전에 규정을 준수하지 않는 배송을 거부하거나 플래그를 지정하여 통관 보류와 관련 비용 위험을 줄일 수 있습니다.

세관 당국: Greenlight를 사용하여 허위 신고 위험 점수가 높은 배송에 집중함으로써 검사 우선순위를 정하세요. 위험도가 낮은 배송은 신속 처리하여, 집행 정확성을 유지하면서도 처리량을 개선할 수 있습니다.

API 가이드 

아래 예시는 6가지 검사를 모두 실행합니다. GreenLightWorkflowInput에서 토글을 false로 설정하면 해당 검사를 건너뜁니다.

1mutation GreenLightWorkflow(
2$partyInput: [PartyCreateWorkflowInput!]!
3$itemInput: [ItemCreateWorkflowInput!]!
4$greenLightInput: GreenLightWorkflowInput!
5) {
6 partyCreateWorkflow(input: $partyInput) {
7 id
8 type
9 location {
10 countryCode
11 }
12 }
13 itemCreateWorkflow(input: $itemInput) {
14 id
15 name
16 hsCode
17 countryOfOrigin
18 }
19 greenLightWorkflow(input: $greenLightInput) {
20 id
21 organizationId
22 createdAt
23 createdBy
24 itemRiskSummary {
25 itemCount
26 underValuation {
27 maxProbability
28 }
29 countryOfOriginMisrepresentation {
30 maxMisrepresentationProbability
31 }
32 hsCodeCoherence {
33 maxMiscoherenceProbability
34 worstOutcome
35 }
36 restriction {
37 matchedCount
38 affectedItemCount
39 worstCategory
40 worstConfidence
41 maxConfidenceScore
42 }
43 regulation {
44 matchedCount
45 affectedItemCount
46 maxConfidenceScore
47 }
48 }
49 partyScreeningSummary {
50 partyCount
51 action
52 maxDeniedPartyMatchScore
53 }
54 itemResults {
55 item {
56 id
57 name
58 hsCode
59 countryOfOrigin
60 amount
61 currencyCode
62 }
63 classification {
64 id
65 customsDescription
66 confidenceScore
67 hsCodeProvidedValidationScore
68 hsCodeProvidedValidation {
69 code
70 }
71 }
72 valueValidation {
73 id
74 probabilityOfUnderValuation
75 value
76 currency
77 }
78 countryOfOriginValidation {
79 id
80 probabilityOfMisrepresentation
81 countryOfOrigin
82 }
83 appliedRestrictions {
84 id
85 itemHsCode
86 restrictions {
87 id
88 category
89 confidence
90 confidenceScore
91 summary
92 url
93 imposingCountryCode
94 measureDirection
95 }
96 }
97 appliedRegulations {
98 id
99 itemHtsCode
100 certificateType
101 regulations {
102 id
103 referenceId
104 summary
105 confidenceScore
106 }
107 }
108 }
109 partyScreenings {
110 id
111 action
112 party {
113 id
114 type
115 }
116 matches {
117 scores {
118 overall
119 name
120 location
121 }
122 name
123 companyName
124 countryCode
125 deniedParty {
126 id
127 name
128 companyName
129 countryCode
130 source
131 sourceUrls
132 }
133 }
134 }
135 }
136}

시작하기 

Zonos Greenlight는 구독이 필요합니다. 액세스 권한, 가격 정책, API 연동에 대해 자세히 알아보려면 영업팀에 문의하세요.

GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

GreenLightWorkflowInput ItemCreateWorkflowInput PartyCreateWorkflowInput

MUTATIONS

greenLightWorkflow itemCreateWorkflow partyCreateWorkflow

이 페이지가 도움이 되었나요?

지원 받기·법적 문서·© 2026 Zonos
이 페이지에서:
  • Zonos Greenlight
  • API 가이드