Attributs
Paires clé/valeur JSON dans le corps de la demande
POST | https://api.zonos.com/v1/landed_cost
HEADER zonos-version: 2019-11-21
L'en-tête ci-dessus est une entrée requise pour que cette demande de landed cost se termine avec succès.
| Champ | Remarques |
|---|---|
currency OBLIGATOIRE | La chaîne de devise de base, représentée par un code ISO à trois lettres. |
discounts OPTIONNEL | Les informations relatives à toute remise, y compris l'identifiant, le montant et tous les détails. |
discounts.id OPTIONNEL | L'identifiant unique de la remise pour le commerçant ou l'exportateur. |
discounts.amount OPTIONNEL | Un décimal avec le montant de la remise, en dollars et en cents. |
discounts.detail OPTIONNEL | Caractéristiques, attributs ou descriptions supplémentaires de la remise. |
items OBLIGATOIRE | La liste des articles exportés. hash |
items.id OBLIGATOIRE | L'identifiant unique de l'article pour le commerçant ou l'exportateur. |
items.amount OBLIGATOIRE | Un décimal avec le total d'un seul article, en dollars et en cents. |
items.amount_discount OPTIONNEL | Le montant de la remise qui s'applique à l'article. |
items.brand OPTIONNEL | La marque de l'article, par exemple "Leatherman". |
items.category OPTIONNEL | Description de la catégorie de l'article, par exemple "Vêtements". |
items.color OPTIONNEL | Couleur de l'article. |
items.country_of_origin OPTIONNEL | Le pays de fabrication ou de production, représenté par un code ISO à deux lettres. Ceci est recommandé pour obtenir les devis les plus précis. Si aucun pays d'origine n'est reçu, la rate de la Nation la Plus Favorisée (NPF) est utilisée. |
items.description_customs OPTIONNEL | La description suggérée des marchandises pour la facture commerciale. Cette description diffère généralement d'une description de vente au détail et inclut généralement une description générale de ce que c'est, de quoi c'est fait et de ce à quoi ça sert. |
items.description_retail OPTIONNEL | La description de vente au détail de l'article. |
items.detail OPTIONNEL | Caractéristiques, attributs ou descriptions supplémentaires de l'article. |
items.dimensions OPTIONNEL | La taille de l'envoi. Ceci est recommandé pour obtenir les devis les plus précis dans les pays où les tarifs sont impactés par les dimensions de l'article. hash |
items.dimensions.height OPTIONNEL | Un décimal pour la hauteur de l'article. |
items.dimensions.length OPTIONNEL | Un décimal pour la longueur de l'article. |
items.dimensions.unit OPTIONNEL | L'unité de mesure des dimensions de l'article. Les valeurs possibles sont inch, centimeter, millimeter, et null. Lorsque null, inch sera utilisé. |
items.dimensions.width OPTIONNEL | Un décimal pour la largeur de l'article. |
items.duty_tax_fee_free OPTIONNEL | Une chaîne pour spécifier si l'article ne doit pas être inclus dans le calcul du landed cost. Lorsque exclude est envoyé dans la demande, l'article apparaîtra dans removed_items dans la réponse de l'API. |
items.hs_code OPTIONNEL | Code SH de l'article, de 2 à 10 chiffres. |
items.image_url OPTIONNEL | L'URL de l'image. |
items.quantity OBLIGATOIRE | Un entier avec la quantité de l'article. |
items.upc_code OPTIONNEL | La chaîne de code UPC pour l'article. |
items.weight OPTIONNEL | Un décimal pour le poids de l'article. |
items.weight_unit OPTIONNEL | La chaîne de l'unité de mesure pour le poids. Les valeurs possibles sont pound, ounce, kilogram, et null. Lorsque null, pound sera utilisé. |
landed_cost FACULTATIF | Le type de demande pour un landed cost. Les valeurs possibles incluent delivery_duty_paid et delivery_duty_unpaid. Les frais pour un landed cost peuvent différer, qu'il soit envoyé DDP ou DDU. Si null, une demande DDP sera supposée. Si une demande DDP est faite et que DDP n'est pas disponible, une erreur 400 sera renvoyée avec un message indiquant que DDP n'est pas disponible pour le niveau de service fourni.DDP et DDU sont généralement tous deux disponibles dans chaque niveau de service, veuillez donc vous assurer que cela peut être configuré sur une base par niveau de service au lieu du niveau de compte. |
sale_type FACULTATIF | Un indicateur du type de vente. Les valeurs possibles incluent not_for_resale et for_resale. Si null, une demande not_for_resale sera supposée. |
ship_from_country REQUIS | La chaîne du pays d'expédition, représentée par un code ISO à deux lettres. |
ship_to REQUIS | L'adresse de destination. hash |
ship_to.city FACULTATIF* | Une chaîne pour la ville, la commune, le quartier, la banlieue ou le village de l'adresse du client. Selon le pays d'importation, ce champ peut être REQUIS. |
ship_to.country REQUIS | Une chaîne pour le pays de destination dans lequel le compte bancaire est situé, représenté par un code ISO à deux lettres. |
ship_to.postal_code FACULTATIF* | Une chaîne pour le code postal de destination. Ce champ peut être requis lorsque l'envoi se fait entre l'Irlande du Nord et l'Union européenne. |
ship_to.state FACULTATIF* | Une chaîne pour le code d'état de destination lorsque disponible. Si le pays d'importation est le Brésil ou le Canada, ce champ est requis. |
shipping REQUIS | Les détails d'expédition tels que le montant, le montant de réduction et le niveau de service avec le transporteur. hash |
shipping.amount REQUIS | Un décimal pour le total des coûts d'expédition, en dollars et cents. |
shipping.amount_discount FACULTATIF | Un décimal pour le montant de la réduction appliquée à l'expédition. |
shipping.service_level REQUIS | Le niveau de service avec le transporteur. Consultez la documentation du transporteur pour la liste complète des niveaux de service disponibles par transporteur. |
*Ce champ est facultatif en fonction des exigences du champ d'adresse pour le pays d'importation.
Exemple de 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
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
{
"currency": "USD",
"discounts": [
{
"id": "sale124",
"amount": 43.0,
"detail": null
}
],
"items": [
{
"id": "294395",
"amount": 75,
"amount_discount": 0,
"brand": null,
"category": "Women's Clothing",
"color": null,
"country_of_origin": "FR",
"description_customs": null,
"description_retail": "Hoka One Running Shoe - Women's",
"detail": null,
"dimensions": {
"height": 4,
"length": 6,
"unit": "inch",
"width": 11
},
"duty_tax_fee_free": null,
"hs_code": "6116.10.00",
"image_url": "https://zonos.com/images/handbag.png",
"quantity": 1,
"upc_code": null,
"weight": 10,
"weight_unit": "pound"
},
{
"id": "294396",
"amount": 15,
"country_of_origin": "CN",
"country_of_origin_source": "account_default",
"description_customs": "Men's t-shirt 100% polyester",
"description_retail": "Galaxy Quest Men's Tee Blue",
"detail": null,
"dimensions": {
"height": 4,
"lenght": 6,
"unit": "inch",
"width": 11
},
"duty_tax_fee_free": "exclude",
"hs_code": "6217.10",
"image_url": null,
"note": null,
"quantity": 1,
"upc_code": null,
"weight": 1,
"weight_unit": "pound"
}
],
"landed_cost": "delivery_duty_paid",
"sale_type": "not_for_resale",
"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"
},
"tariff_rate": "zonos_preferred"
}
Exemple de 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
{
"id": "ldct_eab3008d-a8ca-4bd7-bf6d-cd178fe3cd77",
"amount_subtotal": {
"duties": 27.74,
"fees": 15.33,
"taxes": 16.23
},
"currency": {
"id": "curr_8fb20952-d",
"base": "USD",
"date": "2019-11-04T20:42:40.999+0000",
"rates": [
{
"currency": "BRL",
"rate": 0.2274
}
]
},
"customs": {
"delivery_duty_paid": "available",
"items": [
{
"id": "294395",
"amount": 32.0,
"country_of_origin": "FR",
"country_of_origin_source": null,
"description_customs": "Women's Tennis Shoe",
"description_retail": "Hoka One Running Shoe - Women's",
"detail": null,
"dimensions": {
"height": 4.0,
"length": 6.0,
"unit": "inch",
"width": 11.0
},
"hs_code": "6116.10.00",
"hs_code_source": "account_default",
"image_url": "https://zonos.com/images/handbag.png",
"note": null,
"quantity": 1,
"upc_code": null,
"weight": 10.0,
"weight_unit": "pound"
}
],
"ship_to_country": "BR",
"shipping_amount": 14.23
},
"de_minimis": [
{
"formula": "Less than 0 BRL",
"method": "FOB",
"note": null,
"threshold": "above",
"type": "duty"
},
{
"formula": "Less than 0 BRL",
"method": "FOB",
"note": null,
"threshold": "above",
"type": "tax"
}
],
"duties": [
{
"amount": 19.2,
"description": "duty",
"formula": "60%",
"item_id": "294395",
"note": "Duty is 60% of the items total.",
"type": "item"
},
{
"amount": 8.54,
"description": "Duty",
"formula": "60%",
"item_id": null,
"note": null,
"type": "shipping"
}
],
"fees": [
{
"amount": 22.0,
"description": "UPS United States Duty and Tax Forwarding Charge",
"formula": "15 USD",
"item_id": null,
"note": null,
"type": "ddp_service_fee"
},
{
"amount": 0.33,
"description": "UPS Currency Conversion Fee",
"formula": ".75% of the amount converted",
"item_id": null,
"note": null,
"type": "currency_conversion_fee"
}
],
"removed_items": [
{
"id": "294396",
"amount": 15,
"country_of_origin": "CN",
"country_of_origin_source": "account_default",
"description_customs": "Men's t-shirt 100% polyester",
"description_retail": "Galaxy Quest Men's Tee Blue",
"hs_code": "6217.10",
"hs_code_source": "account_default",
"note": null,
"quantity": 1
}
],
"remittance": [],
"taxes": [
{
"amount": 7.02,
"description": "ICMS",
"formula": "18% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"item_id": "294395",
"note": null,
"type": "item"
},
{
"amount": 3.12,
"description": "ICMS",
"formula": "18% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"item_id": null,
"note": null,
"type": "shipping"
},
{
"amount": 6.09,
"description": "ICMS",
"formula": "18% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"item_id": null,
"note": null,
"type": "duty"
}
]
}
Demandez un landed cost
Trouvez les paires clé/valeur dans une demande de landed cost.
Bien que Zonos Landed Cost soit capable de fournir un landed cost précis basé uniquement sur la description d'un article, plus d'informations sont fournies, plus précis sera le devis de landed cost. Voici les entrées OBLIGATOIRES et OPTIONNELLES, mais il est recommandé de remplir autant de champs OPTIONNELS que possible.