Configura Zonos
Per prima cosa, registrati per un account Zonos e configura il tuo account sul Dashboard di Zonos. Potrai quindi ottenere la tua chiave API, che ti consentirà di autenticarti con l'API Zonos.
Imposta la valuta di base
Per fornire contesto sugli importi monetari inclusi in una richiesta di landed cost, è necessario specificare il codice della valuta di base della richiesta (come codice ISO della valuta). Questo si riferirà a tutti i valori monetari nella richiesta e a quale valuta verrà restituito il preventivo per il landed cost risultante. Puoi trovare un elenco delle valute supportate e dei loro codici ISO nella nostra documentazione sul landed cost.
Richiesta
{
"currency": "USD"
}
Fornire i dettagli dell'articolo
Per ottenere un preventivo possibile e accurato di landed cost utilizzando Zonos, sarà necessario 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.
Fornire i codici HS consente a Zonos Landed Cost di restituire i calcoli più accurati e completi, ma è possibile approssimare il reale landed cost senza un codice HS. Tuttavia, nota che se il costo totale dei tuoi articoli supera la soglia de minimis, potrebbe essere richiesto un codice HS. In quei casi, inviare una richiesta senza un codice HS comporterà un errore.
Per ogni articolo che desideri includere nel tuo preventivo di landed cost, aggiungi un'entrata all'array items nel corpo della richiesta.
Richiesta
{
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"description_customs": null,
"hs_code": "6116.10.00",
"quantity": 1
}
]
}
Aggiungi indirizzi di spedizione
Le località di partenza e di destinazione per la tua spedizione sono necessarie per calcolare il landed cost. È necessario un indirizzo completo per la destinazione della spedizione, ma includere il paese di partenza è sufficiente per la maggior parte dei preventivi di landed cost.
Richiesta
{
"ship_from_country": "US",
"ship_to": {
"city": "Campinas",
"country": "BR",
"postal_code": "75828-000",
"state": "SP"
}
}
Fornire i costi di spedizione
L'API Zonos Landed Cost non calcola i costi di spedizione - si concentra su dazi doganali, tasse e commissioni. Poiché la spedizione è un aspetto considerevole di un preventivo totale landed cost e un fattore significativo nel modo in cui vengono effettuati i calcoli, è essenziale specificare il costo di spedizione in anticipo. Questo valore può essere ottenuto utilizzando un'API di valutazione delle spedizioni, come l'API di valutazione Zonos, o attraverso una varietà di altri mezzi, come il software di spedizione del tuo corriere, le tabelle rate ecc.
Le informazioni relative ai costi di spedizione, incluso l'importo totale della spedizione, vengono inviate tramite il campo shipping nella tua richiesta API.
Richiesta
{
"shipping": {
"amount": 14.23
}
}
Mentre è richiesto solo l'importo, puoi anche fornire un nome del livello di servizio per consentire all'API di calcolare le spese di spedizione in base all'importo fornito. Puoi vedere un elenco dei vettori e dei livelli di servizio supportati nella nostra documentazione di Landed Cost.
Richiesta
{
"shipping": {
"amount": 14.23,
"service_level": "ups_express_saver"
}
}
Invia una richiesta API
Ora che hai costruito la tua richiesta e l'hai configurata, puoi inviare una richiesta POST all'API Zonos Landed Cost. Assicurati di autenticarti con la tua chiave API e di fornire l'intestazione di versione corretta nella tua richiesta.
POST https://api.zonos.com/v1/landed_cost
Richiesta
{
"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",
"state": "SP"
},
"shipping": {
"amount": 14.23,
"amount_discount": 0,
"service_level": "ups_express_saver"
}
}
Risposta
{
"id": "ldct_1AoaDV8MZ8SAmsVFFTWISI",
"amount_subtotal": {
"duties": 53.54,
"fees": 27.64,
"taxes": 33.96
},
"currency": {
"id": "1aad3b7e-c",
"base": "USD",
"date": "2022-09-06T20:57:10.333+0000",
"rates": [
{
"currency": "BRL",
"rate": 5.2499
}
]
},
"customs": {
"delivery_duty_paid": "available",
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"country_of_origin_source": "api_request",
"description_customs": null,
"description_retail": null,
"hs_code": "6116.10.00",
"hs_code_source": "api_request",
"note": "",
"quantity": 1
}
],
"shipping_amount": 14.23,
"ship_to_country": "BR"
},
"de_minimis": [
{
"formula": "(cost {'<='} 0 brl)",
"method": "FOB",
"note": "Duty applies to all shipments",
"threshold": "above",
"type": "duty"
},
{
"formula": "(cost {'<='} 0 brl)",
"method": "FOB",
"note": "Tax applies to all shipments",
"threshold": "above",
"type": "tax"
}
],
"duties": [
{
"amount": 45.0,
"description": "Basic customs duty",
"item_id": "294395",
"formula": "60 %",
"note": "Duty is 60% of the items total.",
"type": "item"
},
{
"amount": 8.538,
"description": "Basic customs duty",
"item_id": "294395",
"formula": "60 %",
"note": "Duty is 60% of the items total.",
"type": "shipping"
}
],
"fees": [
{
"amount": 15.0,
"description": "UPS United States Duty and Tax Forwarding Charge",
"item_id": null,
"formula": "15 USD",
"note": null,
"type": "ddp_service_fee"
},
{
"amount": 12.0,
"description": "UPS Disbursement Fee",
"item_id": null,
"formula": "2.00% of duties & taxes amount with a minimum of 12 usd, whichever is greater",
"note": null,
"type": "advancement"
},
{
"amount": 0.64,
"description": "UPS Currency Conversion Fee",
"item_id": null,
"formula": ".75% of the amount converted",
"note": null,
"type": "currency_conversion_fee"
}
],
"taxes": [
{
"amount": 16.46,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": null,
"type": "item"
},
{
"amount": 3.12,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": null,
"type": "shipping"
},
{
"amount": 9.88,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": "ICMS on the duty of the item",
"type": "duty"
},
{
"amount": 1.87,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": "ICMS on the duty of the shipping",
"type": "duty"
},
{
"amount": 2.63,
"description": "ICMS",
"item_id": null,
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": null,
"type": "advancement"
}
],
"removed_items": [],
"remittance": [],
"landedCostGuaranteeCode": "ZONOS"
}
Calcola un landed cost
Scopri come richiedere un landed cost tramite l'API REST.REST
L'API Zonos Landed Cost ti consente di ottenere rapidamente un preventivo altamente accurato per il landed cost per spedizioni di importazione ed esportazione transfrontaliere. Fornire codici armonizzati (HS) consente a Zonos Landed Cost di restituire il calcolo dei dazi più accurato, ma restituiremo l'importo approssimativo dei dazi e delle tasse anche quando non viene fornito un codice armonizzato.