DOCS
Landed Cost•
Strona głównaDla dostawców logistyki Landed Cost Oblicz landed cost - GraphQL

Oblicz landed cost

Obliczaj cła, podatki i opłaty za pomocą GraphQL.

GraphQL

Zonos oblicza całkowity landed cost przesyłek międzynarodowych — w tym cła, podatki oraz wszelkie dodatkowe opłaty pobierane przez urząd celny, agencje celne lub przewoźników. W większości przypadków gwarantujemy te obliczenia: sami opłacamy końcowy rachunek i pobieramy od Ciebie dokładnie tyle, ile obliczyliśmy. W niektórych przypadkach możesz korzystać z naszego landed cost bez gwarancji, co oznacza, że to Ty odpowiadasz za wszelkie różnice między naszym obliczeniem a faktycznymi opłatami.

Przygotuj żądanie 

Obliczenie landed cost przez API wymaga kilku danych wejściowych, które pogrupowaliśmy w przepływy pracy (workflows). Po ich przygotowaniu możesz wysłać jedno żądanie, które zwróci landed cost na podstawie miejsca docelowego wysyłki, produktów w koszyku i szczegółów wysyłki.

Każdy przepływ pracy ma własne wymagane dane wejściowe. GraphQL pozwala przekazać więcej danych, niż jest to konieczne, ale do zwrócenia landed cost wymagane są tylko niektóre pola. Są one wyraźnie oznaczone w naszej dokumentacji API, gdzie znajdziesz też wszystkie dostępne pola.

Pamiętaj, że niektóre pola są wymagane warunkowo — jeśli chcesz, aby Twoje obliczenie było gwarantowane.

Poniżej wymieniliśmy wszystkie pola wymagane do obliczenia gwarantowanego landed cost. Upewnij się, że uwzględniasz te informacje, zanim wyślesz żądanie.

Pobierz landed cost przez API 

Gdy masz już wymagane dane wejściowe, wyślij mutację GraphQL do endpointu API, korzystając z wybranej biblioteki klienckiej lub narzędzia. Oto kilka przykładów struktury takiej mutacji.

Użyj tego żądania, jeśli Zonos ma obliczyć koszt wysyłki w ramach żądania Landed Cost. Następnie obliczymy cła i podatki od wysyłki, jeśli kraj docelowy je nalicza.

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 landed cost i otrzymaniu landedCostId w odpowiedzi API utwórz zamówienie, aby sfinalizować transakcję w systemie Zonos. Użyj mutacji orderCreate i przekaż w niej landedCostId ze swojej wyceny. Dowiedz się więcej o tworzeniu zamówień.

Pobierz landed cost w Dashboard 

Landed cost możesz też obliczać bezpośrednio w Zonos Dashboard, bez korzystania z API. Przydaje się to do testowania obliczeń, szkolenia zespołu lub szybkiego przygotowywania wycen w odpowiedzi na zapytania klientów.

Dashboard korzysta z tych samych endpointów API opisanych powyżej, więc wyniki będą zgodne z tymi, które otrzymasz, wywołując API bezpośrednio. Dzięki temu to świetny sposób na weryfikację integracji z API lub sprawdzenie, jak różne dane wejściowe wpływają na obliczenia.

Korzystanie z kalkulatora w Dashboard

Za pomocą kalkulatora landed cost w Dashboard możesz uzyskiwać wyceny z obliczonymi stawkami wysyłki, tworzyć wyceny ze znanymi kosztami wysyłki lub przetwarzać wiele wycen zbiorczo.

Użyj tego procesu, gdy znasz poziom usługi wysyłki i koszt wysyłki przesyłki.

  1. Przejdź do Dashboard → Orders → Quotes
  2. Kliknij New quote
  3. Opcjonalnie — zmień lokalizację adresu nadania
  4. Wybierz Destination country z listy rozwijanej
  5. Wprowadź kwotę wysyłki
    • Poziom usługi jest opcjonalny; jego dodanie pozwala nam obliczyć odpowiednie opłaty przewoźnika
  6. Dodaj szczegóły produktów w przesyłce
    • Po wpisaniu opisu automatycznie klasyfikujemy produkt i generujemy kod HS
    • W razie potrzeby możesz nadpisać wygenerowany kod HS
    • Aby dodać kilka produktów, kliknij Save and add another. W przeciwnym razie kliknij Save
  7. Opcjonalnie — kliknij More options, aby zmienić:
    • Typ sprzedaży na For resale
    • Tryb dostawy na Delivery duties unpaid
  8. Kliknij Get quote
    • Aby wprowadzić zmiany, kliknij Edit form i zmień wybrane szczegóły
    • Kliknij ponownie Get quote, aby zaktualizować wycenę

Po prawej stronie pojawi się wycena landed cost obejmująca koszty produktów, wysyłki i importu. Rozwiń wycenę, aby zobaczyć szczegółowe zestawienie produktów, wysyłki, ceł, podatków i opłat. Wszystkie wyceny są zapisywane na stronie wycen do wglądu w przyszłości.

Edycja istniejących wycen: Kliknij Quote again w prawym górnym rogu, aby zmodyfikować istniejącą wycenę zamiast tworzyć nową od podstaw.

Zalety korzystania z Dashboard

  • Bez programowania — generuj wyceny w przyjaznym interfejsie
  • Szkolenie zespołu — pomóż osobom bez wiedzy technicznej zrozumieć składowe landed cost
  • Weryfikacja API — sprawdź, czy integracja z API daje oczekiwane wyniki
  • Obsługa klienta — szybko przygotowuj wyceny w odpowiedzi na zapytania klientów
  • Przetwarzanie zbiorcze — sprawnie obsługuj wiele obliczeń naraz (wkrótce)

Wyceny w Dashboard zawierają te same szczegółowe zestawienia co odpowiedzi API, dzięki czemu Dashboard doskonale uzupełnia zautomatyzowaną integrację.

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 landed cost
  • Przygotuj żądanie
  • Pobierz landed cost przez API
  • Pobierz landed cost w Dashboard