Skonfiguruj Zonos
Najpierw zarejestruj konto Zonos i skonfiguruj swoje konto w Zonos Dashboard. Będziesz wtedy mógł uzyskać swój klucz API, który pozwoli ci się uwierzytelnić za pośrednictwem API Zonos.
Ustaw walutę bazową
Aby podać kontekst dotyczący kwot pieniężnych zawartych w żądaniu wyceny landed cost, musisz określić kod waluty bazowej żądania (jako kod waluty ISO). Będzie to odnosić się do wszystkich wartości pieniężnych w żądaniu i jaka waluta będzie użyta do wyrenderowania wyceny landed cost. Listę obsługiwanych walut i ich kodów ISO można znaleźć w naszej dokumentacji landed cost.
{ "currency": "USD"}Podaj szczegóły elementu
Aby uzyskać dokładną możliwą wycenę landed cost za pośrednictwem Zonos, będziesz musiał podać jak najwięcej szczegółów dla każdego elementu, w tym harmonizowane kody (HS). Ogólnie rzecz biorąc, im więcej informacji podasz, tym bardziej dokładna będzie twoja wycena.
Chociaż podanie kodów HS pozwala API Zonos Landed Cost zwrócić najdokładniejsze i kompletne obliczenia, możliwe jest przybliżenie rzeczywistego landed cost bez kodu HS. Jednak zwróć uwagę, że jeśli całkowity koszt twoich elementów przekroczy próg de minimis, kod HS może być wymagany. W takich przypadkach wysłanie żądania bez kodu HS spowoduje błąd.
Dla każdego elementu, który chcesz uwzględnić w swojej wycenie landed cost, dodaj wpis do tablicy items w treści żądania.
{ "items": [ { "id": "294395", "amount": 75, "country_of_origin": "FR", "description_customs": null, "hs_code": "6116.10.00", "quantity": 1 } ]}Dodaj adresy wysyłki
Lokalizacje nadania i dostawy przesyłki są wymagane do obliczenia landed cost. Pełny adres jest wymagany dla miejsca przeznaczenia przesyłki, ale dla większości wycen landed cost wystarczy podanie tylko kraju nadania.
{ "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 - skupia się na cłach, podatkach i opłatach. Ponieważ wysyłka jest istotnym aspektem całkowitej wyceny landed cost i ważnym czynnikiem wpływającym na sposób obliczeń, ważne jest, aby z góry określić koszt wysyłki. Tę wartość można uzyskać za pomocą API oceny przesyłki, takiego jak Zonos Rating API, lub na różne inne sposoby, takie jak oprogramowanie wysyłkowe twojego przewoźnika, tabele stawek itp.
Informacje dotyczące kosztów wysyłki, w tym ogólną kwotę wysyłki, są wysyłane za pośrednictwem pola shipping w żądaniu API.
{ "shipping": { "amount": 14.23 }}Chociaż tylko kwota jest wymagana, możesz również podać nazwę poziomu usługi, aby umożliwić API obliczenie opłat przewoźnika na podstawie podanej kwoty. Listę obsługiwanych przewoźników i poziomów usług można znaleźć w naszej dokumentacji Landed Cost.
{ "shipping": { "amount": 14.23, "service_level": "ups_express_saver" }}Wyślij żądanie API
Teraz, gdy zbudowałeś swoje żądanie i je skonfigurowałeś, możesz wysłać żądanie POST do API Zonos Landed Cost. Upewnij się, że uwierzytelniasz się za pomocą klucza API i podajesz poprawny nagłówek wersji w swoim żądaniu.
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", "state"
Oblicz landed cost
Dowiedz się, jak poprosić o wycenę landed cost za pośrednictwem REST API.
REST
API Zonos Landed Cost pozwala szybko uzyskać bardzo dokładną wycenę landed cost dla przesyłek importowych i eksportowych transgranicznych. Chociaż podanie harmonizowanych kodów (HS) pozwala API Zonos Landed Cost zwrócić najdokładniejsze obliczenie cła, zwrócimy przybliżoną wartość cła i podatków nawet jeśli harmonizowany kod nie zostanie podany.