Configura Zonos
Innanzitutto, registrati per un account Zonos e configura il tuo account su Zonos Dashboard. Potrai quindi ottenere la tua chiave API, che ti consentirà di autenticarti con Zonos API.
Imposta la valuta di base
Per fornire contesto sugli importi di denaro inclusi in una richiesta di Landed Cost, è necessario specificare il codice valuta di base della richiesta (come codice valuta ISO). Ciò farà riferimento a tutti i valori monetari nella richiesta e alla valuta in cui verrà reso il preventivo di Landed Cost risultante. Puoi trovare un elenco delle valute supportate e i relativi codici ISO nella nostra documentazione di Landed Cost.
{ "currency": "USD"}Fornisci i dettagli degli articoli
Per ottenere un preventivo di Landed Cost il più accurato possibile utilizzando Zonos, dovrai fornire il maggior numero possibile di dettagli per articolo, inclusi i codici armonizzati (HS). In generale, più informazioni includi, più accurato sarà il tuo preventivo.
Sebbene fornire i codici HS consenta a Zonos Landed Cost di restituire i calcoli più accurati e completi, è possibile approssimare il Landed Cost effettivo senza un codice HS. Tuttavia, tieni presente che se il costo totale dei tuoi articoli supera la soglia de minimis, potrebbe essere richiesto un codice HS. In questi casi, l'invio di una richiesta senza un codice HS risulterà in un errore.
Per ciascun articolo che desideri includere nel tuo preventivo di Landed Cost, aggiungi una voce all'array items nel corpo della richiesta.
{ "items": [ { "id": "294395", "amount": 75, "country_of_origin": "FR", "description_customs": null, "hs_code": "6116.10.00", "quantity": 1 } ]}Aggiungi indirizzi di spedizione
Per calcolare il Landed Cost sono necessari i luoghi di partenza e di destinazione della spedizione. Per la destinazione della spedizione è richiesto un indirizzo completo, ma per la maggior parte dei preventivi di Landed Cost è sufficiente includere il paese di origine della spedizione.
{ "ship_from_country": "US", "ship_to": { "city": "Campinas", "country": "BR", "postal_code": "75828-000", "state": "SP" }}Fornisci le spese di spedizione
La Zonos Landed Cost API non calcola i costi di spedizione: si concentra su dazi doganali, tasse e spese. Poiché la spedizione rappresenta un aspetto considerevole di un preventivo di Landed Cost totale e un fattore significativo nel modo in cui vengono calcolati, è essenziale specificare in anticipo il costo di spedizione. Questo valore può essere ottenuto utilizzando un'API di valutazione della spedizione, come la Zonos Rating API, o con una varietà di altri mezzi, come il software di spedizione del corriere, i grafici delle tariffe, ecc.
Le informazioni relative ai costi di spedizione, compreso l'importo complessivo della spedizione, vengono inviate tramite il campo shipping nella tua richiesta API.
{ "shipping": { "amount": 14.23 }}Sebbene sia richiesto solo l'importo, puoi anche fornire un nome del livello di servizio per consentire all'API di calcolare le tariffe del corriere dall'importo fornito. Puoi visualizzare un elenco degli operatori supportati e dei livelli di servizio nella nostra documentazione di Landed Cost.
{ "shipping": { "amount": 14.23, "service_level": "ups_express_saver" }}Invia una richiesta API
Ora che hai creato la tua richiesta e l'hai configurata, puoi inviare una richiesta POST alla Zonos Landed Cost API. Assicurati di autenticarti con la tua chiave API e di fornire l'intestazione della versione corretta nella tua richiesta.
POST https://api.zonos.com/v1/landed_cost
{ "currency": "USD", "items": [ { "id": "294395", "amount": 75, "country_of_origin": "FR", "description_customs": null, "hs_code": "6116.10.00", "quantity": 1 } ], "ship_from_country": "US", "ship_to": { "city": "Campinas", "country": "BR", "postal_code": "75828-000",
Calcola un Landed Cost
Scopri come richiedere un Landed Cost tramite REST API.REST
La Zonos Landed Cost API ti consente di ottenere rapidamente un preventivo di Landed Cost estremamente accurato per le spedizioni transfrontaliere di importazione ed esportazione. Sebbene fornire i codici armonizzati (HS) consenta a Zonos Landed Cost di restituire il calcolo dei dazi più accurato, restituiremo comunque l'importo approssimativo di dazi e tasse anche quando non viene fornito un codice armonizzato.