DOCS
Strona głównaDla dostawców logistyki Zonos Clarify Sprawdź wymagania zgodności

Sprawdź wymagania zgodności

Odkryj, które programy zgodności dotyczą przedmiotu, i przeczytaj ankietę, którą będziesz musiał wypełnić.

GraphQL

Zapytanie complianceRequirements jest punktem wejścia do Zonos Clarify. Mając kod HS przedmiotu i trasę, zwraca programy zgodności, które są wyzwalane, i pozwala przejść przez pełną strukturę ankiety każdego programu — pytania, opcje i logikę rozgałęzień. Użyj go, aby zdecydować, czy wysyłka wymaga odpowiedzi na pytania dotyczące zgodności i aby renderować własny interfejs użytkownika ankiety.

Wymagany zakres

To zapytanie wymaga zakresu COMPLIANCE_READ. Przejrzyj OAuth, aby uwierzytelnić żądania API.

Odkryj mające zastosowanie programy 

Podaj hsCode i shipToCountry przedmiotu, aby znaleźć, które programy mają zastosowanie. Wynik jest paginowanym połączeniem węzłów ComplianceRequirement, każdy wskazujący ComplianceProgram, który on wyzwala.

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}

Wartość shipFromCountry równa null w wymaganiu oznacza, że program ma zastosowanie niezależnie od pochodzenia. Jeśli dostarczysz shipFromCountry w filtrze, zarówno wiersze specyficzne dla pochodzenia jak i wiersze „dowolnego pochodzenia” są dopasowywane.

Filtrowanie i paginacja 

complianceRequirements akceptuje ComplianceRequirementFilter plus standardowe argumenty paginacji kursorów (first / after do przewijania do przodu, last / before do przewijania do tyłu).

Pole filtra↕Typ↕Notatki↕
hsCodeStringDokładne dopasowanie kodu HS. Wzajemnie wykluczające się z hsCodePrefix.
hsCodePrefixStringDopasowanie prefiksu (tylko cyfry i kropki, maksymalnie 12 znaków). Wzajemnie wykluczające się z hsCode.
shipToCountryCountryCodeKraj docelowy.
shipFromCountryCountryCodeKraj pochodzenia. Wiersze z wartością null pochodzenia („dowolne pochodzenie”) również się dopasowują.
programTypes[ComplianceProgramType!]Dopasuj tylko te typy programów. Pusta lista = brak filtra.

Na przykład wymień każde wymaganie PGA dla rozdziału kosmetyków 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}

Przeczytaj ankietę programu 

Każdy ComplianceProgram ujawnia swoją currentVersion — ankietę ACTIVE — i pytania questions tej wersji w kolejności wyświetlania. Każde pytanie deklaruje swoje answerType, czy jest required, jego options (dla typów wyboru) i opcjonalny displayCondition, który rozgałęzia ankietę. Przeczytaj tę strukturę, aby renderować własny interfejs użytkownika lub aby zrozumieć dokładnie, co importer musi dostarczyć.

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}

W powyższym przykładzie contains_color_additives jest wyświetlane tylko gdy intended_use równa się cosmetic — to displayCondition w działaniu. Aby zapoznać się z pełnym modelem rozgałęzienia i dynamicznymi opcjami (optionsSource), przejrzyj Jak to działa.

Następne kroki 

  • Ukończ ankietę - wnioskuj, odpowiadaj i finalizuj ankiety, które odkryłeś tutaj.
  • Jak to działa - rozgałęzienia, pochodzenie i opcje dynamiczne.
GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

ComplianceRequirementFilter

Czy ta strona była pomocna?

Uzyskaj wsparcie·Dokumenty prawne·© 2026 Zonos
Na tej stronie:
  • Sprawdź wymagania zgodności
  • Odkryj mające zastosowanie programy
  • Filtrowanie i paginacja
  • Przeczytaj ankietę programu
  • Następne kroki