Skonfiguruj Zonos
Najpierw zarejestruj się na konto Zonos i skonfiguruj swoje konto na Zonos Dashboard. Następnie będziesz mógł uzyskać swój klucz API, który pozwoli Ci uwierzytelnić się w API Zonos.
Ustaw walutę bazową
Aby dostarczyć kontekst dotyczący kwot pieniężnych zawartych w żądaniu landed cost, musisz określić kod waluty bazowej swojego żądania (jako kod waluty ISO). Będzie to odnosić się do wszystkich wartości pieniężnych w żądaniu oraz do waluty, w której zostanie przedstawiony wynikowy koszt landed cost. Możesz znaleźć listę obsługiwanych walut i ich kody ISO w naszej dokumentacji dotyczącej landed cost.
Żądanie
{
"currency": "USD"
}
Podaj szczegóły przedmiotu
Aby uzyskać jak najdokładniejszą wycenę landed cost za pomocą Zonos, musisz dostarczyć jak najwięcej szczegółów dotyczących każdego przedmiotu, w tym kody zharmonizowane (HS). Zazwyczaj im więcej informacji podasz, tym dokładniejsza będzie twoja wycena.
Podanie kodów HS pozwala Zonos Landed Cost zwrócić najbardziej dokładne i kompletne obliczenia, jednak możliwe jest przybliżenie rzeczywistego landed cost bez kodu HS. Należy jednak pamiętać, że jeśli całkowity koszt twoich przedmiotów przekracza próg de minimis, może być wymagany kod HS. W takich przypadkach wysłanie żądania bez kodu HS spowoduje błąd.
Dla każdego przedmiotu, który chcesz uwzględnić w swojej wycenie landed cost, dodaj wpis do tablicy items w treści żądania.
Żądanie
{
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"description_customs": null,
"hs_code": "6116.10.00",
"quantity": 1
}
]
}
Dodaj adresy wysyłki
Lokalizacje wysyłki i dostawy dla Twojej przesyłki są wymagane do obliczenia landed cost. Pełny adres jest wymagany dla miejsca przeznaczenia przesyłki, ale podanie kraju wysyłki jest wystarczające dla większości wycen landed cost.
Żądanie
{
"ship_from_country": "US",
"ship_to": {
"city": "Campinas",
"country": "BR",
"postal_code": "75828-000",
"state": "SP"
}
}
Podaj koszty wysyłki
API Zonos Landed Cost nie oblicza kosztów wysyłki - koncentruje się na cłach, podatkach i opłatach. Ponieważ wysyłka jest istotnym aspektem całkowitego wyceny landed cost oraz znaczącym czynnikiem w sposobie obliczeń, ważne jest, aby określić koszt wysyłki z góry. Ta wartość może być uzyskana za pomocą API oceny przesyłek, takiego jak API oceny Zonos, lub na różne inne sposoby, takie jak oprogramowanie do wysyłki Twojego przewoźnika, tabele rate itp.
Informacje dotyczące kosztów wysyłki, w tym całkowita kwota wysyłki, są przesyłane za pomocą pola shipping w Twoim żądaniu API.
Żądanie
{
"shipping": {
"amount": 14.23
}
}
Chociaż wymagana jest tylko kwota, możesz również podać nazwę poziomu usługi, aby umożliwić API obliczenie opłat przewoźnika na podstawie podanej kwoty. Możesz zobaczyć listę obsługiwanych przewoźników i poziomów usług w naszych dokumentach Landed Cost.
Request
{
"shipping": {
"amount": 14.23,
"service_level": "ups_express_saver"
}
}
Wyślij żądanie API
Teraz, gdy zbudowałeś swoje żądanie i skonfigurowałeś je, możesz wysłać żądanie POST do API Zonos Landed Cost. Upewnij się, że uwierzytelniasz się za pomocą swojego klucza API i podajesz poprawny nagłówek wersji w swoim żądaniu.
POST https://api.zonos.com/v1/landed_cost
Żądanie
{
"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"
}
}
Odpowiedź
{
"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"
}
Oblicz koszt landed cost
Dowiedz się, jak zażądać kosztu landed cost za pomocą REST API.
REST
API Zonos Landed Cost pozwala szybko uzyskać wysoce dokładny koszt landed cost dla przesyłek importowych i eksportowych. Podanie skodyfikowanych (HS) kodów pozwala Zonos Landed Cost zwrócić najbardziej dokładne obliczenia ceł, jednak zwrócimy przybliżoną kwotę ceł i podatków, nawet gdy kod harmonizowany nie jest podany.