DOCS
ГлавнаяДля логистических компаний Zonos Clarify Проверка требований по соответствию

Проверка требований по соответствию

Определите, какие программы соответствия применяются к товару, и прочитайте анкету, которую вам потребуется заполнить.

GraphQL

Запрос complianceRequirements является точкой входа в Zonos Clarify. По коду HS товара и маршруту он возвращает программы соответствия, которые срабатывают, и позволяет вам просмотреть полную структуру анкеты каждой программы — вопросы, варианты и логику ветвления. Используйте его, чтобы определить, нужны ли поставке ответы по соответствию, и для отрисовки собственного интерфейса анкеты.

Требуется область действия

Этот запрос требует области действия COMPLIANCE_READ. Перейдите на OAuth для аутентификации запросов API.

Обнаружение применимых программ 

Передайте hsCode и shipToCountry товара, чтобы найти, какие программы применяются. Результатом является постраничное соединение узлов 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}

Значение shipFromCountry равное null для требования означает, что программа применяется независимо от происхождения. Когда вы предоставляете shipFromCountry в фильтре, совпадают как строки, специфичные по происхождению, так и строки "любого происхождения".

Фильтрация и постраничность 

complianceRequirements принимает ComplianceRequirementFilter плюс стандартные аргументы постраничности курсора (first / after для прямого постраничного преобразования, last / before для обратного постраничного преобразования).

Поле фильтра↕Тип↕Примечания↕
hsCodeStringТочное совпадение кода HS. Несовместимо с hsCodePrefix.
hsCodePrefixStringСовпадение префикса (только цифры и точки, максимум 12 символов). Несовместимо с hsCode.
shipToCountryCountryCodeСтрана назначения.
shipFromCountryCountryCodeСтрана происхождения. Строки со значением null в поле происхождения ("любое происхождение") также совпадают.
programTypes[ComplianceProgramType!]Совпадают только эти типы программ. Пустой список = нет фильтра.

Например, перечислите все требования PGA для главы косметики 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}

Чтение анкеты программы 

Каждая ComplianceProgram предоставляет свою currentVersion — активную анкету — и вопросы этой версии questions в порядке отображения. Каждый вопрос объявляет свой answerType, является ли он required, его options (для типов выбора) и необязательный displayCondition, который ветвит анкету. Прочитайте эту структуру, чтобы отобразить собственный интерфейс или точно понять, что должен предоставить импортер.

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}

В примере выше contains_color_additives отображается только если intended_use равно cosmetic — вот как работает displayCondition. Для полной модели ветвления и динамических опций (optionsSource) см. Как это работает.

Следующие шаги 

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

ComplianceRequirementFilter

Была ли эта страница полезной?

Получить поддержку·Юридические документы·© 2026 Zonos
На этой странице: