DOCS

コンプライアンス要件の確認

コンプライアンス要件の確認

品目に適用されるコンプライアンスプログラムを特定し、回答が必要な アンケートを読み取ります。

GraphQL

complianceRequirements クエリは Zonos Clarify のエントリーポイントです。品目の HS コードとルートを指定すると、トリガーされる コンプライアンスプログラム を返し、 各プログラムの アンケート構造 全体 — 質問、選択肢、分岐ロジック — を たどることができます。出荷にコンプライアンス回答が必要かどうかを判断し、 独自のアンケート UI をレンダリングするために使用します。

必要なスコープ

このクエリには COMPLIANCE_READ スコープが必要です。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 を指定すると、原産地固有の行と 「任意の原産地」の行の両方が一致します。

フィルタリングとページネーション 

complianceRequirementsComplianceRequirementFilter と標準的な カーソルページネーション引数(前方ページングの first / after、 後方ページングの last / before)を受け付けます。

フィールド備考
hsCodeStringHS コードの完全一致。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}

プログラムのアンケートを読み取る 

ComplianceProgramcurrentVersionACTIVE なアンケート — を公開し、 そのバージョンの questions を表示順で返します。各質問は answerTyperequired かどうか、選択タイプの 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}

上記の例では、intended_usecosmetic に等しい場合にのみ contains_color_additives が表示されます — これが displayCondition の 動作です。分岐モデル全体と動的(optionsSource)オプションについては、 仕組み を参照してください。

次のステップ 

GraphQL API ReferenceTypes, inputs, and operations used in this guide

このページは役に立ちましたか?


このページでは: