Attributter
JSON nøkkel/verdi-par i forespørselens kropp
POST | https://api.zonos.com/v1/landed_cost
HEADER zonos-version: 2019-11-21
Headeren ovenfor er en påkrevd inndata for denne landed cost forespørselen for å fullføres vellykket.
| Felt | Notater |
|---|---|
currency PÅKREVD | Basisvaluta-strengen, representert med en tre-bokstavers ISO-kode. |
discounts VALGFRI | Informasjonen relatert til eventuelle rabatter, inkludert id, beløp og eventuelle detaljer. |
discounts.id VALGFRI | Den unike rabattidentifikatoren for kjøpmannen eller eksportøren. |
discounts.amount VALGFRI | Et desimaltall med beløpet av rabatten, i dollar og cent. |
discounts.detail VALGFRI | Ytterligere funksjoner, attributter eller beskrivelser av rabatten. |
items PÅKREVD | Listen over varer som eksporteres. hash |
items.id PÅKREVD | Den unike vareidentifikatoren for kjøpmannen eller eksportøren. |
items.amount PÅKREVD | Et desimaltall med totalen for én enkelt vare, i dollar og cent. |
items.amount_discount VALGFRI | Beløpet av rabatten som gjelder for varen. |
items.brand VALGFRI | Merket på varen, f.eks. "Leatherman.” |
items.category VALGFRI | Kategoribeskrivelse av varen, f.eks. "Klær." |
items.color VALGFRI | Fargen på varen. |
items.country_of_origin VALGFRI | Landet for produksjon eller fremstilling, representert med en to-bokstavers ISO-kode. Dette anbefales for de mest nøyaktige tilbudene. Hvis det ikke mottas noe opprinnelsesland, brukes den mest favoriserte nasjonen (MFN) rate. |
items.description_customs VALGFRI | Den foreslåtte beskrivelsen av varer for den kommersielle fakturaen. Denne beskrivelsen vil vanligvis avvike fra en detaljhandelsbeskrivelse og vil typisk inkludere en generell beskrivelse av hva det er, hva det er laget av, og hva det brukes til. |
items.description_retail VALGFRI | Detaljhandelsbeskrivelsen av varen. |
items.detail VALGFRI | Ytterligere funksjoner, attributter eller beskrivelser av varen. |
items.dimensions VALGFRI | Størrelsen på forsendelsen. Dette anbefales for å få de mest nøyaktige tilbudene til land der toll påvirkes av dimensjonene på varen. hash |
items.dimensions.height VALGFRI | Et desimaltall for høyden på varen. |
items.dimensions.length VALGFRI | Et desimaltall for lengden på varen. |
items.dimensions.unit VALGFRI | Måleenheten for vare dimensjoner. Mulige verdier er inch, centimeter, millimeter, og null. Når null, vil inch bli brukt. |
items.dimensions.width VALGFRI | Et desimaltall for bredden på varen. |
items.duty_tax_fee_free VALGFRI | En streng for å spesifisere om varen ikke skal inkluderes i landed cost beregningen. Når exclude sendes i forespørselen, vil varen vises i removed_items i API-responsen. |
items.hs_code VALGFRI | Vare HS-kode, 2 til 10 sifre. |
items.image_url VALGFRI | Bildets URL. |
items.quantity PÅKREVD | Et heltall med antallet av varen. |
items.upc_code VALGFRI | UPC-kode-strengen for varen. |
items.weight VALGFRI | Et desimaltall for vekten av varen. |
items.weight_unit VALGFRI | Måleenheten for vekten. Mulige verdier er pound, ounce, kilogram, og null. Når null, vil pound bli brukt. |
landed_cost VALGFRI | Type av forespørsel for en landed cost. Mulige verdier inkluderer delivery_duty_paid og delivery_duty_unpaid. Gebyrene for en landed cost kan variere, enten den sendes DDP eller DDU. Hvis null, vil en DDP-forespørsel bli antatt. Hvis en DDP-forespørsel gjøres og DDP ikke er tilgjengelig, vil en 400-feil bli returnert med en melding som sier at DDP ikke er tilgjengelig for det angitte tjenestenivået. DDP og DDU er vanligvis begge tilgjengelige innen hvert tjenestenivå, så vær sikker på at dette kan konfigureres på et per-tjenestenivå basis i stedet for kontonivå. |
sale_type VALGFRI | En indikator for typen salg. Mulige verdier inkluderer not_for_resale for_resale. Hvis null, vil en not_for_resale forespørsel bli antatt. |
ship_from_country PÅKREVES | Strengen for avsendelseslandet, representert med en to-bokstavers ISO-kode. |
ship_to PÅKREVES | Leveringsadressen. hash |
ship_to.city VALGFRI* | En streng for adressen til byen, tettstedet, distriktet, forstaden eller landsbyen til kunden. Avhengig av importlandet kan dette feltet være PÅKREVET. |
ship_to.country PÅKREVES | En streng for destinasjonslandet der bankkontoen ligger, representert med en to-bokstavers ISO-kode. |
ship_to.postal_code VALGFRI* | En streng for destinasjonens postnummer. Dette feltet kan være nødvendig når forsendelsen er mellom Nord-Irland og Den europeiske union. |
ship_to.state VALGFRI* | En streng for destinasjonsstatens kode når tilgjengelig. Hvis importlandet er Brasil eller Canada, er dette feltet påkrevd. |
shipping PÅKREVES | Fraktopplysningene, som beløp, rabattbeløp og tjenestenivå med transportøren. hash |
shipping.amount PÅKREVES | Et desimaltall for den totale summen av fraktkostnadene, i dollar og cent. |
shipping.amount_discount VALGFRI | Et desimaltall for beløpet av rabatten som gjelder for frakten. |
shipping.service_level PÅKREVES | Tjenestenivået med transportøren. Se transportørens dokumentasjon for den fullstendige listen over tilgjengelige tjenestenivåer per transportør. |
*Dette feltet er valgfritt avhengig av adressefeltkravene for importlandet.
Eksempel forespørsel
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"
}
Eksempelrespons
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"
}
]
}
Be om en landed cost
Finn nøkkel/verdi-par i en landed cost forespørsel.Selv om Zonos Landed Cost kan gi en nøyaktig landed cost basert utelukkende på beskrivelsen av en vare, jo mer informasjon som gis, desto mer nøyaktig vil landed cost tilbudet være. Nedenfor er PÅKREVDE og VALGFRIE inndata, men det anbefales å fylle ut så mange VALGFRIE felt som mulig.