Champs d'entrée
Bien qu'une description soit uniquement requise pour générer une classification, plus vous fournissez de détails sur le produit, plus votre classification sera précise. Ci-dessous, une explication complète de chaque champ d'entrée accepté par Classify. En comprenant ces champs d'entrée, vous pouvez maximiser leur utilisation et générer des classifications très précises.
Descriptions des champs d'entrée
| Champ | Description |
|---|---|
| Nom (obligatoire) | Le nom du produit |
| Description (facultatif) | Une description détaillée et longue du produit |
| URL de l'image (facultatif) | Lien vers une image du produit. Remarque : Assurez-vous d'utiliser un lien vers l'URL de l'image réelle et non l'URL de la page produit |
| Catégories (facultatif) | Sous-catégories générales de produits, par exemple, Vêtements et accessoires, Fournitures pour animaux de compagnie, Produits de bureau ou Vêtements pour bébés, Lits pour animaux de compagnie, Adhésifs et rubans |
| Matériau (facultatif) | De quoi est fait le produit, par exemple, plastique, bois, acier |
| Pays d'origine (facultatif) | Labréviation à deux lettres (code ISO) pour le pays de fabrication ou de production du produit |
| Code SH fourni (facultatif) | Incluez un code SH existant dans votre demande de classification pour guider votre demande. En fonction de votre préférence et de l'origine de votre code SH fourni, Classify peut valider le code SH et vérifier sa cohérence par rapport aux détails de description de l'article. En savoir plus. |
| Pays de destination (facultatif) | Identifie le pays vers lequel le produit sera classé. Le pays de destination doit être affiché avec labréviation à deux lettres (code ISO) de chaque pays et non le nom réel du pays, par exemple, AU, pas Australie. L'inclusion de ce champ permettra à Classify de renvoyer un code SH spécifique au pays de 8 chiffres ou plus au lieu du code universel de 6 chiffres. En savoir plus sur les différences entre les codes SH universels et spécifiques à chaque pays. |
| ID produit (facultatif) | Votre ID produit ou tout numéro pouvant être utilisé pour identifier de manière unique chaque produit. Si un ID produit n'est pas fourni, Classify attribuera des ID produits commençant par 1 |
Remarque : Si vous téléchargez votre demande en masse CSV dans le Dashboard, le pays de destination ne fera pas partie du modèle, vous sélectionnerez vos pays de destination après avoir téléchargé votre demande en masse 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 pour des pays spécifiques, ajoutez les ' codes ISO' des pays dans la demande Classify comme indiqué dans l'exemple ci-dessous. Pour demander un code SH universel, laissez le pays de destination null dans la demande Classify.
L'entrée prend une liste, vous pouvez donc demander plusieurs classifications ou une seule à la fois.
MUTATION
GraphQL
mutation {
classificationsCalculate(
input: [
{
categories: "women's clothing"
imageUrl: "https://zonos.com/images/cozygloves.webp"
name: "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter"
configuration: { shipToCountries: KR }
}
]
) {
id
name
categories
imageUrl
hsCode {
code
description {
full
}
}
}
}
RÉPONSE
JSON
{
"data": {
"classificationsCalculate": [
{
"id": "classification_313d8d9d-e330-4d79-9922-cb7a1ff317e2",
"name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter",
"categories": ["women's clothing"],
"imageUrl": null,
"hsCode": {
"code": "6116.99.0000",
"description": {
"full": "Articles of apparel and clothing accessories, knitted or crocheted: Gloves, mittens and mitts, knitted or crocheted: Other : Of other textile materials"
}
}
}
]
}
}
Réponses API possibles
Lorsque Classify reçoit une demande de classification, il tente de faire correspondre les données de l'élément d'entrée incluses dans la demande avec une correspondance dans la base de données de Classify's en fonction du score de confiance le plus élevé. En fonction de ce qui est trouvé, Classify renverra l'une des réponses suivantes :
- Lorsque
hsCodeest renvoyé avec un code HS de 6 à 8+ chiffres, selon que le pays de destination a été inclus ou non dans la demande, votre demande de classification a été réussie. - Lorsque
{"errors": [ { "message": "Aucune réponse adéquate"}]}est renvoyé, cela signifie que Classify n'a pas pu trouver de classification en raison d'informations d'entrée insuffisantes.
Classification 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 à chaque pays via le Dashboard ou via l'API. Pour ceux qui recherchent des détails techniques plus complets et une documentation étendue, visitez notre Zonos site de référence pour l'API GraphQL. Cette ressource complète offre des informations détaillées sur les points de terminaison de l'API, les mutations GraphQL et des informations techniques étendues.