DOCS

Customs Description Validation

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

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 dont il découle l'est aussi. La classification HS conditionne le dédouanement et le calcul des droits et taxes ; la description figurant 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 à un mauvais code HS. Un code erroné entraîne des droits et taxes incorrects, 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 repérer une description insuffisante en amont, dès 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, la validation vous indique exactement quel détail demander au client — afin que vous puissiez corriger la description avant même 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 dont vous disposez 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 indiqué, comme la composition en fibres, le fait qu'un tissu soit en maille ou tissé, ou l'usage prévu de l'article.

Elle renvoie un status qui indique dans quelle mesure la description est prête 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 : c'est à vous de décider de la suite à donner selon votre propre politique — passer à la classification, émettre un avertissement, demander plus de détails au client ou rejeter l'article.

Trois entrées facultatives étendent la vérification :

  • existingItemId — validez un article que vous avez déjà enregistré au lieu de transmettre ses champs directement. Tout champ que vous fournissez en plus remplace la valeur enregistrée.
  • shipToCountry — lorsqu'il est fourni, la validation vérifie également si la description est suffisamment précise pour déterminer la ligne tarifaire propre au pays de destination, et pas seulement la sous-position HS à six chiffres.
  • sessionId — reliez les validations successives d'un même article afin que les mêmes questions ne soient pas posées deux fois aux clients. Consultez Sessions.

Statuts de préparation 

Le champ status renvoie l'une des quatre valeurs suivantes.

Statut↕Signification↕Action recommandée↕
READYLes informations suffisent pour déterminer le code HS en toute confiance, sans aucune 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 indiqué.Demandez au client le détail indiqué dans clarifications, puis relancez la validation ou la classification.
READY_TO_SUBHEADINGLa sous-position à six chiffres est déterminée en toute confiance, mais il manque encore un détail pour choisir la bonne ligne tarifaire propre au pays. Possible uniquement lorsque shipToCountry a été fourni.Recueillez éventuellement le détail supplémentaire pour obtenir des droits précis, ou poursuivez au niveau de la sous-position.
UNRECOGNIZABLELe texte ne permet pas d'établir ce qu'est fondamentalement l'article — par exemple une valeur vide, un simple SKU ou code interne, ou une suite de caractères incompréhensible.Demandez au client de saisir à nouveau l'article.

Clarifications 

Lorsque le statut n'est pas READY, la liste clarifications contient de courtes phrases précises qui décrivent 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 ; une bonne pratique consiste donc à les afficher au moment de la saisie des données et à demander le détail manquant avant de poursuivre.

Lorsque le statut est READY, clarifications est vide.

Sessions 

Chaque validation renvoie un sessionId. Lorsque le client met à jour l'article en réponse aux clarifications, relancez la validation en renvoyant ce sessionId avec l'ensemble des informations à jour de l'article — et pas seulement le nouveau détail.

Au sein d'une session, la validation se souvient des questions déjà posées. Une question n'est jamais répétée, même si le client l'a ignorée ou n'y a répondu que partiellement, de sorte qu'il ne reste jamais bloqué à répondre en boucle à la même demande. Si toutes les questions restantes ont déjà été posées, le statut renvoyé est READY afin que l'article puisse avancer.

1{
2 "input": {
3 "name": "Women's blouse",
4 "description": "long-sleeve blouse, woven",
5 "sessionId": "customs_description_validation_0ryft0yp0f5fg"
6 }
7}

Dans cette suite de l'exemple du chemisier, le client a précisé que le chemisier est tissé, mais pas sa matière. La question sur la matière a déjà été posée dans cette session ; elle n'est donc pas reposée et l'article passe au statut READY.

Gardez ces règles à l'esprit :

  • Omettez sessionId lors de la première validation d'un article pour démarrer une nouvelle session.
  • Les sessions appartiennent à l'organisation appelante et utilisent un seul pays de destination. Modifier shipToCountry démarre une nouvelle session ; utilisez donc toujours le sessionId de la réponse la plus récente.
  • Démarrez une nouvelle session pour chaque article distinct.

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 moins un champ descriptif.

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

Dans l'exemple ci-dessus, l'article est clairement identifiable comme un chemisier, mais les vêtements sont classés en partie selon leur matière et leur mode de fabrication — 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é comme READY.

GraphQL API ReferenceTypes, inputs, and operations used in this guide
Réserver une démo

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