Champs d'input
Seule une description est requise pour générer une classification, mais plus vous fournissez de détails produit, plus votre classification sera précise. Vous pouvez aussi simplement fournir une URL produit et Classify extraira automatiquement tous les détails article pertinents pour vous. Ci-dessous, une explication complète de chaque champ d'input accepté par Classify. En comprenant ces champs, vous maximisez leur utilisation et générez des classifications très précises.
Descriptions des champs d'input
| Field↕ | Description↕ |
|---|---|
| Name (required) | Le nom du produit |
| Product URL (optional) | Collez une URL produit et Classify récupérera automatiquement la page et extraira les détails article pertinents (nom, description, catégories, etc.) pour la classification. Disponible dans le Dashboard en cliquant sur l'icône + ou en l'ajoutant directement dans le champ de texte principal. Pour les intégrations API, contactez votre représentant Zonos. Idéal pour les démos et tests, les implémentations en production obtiennent des performances et une efficacité optimales en passant les données article directement depuis les systèmes backend. |
| Description (optional) | Une description longue et détaillée du produit |
| Image URL (optional) | Lien vers une image du produit. Note : utilisez un lien vers l'URL réelle de l'image et non l'URL de la page produit |
| Categories (optional) | Sous-catégories produit générales, p. ex. Clothing & Accessories, Pet Supplies, Office Products ou Baby Clothes, Pet Beds, Adhesives & Tape |
| Material (optional) | Matériau du produit, p. ex. plastic, wood, steel |
| Country of Origin (optional) | L'abréviation à deux lettres (code ISO) du pays de fabrication ou de production du produit |
| Provided HS Code (optional) | Incluez un code HS existant dans votre demande de classification pour guider votre requête. Selon vos préférences et l'origine de votre code HS fourni, Classify peut valider le code HS et vérifier sa cohérence par rapport aux détails de description de l'article. En savoir plus. |
| Destination country (optional) | Identifie le pays pour lequel le produit sera classifié. Le pays de destination doit être affiché avec l'abréviation à deux lettres (code ISO) de chaque pays et non le nom du pays, p. ex. AU, pas Australia. Inclure ce champ permet à Classify de renvoyer un code HS spécifique au pays à 8 chiffres ou plus au lieu du code universel à 6 chiffres. En savoir plus sur les différences entre codes HS universels et spécifiques par pays. |
| Product ID (optional) | Votre ID produit ou tout numéro permettant d'identifier chaque produit de façon unique. Si aucun ID produit n'est fourni, Classify assignera des ID produit commençant par 1 |
Note : Si vous téléversez votre CSV de demande en lot dans le Dashboard, le pays de destination ne fera pas partie du modèle ; vous sélectionnerez vos pays de destination après le téléversement de votre CSV.
Demander une classification
Pour demander une classification dans le Dashboard ou via l'API, suivez les étapes et la mutation ci-dessous.
L'exemple ci-dessous montre une demande universelle (6 chiffres). Pour demander des classifications vers des pays spécifiques, ajoutez les codes ISO des pays dans la requête Classify comme dans l'exemple ci-dessous. Pour demander un code HS universel, laissez le pays de destination à null dans la requête Classify.
L'input accepte une liste, vous pouvez donc demander une ou plusieurs classifications à la fois.
Note : Pour générer des pistes d'audit via l'API, incluez le champ
auditTraildans votre query. Contactez votre représentant Zonos pour l'accès et les détails d'implémentation.
mutation ClassifyItems($input: [ClassificationCalculateInput!]!) { classificationsCalculate(input: $input) { id name categories imageUrl hsCode { code description { full } } }}Réponses API possibles
Lorsque Classify reçoit une demande de classification, il tente de faire correspondre les données article de la requête avec une correspondance dans la base de données Classify selon le score de confiance le plus élevé. Selon ce qui est trouvé, Classify renverra l'une des réponses suivantes :
- Lorsque
hsCodeest renvoyé avec un code HS de 6 à 8 chiffres ou plus, selon qu'un pays de destination a été inclus dans la requête, votre demande de classification a réussi. - Lorsque
{"errors": [ { "message": "No adequate response"}]}est renvoyé, Classify n'a pas pu trouver de classification en raison d'informations d'input insuffisantes.
Classifier des articles
Apprenez à demander une classification dans le Dashboard et via l'API.
Vous trouverez ci-dessous des exemples illustrant comment demander des classifications universelles et spécifiques par pays via le Dashboard ou l'API. Pour des détails techniques plus complets et une documentation étendue, consultez notre site de référence développeur API GraphQL Zonos. Cette ressource complète offre des informations détaillées sur les endpoints API, les mutations GraphQL et la documentation technique.