DOCS
Ana sayfaLojistik sağlayıcıları için Zonos Clarify Uyum gereksinimlerini kontrol etme

Uyum gereksinimlerini kontrol etme

Bir ürüne hangi uyum programlarının geçerli olduğunu keşfedin ve cevaplamanız gereken anketi okuyun.

GraphQL

complianceRequirements sorgusu Zonos Clarify'nin giriş noktasıdır. Bir ürünün HS kodu ve rotası verilerek, tetiklenen uyum programlarını döndürür ve her programın tam anket yapısını geçmenize olanak tanır — sorular, seçenekler ve dallanma mantığı. Bir sevkiyatın uyum yanıtlarına ihtiyaç duyup duymadığını belirlemek ve kendi anket arayüzünüzü render etmek için kullanın.

Kapsam gereklidir

Bu sorgu COMPLIANCE_READ kapsamını gerektirir. API isteklerini doğrulamak için bkz. OAuth.

Geçerli programları keşfedin 

Hangi programların uygulanacağını bulmak için bir ürünün hsCode ve shipToCountry değerini iletin. Sonuç, tetiklediği ComplianceProgram öğesine işaret eden ComplianceRequirement düğümlerinin sayfalandırılmış bir bağlantısıdır.

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}

Bir gereksinimde null değerinde shipFromCountry, programın kökenden bağımsız olarak geçerli olduğu anlamına gelir. Filtrede shipFromCountry sağladığınızda, hem başlangıç ülkesine özgü satırlar hem de "herhangi bir kökenden" satırlar eşleştirilir.

Filtreleme ve sayfalandırma 

complianceRequirements bir ComplianceRequirementFilter ve standart imleç sayfalandırma bağımsız değişkenlerini kabul eder (first / after ileri sayfalandırma için, last / before geri sayfalandırma için).

Filtre alanı↕Tür↕Notlar↕
hsCodeStringTam HS kodu eşleşmesi. hsCodePrefix ile karşılıklı olarak münhasırdır.
hsCodePrefixStringÖn ek eşleşmesi (yalnızca rakamlar ve noktalar, en fazla 12 karakter). hsCode ile karşılıklı olarak münhasırdır.
shipToCountryCountryCodeHedef ülke.
shipFromCountryCountryCodeKöken ülkesi. null kökenli satırlar ("herhangi bir kökenden") da eşleşir.
programTypes[ComplianceProgramType!]Yalnızca bu program türlerini eşleştir. Boş liste = filtre yok.

Örneğin, kozmetik bölümü 3304 için her PGA gereksinimini listele:

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}

Program anketini okuyun 

Her ComplianceProgram kendi currentVersion — ACTIVE anketini — ve bu sürümün questions öğesini görüntüleme sırasında ortaya koymaktadır. Her soru answerType değerini, required olup olmadığını, options değerini (seçim türleri için) ve anketi dallandıran isteğe bağlı displayCondition değerini bildirir. Kendi arayüzünüzü render etmek veya bir ithalatçının tam olarak neyi sağlaması gerektiğini anlamak için bu yapıyı okuyun.

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}

Yukarıdaki örnekte, contains_color_additives yalnızca intended_use eşittir cosmetic olduğunda gösterilir — bu displayCondition işlemidir. Tam dallanma modeli ve dinamik (optionsSource) seçenekleri için bkz. Nasıl çalışır.

Sonraki adımlar 

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

ComplianceRequirementFilter

Bu sayfa faydalı mıydı?

Destek alın·Hukuki belgeler·© 2026 Zonos
Bu sayfada:
  • Uyum gereksinimlerini kontrol etme
  • Geçerli programları keşfedin
  • Filtreleme ve sayfalandırma
  • Program anketini okuyun
  • Sonraki adımlar