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.
Si consiglia vivamente un codice HS. A differenza del landed cost di base, il landed cost completo include il dettaglio a livello di articolo delle aliquote di dazio per codice HS.
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.Le commissioni 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_resalefor_resale.Se null verrà assunta una richiesta not_for_resale.
Una stringa per la città, la cittadina, 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":null
8}
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",
Richiedere un landed cost
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.
Attributi
Coppie chiave/valore JSON nel corpo della richiesta
POST |
https://api.zonos.com/v1/landed_costHEADER
zonos-version: 2019-11-21currencyREQUIREDdiscountsOPTIONALdiscounts.idOPTIONALdiscounts.amountOPTIONALdiscounts.detailOPTIONALitemsREQUIREDhashitems.idREQUIREDitems.amountREQUIREDitems.amount_discountOPTIONALitems.brandOPTIONALitems.categoryOPTIONALitems.colorOPTIONALitems.country_of_originOPTIONALitems.description_customsOPTIONALitems.description_retailOPTIONALitems.detailOPTIONALitems.dimensionsOPTIONALhashitems.dimensions.heightOPTIONALitems.dimensions.lengthOPTIONALitems.dimensions.unitOPTIONALinch,centimeter,millimeterenull.Quando ènull, verrà utilizzatoinch.items.dimensions.widthOPTIONALitems.duty_tax_fee_freeOPTIONALexcludenella richiesta, l'articolo verrà visualizzato inremoved_itemsnella risposta dell'API.items.hs_codeOPTIONALitems.image_urlOPTIONALitems.quantityREQUIREDitems.upc_codeOPTIONALitems.weightOPTIONALitems.weight_unitOPTIONALpound,ounce,kilogramenull.Quando ènull, verrà utilizzatopound.landed_costOPTIONALdelivery_duty_paidedelivery_duty_unpaid.Le commissioni per un landed cost possono variare in base al fatto che venga inviato come DDP o DDU. Senull, 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_typeOPTIONALnot_for_resalefor_resale.Senullverrà assunta una richiestanot_for_resale.ship_from_countryREQUIREDship_toREQUIREDhashship_to.cityOPTIONAL*ship_to.countryREQUIREDship_to.postal_codeOPTIONAL*ship_to.stateOPTIONAL*shippingREQUIREDhashshipping.amountREQUIREDshipping.amount_discountOPTIONALshipping.service_levelREQUIRED{"currency": "USD","discounts": [{"id": "sale124","amount": 43,"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.webp","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"}Questa pagina è stata utile?