DOCS
InícioPara fornecedores logísticos Zonos Clarify Verificar requisitos de conformidade

Verificar requisitos de conformidade

Descubra que programas de conformidade se aplicam a um artigo e consulte o questionário a que terá de responder.

GraphQL

A consulta complianceRequirements é o ponto de entrada do Zonos Clarify. A partir do código HS e da rota de um artigo, devolve os programas de conformidade acionados e permite percorrer a estrutura completa do questionário de cada programa — perguntas, opções e lógica de ramificação. Utilize-a para decidir se uma remessa precisa de respostas de conformidade e para apresentar a sua própria interface de questionário.

Âmbito obrigatório

Esta consulta requer o âmbito COMPLIANCE_READ. Consulte OAuth para saber como autenticar pedidos à API.

Descobrir os programas aplicáveis 

Indique o hsCode e o shipToCountry de um artigo para saber que programas se aplicam. O resultado é uma ligação paginada de nós ComplianceRequirement, cada um a apontar para o ComplianceProgram que aciona.

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}

Um shipFromCountry com o valor null num requisito significa que o programa se aplica independentemente da origem. Quando indica shipFromCountry no filtro, são devolvidas tanto as linhas específicas da origem como as linhas de "qualquer origem".

Filtragem e paginação 

complianceRequirements aceita um ComplianceRequirementFilter, além dos argumentos padrão de paginação por cursor (first / after para avançar, last / before para recuar).

Campo do filtro↕Tipo↕Notas↕
hsCodeStringCorrespondência exata do código HS. Mutuamente exclusivo com hsCodePrefix.
hsCodePrefixStringCorrespondência por prefixo (apenas dígitos e pontos, máximo de 12 caracteres). Mutuamente exclusivo com hsCode.
shipToCountryCountryCodePaís de destino.
shipFromCountryCountryCodePaís de origem. As linhas com origem null ("qualquer origem") também correspondem.
programTypes[ComplianceProgramType!]Corresponde apenas a estes tipos de programa. Lista vazia = sem filtro.

Por exemplo, para listar todos os requisitos PGA do 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}

Ler o questionário de um programa 

Cada ComplianceProgram expõe a sua currentVersion — o questionário ACTIVE — e as questions dessa versão, por ordem de apresentação. Cada pergunta declara o seu answerType, se é required, as suas options (para tipos de seleção) e uma displayCondition opcional que ramifica o questionário. Leia esta estrutura para apresentar a sua própria interface ou para perceber exatamente o que um importador tem de fornecer.

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}

No exemplo acima, contains_color_additives só é apresentada quando intended_use é igual a cosmetic — é a displayCondition em ação. Para o modelo completo de ramificação e as opções dinâmicas (optionsSource), consulte Como funciona.

Próximos passos 

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

ComplianceRequirementFilter

Esta página foi útil?

Obter apoio·Documentos legais·© 2026 Zonos
Nesta página:
  • Verificar requisitos de conformidade
  • Descobrir os programas aplicáveis
  • Filtragem e paginação
  • Ler o questionário de um programa
  • Próximos passos