DOCS
InicioPara proveedores logísticos Zonos Clarify Consultar requisitos de cumplimiento

Consultar requisitos de cumplimiento

Descubra qué programas de cumplimiento aplican a un artículo y lea el cuestionario que deberá responder.

GraphQL

La consulta complianceRequirements es el punto de entrada a Zonos Clarify. Dado el código HS y la ruta de un artículo, devuelve los programas de cumplimiento que se activan y le permite recorrer la estructura completa del cuestionario de cada programa: preguntas, opciones y lógica de ramificación. Utilícela para decidir si un envío necesita respuestas de cumplimiento y para renderizar su propia interfaz de cuestionario.

Ámbito requerido

Esta consulta requiere el ámbito COMPLIANCE_READ. Consulte OAuth para autenticar solicitudes a la API.

Descubrir programas aplicables 

Pase el hsCode y shipToCountry de un artículo para encontrar qué programas aplican. El resultado es una conexión paginada de nodos ComplianceRequirement, cada uno apuntando al ComplianceProgram que activa.

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}

Un shipFromCountry de null en un requisito significa que el programa aplica independientemente del origen. Cuando proporciona shipFromCountry en el filtro, coinciden tanto las filas específicas de origen como las de "cualquier origen".

Filtrado y paginación 

complianceRequirements acepta un ComplianceRequirementFilter más los argumentos estándar de paginación por cursor (first / after para avanzar, last / before para retroceder).

Campo de filtro↕Tipo↕Notas↕
hsCodeStringCoincidencia exacta de código HS. Mutuamente excluyente con hsCodePrefix.
hsCodePrefixStringCoincidencia por prefijo (solo dígitos y puntos, máx. 12 caracteres). Mutuamente excluyente con hsCode.
shipToCountryCountryCodePaís de destino.
shipFromCountryCountryCodePaís de origen. Las filas con origen null ("cualquier origen") también coinciden.
programTypes[ComplianceProgramType!]Coincidir solo con estos tipos de programa. Lista vacía = sin filtro.

Por ejemplo, liste todos los requisitos PGA del capítulo de cosméticos 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}

Leer el cuestionario de un programa 

Cada ComplianceProgram expone su currentVersion — el cuestionario ACTIVE — y las questions de esa versión en orden de visualización. Cada pregunta declara su answerType, si es required, sus options (para tipos de selección) y una displayCondition opcional que ramifica el cuestionario. Lea esta estructura para renderizar su propia interfaz o para comprender exactamente qué debe proporcionar un importador.

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}

En el ejemplo anterior, contains_color_additives solo se muestra cuando intended_use es igual a cosmetic; así funciona la displayCondition. Para el modelo completo de ramificación y opciones dinámicas (optionsSource), consulte Cómo funciona.

Siguientes pasos 

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

ComplianceRequirementFilter

¿Fue útil esta página?

Obtener soporte·Documentos legales·© 2026 Zonos
En esta página:
  • Consultar requisitos de cumplimiento
  • Descubrir programas aplicables
  • Filtrado y paginación
  • Leer el cuestionario de un programa
  • Siguientes pasos