Attributen
JSON sleutel/waarde paren in de aanvraagbody
POST | https://api.zonos.com/v1/landed_cost
HEADER zonos-version: 2019-11-21
De bovenstaande header is een vereiste invoer voor deze landed cost aanvraag om succesvol te voltooien.
| Veld | Opmerkingen |
|---|---|
currency VERPLICHT | De basisvaluta string, weergegeven door een drieletterige ISO-code. |
discounts OPTIONEEL | De informatie met betrekking tot eventuele kortingen, inclusief de id, het bedrag en eventuele details. |
discounts.id OPTIONEEL | De unieke kortingsidentificatie voor de handelaar of exporteur. |
discounts.amount OPTIONEEL | Een decimaal met het bedrag van de korting, in dollars en centen. |
discounts.detail OPTIONEEL | Aanvullende kenmerken, attributen of beschrijvingen van de korting. |
items VERPLICHT | De lijst van items die worden geëxporteerd. hash |
items.id VERPLICHT | De unieke itemidentificatie voor de handelaar of exporteur. |
items.amount VERPLICHT | Een decimaal met het totaal van één enkel item, in dollars en centen. |
items.amount_discount OPTIONEEL | Het bedrag van de korting die van toepassing is op het item. |
items.brand OPTIONEEL | Het merk van het item, bijv. "Leatherman.” |
items.category OPTIONEEL | Categorieomschrijving van het item, bijv. "Kleding." |
items.color OPTIONEEL | Kleur van het item. |
items.country_of_origin OPTIONEEL | Het land van vervaardiging of productie, weergegeven door een tweeletterige ISO-code. Dit wordt aanbevolen voor de meest nauwkeurige offertes. Als er geen land van oorsprong wordt ontvangen, wordt de Meest Begunstigde Natie (MFN) rate gebruikt. |
items.description_customs OPTIONEEL | De voorgestelde beschrijving van goederen voor de commerciële factuur. Deze beschrijving verschilt meestal van een detailhandelsbeschrijving en bevat doorgaans een algemene beschrijving van wat het is, waar het van gemaakt is en waarvoor het wordt gebruikt. |
items.description_retail OPTIONEEL | De detailhandelsbeschrijving van het item. |
items.detail OPTIONEEL | Aanvullende kenmerken, attributen of beschrijvingen van het item. |
items.dimensions OPTIONEEL | De grootte van de zending. Dit wordt aanbevolen om de meest nauwkeurige offertes te krijgen voor landen waar tarieven worden beïnvloed door de afmetingen van het item. hash |
items.dimensions.height OPTIONEEL | Een decimaal voor de hoogte van het item. |
items.dimensions.length OPTIONEEL | Een decimaal voor de lengte van het item. |
items.dimensions.unit OPTIONEEL | De eenheid van meting voor de itemafmetingen. Mogelijke waarden zijn inch, centimeter, millimeter, en null. Wanneer null, wordt inch gebruikt. |
items.dimensions.width OPTIONEEL | Een decimaal voor de breedte van het item. |
items.duty_tax_fee_free OPTIONEEL | Een string om aan te geven of het item niet moet worden opgenomen in de landed cost berekening. Wanneer exclude wordt verzonden in het verzoek, verschijnt het item in removed_items in de API-respons. |
items.hs_code OPTIONEEL | HS-code van het item, 2 tot 10 cijfers. |
items.image_url OPTIONEEL | De afbeelding URL. |
items.quantity VERPLICHT | Een geheel getal met de hoeveelheid van het item. |
items.upc_code OPTIONEEL | De UPC-code string voor het item. |
items.weight OPTIONEEL | Een decimaal voor het gewicht van het item. |
items.weight_unit OPTIONEEL | De eenheid van meting string voor het gewicht. Mogelijke waarden zijn pound, ounce, kilogram, en null. Wanneer null, wordt pound gebruikt. |
landed_cost OPTIONEEL | Het type verzoek voor een landed cost. Mogelijke waarden zijn delivery_duty_paid en delivery_duty_unpaid. De kosten voor een landed cost kunnen verschillen, of het nu DDP of DDU is verzonden. Als null, wordt een DDP-verzoek aangenomen. Als een DDP-verzoek wordt gedaan en DDP niet beschikbaar is, wordt een 400-fout geretourneerd met een bericht waarin staat dat DDP niet beschikbaar is voor het geleverde serviceniveau. DDP en DDU zijn doorgaans beide beschikbaar binnen elk serviceniveau, dus zorg ervoor dat dit per serviceniveau kan worden geconfigureerd in plaats van op accountniveau. |
sale_type OPTIONEEL | Een indicator van het type verkoop. Mogelijke waarden zijn not_for_resale for_resale. Als null, wordt een not_for_resale verzoek aangenomen. |
ship_from_country VERPLICHT | De verzendlandstring, weergegeven door een tweeletterige ISO-code. |
ship_to VERPLICHT | Het bestemmingsadres. hash |
ship_to.city OPTIONEEL* | Een string voor de stad, het dorp, het district, de buitenwijk of het dorp van de klant. Afhankelijk van het importland kan dit veld VERPLICHT zijn. |
ship_to.country VERPLICHT | Een string voor het bestemmingsland waarin de bankrekening zich bevindt, weergegeven door een tweeletterige ISO-code. |
ship_to.postal_code OPTIONEEL* | Een string voor de bestemmingspostcode. Dit veld kan vereist zijn wanneer de verzending tussen Noord-Ierland en de Europese Unie plaatsvindt. |
ship_to.state OPTIONEEL* | Een string voor de bestemmingsstaatcode wanneer beschikbaar. Als het importland Brazilië of Canada is, is dit veld vereist. |
shipping VERPLICHT | De verzenddetails zoals het bedrag, het kortingsbedrag en het serviceniveau bij de vervoerder. hash |
shipping.amount VERPLICHT | Een decimaal voor het totaalbedrag van de verzendkosten, in dollars en centen. |
shipping.amount_discount OPTIONEEL | Een decimaal voor het bedrag van de korting die van toepassing is op de verzending. |
shipping.service_level VERPLICHT | Het serviceniveau bij de vervoerder. Zie de vervoerdersdocumentatie voor de volledige lijst van beschikbare serviceniveaus per vervoerder. |
*Dit veld is optioneel, afhankelijk van de vereisten voor de adresvelden voor het importland.
Voorbeeldverzoek
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"
}
Voorbeeldreactie
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"
}
]
}
Aanvraag voor een landed cost
Vind de sleutel/waarde paren in een landed cost aanvraag.Hoewel Zonos Landed Cost in staat is om een nauwkeurige landed cost te bieden op basis van alleen de beschrijving van een item, hoe meer informatie er wordt verstrekt, hoe nauwkeuriger de landed cost offerte zal zijn. Hieronder staan de VERPLICHTE en OPTIONELE invoer, maar het wordt aanbevolen om zoveel mogelijk OPTIONELE velden in te vullen.