DOCS
Landed Cost•
Strona głównaDla dostawców logistyki Landed Cost Oblicz koszt dostawy - GraphQL

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.

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.

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.

1mutation CalculateLandedCost(
2$parties: [PartyCreateWorkflowInput!]!
3$items: [ItemCreateWorkflowInput!]!
4$landedCostConfig: LandedCostWorkFlowInput!
5) {
6 partyCreateWorkflow(input: $parties) {
7 type
8 id
9 organization
10 }
11 itemCreateWorkflow(input: $items) {
12 id
13 amount
14 productId
15 }
16 cartonizeWorkflow {
17 id
18 type
19 items {
20 item {
21 id
22 }
23 }
24 }
25 shipmentRatingCalculateWorkflow {
26 id
27 amount
28 }
29 landedCostCalculateWorkflow(input: $landedCostConfig) {
30 id
31 duties {
32 amount
33 currency
34 note
35 }
36 taxes {
37 amount
38 currency
39 note
40 }
41 fees {
42 amount
43 currency
44 note
45 }
46 }
47}

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 Twojej wyceny. 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 wycen 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ć wyceny z obliczonymi stawkami wysyłki, tworzyć wyceny ze znanymi kosztami wysyłki lub przetwarzać wiele wycen zbiorczo.

Użyj tego przepływu, gdy znasz poziom usługi wysyłki i koszt dla Twojej przesyłki.

  1. Przejdź do Dashboard → Zamówienia → Wyceny
  2. Kliknij Nowa wycena
  3. Opcjonalnie — Zmodyfikuj lokalizację adresu wysyłki
  4. Wybierz Kraj docelowy z listy rozwijanej
  5. Wprowadź kwotę wysyłki
    • Poziom usługi jest opcjonalny; dodanie go pozwala nam obliczyć odpowiednie opłaty przewoźnika
  6. 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
  7. Opcjonalnie — Kliknij Więcej opcji, aby zmienić:
    • Typ sprzedaży na Dla sprzedaży
    • Tryb dostawy na Cła przy dostawie
  8. Kliknij Uzyskaj wycenę
    • Aby wprowadzić zmiany, kliknij Edytuj formularz i zmodyfikuj szczegóły
    • Kliknij Uzyskaj wycenę ponownie, aby zaktualizować

Wycena kosztu dostawy pojawi się po prawej stronie, w tym informacje o produkcie, wysyłce i kosztach importu. Rozwiń wycenę, aby zobaczyć szczegółowe podziały pozycji, wysyłki, ceł, podatków i opłat. Wszystkie wyceny są zapisywane na stronie wycen do celów referencyjnych.

Edytuj istniejące wyceny: Kliknij Wycenuj ponownie w górnym rogu, aby zmodyfikować istniejącą wycenę zamiast zaczynać od zera.

Korzyści z używania Dashboard

  • Nie jest wymagane kodowanie — Generuj wyceny 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 wyceny dla zapytań klientów
  • Przetwarzanie zbiorcze — Efektywnie obsługuj wiele obliczeń (wkrótce)

Wyceny Dashboard zawierają te same szczegółowe podziały dostępne za pośrednictwem interfejsu API, co czyni go doskonałym uzupełnieniem zautomatyzowanej integracji.

GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

ItemCreateWorkflowInput LandedCostWorkFlowInput PartyCreateWorkflowInput ShipmentRatingCreateWorkflowInput

MUTATIONS

cartonizeWorkflow itemCreateWorkflow landedCostCalculateWorkflow partyCreateWorkflow shipmentRatingCalculateWorkflow shipmentRatingCreateWorkflow

Czy ta strona była pomocna?

Uzyskaj wsparcie·Dokumenty prawne·© 2026 Zonos
Na tej stronie:
  • Oblicz koszt dostawy
  • Przygotuj żądanie
  • Poproś o koszt dostawy za pomocą interfejsu API
  • Poproś o koszt dostawy w Dashboard