发现适用于某个商品的合规计划,并读取您需要回答的问卷。
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 来分支问卷。读取此结构来渲染您自己的 UI 或确切了解进口商必须提供的内容。
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来分支问卷。读取此结构来渲染您自己的 UI 或确切了解进口商必须提供的内容。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
这个页面有帮助吗?