Ställ in Zonos
Först, registrera dig för ett Zonos konto och konfigurera ditt konto på Zonos Dashboard. Du kommer då att kunna få din API-nyckel, som gör att du kan autentisera dig med Zonos API:et.
Ställ in basvaluta
För att ge kontext om penningbelopp som ingår i en landed cost begäran, behöver du specificera din begärans basvaluta kod (som en ISO-valutakod). Detta kommer att referera till alla monetära värden i begäran och vilken valuta den resulterande landed cost offerten kommer att anges i. Du kan hitta en lista över stödda valutor och deras ISO-koder i vår landed cost dokumentation.
Begäran
{
"currency": "USD"
}
Ange artikeluppgifter
För att få en så exakt som möjligt landed cost offert med hjälp av Zonos, behöver du ange så mycket per-artikelinformation som möjligt, inklusive harmoniserade (HS) koder. Generellt sett, ju mer information du inkluderar, desto mer exakt blir din offert.
Att tillhandahålla HS-koder gör att Zonos Landed Cost kan returnera de mest exakta och kompletta beräkningarna, men det är möjligt att approximera den faktiska landed cost utan en HS-kod. Observera dock att om den totala kostnaden för dina artiklar överstiger de minimala gränserna, kan en HS-kod krävas. I sådana fall kommer en begäran utan en HS-kod att resultera i ett fel.
För varje artikel du vill inkludera i din landed cost offert, lägg till en post i items arrayen i begärans kropp.
Begäran
{
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"description_customs": null,
"hs_code": "6116.10.00",
"quantity": 1
}
]
}
Lägg till fraktadresser
Fraktfrån- och frakttill-platserna för din försändelse krävs för att beräkna landed cost. En komplett adress krävs för försändelsens destination, men att inkludera fraktfrån-landet är tillräckligt för de flesta landed cost-offerter.
Begäran
{
"ship_from_country": "US",
"ship_to": {
"city": "Campinas",
"country": "BR",
"postal_code": "75828-000",
"state": "SP"
}
}
Ange fraktkostnader
API:en Zonos Landed Cost beräknar inte fraktkostnader - den fokuserar på tullavgifter, skatter och avgifter. Eftersom frakt är en betydande aspekt av en total landed cost offert och en viktig faktor i hur saker beräknas, är det avgörande att specificera fraktkostnaden i förväg. Detta värde kan erhållas genom att använda en fraktvärderings-API, såsom Zonos Rating API, eller genom en mängd andra medel, såsom din transportörs fraktprogram, rate-tabeller, etc.
Information relaterad till fraktkostnader, inklusive det totala fraktbeloppet, skickas via fältet shipping i din API-förfrågan.
Begäran
{
"shipping": {
"amount": 14.23
}
}
Medan endast beloppet krävs kan du också ange ett servicenivånamn för att möjliggöra API:et att beräkna fraktkostnader baserat på det angivna beloppet. Du kan se en lista över stödda transportörer och servicenivåer i vår Landed Cost dokumentation.
Begäran
{
"shipping": {
"amount": 14.23,
"service_level": "ups_express_saver"
}
}
Skicka en API-förfrågan
Nu när du har byggt din förfrågan och konfigurerat den kan du skicka en POST-förfrågan till Zonos Landed Cost API. Se till att autentisera med din API-nyckel och ange rätt versionshuvud i din förfrågan.
POST https://api.zonos.com/v1/landed_cost
Förfrågan
{
"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"
}
}
Svar
{
"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"
}
Beräkna en landed cost
Lär dig hur du begär en landed cost via REST API:et.REST
API:et för Zonos Landed Cost låter dig snabbt få en mycket exakt landed cost offert för gränsöverskridande import- och exportleveranser. Genom att tillhandahålla harmoniserade (HS) koder kan Zonos Landed Cost returnera den mest exakta tullberäkningen, men vi kommer att returnera det ungefärliga beloppet av tullar och skatter även när en harmoniserad kod inte tillhandahålls.