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 riportata è un input obbligatorio per il completamento corretto di questa richiesta di landed cost.
| Campo↕ | Note↕ |
|---|---|
currency REQUIRED | La stringa della valuta di base, rappresentata da un codice ISO di tre lettere. |
discounts OPTIONAL | Le informazioni relative a eventuali sconti, inclusi id, importo e dettagli. |
discounts.id OPTIONAL | L'identificatore univoco dello sconto per il commerciante o l'esportatore. |
discounts.amount OPTIONAL | Un decimale con l'importo dello sconto, in dollari e centesimi. |
discounts.detail OPTIONAL | Funzionalità, attributi o descrizioni aggiuntive dello sconto. |
items REQUIRED | L'elenco degli articoli esportati. hash |
items.id REQUIRED | L'identificatore univoco dell'articolo per il commerciante o l'esportatore. |
items.amount REQUIRED | Un decimale con il totale di un singolo articolo, in dollari e centesimi. |
items.amount_discount OPTIONAL | L'importo dello sconto applicato all'articolo. |
items.brand OPTIONAL | La marca dell'articolo, ad es. Leatherman. |
items.category OPTIONAL | La descrizione della categoria dell'articolo, ad es. Abbigliamento. |
items.color OPTIONAL | Il colore dell'articolo. |
items.country_of_origin OPTIONAL | Il paese di fabbricazione o produzione, rappresentato da un codice ISO di due lettere. Consigliato per ottenere i preventivi più precisi. Se non viene fornito alcun paese di origine, viene utilizzata l'aliquota della Nazione più favorita (MFN). |
items.description_customs OPTIONAL | La descrizione suggerita della merce per la fattura commerciale. Questa descrizione di solito differisce da una descrizione al dettaglio e in genere include una descrizione generale di cosa sia, di cosa sia fatto e a cosa serva. |
items.description_retail OPTIONAL | La descrizione al dettaglio dell'articolo. |
items.detail OPTIONAL | Funzionalità, attributi o descrizioni aggiuntive dell'articolo. |
items.dimensions OPTIONAL | Le dimensioni della spedizione. Consigliato per ottenere preventivi più precisi nei paesi in cui le tariffe sono influenzate dalle dimensioni dell'articolo. hash |
items.dimensions.height OPTIONAL | Un decimale per l'altezza dell'articolo. |
items.dimensions.length OPTIONAL | Un decimale per la lunghezza dell'articolo. |
items.dimensions.unit OPTIONAL | 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 OPTIONAL | Un decimale per la larghezza dell'articolo. |
items.duty_tax_fee_free OPTIONAL | Una stringa per specificare se l'articolo non deve essere incluso nel calcolo del landed cost. Quando viene inviato exclude nella richiesta, l'articolo verrà visualizzato in removed_items nella risposta dell'API. |
items.hs_code OPTIONAL | Il codice HS dell'articolo, da 2 a 10 cifre. |
items.image_url OPTIONAL | L'URL dell'immagine. |
items.quantity REQUIRED | Un numero intero con la quantità dell'articolo. |
items.upc_code OPTIONAL | La stringa del codice UPC per l'articolo. |
items.weight OPTIONAL | Un decimale per il peso dell'articolo. |
items.weight_unit OPTIONAL | 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 OPTIONAL | Il tipo di richiesta per un landed cost.I valori possibili includono delivery_duty_paid e delivery_duty_unpaid.I costi per un landed cost possono variare in base al fatto che venga inviato come DDP o DDU. Se null, verrà assunta una richiesta DDP.Se viene effettuata una richiesta DDP e il DDP non è disponibile, verrà restituito un errore 400 con un messaggio che indica che il DDP non è disponibile per il livello di servizio fornito.DDP e DDU sono in genere entrambi disponibili all'interno di ciascun livello di servizio, quindi assicurarsi che questo possa essere configurato a livello di singolo servizio invece che a livello di account. |
sale_type OPTIONAL | Un indicatore del tipo di vendita.I valori possibili includono not_for_resale for_resale.Se null verrà assunta una richiesta not_for_resale. |
ship_from_country REQUIRED | La stringa del paese di spedizione, rappresentata da un codice ISO di due lettere. |
ship_to REQUIRED | L'indirizzo di destinazione. hash |
ship_to.city OPTIONAL* | Una stringa per la città, il paese, il distretto, il sobborgo o il villaggio dell'indirizzo del cliente. In base al paese di importazione, questo campo può essere REQUIRED. |
ship_to.country REQUIRED | Una stringa per il paese di destinazione in cui è ubicato il conto bancario, rappresentata da un codice ISO di due lettere. |
ship_to.postal_code OPTIONAL* | Una stringa per il codice postale di destinazione. Questo campo può essere obbligatorio quando la spedizione avviene tra l'Irlanda del Nord e l'Unione Europea. |
ship_to.state OPTIONAL* | 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 REQUIRED | I dettagli di spedizione, come l'importo, l'importo dello sconto e il livello di servizio con il corriere. hash |
shipping.amount REQUIRED | Un decimale per il totale complessivo dei costi di spedizione, in dollari e centesimi. |
shipping.amount_discount OPTIONAL | Un decimale per l'importo dello sconto applicato alla spedizione. |
shipping.service_level REQUIRED | Il service_level con il corriere.Consultare la documentazione sui corrieri per l'elenco completo dei livelli di servizio disponibili per corriere. |
*Questo campo è opzionale in base ai requisiti dei campi dell'indirizzo per il paese di importazione.
1
{2
"currency": "USD",3
"discounts": [4
{5
"id": "sale124",6
"amount": 43,7
"detail": null8
}9
],10
"items": [11
{12
"id": "294395",13
"amount": 75,14
"amount_discount": 0,15
"brand": null,16
"category": "Women's Clothing",17
"color": null,18
"country_of_origin": "FR",19
"description_customs": null,20
"description_retail": "Hoka One Running Shoe - Women's",21
"detail": null,22
"dimensions": {23
"height": 4,24
"length": 6,25
"unit": "inch",26
"width": 1127
},28
"duty_tax_fee_free": null,29
"hs_code": "6116.10.00",30
"image_url": "https://zonos.com/images/handbag.webp",31
"quantity": 1,32
"upc_code": null,33
"weight": 10,34
"weight_unit": "pound"35
},36
{37
"id": "294396",38
"amount": 15,39
"country_of_origin": "CN",40
"country_of_origin_source": "account_default",41
"description_customs": "Men's t-shirt 100% polyester",42
"description_retail": "Galaxy Quest Men's Tee Blue",43
"detail": null,44
"dimensions": {45
"height": 4,46
"lenght": 6,47
"unit": "inch",48
"width": 1149
},50
"duty_tax_fee_free": "exclude",51
"hs_code": "6217.10",52
"image_url": null,53
"note": null,54
"quantity": 1,55
"upc_code": null,56
"weight": 1,57
"weight_unit": "pound"58
}59
],60
"landed_cost": "delivery_duty_paid",61
"sale_type": "not_for_resale",62
"ship_from_country": "US",63
"ship_to": {64
"city": "Campinas",65
"country": "BR",66
"postal_code": "75828-000",67
"state": "SP"68
},69
"shipping": {70
"amount": 14.23,71
"amount_discount": 0,72
"service_level": "ups_express_saver"73
},74
"tariff_rate": "zonos_preferred"75
}
Richiedere un landed cost
Trovi le coppie chiave/valore in una richiesta di landed cost.
Sebbene Zonos Landed Cost sia in grado di fornire un landed cost accurato basandosi esclusivamente sulla descrizione di un articolo, più informazioni vengono fornite, più preciso sarà il preventivo di landed cost. Di seguito sono riportati gli input REQUIRED e OPTIONAL, ma si consiglia di compilare quanti più campi OPTIONAL possibile.