探索適用的計畫
傳遞商品的 hsCode 和 shipToCountry 以找出適用的計畫。結果是 ComplianceRequirement 節點的分頁連線,每個節點都指向它觸發的 ComplianceProgram。
1
query ComplianceRequirements($filter: ComplianceRequirementFilter!) {2
complianceRequirements(filter: $filter, first: 10) {3
totalCount4
pageInfo {5
hasNextPage6
endCursor7
}8
edges {9
cursor10
node {11
id12
hsCode13
shipToCountry14
shipFromCountry15
program {16
id17
code18
name19
programType20
authority21
jurisdiction22
status23
strictness24
currentVersion {25
id26
version27
status28
}29
}30
}31
}32
}33
}需求上 shipFromCountry 為 null 表示該計畫不論起源地如何都適用。當您在篩選條件中提供 shipFromCountry 時,起源地特定的列和「任何起源地」列都會被比對。
篩選和分頁
complianceRequirements 接受 ComplianceRequirementFilter 加上標準遊標分頁引數(first / after 用於向前分頁,last / before 用於向後分頁)。
| 篩選欄位↕ | 類型↕ | 備註↕ |
|---|---|---|
hsCode | String | 精確 HS 編碼比對。與 hsCodePrefix 互斥。 |
hsCodePrefix | String | 前綴比對(僅限數字和點號,最多 12 個字元)。與 hsCode 互斥。 |
shipToCountry | CountryCode | 目的地國家/地區。 |
shipFromCountry | CountryCode | 起源地國家/地區。具有 null 起源地(「任何起源地」)的列也會相符。 |
programTypes | [ComplianceProgramType!] | 僅比對這些計畫類型。空清單 = 無篩選。 |
例如,列出化妝品章 3304 的每個 PGA 需求:
1
query PgaRequirements($filter: ComplianceRequirementFilter!) {2
complianceRequirements(filter: $filter, first: 25) {3
totalCount4
edges {5
node {6
hsCode7
shipToCountry8
program {9
code10
name11
}12
}13
}14
}15
}查閱計畫的問卷
每個 ComplianceProgram 都會公開其 currentVersion —— ACTIVE 問卷 —— 以及該版本的 questions(按顯示順序)。每個問題都會宣告其 answerType、是否為 required、其 options(用於選擇類型),以及可選的會分支問卷的 displayCondition。讀取此結構以呈現您自己的使用者介面,或精確了解進口商必須提供的內容。
1
query QuestionnaireStructure($filter: ComplianceRequirementFilter!) {2
complianceRequirements(filter: $filter, first: 1) {3
edges {4
node {5
program {6
code7
name8
currentVersion {9
version10
status11
questions {12
code13
prompt14
helpText15
answerType16
required17
section18
displayOrder19
optionsSource20
options {21
value22
label23
displayOrder24
}25
displayCondition {26
questionCode27
operator28
values29
}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
核查合規要求
探索適用於商品的合規計畫,並查閱您需要回答的問卷。
GraphQL
complianceRequirements查詢是 Zonos Clarify 的進入點。根據商品的 HS 編碼和路線,它會返回觸發的合規計畫,並讓您可以遍歷每項計畫的完整問卷結構 — 問題、選項和分支邏輯。使用它來判斷是否需要為貨運提供合規答案,以及呈現您自己的問卷使用者介面。此查詢需要
COMPLIANCE_READscope。如需了解如何驗證 API 請求,請參閱OAuth。