Statuts de préparation
Chaque validation renvoie un status. Le statut est consultatif — votre intégration décide de la conséquence de chaque valeur.
| Status↕ | Signification↕ | Action suggérée↕ |
|---|---|---|
READY | Les informations suffisent pour assigner un code HS à 6 chiffres avec confiance, sans hypothèses. | Procéder à la classification. |
INCOMPLETE | L'article est identifiable, mais un attribut décisif manque, une classification reposerait donc sur des hypothèses. | Demander l'attribut nommé dans missingAttributes, puis réessayer. |
UNRECOGNIZABLE | Le texte n'établit pas ce qu'est fondamentalement l'article — valeurs vides, SKU ou codes internes seuls, ou charabia. | Demander à l'utilisateur de ressaisir l'article. |
Lorsque le statut est INCOMPLETE, le champ missingAttributes renvoie le ou les attributs manquants sous forme de courte phrase (p. ex. "fiber content" ou "material, construction") adaptée à composer un message utilisateur. Il est null pour tout autre statut.
Valider un article via l'API
Fournissez les champs article directement — au moins un champ descriptif est requis. L'exemple ci-dessous valide un article dont le nom et la description l'identifient comme un t-shirt mais omet la composition en fibres nécessaire à la classification, la mutation renvoie donc INCOMPLETE.
mutation CustomsDescriptionValidate($input: CustomsDescriptionValidationInput!) { customsDescriptionValidate(input: $input) { id status missingAttributes content { name description material categories existingItemId } createdAt }}Champs d'input
| Field↕ | Type↕ | Description↕ |
|---|---|---|
name | String | Nom de l'article. |
description | String | Description lisible de l'article. |
material | String | Matériau ou composition de l'article, si connu (p. ex. "55% cotton, 45% polyester"). |
categories | [String!] | Catégories associées à l'article et le décrivant. |
existingItemId | ID | ID d'un Item existant à valider. Lorsqu'il est fourni, les champs de l'article stocké sont utilisés et tout champ fourni ici remplace les valeurs stockées. |
Fournissez soit existingItemId, soit les champs article directement — au moins un champ descriptif est requis.
Valider un article existant
Si l'article existe déjà dans Zonos, passez son ID comme existingItemId au lieu de renvoyer tous les champs. Les champs de l'article stocké servent de base à la validation, et tout champ que vous fournissez aussi dans le même input remplace les valeurs stockées — utile pour tester si une modification rendrait un article insuffisant prêt pour la classification.
Le content de la réponse reprend les données article validées, avec existingItemId résolu, chaque CustomsDescriptionValidation stockée est donc auto-descriptive.
Plus qu'une porte de classification
Comme le statut de préparation est consultatif, la même vérification alimente plus d'un flux — il ne s'agit pas uniquement de décider s'il faut classifier. customsDescriptionValidate évalue les mêmes données article que consomment les services de classification et de description douanière de Zonos, ce qui en fait une première étape naturelle dans un flux Customs Description plus large :
- Porte qualité des données — Signaler des informations article insuffisantes ou inutilisables au point d'entrée (dans un PIM, import catalogue ou checkout) et demander exactement ce qui manque via
missingAttributes, avant que ces données ne circulent en aval. - Générer une description douanière — Une fois qu'un article est
READY, transmettez les mêmes données à la mutationcustomsDescriptionsCreatepour que Zonos génère une description douanière concise, conforme à la douane et à ICS2 à partir de l'article — en demandant optionnellement un code HS dans le même appel. Valider la préparation au préalable signifie que la description générée repose sur des informations complètes plutôt que sur des hypothèses. - Classifier avec confiance — Procédez à Classify en sachant que la description est suffisamment riche pour assigner un code HS à 6 chiffres précis sans devinettes.
Un flux de bout en bout typique est : valider la préparation → collecter les missingAttributes → générer une description douanière conforme (et code HS) → classifier ou déposer.
Préparation à la classification
Vérifiez si les informations d'un article sont suffisamment détaillées pour classifier — avant de demander un code HS.
GraphQL
La mutation
customsDescriptionValidatevérifie si les informations d'un article sont suffisantes pour assigner un code HS à 6 chiffres avec confiance, avant l'exécution de la classification. Elle renvoie un statut de préparation que vous appliquez selon votre propre politique — procéder à la classification, avertir, demander plus de détails à l'acheteur ou au marchand, ou rejeter l'article.Il s'agit d'une vérification préalable, pas d'une classification :
customsDescriptionValidatene classifie pas l'article et ne renvoie pas de code HS. Utilisez-la pour détecter en amont les descriptions insuffisantes ou inutilisables afin que les descriptions que vous enverrez finalement à Classify produisent des résultats précis et sans hypothèses.La vérification de préparation n'est qu'un usage. Comme les mêmes données article alimentent les services de description douanière et de classification de Zonos, cette mutation est le point d'entrée d'un flux Customs Description plus large — contrôle de la qualité des données, puis génération d'une description douanière conforme à partir de l'article. Consultez Plus qu'une porte de classification ci-dessous.