DOCS

Customs Description Validation

Customs Description Validation

Vérifiez si la description d'un article est suffisamment complète pour le classifier en confiance — avant de classifier.

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.

StatutSignificationAction recommandée
READYLes informations sont suffisantes pour déterminer le code HS en toute confiance, sans supposition. clarifications est vide.Passez à la classification.
INCOMPLETEL'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_SUBHEADINGLa 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.
UNRECOGNIZABLELe 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.

1mutation CustomsDescriptionValidate(
2$input: CustomsDescriptionValidationInput!
3) {
4 customsDescriptionValidate(input: $input) {
5 status
6 clarifications
7 content {
8 name
9 description
10 material
11 categories
12 }
13 }
14}

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.

Une description contenant déjà les attributs décisifs valide en READY sans clarifications.

1{
2 "input": {
3 "name": "Men's crew-neck t-shirt",
4 "material": "100% combed cotton, knit",
5 "categories": [
6 "Apparel",
7 "Tops"
8 ]
9 }
10}

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.

1{
2 "input": {
3 "name": "Pullover sweater",
4 "material": "100% cotton, knit",
5 "categories": [
6 "Apparel",
7 "Tops"
8 ],
9 "shipToCountry": "US"
10 }
11}
GraphQL API ReferenceTypes, inputs, and operations used in this guide

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