適用プログラムの特定
品目の hsCode と shipToCountry を渡すと、どのプログラムが適用されるかを
確認できます。結果は ComplianceRequirement ノードのページネーション接続で、
各ノードはトリガーする ComplianceProgram を指します。
query ComplianceRequirements($filter: ComplianceRequirementFilter!) { complianceRequirements(filter: $filter, first: 10) { totalCount pageInfo { hasNextPage endCursor } edges { cursor node { id hsCode shipToCountry shipFromCountry program { id code name programType authority jurisdiction status strictness currentVersion { id version status } } } } }}要件の 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 要件をすべて一覧表示します。
query PgaRequirements($filter: ComplianceRequirementFilter!) { complianceRequirements(filter: $filter, first: 25) { totalCount edges { node { hsCode shipToCountry program { code name } } } }}プログラムのアンケートを読み取る
各 ComplianceProgram は currentVersion — ACTIVE なアンケート — を公開し、
そのバージョンの questions を表示順で返します。各質問は answerType、
required かどうか、選択タイプの options、アンケートを分岐させる
オプションの displayCondition を宣言します。この構造を読み取って
独自の UI をレンダリングするか、輸入者が提供する必要がある内容を
正確に把握します。
query QuestionnaireStructure($filter: ComplianceRequirementFilter!) { complianceRequirements(filter: $filter, first: 1) { edges { node { program { code name currentVersion { version status questions { code prompt helpText answerType required section displayOrder optionsSource options { value label displayOrder } displayCondition { questionCode operator values } } } } } } }}上記の例では、intended_use が cosmetic に等しい場合にのみ
contains_color_additives が表示されます — これが displayCondition の
動作です。分岐モデル全体と動的(optionsSource)オプションについては、
仕組み を参照してください。
次のステップ
- アンケートを完了する — ここで特定したアンケートを推論、回答、確定します。
- 仕組み — 分岐、 出所、動的オプション。
コンプライアンス要件の確認
品目に適用されるコンプライアンスプログラムを特定し、回答が必要な アンケートを読み取ります。
GraphQL
complianceRequirementsクエリは Zonos Clarify のエントリーポイントです。品目の HS コードとルートを指定すると、トリガーされる コンプライアンスプログラム を返し、 各プログラムの アンケート構造 全体 — 質問、選択肢、分岐ロジック — を たどることができます。出荷にコンプライアンス回答が必要かどうかを判断し、 独自のアンケート UI をレンダリングするために使用します。このクエリには
COMPLIANCE_READスコープが必要です。API リクエストの認証については OAuth を参照してください。