DOCS
首頁為物流供應商提供的解決方案 Zonos Clarify 檢查合規要求

檢查合規要求

發現適用於商品的合規計畫，並查看您需要回答的問卷。

GraphQL

complianceRequirements 查詢是 Zonos Clarify 的入口點。根據商品的 HS 編碼和路線，它會返回所觸發的合規計畫，並允許您遍歷每個計畫的完整問卷結構 —— 問題、選項和分支邏輯。使用它來決定貨運是否需要合規答案，以及渲染您自己的問卷 UI。

需要作用域

此查詢需要 COMPLIANCE_READ 作用域。詳見 OAuth 以對 API 請求進行身份驗證。

發現適用的計畫 

傳遞商品的 hsCode 和 shipToCountry 以尋找適用的計畫。結果是 ComplianceRequirement 節點的分頁連接，每個節點都指向它所觸發的 ComplianceProgram。

1query ComplianceRequirements($filter: ComplianceRequirementFilter!) {
2 complianceRequirements(filter: $filter, first: 10) {
3 totalCount
4 pageInfo {
5 hasNextPage
6 endCursor
7 }
8 edges {
9 cursor
10 node {
11 id
12 hsCode
13 shipToCountry
14 shipFromCountry
15 program {
16 id
17 code
18 name
19 programType
20 authority
21 jurisdiction
22 status
23 strictness
24 currentVersion {
25 id
26 version
27 status
28 }
29 }
30 }
31 }
32 }
33}

要求上的 shipFromCountry 值為 null 表示該計畫不論原產地都適用。當您在篩選條件中提供 shipFromCountry 時，特定原產地的列和「任何原產地」列都會被匹配。

篩選和分頁 

complianceRequirements 接受 ComplianceRequirementFilter 加上標準遊標分頁引數（first / after 用於向前分頁，last / before 用於向後分頁）。

篩選條件欄位↕類型↕備註↕
hsCodeString精確 HS 編碼匹配。與 hsCodePrefix 互斥。
hsCodePrefixString前綴匹配（僅數字和點，最多 12 個字元）。與 hsCode 互斥。
shipToCountryCountryCode目的地國家。
shipFromCountryCountryCode原產國。帶有 null 原產地（「任何原產地」）的列也會匹配。
programTypes[ComplianceProgramType!]僅匹配這些計畫類型。空清單 = 無篩選。

例如，列出化妝品章節 3304 的每個 PGA 要求：

1query PgaRequirements($filter: ComplianceRequirementFilter!) {
2 complianceRequirements(filter: $filter, first: 25) {
3 totalCount
4 edges {
5 node {
6 hsCode
7 shipToCountry
8 program {
9 code
10 name
11 }
12 }
13 }
14 }
15}

讀取計畫的問卷 

每個 ComplianceProgram 都會公開其 currentVersion —— ACTIVE 問卷 —— 以及該版本的 questions（按顯示順序）。每個問題都聲明其 answerType、是否為 required、其 options（針對選擇類型）以及可選的 displayCondition，該條件會分支問卷。讀取此結構以渲染您自己的 UI 或瞭解進口商必須提供的內容。

1query QuestionnaireStructure($filter: ComplianceRequirementFilter!) {
2 complianceRequirements(filter: $filter, first: 1) {
3 edges {
4 node {
5 program {
6 code
7 name
8 currentVersion {
9 version
10 status
11 questions {
12 code
13 prompt
14 helpText
15 answerType
16 required
17 section
18 displayOrder
19 optionsSource
20 options {
21 value
22 label
23 displayOrder
24 }
25 displayCondition {
26 questionCode
27 operator
28 values
29 }
30 }
31 }
32 }
33 }
34 }
35 }
36}

在上方的範例中，contains_color_additives 僅在 intended_use 等於 cosmetic 時顯示 —— 這是 displayCondition 的作用。如需完整的分支模型和動態（optionsSource）選項，請參閱 它的工作原理。

後續步驟 

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

ComplianceRequirementFilter

這個頁面有幫助嗎？

獲取支持·法律文件·© 2026 Zonos
在此頁面：