DOCS

Create a landed cost

/

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é.

1

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.

2

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

1
2
3
{
  "currency": "USD"
}
3

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

1
2
3
4
5
6
7
8
9
10
11
12
{
  "items": [
    {
      "id": "294395",
      "amount": 75,
      "country_of_origin": "FR",
      "description_customs": null,
      "hs_code": "6116.10.00",
      "quantity": 1
    }
  ]
}
4

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

1
2
3
4
5
6
7
8
9
{
  "ship_from_country": "US",
  "ship_to": {
    "city": "Campinas",
    "country": "BR",
    "postal_code": "75828-000",
    "state": "SP"
  }
}
5

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

1
2
3
4
5
{
  "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

1
2
3
4
5
6
{
  "shipping": {
    "amount": 14.23,
    "service_level": "ups_express_saver"
  }
}
6

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
  "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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
{
  "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"
}

Cette page était-elle utile?


Des questions ?

Contactez-nous.