Configurer Zonos
Commencez par créer un compte Zonos et configurer votre compte sur Zonos Dashboard. Vous pourrez ensuite obtenir votre clé API pour vous authentifier auprès de l'API Zonos.
Définir la devise de base
Pour fournir le contexte des montants inclus dans une demande de coût d'acquittement, vous devez indiquer le code de devise de base de votre requête (sous la forme d'un code de devise ISO). Ce code s'appliquera à toutes les valeurs monétaires de la requête et déterminera la devise dans laquelle le devis de coût d'acquittement résultant sera exprimé. Vous trouverez la liste des devises prises en charge et de leurs codes ISO dans notre documentation sur le coût d'acquittement.
{ "currency": "USD"}Fournir les détails des articles
Pour obtenir un devis de coût d'acquittement aussi précis que possible avec Zonos, vous devrez fournir le maximum de détails par article, y compris les codes harmonisés (HS). En règle générale, plus vous fournissez d'informations, plus votre devis sera précis.
Bien que la fourniture de codes HS permette à Zonos Landed Cost de renvoyer les calculs les plus précis et les plus complets, il est possible d'estimer le coût d'acquittement réel sans code HS. Notez toutefois que si le coût total de vos articles dépasse le seuil de minimis, un code HS peut être requis. Dans ce cas, l'envoi d'une requête sans code HS entraînera une erreur.
Pour chaque article que vous souhaitez inclure dans votre devis de coût d'acquittement, ajoutez une entrée dans le tableau items du corps de la requête.
{ "items": [ { "id": "294395", "amount": 75, "country_of_origin": "FR", "description_customs": null, "hs_code": "6116.10.00", "quantity": 1 } ]}Ajouter les adresses d'expédition
Les lieux d'expédition (ship-from) et de destination (ship-to) de votre envoi sont nécessaires pour calculer le coût d'acquittement. Une adresse complète est requise pour la destination de l'envoi, mais indiquer le pays d'expédition suffit pour la plupart des devis de coût d'acquittement.
{ "ship_from_country": "US", "ship_to": { "city": "Campinas", "country": "BR", "postal_code": "75828-000", "state": "SP" }}Fournir les coûts d'expédition
L'API Zonos Landed Cost ne calcule pas les frais d'expédition : elle se concentre sur les droits de douane, les taxes et les frais. L'expédition représentant une part importante d'un devis de coût d'acquittement total et un facteur significatif dans la façon dont les calculs sont effectués, il est essentiel de préciser le coût d'expédition en amont. Cette valeur peut être obtenue à l'aide d'une API de tarification d'expédition, comme l'API Zonos Rating, ou par divers autres moyens, tels que le logiciel d'expédition de votre transporteur, des grilles tarifaires, etc.
Les informations relatives aux frais d'expédition, y compris le montant total de l'expédition, sont envoyées via le champ shipping de votre requête API.
{ "shipping": { "amount": 14.23 }}Bien que seul le montant soit requis, vous pouvez également fournir un nom de niveau de service pour permettre à l'API de calculer les frais de transporteur à partir du montant fourni. Vous pouvez consulter la liste des transporteurs et niveaux de service pris en charge dans notre documentation Landed Cost.
{ "shipping": { "amount": 14.23, "service_level": "ups_express_saver" }}Envoyer une requête API
Maintenant que vous avez construit et configuré votre requête, vous pouvez envoyer une requête POST à l'API Zonos Landed Cost. Veillez à vous authentifier avec votre clé API et à fournir l'en-tête de version correct dans votre requête.
POST https://api.zonos.com/v1/landed_cost
{ "currency": "USD", "items": [ { "id": "294395", "amount": 75, "country_of_origin": "FR", "description_customs": null, "hs_code": "6116.10.00", "quantity": 1 } ], "ship_from_country": "US", "ship_to": { "city": "Campinas", "country": "BR", "postal_code": "75828-000",
Calculer un coût d'acquittement
Apprenez à demander un coût d'acquittement via l'API REST.REST
L'API Zonos Landed Cost vous permet d'obtenir rapidement un devis de coût d'acquittement très précis pour les envois transfrontaliers. Bien que la fourniture de codes harmonisés (HS) permette à Zonos Landed Cost de renvoyer le calcul de droits le plus précis, nous renverrons le montant approximatif des droits et taxes même sans code harmonisé.