Configurer Zonos
Tout d'abord, inscrivez-vous pour un compte Zonos et configurez votre compte sur le tableau de bord Zonos. Vous pourrez ensuite obtenir votre clé API, qui vous permettra de vous authentifier auprès de l'API Zonos.
Définir la devise de base
Pour fournir un contexte sur les montants d'argent inclus dans une demande de landed cost, vous devez spécifier le code de devise de base de votre demande (sous forme de code de devise ISO). Cela fera référence à toutes les valeurs monétaires de la demande et à la devise dans laquelle le devis de landed cost résultant sera affiché. Vous pouvez trouver une liste des devises prises en charge et de leurs codes ISO sur nos documents sur le landed cost.
Demande
{
"currency": "USD"
}
Fournir les détails de l'article
Pour obtenir une estimation précise du landed cost en utilisant Zonos, vous devrez fournir autant de détails que possible pour chaque article, y compris les codes harmonisés (HS). En général, plus vous incluez d'informations, plus votre estimation sera précise.
Bien que la fourniture de codes HS permette à Zonos Landed Cost de renvoyer les calculs les plus précis et complets, il est possible d'estimer le landed cost réel sans un code HS. Cependant, notez que si le coût total de vos articles dépasse le seuil de minimis, un code HS peut être requis. Dans ces cas, l'envoi d'une demande sans code HS entraînera une erreur.
Pour chaque article que vous souhaitez inclure dans votre estimation de landed cost, ajoutez une entrée au tableau items
dans le corps de la demande.
Request
{
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"description_customs": null,
"hs_code": "6116.10.00",
"quantity": 1
}
]
}
Ajouter des adresses de livraison
Les lieux d'expédition et de destination de votre envoi sont nécessaires pour calculer le landed cost. Une adresse complète est requise pour la destination de l'envoi, mais inclure le pays d'expédition est suffisant pour la plupart des devis de landed cost.
Demande
{
"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 coûts d'expédition - elle se concentre sur les droits de douane, les taxes et les frais. Étant donné que l'expédition est un aspect considérable d'un devis total de landed cost et un facteur important dans la manière dont les choses sont calculées, il est essentiel de spécifier le coût d'expédition à l'avance. Cette valeur peut être obtenue en utilisant une API de tarification des expéditions, telle que l'API de tarification Zonos, ou par divers autres moyens, tels que le logiciel d'expédition de votre transporteur, les tableaux de rate, etc.
Les informations relatives aux coûts d'expédition, y compris le montant total de l'expédition, sont envoyées via le champ shipping
dans votre demande d'API.
Request
{
"shipping": {
"amount": 14.23
}
}
Bien que seule la quantité soit requise, vous pouvez également fournir un nom de niveau de service pour permettre à l'API de calculer les frais de transporteur en fonction de la quantité fournie. Vous pouvez consulter une liste des transporteurs pris en charge et des niveaux de service sur nos documents Landed Cost.
Demande
{
"shipping": {
"amount": 14.23,
"service_level": "ups_express_saver"
}
}
Envoyer une demande d'API
Maintenant que vous avez construit votre demande et que vous l'avez configurée, vous pouvez envoyer une demande POST
à l'API Zonos Landed Cost. Assurez-vous de vous authentifier avec votre clé API et de fournir l'en-tête de version correcte dans votre demande.
POST https://api.zonos.com/v1/landed_cost
Demande
{
"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",
"state": "SP"
},
"shipping": {
"amount": 14.23,
"amount_discount": 0,
"service_level": "ups_express_saver"
}
}
Réponse
{
"id": "ldct_1AoaDV8MZ8SAmsVFFTWISI",
"amount_subtotal": {
"duties": 53.54,
"fees": 27.64,
"taxes": 33.96
},
"currency": {
"id": "1aad3b7e-c",
"base": "USD",
"date": "2022-09-06T20:57:10.333+0000",
"rates": [
{
"currency": "BRL",
"rate": 5.2499
}
]
},
"customs": {
"delivery_duty_paid": "available",
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"country_of_origin_source": "api_request",
"description_customs": null,
"description_retail": null,
"hs_code": "6116.10.00",
"hs_code_source": "api_request",
"note": "",
"quantity": 1
}
],
"shipping_amount": 14.23,
"ship_to_country": "BR"
},
"de_minimis": [
{
"formula": "(cost {'<='} 0 brl)",
"method": "FOB",
"note": "Duty applies to all shipments",
"threshold": "above",
"type": "duty"
},
{
"formula": "(cost {'<='} 0 brl)",
"method": "FOB",
"note": "Tax applies to all shipments",
"threshold": "above",
"type": "tax"
}
],
"duties": [
{
"amount": 45.0,
"description": "Basic customs duty",
"item_id": "294395",
"formula": "60 %",
"note": "Duty is 60% of the items total.",
"type": "item"
},
{
"amount": 8.538,
"description": "Basic customs duty",
"item_id": "294395",
"formula": "60 %",
"note": "Duty is 60% of the items total.",
"type": "shipping"
}
],
"fees": [
{
"amount": 15.0,
"description": "UPS United States Duty and Tax Forwarding Charge",
"item_id": null,
"formula": "15 USD",
"note": null,
"type": "ddp_service_fee"
},
{
"amount": 12.0,
"description": "UPS Disbursement Fee",
"item_id": null,
"formula": "2.00% of duties & taxes amount with a minimum of 12 usd, whichever is greater",
"note": null,
"type": "advancement"
},
{
"amount": 0.64,
"description": "UPS Currency Conversion Fee",
"item_id": null,
"formula": ".75% of the amount converted",
"note": null,
"type": "currency_conversion_fee"
}
],
"taxes": [
{
"amount": 16.46,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": null,
"type": "item"
},
{
"amount": 3.12,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": null,
"type": "shipping"
},
{
"amount": 9.88,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": "ICMS on the duty of the item",
"type": "duty"
},
{
"amount": 1.87,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": "ICMS on the duty of the shipping",
"type": "duty"
},
{
"amount": 2.63,
"description": "ICMS",
"item_id": null,
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": null,
"type": "advancement"
}
],
"removed_items": [],
"remittance": [],
"landedCostGuaranteeCode": "ZONOS"
}
Calculer un landed cost
Apprenez comment demander un landed cost via l'API REST.REST
L'API Zonos Landed Cost vous permet d'obtenir rapidement un devis de landed cost très précis pour les expéditions d'importation et d'exportation transfrontalières. Bien que fournir des codes harmonisés (HS) permette à Zonos Landed Cost de retourner le calcul des droits le plus précis, nous retournerons une estimation des droits et taxes même en l'absence d'un code harmonisé.