Attributi
Coppie chiave/valore JSON nel corpo della richiesta
POST | https://api.zonos.com/v1/landed_cost
HEADER zonos-version: 2019-11-21
L'intestazione sopra è un input obbligatorio per questa richiesta di landed cost affinché venga completata con successo.
| Campo | Note |
|---|---|
currency OBBLIGATORIO | La stringa della valuta di base, rappresentata da un codice ISO a tre lettere. |
discounts OPZIONALE | Le informazioni relative a eventuali sconti, inclusi l'id, l'importo e eventuali dettagli. |
discounts.id OPZIONALE | L'identificatore unico dello sconto per il commerciante o l'esportatore. |
discounts.amount OPZIONALE | Un decimale con l'importo dello sconto, in dollari e centesimi. |
discounts.detail OPZIONALE | Caratteristiche, attributi o descrizioni aggiuntive dello sconto. |
items OBBLIGATORIO | L'elenco degli articoli in fase di esportazione. hash |
items.id OBBLIGATORIO | L'identificatore unico dell'articolo per il commerciante o l'esportatore. |
items.amount OBBLIGATORIO | Un decimale con il totale di un singolo articolo, in dollari e centesimi. |
items.amount_discount OPZIONALE | L'importo dello sconto che si applica all'articolo. |
items.brand OPZIONALE | La marca dell'articolo, ad esempio "Leatherman.” |
items.category OPZIONALE | Descrizione della categoria dell'articolo, ad esempio "Abbigliamento." |
items.color OPZIONALE | Colore dell'articolo. |
items.country_of_origin OPZIONALE | Il paese di fabbricazione o produzione, rappresentato da un codice ISO a due lettere. Questo è raccomandato per ottenere le quotazioni più accurate. Se non viene ricevuto alcun paese di origine, viene utilizzato il rate della Nazione più Favorevole (MFN). |
items.description_customs OPZIONALE | La descrizione suggerita delle merci per la fattura commerciale. Questa descrizione di solito differisce da una descrizione al dettaglio e include tipicamente una descrizione generale di cosa sia, di cosa sia fatto e a cosa serva. |
items.description_retail OPZIONALE | La descrizione al dettaglio dell'articolo. |
items.detail OPZIONALE | Caratteristiche, attributi o descrizioni aggiuntive dell'articolo. |
items.dimensions OPZIONALE | La dimensione della spedizione. Questo è raccomandato per ottenere le quotazioni più accurate nei paesi in cui le tariffe sono influenzate dalle dimensioni dell'articolo. hash |
items.dimensions.height OPZIONALE | Un decimale per l'altezza dell'articolo. |
items.dimensions.length OPZIONALE | Un decimale per la lunghezza dell'articolo. |
items.dimensions.unit OPZIONALE | L'unità di misura per le dimensioni dell'articolo. I valori possibili sono inch, centimeter, millimeter, e null. Quando è null, verrà utilizzato inch. |
items.dimensions.width OPZIONALE | Un decimale per la larghezza dell'articolo. |
items.duty_tax_fee_free OPZIONALE | Una stringa per specificare se l'articolo non dovrebbe essere incluso nel calcolo del landed cost. Quando exclude viene inviato nella richiesta, l'articolo apparirà in removed_items nella risposta API. |
items.hs_code OPZIONALE | Codice HS dell'articolo, da 2 a 10 cifre. |
items.image_url OPZIONALE | L'URL dell'immagine. |
items.quantity OBBLIGATORIO | Un intero con la quantità dell'articolo. |
items.upc_code OPZIONALE | La stringa del codice UPC per l'articolo. |
items.weight OPZIONALE | Un decimale per il peso dell'articolo. |
items.weight_unit OPZIONALE | La stringa dell'unità di misura per il peso. I valori possibili sono pound, ounce, kilogram, e null. Quando è null, verrà utilizzato pound. |
landed_cost OPZIONALE | Il tipo di richiesta per un landed cost. I valori possibili includono delivery_duty_paid e delivery_duty_unpaid. Le spese per un landed cost possono differire, sia che venga inviato DDP o DDU. Se null, verrà assunta una richiesta DDP. Se viene effettuata una richiesta DDP e DDP non è disponibile, verrà restituito un errore 400 con un messaggio che indica che DDP non è disponibile per il livello di servizio fornito. DDP e DDU sono tipicamente entrambi disponibili all'interno di ciascun livello di servizio, quindi si prega di assicurarsi che questo possa essere configurato su base per livello di servizio anziché a livello di account. |
sale_type OPZIONALE | Un indicatore del tipo di vendita. I valori possibili includono not_for_resale e for_resale. Se null, verrà assunta una richiesta not_for_resale. |
ship_from_country OBBLIGATORIO | La stringa del paese di partenza, rappresentata da un codice ISO a due lettere. |
ship_to OBBLIGATORIO | L'indirizzo di destinazione. hash |
ship_to.city OPZIONALE* | Una stringa per la città, paese, distretto, sobborgo o villaggio del cliente. A seconda del paese di importazione, questo campo potrebbe essere OBBLIGATORIO. |
ship_to.country OBBLIGATORIO | Una stringa per il paese di destinazione in cui si trova il conto bancario, rappresentata da un codice ISO a due lettere. |
ship_to.postal_code OPZIONALE* | Una stringa per il codice postale di destinazione. Questo campo potrebbe essere richiesto quando la spedizione avviene tra l'Irlanda del Nord e l'Unione Europea. |
ship_to.state OPZIONALE* | Una stringa per il codice dello stato di destinazione quando disponibile. Se il paese di importazione è il Brasile o il Canada, questo campo è obbligatorio. |
shipping OBBLIGATORIO | I dettagli della spedizione come l'importo, l'importo dello sconto e il livello di servizio con il corriere. hash |
shipping.amount OBBLIGATORIO | Un decimale per il totale dei costi di spedizione, in dollari e centesimi. |
shipping.amount_discount OPZIONALE | Un decimale per l'importo dello sconto che si applica alla spedizione. |
shipping.service_level OBBLIGATORIO | Il livello di servizio con il corriere. Vedi la documentazione del corriere per l'elenco completo dei livelli di servizio disponibili per corriere. |
*Questo campo è facoltativo a seconda dei requisiti dei campi indirizzo per il paese di importazione.
Esempio di richiesta
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"
}
Esempio di risposta
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"
}
]
}
Richiedi un landed cost
Trova le coppie chiave/valore in una richiesta di landed cost.
Sebbene Zonos Landed Cost sia in grado di fornire un landed cost accurato basato esclusivamente sulla descrizione di un articolo, più informazioni vengono fornite, più accurato sarà il preventivo per landed cost. Di seguito sono riportati gli input OBBLIGATORI e FACOLTATIVI, ma si consiglia di compilare il maggior numero possibile di campi FACOLTATIVI.