Aller au contenu

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
}