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.
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.
Le champ status renvoie l'une des quatre valeurs suivantes.
Statut↕
Signification↕
Action recommandée↕
READY
Les informations suffisent pour déterminer le code HS en toute confiance, sans aucune 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 indiqué.
Demandez au client le détail indiqué dans clarifications, puis relancez la validation ou la classification.
READY_TO_SUBHEADING
La 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.
UNRECOGNIZABLE
Le 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.
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.
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.
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.
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.
1mutationCustomsDescriptionValidate(
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.
Voir un exemple READY
Une description qui contient déjà les attributs décisifs est validée comme 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}
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.
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
Customs Description Validation
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,materialetcategories. 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
statusqui indique dans quelle mesure la description est prête et — lorsqu'un élément manque — une listeclarificationsqui vous indique exactement quoi demander.La validation ne classe pas l'article et ne renvoie pas de code HS. Le
statusest 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
statusrenvoie l'une des quatre valeurs suivantes.READYclarificationsest vide.INCOMPLETEclarifications, puis relancez la validation ou la classification.READY_TO_SUBHEADINGshipToCountrya été fourni.UNRECOGNIZABLEClarifications
Lorsque le statut n'est pas
READY, la listeclarificationscontient 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,clarificationsest vide.Sessions
Chaque validation renvoie un
sessionId. Lorsque le client met à jour l'article en réponse aux clarifications, relancez la validation en renvoyant cesessionIdavec 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
READYafin que l'article puisse avancer.{"input": {"name": "Women's blouse","description": "long-sleeve blouse, woven","sessionId": "customs_description_validation_0ryft0yp0f5fg"}}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 :
sessionIdlors de la première validation d'un article pour démarrer une nouvelle session.shipToCountrydémarre une nouvelle session ; utilisez donc toujours lesessionIdde la réponse la plus récente.Valider une description douanière
Utilisez la mutation
customsDescriptionValidate. Fournissez directement les champs de l'article, ou référencez un article enregistré avecexistingItemId. Incluez au moins un champ descriptif.mutation CustomsDescriptionValidate($input: CustomsDescriptionValidationInput!) {customsDescriptionValidate(input: $input) {statusclarificationssessionIdcontent {namedescriptionmaterialcategories}}}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, etclarificationsvous indique exactement quoi demander au client. Une fois ces détails ajoutés, le même article est validé commeREADY.Voir un exemple READY
Une description qui contient déjà les attributs décisifs est validée comme
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
shipToCountryvé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 doncREADY_TO_SUBHEADINGet lesclarificationsdé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"}}CustomsDescriptionValidationInput
customsDescriptionValidate
Cette page vous a-t-elle été utile?