DOCS
BerandaUntuk penyedia logistik Zonos Clarify Periksa persyaratan kepatuhan

Periksa persyaratan kepatuhan

Temukan program kepatuhan mana yang berlaku untuk item, dan baca kuesioner yang perlu Anda jawab.

GraphQL

Kueri complianceRequirements adalah titik masuk ke Zonos Clarify. Diberikan kode HS dan rute item, ia mengembalikan program kepatuhan yang terpicu, dan memungkinkan Anda melintasi struktur kuesioner lengkap setiap program — pertanyaan, opsi, dan logika cabang. Gunakan untuk memutuskan apakah pengiriman memerlukan jawaban kepatuhan dan untuk merender UI kuesioner Anda sendiri.

Cakupan diperlukan

Kueri ini memerlukan ruang lingkup COMPLIANCE_READ. Lihat OAuth untuk mengautentikasi permintaan API.

Temukan program yang berlaku 

Teruskan hsCode dan shipToCountry item untuk menemukan program mana yang berlaku. Hasilnya adalah koneksi yang dipaginasi dari node ComplianceRequirement, masing-masing menunjuk ke ComplianceProgram yang dipicunya.

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}

Sebuah shipFromCountry dari null pada suatu persyaratan berarti program berlaku terlepas dari asal. Ketika Anda memberikan shipFromCountry dalam filter, baris khusus asal dan baris "asal apa pun" cocok.

Penyaringan dan paginasi 

complianceRequirements menerima ComplianceRequirementFilter ditambah argumen paginasi kursor standar (first / after untuk paging maju, last / before untuk paging mundur).

Bidang filter↕Tipe↕Catatan↕
hsCodeStringKecocokan kode HS yang tepat. Saling eksklusif dengan hsCodePrefix.
hsCodePrefixStringKecocokan prefiks (angka dan titik saja, maks 12 karakter). Saling eksklusif dengan hsCode.
shipToCountryCountryCodeNegara tujuan.
shipFromCountryCountryCodeNegara asal. Baris dengan asal null ("asal apa pun") juga cocok.
programTypes[ComplianceProgramType!]Cocokkan hanya jenis program ini. Daftar kosong = tidak ada filter.

Sebagai contoh, cantumkan setiap persyaratan PGA untuk bab kosmetik 3304:

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}

Baca kuesioner program 

Setiap ComplianceProgram mengekspos currentVersion — kuesioner ACTIVE — dan questions versi itu dalam urutan tampilan. Setiap pertanyaan mendeklarasikan answerType, apakah itu required, options (untuk jenis pilihan), dan displayCondition opsional yang membuat cabang kuesioner. Baca struktur ini untuk merender UI Anda sendiri atau untuk memahami dengan tepat apa yang harus disediakan importir.

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}

Pada contoh di atas, contains_color_additives hanya ditampilkan ketika intended_use sama dengan cosmetic — itulah displayCondition dalam aksi. Untuk model cabang penuh dan opsi dinamis (optionsSource), lihat Cara kerjanya.

Langkah berikutnya 

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

ComplianceRequirementFilter

Apakah halaman ini bermanfaat?

Dapatkan dukungan·Dokumen hukum·© 2026 Zonos
Di halaman ini:
  • Periksa persyaratan kepatuhan
  • Temukan program yang berlaku
  • Penyaringan dan paginasi
  • Baca kuesioner program
  • Langkah berikutnya