Przygotuj żądanie
Obliczenie kosztu dostawy za pomocą interfejsu API wymaga kilku danych wejściowych, które zorganizowaliśmy w przepływy pracy. Po zakończeniu będziesz mógł wysłać jedno żądanie w celu uzyskania kosztu dostawy na podstawie miejsca dostawy, pozycji w koszyku i szczegółów wysyłki.
Każdy przepływ pracy ma swoje własne wymagane dane wejściowe. GraphQL pozwala na przekazanie więcej danych niż to konieczne, ale tylko określone pola są wymagane do zwrócenia kosztu dostawy. Są one jasno oznaczone w naszym odniesieniu do interfejsu API, aby zobaczyć wszystkie możliwe pola.
Należy pamiętać, że niektóre pola są warunkowo wymagane, jeśli chcesz, aby obliczenie było gwarantowane.
Poniżej przedstawiliśmy wszystkie pola wymagane do obliczenia gwarantowanego kosztu dostawy. Upewnij się, że te informacje są zawarte przed wysłaniem żądania.
Wymagane dane wejściowe do obliczeń gwarantowanych
partyCreateWorkflowInputDane partyCreateWorkflowInput identyfikują zaangażowane strony i ich lokalizacje. Wyświetl pełny schemat w naszym odniesieniu do interfejsu API GraphQL. Wymagane pola to:
locationadministrativeAreaCode: Kod stanu lub prowincji, dwa znaki. Wymagane tylko dla CA i BR.countryCode: Dwuliterowy kod ISO kraju.line1: Pierwszy wiersz adresu.postalCode: Kod pocztowy lub numer pocztowy adresu.
personemail: Adres e-mail osoby.firstName: Imię osoby.lastName: Nazwisko osoby.phone: Numer telefonu osoby.
typeDESTINATION: Informacjelocationipersondotyczące miejsca dostawy.ORIGIN: Informacjelocationdotyczące miejsca wysłania.personpowiązana z miejscem wysłania nie jest wymagana.
itemCreateWorkflowInputDane itemCreateWorkflowInput zawierają listę pozycji w koszyku. Istnieje wiele pól opcjonalnych (wszystkie możliwości zobacz w naszym odniesieniu do interfejsu API), ale poniższe pola są wymagane.
amount: Wartość pojedynczej jednostki produktu wysyłanego, przed pomnożeniem przez ilość. Należy pamiętać, że różni się to od definicji pocztowej pozycji pocztowej. Jeśliquantitypozycji wynosi 1, to jest to całkowity koszt pozycji. Jeśliquantitypozycji wynosi >1, interfejs API pomnożyamountpozycji przezquantitypozycji w celu uzyskania sumy dla pozycji w wierszu. Nie wpisuj całkowitej ceny wszystkich jednostek pozycji wamount.currencyCode: Kod waluty dla kwoty pozycji.quantity: Ilość pozycji. Interfejs API pomnożyamountpozycji przezquantitypozycji w celu uzyskania sumy dla pozycji w wierszu.countryOfOrigin: Kraj, w którym został wyprodukowany artykuł.- Jedno z następujących (którą ustawiłeś jako preferencję klucza pozycji. Twój klucz pozycji łączy informacje przechowywane w Katalog z pozycją w koszyku i jest używany podczas tworzenia etykiety.)
productId: Identyfikator produktu pozycji.sku: SKU pozycji.
Wymiary (WEIGHT, LENGTH, WIDTH, HEIGHT) są wymagane tylko wtedy, gdy chcesz kartonizować swoje pozycje podczas uzyskiwania oceny wysyłki.
cartonsCreateWorkflowInputDane cartonsCreateWorkflowInput wymagają tylko samego wejścia. Wyświetl pełny schemat w naszym odniesieniu do interfejsu API GraphQL, aby zobaczyć wszystkie wartości, które można przekazać. Ważne jest przekazanie wymiarów i wagi kartonu, jeśli Zonos oblicza koszt wysyłki.
shipmentRatingCreateWorkflowInputTen przepływ pracy jest używany, gdy już znasz usługę wysyłki i jej koszt; jeśli chcesz, aby Zonos obliczył te koszty dla usług, które masz włączone, zamień ten przepływ pracy i użyj zamiast niego shipmentRatingCalculateWorkflow.
Dane shipmentRatingCreateWorkflowInput komunikują koszt wysyłki. Wyświetl pełny schemat w naszym odniesieniu do interfejsu API GraphQL. Wymagane pola to:
amount: Koszt wysyłki.currencyCode: Kod waluty kosztu wysyłki.serviceLevelCode: Kod wskazujący poziom usługi wysyłki użyty w ocenie wysyłki.
landedCostWorkFlowInputDane landedCostWorkFlowInput określają preferencje dla obliczenia kosztu dostawy. Wyświetl pełny schemat w naszym odniesieniu do interfejsu API GraphQL. Wymagane pola to:
calculationMethod: Wskazuje Twoją preferencję dotyczącą sposobu wysyłki: DDP (prepłacone cła i podatki) lub DAP (cła i podatki są opłacane przy dostawie lub, jeśli obowiązuje system zwrotu, są zwracane za pośrednictwem identyfikatora podatkowego).- Jeśli używasz naszej gwarancji kosztu dostawy, ta wartość powinna być zawsze
DDP_PREFERRED, która będzie dostarczać cytat DDP, jeśli jest to możliwe, a cytat DAP, jeśli DDP nie jest dozwolony. Zamiast tego użycieDAPmoże spowodować, że koszty dostawy nie będą już gwarantowane, ponieważ zazwyczaj skutkuje to opłatą ceł i podatków przy dostawie.
- Jeśli używasz naszej gwarancji kosztu dostawy, ta wartość powinna być zawsze
endUse: Wskazuje, czy towary są sprzedawane innej firmie (FOR_RESALE) czy do użytku końcowego u konsumenta (NOT_FOR_RESALE).tariffRate: Wskazuje metodę, którą Zonos powinien użyć do obliczenia stawek taryfowych dla tego cytatu, na wypadek gdyby istniał zakres stawek taryfowych, które mogły zostać zastosowane. *Podczas korzystania z naszej gwarancji kosztu dostawy, powinno to być zawszeZONOS_PREFERRED.
Dodaj obliczoną wysyłkę: Jeśli chcesz, aby Zonos obliczył dla Ciebie koszt wysyłki, zamień
shipmentRatingCreateWorkflownashipmentRatingCalculateWorkflow. DodajcartonizeWorkflow, jeśli chcesz, aby Zonos posortował Twoje pozycje do kartonów przed znalezieniem kosztu wysyłki (używane dla masy wymiarowej).
Kody HS i opcje wysyłki
GraphQL daje Ci elastyczność, aby dostosować żądanie do swoich preferencji. Istnieje kilka opcji dotyczące sposobu dołączenia kodów HS i kosztów wysyłki w żądaniu.
Kody HS
Kody HS wpływają na stawki cła i dlatego są wymagane. Możesz przekazać kod HS dla każdej pozycji lub pozwolić, aby Classify je wygenerował.
Zonos zdecydowanie zaleca używanie kodów HS specyficznych dla produktów, ponieważ prowadzi to do dokładniejszej wyceny kosztu dostawy. Jeśli znasz swoje kody HS, przekaż hsCode dla każdej item podczas itemCreateWorkflow.
Jeśli przekażesz kod HS, Zonos zweryfikuje go natychmiast podczas uzyskiwania cytatu kosztu dostawy. Jeśli przekazany kod HS jest nieprawidłowy (co oznacza, że nie istnieje), Zonos ponownie sklasyfikuje Twoją pozycję w locie i użyje nowego, prawidłowego kodu HS zamiast Twojego dostarczonego.
Jeśli potrzebujesz pomocy w generowaniu kodów HS dla Twoich produktów, dowiedz się o Zonos Classify i sposobie zażądania klasyfikacji.
Jeśli nie przekażesz Zonos hsCode, najpierw sprawdzimy Katalog Zonos, aby sprawdzić, czy masz kod HS przechowywany dla Twojej pozycji. Jeśli nie, zadzwonimy do Classify, aby wygenerować klasyfikację w celu zasilenia obliczenia kosztu dostawy na podstawie następujących pól szczegółów produktu itemCreateWorkflow: description, category i material. Jeśli Twoje pola szczegółów produktu nie są wystarczająco szczegółowe, aby wygenerować klasyfikację na podstawie punktacji pewności Classify, domyślny kod HS przypisany do Twojego sklepu będzie używany.
Koszt wysyłki
Zarówno poziom usługi wysyłki, jak i jej koszt wpływają na cła, podatki i opłaty i dlatego są wymagane. Zonos może obliczyć wysyłkę lub możesz nam to przekazać.
Aby Zonos obliczył koszty wysyłki, użyj shipmentRatingCalculateWorkflow. Opcje wysyłki zwrócone w odpowiedzi na obliczoną wysyłkę będą korelować z serviceLevels, które przydzieliłeś do profili wysyłki w Dashboard.
Rozwiązywanie problemów: Jeśli oczekujesz
serviceLevelw odpowiedzi, ale się nie pojawia, upewnij się, żeserviceLeveljest włączony i obsługiwany przez wybranąmethod.
Dodaj cartonizeWorkflow (które nie ma wejść), jeśli chcesz, aby Zonos posortował Twoje pozycje do kartonów przed znalezieniem kosztu wysyłki (używane dla masy wymiarowej.
Jeśli znasz serviceLevel i amount dla wysyłki, możesz przekazać je w części shipmentRatingCreateWorkflow żądania. Użyjemy tych wartości do obliczenia wszelkich powiązanych opłat przewoźnika i zwrócimy je w odpowiedzi.
Poproś o koszt dostawy za pomocą interfejsu API
Po uzyskaniu wymaganych danych wejściowych wyślij mutację GraphQL do punktu końcowego interfejsu API za pomocą wybranej biblioteki klienta lub narzędzia. Oto kilka przykładów struktury mutacji.
Użyj tego żądania, gdy Zonos oblicza koszt wysyłki w ramach żądania Landed Cost. Następnie obliczymy cła i podatki od wysyłki, jeśli są oceniane przez kraj docelowy.
mutation CalculateLandedCost($parties: [PartyCreateWorkflowInput!]!$items: [ItemCreateWorkflowInput!]!$landedCostConfig: LandedCostWorkFlowInput!) { partyCreateWorkflow(input: $parties) { type id organization } itemCreateWorkflow(input: $items) { id amount productId } cartonizeWorkflow { id type items { item { id } } } shipmentRatingCalculateWorkflow { id amount } landedCostCalculateWorkflow(input: $landedCostConfig) { id duties { amount currency note } taxes { amount currency note } fees { amount currency note } }}Następny krok: Utwórz zamówienie
Po obliczeniu kosztu dostawy i otrzymaniu landedCostId z odpowiedzi API powinieneś utworzyć zamówienie, aby sfinalizować transakcję w systemie Zonos. Użyj mutacji orderCreate i przekaż landedCostId z Twojego cytatu. Dowiedz się więcej o tworzeniu zamówień.
Poproś o koszt dostawy w Dashboard
Możesz również obliczyć koszty dostawy bezpośrednio w Zonos Dashboard bez korzystania z interfejsu API. Jest to przydatne do testowania obliczeń, szkolenia zespołu lub szybkiego uzyskiwania cytatów dla zapytań klientów.
Dashboard używa tych samych punktów końcowych interfejsu API opisanych powyżej, więc wyniki będą zgodne z tym, co uzyskałbyś z bezpośrednich połączeń interfejsu API. To czyni go doskonałym sposobem na zweryfikowanie integracji interfejsu API lub eksplorowanie tego, jak różne wejścia wpływają na obliczenia.
Używanie kalkulatora Dashboard
Za pomocą kalkulatora kosztu dostawy w Dashboard możesz uzyskać cytaty z obliczonymi stawkami wysyłki, tworzyć cytaty ze znanymi kosztami wysyłki lub przetwarzać wiele cytatów zbiorczo.
Użyj tego przepływu, gdy znasz poziom usługi wysyłki i koszt dla Twojej przesyłki.
- Przejdź do Dashboard → Zamówienia → Cytaty
- Kliknij Nowy cytat
- Opcjonalnie — Zmodyfikuj lokalizację adresu wysyłki
- Wybierz Kraj docelowy z listy rozwijanej
- Wprowadź kwotę wysyłki
- Poziom usługi jest opcjonalny; dodanie go pozwala nam obliczyć odpowiednie opłaty przewoźnika
- Dodaj szczegóły przedmiotu dla przesyłki
- Kiedy wpiszesz opis, automatycznie klasyfikujemy produkt i generujemy kod HS
- Możesz nadpisać wygenerowany kod HS w razie potrzeby
- W przypadku wielu pozycji kliknij Zapisz i dodaj kolejny. W przeciwnym razie kliknij Zapisz
- Opcjonalnie — Kliknij Więcej opcji, aby zmienić:
- Typ sprzedaży na Dla sprzedaży
- Tryb dostawy na Cła przy dostawie
- Kliknij Uzyskaj cytat
- Aby wprowadzić zmiany, kliknij Edytuj formularz i zmodyfikuj szczegóły
- Kliknij Uzyskaj cytat ponownie, aby zaktualizować
Cytat kosztu dostawy pojawi się po prawej stronie, w tym informacje o produkcie, wysyłce i kosztach importu. Rozwiń cytat, aby zobaczyć szczegółowe podziały pozycji, wysyłki, ceł, podatków i opłat. Wszystkie cytaty są zapisywane na stronie cytaty do celów referencyjnych.
Edytuj istniejące cytaty: Kliknij Cytat ponownie w górnym rogu, aby zmodyfikować istniejący cytat zamiast zaczynać od zera.
Korzyści z używania Dashboard
- Nie jest wymagane kodowanie — Generuj cytaty za pośrednictwem przyjaznego interfejsu użytkownika
- Szkolenie zespołu — Pomóż pracownikom niebędącym programistami zrozumieć składniki kosztu dostawy
- Walidacja interfejsu API — Zweryfikuj, że integracja interfejsu API daje oczekiwane wyniki
- Obsługa klienta — Szybko generuj cytaty dla zapytań klientów
- Przetwarzanie zbiorcze — Efektywnie obsługuj wiele obliczeń (wkrótce)
Cytaty Dashboard zawierają te same szczegółowe podziały dostępne za pośrednictwem interfejsu API, co czyni go doskonałym uzupełnieniem zautomatyzowanej integracji.
Oblicz koszt dostawy
Oblicz cła, podatki i opłaty za pomocą GraphQL.GraphQL
Zonos oblicza całkowity koszt dostawy dla przesyłek międzynarodowych — w tym cła, podatki i wszelkie dodatkowe opłaty pobierane przez służby celne, brokerów lub przewoźników. W większości przypadków gwarantujemy te obliczenia, płacąc ostateczny rachunek sami i pobierając od Ciebie dokładnie to, co obliczyliśmy. W niektórych przypadkach możesz użyć naszego kosztu dostawy bez gwarancji, co oznacza, że Ty ponoszysz odpowiedzialność za wszelkie różnice między naszymi obliczeniami a faktycznymi opłatami.