品目に適用されるコンプライアンスプログラムを特定し、回答が必要な アンケートを読み取ります。
GraphQL
complianceRequirements クエリは Zonos Clarify のエントリーポイントです。品目の HS コードとルートを指定すると、トリガーされる コンプライアンスプログラム を返し、 各プログラムの アンケート構造 全体 — 質問、選択肢、分岐ロジック — を たどることができます。出荷にコンプライアンス回答が必要かどうかを判断し、 独自のアンケート UI をレンダリングするために使用します。
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 要件をすべて一覧表示します。
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
上記の例では、intended_use が cosmetic に等しい場合にのみ contains_color_additives が表示されます — これが displayCondition の 動作です。分岐モデル全体と動的(optionsSource)オプションについては、 仕組み を参照してください。
intended_use
cosmetic
contains_color_additives
コンプライアンス要件の確認
コンプライアンス要件の確認
品目に適用されるコンプライアンスプログラムを特定し、回答が必要な アンケートを読み取ります。
GraphQL
complianceRequirementsクエリは Zonos Clarify のエントリーポイントです。品目の HS コードとルートを指定すると、トリガーされる コンプライアンスプログラム を返し、 各プログラムの アンケート構造 全体 — 質問、選択肢、分岐ロジック — を たどることができます。出荷にコンプライアンス回答が必要かどうかを判断し、 独自のアンケート UI をレンダリングするために使用します。このクエリには
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}}}}}}}}上記の例では、
intended_useがcosmeticに等しい場合にのみcontains_color_additivesが表示されます — これがdisplayConditionの 動作です。分岐モデル全体と動的(optionsSource)オプションについては、 仕組み を参照してください。次のステップ
ComplianceRequirementFilter
このページは役に立ちましたか?