檢查合規要求

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

GraphQL

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

發現適用的計畫

傳遞商品的 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 用於向後分頁）。

篩選條件欄位↕	類型↕	備註↕
`hsCode`	`String`	精確 HS 編碼匹配。與 `hsCodePrefix` 互斥。
`hsCodePrefix`	`String`	前置詞匹配（僅數字和點，最多 12 個字元）。與 `hsCode` 互斥。
`shipToCountry`	`CountryCode`	目的地國家。
`shipFromCountry`	`CountryCode`	原產國。帶有 `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

預約演示

檢查合規要求

檢查合規要求

發現適用的計畫

篩選和分頁

讀取計畫的問卷

後續步驟

這個頁面有幫助嗎？