DOCS

Vérifier les exigences de conformité

AccueilPour les prestataires logistiques Zonos Clarify Vérifier les exigences de conformité

Vérifier les exigences de conformité

Découvrez quels programmes de conformité s'appliquent à un article, et lisez le questionnaire auquel vous devrez répondre.

GraphQL

La query complianceRequirements est le point d'entrée de Zonos Clarify. À partir du code HS et de la route d'un article, elle renvoie les programmes de conformité déclenchés, et vous permet de parcourir la structure complète du questionnaire de chaque programme — questions, options et logique de branchement. Utilisez-la pour déterminer si un envoi nécessite des réponses de conformité et pour afficher votre propre interface de questionnaire.

Scope requis

Cette query requiert le scope COMPLIANCE_READ. Consultez OAuth pour l'authentification des requêtes API.

Découvrir les programmes applicables 

Passez le hsCode et le shipToCountry d'un article pour trouver quels programmes s'appliquent. Le résultat est une connexion paginée de nœuds ComplianceRequirement, chacun pointant vers le ComplianceProgram qu'il déclenche.

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 à null sur une exigence signifie que le programme s'applique quelle que soit l'origine. Lorsque vous fournissez shipFromCountry dans le filtre, les lignes spécifiques à l'origine et les lignes « toute origine » sont toutes deux correspondantes.

Filtrage et pagination 

complianceRequirements accepte un ComplianceRequirementFilter plus les arguments de pagination par curseur standard (first / after pour la pagination avant, last / before pour la pagination arrière).

Filter field↕Type↕Notes↕
hsCodeStringCorrespondance exacte du code HS. Mutuellement exclusif avec hsCodePrefix.
hsCodePrefixStringCorrespondance par préfixe (chiffres et points uniquement, 12 caractères max). Mutuellement exclusif avec hsCode.
shipToCountryCountryCodePays de destination.
shipFromCountryCountryCodePays d'origine. Les lignes avec origine null (« toute origine ») correspondent aussi.
programTypes[ComplianceProgramType!]Correspondre uniquement à ces types de programme. Liste vide = pas de filtre.

Par exemple, listez toutes les exigences PGA pour le chapitre cosmétiques 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}

Lire le questionnaire d'un programme 

Chaque ComplianceProgram expose sa currentVersion — le questionnaire ACTIVE — et les questions de cette version dans l'ordre d'affichage. Chaque question déclare son answerType, si elle est required, ses options (pour les types select), et une displayCondition optionnelle qui branche le questionnaire. Lisez cette structure pour afficher votre propre interface ou pour comprendre exactement ce qu'un importateur doit fournir.

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}

Dans l'exemple ci-dessus, contains_color_additives n'est affichée que lorsque intended_use est égal à cosmetic — c'est la displayCondition en action. Pour le modèle de branchement complet et les options dynamiques (optionsSource), consultez Comment ça marche.

Prochaines étapes 

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

ComplianceRequirementFilter

Réserver une démo

Cette page a-t-elle été utile?

Obtenir de l'aide·Documents juridiques·© 2026 Zonos
Sur cette page :
  • Vérifier les exigences de conformité
  • Découvrir les programmes applicables
  • Filtrage et pagination
  • Lire le questionnaire d'un programme
  • Prochaines étapes