Attributter
JSON nøgle/værdi-par i anmodningskroppen
POST | https://api.zonos.com/v1/landed_cost
HEADER zonos-version: 2019-11-21
Headeren ovenfor er et krav for, at denne landed cost anmodning kan gennemføres med succes.
| Felt | Noter |
|---|---|
currency PÅKRÆVET | Basisvaluta-strengen, repræsenteret ved en tre-bogstavs ISO-kode. |
discounts VALGFRI | Oplysninger relateret til eventuelle rabatter, herunder id, beløb og eventuelle detaljer. |
discounts.id VALGFRI | Den unikke rabatidentifikator for forhandleren eller eksportøren. |
discounts.amount VALGFRI | Et decimaltal med beløbet for rabatten, i dollars og cent. |
discounts.detail VALGFRI | Yderligere funktioner, attributter eller beskrivelser af rabatten. |
items PÅKRÆVET | Listen over varer, der eksporteres. hash |
items.id PÅKRÆVET | Den unikke vareidentifikator for forhandleren eller eksportøren. |
items.amount PÅKRÆVET | Et decimaltal med den samlede pris for én enkelt vare, i dollars og cent. |
items.amount_discount VALGFRI | Beløbet for rabatten, der gælder for varen. |
items.brand VALGFRI | Mærket for varen, f.eks. Leatherman. |
items.category VALGFRI | Kategoribeskrivelse af varen, f.eks. Tøj. |
items.color VALGFRI | Farven på varen. |
items.country_of_origin VALGFRI | Produktionslandet, repræsenteret ved en to-bogstavs ISO-kode. Dette anbefales for de mest præcise tilbud. Hvis der ikke modtages noget oprindelsesland, anvendes den mest begunstigede nation (MFN) rate. |
items.description_customs VALGFRI | Den foreslåede beskrivelse af varer til den kommercielle faktura. Denne beskrivelse vil normalt adskille sig fra en detailbeskrivelse og vil typisk inkludere en generel beskrivelse af, hvad det er, hvad det er lavet af, og hvad det bruges til. |
items.description_retail VALGFRI | Detailbeskrivelsen af varen. |
items.detail VALGFRI | Yderligere funktioner, attributter eller beskrivelser af varen. |
items.dimensions VALGFRI | Størrelsen på forsendelsen. Dette anbefales for at få de mest præcise tilbud til lande, hvor tolden påvirkes af varens dimensioner. hash |
items.dimensions.height VALGFRI | Et decimaltal for højden af varen. |
items.dimensions.length VALGFRI | Et decimaltal for længden af varen. |
items.dimensions.unit VALGFRI | Måleenheden for varens dimensioner. Mulige værdier er inch, centimeter, millimeter, og null. Når null, vil inch blive brugt. |
items.dimensions.width VALGFRI | Et decimaltal for bredden af varen. |
items.duty_tax_fee_free VALGFRI | En streng til at angive, om varen ikke skal inkluderes i landed cost beregningen. Når exclude sendes i anmodningen, vil varen vises i removed_items i API-svaret. |
items.hs_code VALGFRI | Vare HS-kode, 2 til 10 cifre. |
items.image_url VALGFRI | Billed-URL'en. |
items.quantity PÅKRÆVET | Et heltal med antallet af varen. |
items.upc_code VALGFRI | UPC-kode-strengen for varen. |
items.weight VALGFRI | Et decimaltal for vægten af varen. |
items.weight_unit VALGFRI | Måleenhedstrengen for vægten. Mulige værdier er pound, ounce, kilogram, og null. Når null, vil pound blive brugt. |
landed_cost VALGFRI | Den type anmodning for en landed cost. Mulige værdier inkluderer delivery_duty_paid og delivery_duty_unpaid. Gebyrerne for en landed cost kan variere, uanset om den sendes DDP eller DDU. Hvis null, vil en DDP-anmodning blive antaget. Hvis en DDP-anmodning foretages, og DDP ikke er tilgængelig, vil en 400-fejl blive returneret med en meddelelse om, at DDP ikke er tilgængelig for den angivne serviceniveau. DDP og DDU er typisk begge tilgængelige inden for hvert serviceniveau, så sørg for, at dette kan konfigureres på et pr. serviceniveau basis i stedet for kontoniveau. |
sale_type VALGFRI | En indikator for typen af salg. Mulige værdier inkluderer not_for_resale for_resale. Hvis null, vil en not_for_resale anmodning blive antaget. |
ship_from_country PÅKRÆVET | Den afsendte lands streng, repræsenteret ved en to-bogstavs ISO-kode. |
ship_to PÅKRÆVET | Den destination adresse. hash |
ship_to.city VALGFRI* | En streng for adressebyen, byen, distriktet, forstaden eller landsbyen for kunden. Afhængigt af importlandet kan dette felt være PÅKRÆVET. |
ship_to.country PÅKRÆVET | En streng for det destinationsland, hvor bankkontoen er placeret, repræsenteret ved en to-bogstavs ISO-kode. |
ship_to.postal_code VALGFRI* | En streng for den destination postnummer. Dette felt kan være påkrævet, når forsendelsen er mellem Nordirland og Den Europæiske Union. |
ship_to.state VALGFRI* | En streng for destinationsstatens kode, når den er tilgængelig. Hvis importlandet er Brasilien eller Canada, er dette felt påkrævet. |
shipping PÅKRÆVET | Forsendelsesoplysninger såsom beløb, rabatbeløb og serviceniveau med transportøren. hash |
shipping.amount PÅKRÆVET | Et decimalbeløb for den samlede sum af forsendelsesomkostningerne, i dollars og cent. |
shipping.amount_discount VALGFRI | Et decimalbeløb for det beløb af rabatten, der gælder for forsendelsen. |
shipping.service_level PÅKRÆVET | Serviceniveauet med transportøren. Se transportørens dokumenter for den fulde liste over tilgængelige serviceniveauer pr. transportør. |
*Dette felt er valgfrit afhængigt af adressefeltkravene for importlandet.
Eksempelanmodning
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"
}
Eksempel svar
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"
}
]
}
Anmod om en landed cost
Find nøgle/værdi-par i en landed cost anmodning.Selvom Zonos Landed Cost er i stand til at give en nøjagtig landed cost baseret udelukkende på beskrivelsen af en vare, jo flere oplysninger der gives, jo mere præcist vil landed cost tilbuddet være. Nedenfor er KRAV og VALGFRIE input, men det anbefales at udfylde så mange VALGFRIE felter som muligt.