DOCS

核查合規要求

核查合規要求

探索適用於商品的合規計畫,並查閱您需要回答的問卷。

GraphQL

complianceRequirements 查詢是 Zonos Clarify 的進入點。根據商品的 HS 編碼和路線,它會返回觸發的合規計畫,並讓您可以遍歷每項計畫的完整問卷結構 — 問題、選項和分支邏輯。使用它來判斷是否需要為貨運提供合規答案,以及呈現您自己的問卷使用者介面。

需要 Scope

此查詢需要 COMPLIANCE_READ scope。如需了解如何驗證 API 請求,請參閱OAuth

探索適用的計畫 

傳遞商品的 hsCodeshipToCountry 以找出適用的計畫。結果是 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}

需求上 shipFromCountrynull 表示該計畫不論起源地如何都適用。當您在篩選條件中提供 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。讀取此結構以呈現您自己的使用者介面,或精確了解進口商必須提供的內容。

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
預約演示

這個頁面有幫助嗎?


在此頁面: