Pourquoi une description douanière complète est importante
Chaque envoi transfrontalier nécessite un code HS, et ce code n'est fiable que si la description l'est aussi. La classification HS conditionne le dédouanement et le calcul des droits et taxes ; la description sur votre facture commerciale doit donc indiquer clairement ce qu'est l'article et de quoi il est composé.
Lorsqu'une description est vague ou ambiguë, la classification doit combler les lacunes par une supposition — et un détail supposé peut conduire au mauvais code HS. Un code incorrect entraîne de mauvais droits et taxes, et accroît le risque de retards au dédouanement, d'amendes et d'autres problèmes de conformité.
Customs Description Validation vous permet de détecter une description faible dès la saisie, au moment de la saisie des données, plutôt que de découvrir le problème après qu'un article a déjà été classé sur la base d'une supposition. Lorsqu'un élément manque, le service vous indique exactement quel détail demander au client — afin que vous puissiez corriger la description avant qu'elle n'atteigne la classification. Lorsque vous êtes prêt à générer la description elle-même, consultez Customs Description ; pour attribuer le code HS, consultez Classify.
Comment ça fonctionne
Vous soumettez les champs descriptifs disponibles pour un article — name, description, material et categories. La validation détermine si ces informations sont suffisamment précises pour aboutir à un seul code HS sans supposer un fait non déclaré, tel que la composition en fibres, le fait qu'un tissu soit tricoté ou tissé, ou l'usage prévu de l'article.
Il renvoie un status indiquant le degré de préparation de la description et — lorsqu'un élément manque — une liste clarifications qui vous indique exactement quoi demander.
La validation ne classe pas l'article et ne renvoie pas de code HS. Le status est indicatif : vous décidez de la suite en fonction de votre propre politique — passer à la classification, alerter, demander plus de détails au client ou rejeter l'article.
Deux entrées optionnelles étendent la vérification :
existingItemId— validez un article que vous avez déjà enregistré au lieu de transmettre ses champs en ligne. Tous les champs que vous fournissez également remplacent les valeurs enregistrées.shipToCountry— lorsqu'il est fourni, la validation vérifie également si la description est suffisamment précise pour sélectionner la ligne tarifaire spécifique au pays de destination, et pas seulement la sous-position HS à six chiffres.
Statuts de préparation
Le champ status renvoie l'une des quatre valeurs suivantes.
| Statut↕ | Signification↕ | Action recommandée↕ |
|---|---|---|
READY | Les informations sont suffisantes pour déterminer le code HS en toute confiance, sans supposition. clarifications est vide. | Passez à la classification. |
INCOMPLETE | L'article est identifiable, mais choisir parmi les sous-positions HS plausibles nécessiterait de supposer un détail non déclaré. | Demandez au client le détail indiqué dans clarifications, puis validez ou classez à nouveau. |
READY_TO_SUBHEADING | La sous-position à six chiffres est déterminée en toute confiance, mais un détail manque encore pour sélectionner la bonne ligne tarifaire spécifique au pays. Possible uniquement lorsque shipToCountry a été fourni. | Collectez éventuellement le détail supplémentaire pour des droits précis, ou poursuivez au niveau de la sous-position. |
UNRECOGNIZABLE | Le texte n'établit pas ce qu'est fondamentalement l'article — par exemple une valeur vide, un SKU nu ou un code interne, ou du charabia. | Demandez au client de resaisir l'article. |
Clarifications
Lorsque le statut n'est pas READY, la liste clarifications contient des phrases courtes et précises décrivant ce qu'il faut ajouter à la description — par exemple, "state the primary fiber content". Ces phrases sont rédigées pour être présentées directement au client ; nous recommandons donc de les afficher au moment de la saisie des données et de demander le détail manquant avant de continuer.
Lorsque le statut est READY, clarifications est vide.
Valider une description douanière
Utilisez la mutation customsDescriptionValidate. Fournissez directement les champs de l'article, ou référencez un article enregistré avec existingItemId. Incluez au minimum un champ descriptif.
mutation CustomsDescriptionValidate($input: CustomsDescriptionValidationInput!) { customsDescriptionValidate(input: $input) { status clarifications content { name description material categories } }}Dans l'exemple ci-dessus, l'article est clairement identifiable comme un chemisier, mais les vêtements sont classés en partie selon le matériau et la construction — choisir le bon code HS nécessiterait donc une supposition. Le statut est INCOMPLETE, et clarifications vous indique exactement quoi demander au client. Une fois ces détails ajoutés, le même article est validé en READY.
Voir un exemple READY
Une description contenant déjà les attributs décisifs valide en READY sans clarifications.
{ "input": { "name": "Men's crew-neck t-shirt", "material": "100% combed cotton, knit", "categories": [ "Apparel", "Tops" ] }}Voir un exemple spécifique à un pays
L'ajout de shipToCountry vérifie le degré de préparation jusqu'à la ligne tarifaire de destination. Ici, la sous-position à six chiffres est déjà déterminée, le statut est donc READY_TO_SUBHEADING et les clarifications décrivent ce qui manque encore pour sélectionner la ligne tarifaire exacte.
{ "input": { "name": "Pullover sweater", "material": "100% cotton, knit", "categories": [ "Apparel", "Tops" ], "shipToCountry": "US" }}
Customs Description Validation
Vérifiez si la description d'un article est suffisamment complète pour le classifier en confiance — avant de classifier.