Stel Zonos in
Registreer je eerst voor een Zonos account en configureer je account op het Zonos Dashboard. Je kunt dan je API-sleutel verkrijgen, waarmee je kunt authenticeren met de Zonos API.
Stel basisvaluta in
Om context te bieden over de geldbedragen die zijn opgenomen in een landed cost aanvraag, moet je de basisvalutacode van je aanvraag opgeven (als een ISO-valutacode). Dit verwijst naar alle monetaire waarden in de aanvraag en in welke valuta de resulterende landed cost offerte zal worden weergegeven. Je kunt een lijst van ondersteunde valuta's en hun ISO-codes vinden in onze landed cost docs.
Aanvraag
{
"currency": "USD"
}
Geef artikelgegevens op
Om een nauwkeurige mogelijke landed cost offerte te krijgen met Zonos, moet u zoveel mogelijk per-artikelgegevens opgeven, inclusief geharmoniseerde (HS) codes. Over het algemeen geldt: hoe meer informatie u opneemt, hoe nauwkeuriger uw offerte zal zijn.
Hoewel het verstrekken van HS-codes Zonos Landed Cost in staat stelt om de meest nauwkeurige en complete berekeningen te retourneren, is het mogelijk om de werkelijke landed cost zonder een HS-code te benaderen. Houd er echter rekening mee dat als de totale kosten van uw artikelen de de minimis-grens overschrijden, een HS-code vereist kan zijn. In die gevallen zal het verzenden van een verzoek zonder HS-code resulteren in een fout.
Voor elk artikel dat u wilt opnemen in uw landed cost offerte, voegt u een invoer toe aan de items array in de aanvraagbody.
Verzoek
{
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"description_customs": null,
"hs_code": "6116.10.00",
"quantity": 1
}
]
}
Voeg verzendadressen toe
De verzendlocaties voor uw zending zijn vereist om de landed cost te berekenen. Een volledig adres is vereist voor de bestemming van de zending, maar het vermelden van het verzendland is voldoende voor de meeste landed cost offertes.
Verzoek
{
"ship_from_country": "US",
"ship_to": {
"city": "Campinas",
"country": "BR",
"postal_code": "75828-000",
"state": "SP"
}
}
Bied verzendkosten aan
De Zonos Landed Cost API berekent geen verzendkosten - het richt zich op douanerechten, belastingen en vergoedingen. Omdat verzending een aanzienlijk aspect is van een totale landed cost offerte en een belangrijke factor in hoe dingen worden berekend, is het essentieel om de verzendkosten vooraf op te geven. Deze waarde kan worden verkregen door gebruik te maken van een verzendbeoordelings-API, zoals de Zonos Rating API, of door verschillende andere middelen, zoals de verzendsoftware van uw vervoerder, rate tabellen, enz.
Informatie met betrekking tot verzendkosten, inclusief het totale verzendbedrag, wordt verzonden via het shipping veld in uw API-verzoek.
Verzoek
{
"shipping": {
"amount": 14.23
}
}
Hoewel alleen het bedrag vereist is, kunt u ook een servicenaam opgeven om de API in staat te stellen de vervoerskosten op basis van het opgegeven bedrag te berekenen. U kunt een lijst van ondersteunde vervoerders en serviceniveaus zien in onze Landed Cost docs.
Verzoek
{
"shipping": {
"amount": 14.23,
"service_level": "ups_express_saver"
}
}
Stuur een API-verzoek
Nu je je verzoek hebt opgebouwd en geconfigureerd, kun je een POST-verzoek naar de Zonos Landed Cost API sturen. Zorg ervoor dat je je authenticeert met je API-sleutel en de juiste versieheader in je verzoek opneemt.
POST https://api.zonos.com/v1/landed_cost
Verzoek
{
"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"
}
}
Antwoord
{
"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"
}
Bereken een landed cost
Leer hoe je een landed cost kunt aanvragen via de REST API.REST
De Zonos Landed Cost API stelt je in staat om snel een zeer nauwkeurige landed cost offerte te krijgen voor grensoverschrijdende import- en exportzendingen. Het verstrekken van geharmoniseerde (HS) codes stelt Zonos Landed Cost in staat om de meest nauwkeurige douanerekening te retourneren, maar we zullen ook het geschatte bedrag aan douanes en belastingen retourneren, zelfs wanneer er geen geharmoniseerde code is opgegeven.