Taxonomie HS10 Codes Import et Export¶
L’api SMC_TAXO V2 permet d’avoir les codes HS10 Export et Import.
Base URL = https://taxo.imxpostal.fr/api
Description de l'api¶
Méthode : GET
Url : https://taxo.imxpostal.fr/api/v1.0/get_hs10code
Paramètres :
* hscode : le hs6code produit. Peut etre obtenu avec l’api SMC TAXONOMIE
(endpoint :`api/v1.1/get_datas`).
* sc : code pays d'expedition en ISO 3166-1 alpha 2.
* dc : code pays destination en ISO 3166-1 alpha 2.
* desc : description produit en anglais. Est facultatif si la valeur hscode est renseignee.
* try_db : booléen par défaut vaut False. Si True, oblige de faire la recherche que sur les données caches.
Headers : * x-api-key : Code secret fourni par IMX
Résultat au format JSON :
Propriete | Description |
---|---|
10digitExportCode | HS10Code Export de l’article hscode passe en parametre. |
10digitImportCode | HS10Code Import de l’article hscode passe en parametre. |
destinationCountry | Code pays destination, la meme valeur passee en parametre dc. |
sourceCountry | Code pays source, la meme valeur passee en parametre sc. |
success | Resultat booleen de la requete. Vaut false s’il y a une erreur, sinon true. |
suitableDescription | La description en anglais de l’article. |
suitableHS6code | Le code hs6code, la meme valeur que celle passe en parametre hscode. |
message | Si success vaut false, alors message fournit la description de l’erreur. |
Exemple 1 : Utilisation correcte¶
En fournissant des parametres corrects :
* hscode = 420212
* sc = FR
* dc = CH
Appel api smc_taxo :
https://taxo.imxpostal.fr/api/v1.0/get_hs10code?hscode=420212&sc=FR&dc=CH
Réponse :
{
"10digitExportCode": "4202129110",
"10digitImportCode": "4202120000",
"destinationCountry": "CH",
"sourceCountry": "FR",
"success": true,
"suitableDescription": "attache case",
"suitableHS6code": "420212"
}
Exemple 2 : Utilisation avec une mauvaise valeur HS6Code¶
Au cas où le parametre hscode ne correspond à aucun des produits qui existent :
* hscode = 420210
* sc = FR
* dc = CH
Appel api smc_taxo :
https://taxo.imxpostal.fr/api/v1.0/get_hs10code?hscode=420210&sc=FR&dc=CH
Réponse :
{
"message": "Response from Zephyr is not correct.",
"success": false
}
Exemple 3 : Utilisation avec erreur sur code pays¶
Au cas où un des codes pays, d'expedition ou de destionation spécifié n’est pas correct:
* hscode = 420212
* sc = FR
* dc = C
Appel api smc_taxo :
https://taxo.imxpostal.fr/api/v1.0/get_hs10code?hscode=420212&sc=FR&dc=C
Réponse :
{
"message": "The Source* Contry or Destination* Country does not exist.",
"success": false
}
Exemple 4 : Header x-api-key incorrect ou absent¶
Si aucune valeur header est passee ou bien la valeur est erronnee
Réponse :
{
"message": "You doesn't have permission to access.",
"success": false
}