探索適用於商品的合規計畫,並查閱您需要回答的問卷。
GraphQL
complianceRequirements 查詢是 Zonos Clarify 的進入點。根據商品的 HS 編碼和路線,它會返回觸發的合規計畫,並讓您可以遍歷每項計畫的完整問卷結構 — 問題、選項和分支邏輯。使用它來判斷是否需要為貨運提供合規答案,以及呈現您自己的問卷使用者介面。
complianceRequirements
此查詢需要 COMPLIANCE_READ 作用域。如需了解如何驗證 API 請求,請參閱OAuth。
COMPLIANCE_READ
傳遞商品的 hsCode 和 shipToCountry 以找出適用的計畫。結果是 ComplianceRequirement 節點的分頁連線,每個節點都指向它觸發的 ComplianceProgram。
hsCode
shipToCountry
ComplianceRequirement
ComplianceProgram
query ComplianceRequirements($filter: ComplianceRequirementFilter!) {
complianceRequirements(filter: $filter, first: 10) {
totalCount
pageInfo {
hasNextPage
endCursor
}
edges {
cursor
node {
id
shipFromCountry
program {
code
name
programType
authority
jurisdiction
status
strictness
currentVersion {
version
需求上 shipFromCountry 為 null 表示該計畫不論起源地如何都適用。當您在篩選條件中提供 shipFromCountry 時,起源地特定的列和「任何起源地」列都會被比對。
null
complianceRequirements 接受 ComplianceRequirementFilter 加上標準遊標分頁引數(first / after 用於向前分頁,last / before 用於向後分頁)。
ComplianceRequirementFilter
first
after
last
before
String
hsCodePrefix
CountryCode
programTypes
[ComplianceProgramType!]
例如,列出化妝品章 3304 的每個 PGA 需求:
3304
query PgaRequirements($filter: ComplianceRequirementFilter!) {
complianceRequirements(filter: $filter, first: 25) {
每個 ComplianceProgram 都會公開其 currentVersion —— ACTIVE 問卷 —— 以及該版本的 questions(按顯示順序)。每個問題都會宣告其 answerType、是否為 required、其 options(用於選擇類型),以及可選的會分支問卷的 displayCondition。讀取此結構以呈現您自己的使用者介面,或精確了解進口商必須提供的內容。
currentVersion
ACTIVE
questions
answerType
required
options
displayCondition
query QuestionnaireStructure($filter: ComplianceRequirementFilter!) {
complianceRequirements(filter: $filter, first: 1) {
questions {
prompt
helpText
section
displayOrder
optionsSource
options {
value
label
displayCondition {
questionCode
operator
values
在上述範例中,contains_color_additives 僅在 intended_use 等於 cosmetic 時才會顯示 —— 這就是 displayCondition 的作用。如需完整的分支模型和動態(optionsSource)選項,請參閱運作原理。
contains_color_additives
intended_use
cosmetic
核查合規要求
核查合規要求
探索適用於商品的合規計畫,並查閱您需要回答的問卷。
GraphQL
complianceRequirements查詢是 Zonos Clarify 的進入點。根據商品的 HS 編碼和路線,它會返回觸發的合規計畫,並讓您可以遍歷每項計畫的完整問卷結構 — 問題、選項和分支邏輯。使用它來判斷是否需要為貨運提供合規答案,以及呈現您自己的問卷使用者介面。此查詢需要
COMPLIANCE_READ作用域。如需了解如何驗證 API 請求,請參閱OAuth。探索適用的計畫
傳遞商品的
hsCode和shipToCountry以找出適用的計畫。結果是ComplianceRequirement節點的分頁連線,每個節點都指向它觸發的ComplianceProgram。query ComplianceRequirements($filter: ComplianceRequirementFilter!) {complianceRequirements(filter: $filter, first: 10) {totalCountpageInfo {hasNextPageendCursor}edges {cursornode {idhsCodeshipToCountryshipFromCountryprogram {idcodenameprogramTypeauthorityjurisdictionstatusstrictnesscurrentVersion {idversionstatus}}}}}}需求上
shipFromCountry為null表示該計畫不論起源地如何都適用。當您在篩選條件中提供shipFromCountry時,起源地特定的列和「任何起源地」列都會被比對。篩選和分頁
complianceRequirements接受ComplianceRequirementFilter加上標準遊標分頁引數(first/after用於向前分頁,last/before用於向後分頁)。hsCodeStringhsCodePrefix互斥。hsCodePrefixStringhsCode互斥。shipToCountryCountryCodeshipFromCountryCountryCodenull起源地(「任何起源地」)的列也會相符。programTypes[ComplianceProgramType!]例如,列出化妝品章
3304的每個 PGA 需求:query PgaRequirements($filter: ComplianceRequirementFilter!) {complianceRequirements(filter: $filter, first: 25) {totalCountedges {node {hsCodeshipToCountryprogram {codename}}}}}查閱計畫的問卷
每個
ComplianceProgram都會公開其currentVersion——ACTIVE問卷 —— 以及該版本的questions(按顯示順序)。每個問題都會宣告其answerType、是否為required、其options(用於選擇類型),以及可選的會分支問卷的displayCondition。讀取此結構以呈現您自己的使用者介面,或精確了解進口商必須提供的內容。query QuestionnaireStructure($filter: ComplianceRequirementFilter!) {complianceRequirements(filter: $filter, first: 1) {edges {node {program {codenamecurrentVersion {versionstatusquestions {codeprompthelpTextanswerTyperequiredsectiondisplayOrderoptionsSourceoptions {valuelabeldisplayOrder}displayCondition {questionCodeoperatorvalues}}}}}}}}在上述範例中,
contains_color_additives僅在intended_use等於cosmetic時才會顯示 —— 這就是displayCondition的作用。如需完整的分支模型和動態(optionsSource)選項,請參閱運作原理。後續步驟
ComplianceRequirementFilter
這個頁面有幫助嗎?