Zonos instellen
Registreer eerst een Zonos-account en configureer uw account op het Zonos Dashboard. Vervolgens kunt u uw API-sleutel ophalen, waarmee u zich kunt authenticeren bij de Zonos API.
Basismunt instellen
Om context te geven over de geldbedragen in een landed cost-aanvraag, moet u de basisvalutacode van uw aanvraag opgeven (als ISO-valutacode). Deze code is van toepassing op alle monetaire waarden in de aanvraag en bepaalt in welke valuta de resulterende landed cost-offerte wordt weergegeven. Een lijst met ondersteunde valuta's en hun ISO-codes vindt u in onze landed cost-documentatie.
{ "currency": "USD"}Itemdetails opgeven
Om via Zonos een zo nauwkeurig mogelijke landed cost-offerte te krijgen, moet u zo veel mogelijk detail per item opgeven, inclusief harmonized (HS) codes. Over het algemeen geldt: hoe meer informatie u opgeeft, hoe nauwkeuriger de offerte wordt.
Het opgeven van HS-codes stelt Zonos Landed Cost in staat de meest nauwkeurige en volledige berekeningen te retourneren, maar het is ook mogelijk om de werkelijke landed cost te benaderen zonder HS-code. Houd er echter rekening mee dat een HS-code verplicht kan zijn als de totale kosten van uw items de de-minimisdrempel overschrijden. In dat geval resulteert een aanvraag zonder HS-code in een foutmelding.
Voeg voor elk item dat u wilt opnemen in uw landed cost-offerte een vermelding toe aan de items-array in de body van de aanvraag.
{ "items": [ { "id": "294395", "amount": 75, "country_of_origin": "FR", "description_customs": null, "hs_code": "6116.10.00", "quantity": 1 } ]}Verzendadressen toevoegen
De ship-from- en ship-to-locaties van uw zending zijn vereist om de landed cost te berekenen. Voor de bestemming van de zending is een volledig adres vereist, maar voor de meeste landed cost-offertes is het opgeven van het ship-from-land voldoende.
{ "ship_from_country": "US", "ship_to": { "city": "Campinas", "country": "BR", "postal_code": "75828-000", "state": "SP" }}Verzendkosten opgeven
De Zonos Landed Cost API berekent geen verzendkosten — deze richt zich op douanerechten, belastingen en kosten. Omdat verzending een aanzienlijk deel uitmaakt van een totale landed cost-offerte en een belangrijke factor is in de manier waarop alles wordt berekend, is het essentieel om de verzendkosten vooraf op te geven. U kunt deze waarde verkrijgen via een rating-API voor zendingen, zoals de Zonos Rating API, of via andere middelen, zoals de verzendsoftware van uw vervoerder, tariefoverzichten, enzovoort.
Informatie over verzendkosten, waaronder het totale verzendbedrag, wordt verzonden via het veld shipping in uw API-aanvraag.
{ "shipping": { "amount": 14.23 }}Hoewel alleen het bedrag verplicht is, kunt u ook een service level-naam opgeven zodat de API vervoerderskosten kan berekenen op basis van het opgegeven bedrag. Een lijst met ondersteunde vervoerders en service levels vindt u op onze Landed Cost-documentatie.
{ "shipping": { "amount": 14.23, "service_level": "ups_express_saver" }}API-verzoek verzenden
Nu u uw aanvraag heeft opgebouwd en geconfigureerd, kunt u een POST-aanvraag verzenden naar de Zonos Landed Cost API. Zorg ervoor dat u zich authenticeert met uw API-sleutel en de juiste version-header in uw aanvraag opgeeft.
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",
Landed cost berekenen
Leer een landed cost aanvragen via de REST API.REST
Met de Zonos Landed Cost API kunt u snel een zeer nauwkeurige landed cost-offerte opvragen voor grensoverschrijdende import- en exportzendingen. Het opgeven van harmonized (HS) codes stelt Zonos Landed Cost in staat de meest nauwkeurige berekening van invoerrechten te retourneren, maar ook zonder harmonized code geven we het geschatte bedrag aan invoerrechten en belastingen terug.