Wycena wysyłki

Wycena wysyłki pozwala Twojemu sklepowi internetowemu pokazywać klientom w koszyku aktualne ceny wysyłki na podstawie Twoich reguł wysyłki. Zippendo nie ma własnego koszyka: ceny pojawiają się w Twoim sklepie internetowym, przez Zippendo Shipping w Shopify, wtyczkę Zippendo for WooCommerce albo wywołanie API wyceny wysyłki z Twojego własnego sklepu. Każda cena, którą widzi klient, pochodzi z jednej z Twoich reguł wysyłki. Bez reguły wysyłki dla przesyłek wychodzących do kraju klienta koszyk nie pokazuje cen Zippendo. Przewodnik krok po kroku (połączenie sklepu internetowego, wybór reguł, test w sklepie): Koszyk. Ceny się nie pokazują: Wycena wysyłki nie zwraca stawek.

Przycisk Testuj przy regule wysyłki sprawdza, czy ta reguła pasowałaby do koszyka. Nie pyta przewoźnika o cenę. Zippendo nie ma podglądu Twojego koszyka.

Czego potrzebujesz na początek

Połącz sklep internetowy albo utwórz token API

Połącz Shopify lub WooCommerce w sekcji Kanały sprzedaży. Dla własnego sklepu utwórz token API z uprawnieniem Wyświetlanie reguł wysyłki.

Połącz swoich przewoźników

Zobacz Dane dostępowe przewoźnika. Każda reguła wysyłki używa produktu połączonego przewoźnika.

Dodaj reguły wysyłki dla przesyłek wychodzących

Nazwij każdą regułę tak, jak klienci mają ją czytać w koszyku. Ustaw kraje, do których wysyła, oraz limity ceny lub wagi. Zobacz Pola reguły wysyłki.

Lista reguł wysyłki z wychodzącymi regułami GLS i PostNord — Twoje reguły wysyłki to opcje wysyłki pokazywane w koszyku

Shopify: Stawki wysyłki w koszyku

Otwórz swój kanał sprzedaży Shopify w sekcji Kanały sprzedaży. Na karcie Zamówienia i koszyk przewiń do Stawki wysyłki w koszyku. Wszystkie ustawienia Shopify: Ustawienia Shopify. Instalacja aplikacji: Połącz Shopify. Karta mówi: Wybierz reguły wysyłki, spośród których klienci mogą wybierać w koszyku Shopify. Jeśli nie wybierzesz żadnej, używane są wszystkie reguły wysyłki pasujące do kraju odbiorcy. Reguła wysyłki z dostawą do punktów odbioru pokazuje każdy punkt odbioru jako osobną stawkę.

Pole	Co zrobić
Reguły wysyłki	Zaznacz reguły, które Shopify ma oferować. Każdy wiersz pokazuje nazwę reguły, jej przewoźnika i kraje oraz opis. Jeśli nie ma jeszcze reguł, karta pokazuje Brak reguł wysyłki. Utwórz regułę w sekcji „Reguły wysyłki” w menu.
Punkty odbioru w koszyku	Ile punktów odbioru łącznie pokazywać w koszyku. Są dzielone po równo między reguły wysyłki z dostawą do punktu odbioru. Liczba od 1 do 20. Domyślnie 6.
Zapisz zmiany	Zapisuje Twoje wybory. Jest wyszarzone, dopóki czegoś nie zmienisz.

Więcej o punktach odbioru w koszyku: Punkty odbioru.

Stawki wysyłki w koszyku z polami wyboru reguł wysyłki i Punktami odbioru w koszyku ustawionymi na 6 — Stawki wysyłki w koszyku: zaznacz reguły, które Shopify ma oferować, i ustaw Punkty odbioru w koszyku

Zarejestruj Zippendo Shipping w Shopify

Otwórz kartę Połączenie i integracja. Na karcie Usługa przewoźnika:

Element	Co robi
Sprawdź usługę przewoźnika → Sprawdź status	Sprawdza, czy Zippendo jest zarejestrowany w Shopify do aktualnych cen wysyłki. Zobaczysz „Znaleziono 1 usługę przewoźnika” albo Nie zarejestrowano usługi przewoźnika. Stawki wysyłki nie pojawią się w koszyku.
Zarejestruj usługę przewoźnika	Rejestruje Zippendo w Shopify albo rejestruje go ponownie. Potrzebne do aktualnych cen wysyłki w koszyku.

Karta przypomina też: po rejestracji przejdź do Shopify admin → Settings → Shipping and delivery i dodaj „Zippendo Shipping” jako dostawcę stawek w swoich strefach wysyłki.

Dopóki Zippendo Shipping nie zostanie dodany do Twoich stref wysyłki w Shopify, klienci nie zobaczą cen Zippendo, nawet jeśli Sprawdź status znajdzie usługę przewoźnika, a Twoje reguły są zaznaczone.

Karta Połączenie i integracja w Shopify z kartą Usługa przewoźnika, Sprawdź status i Zarejestruj usługę przewoźnika — Usługa przewoźnika: Sprawdź status i Zarejestruj usługę przewoźnika

Sklepy Shopify bez obliczanych cen wysyłki mogą zamiast tego powiązać nazwy własnych metod dostawy Shopify z regułami wysyłki. To nie pokazuje aktualnych cen; jedynie przypisuje właściwą regułę do każdego zamówienia przy imporcie. Zobacz mapowanie metod dostawy w Ustawieniach Shopify.

WooCommerce: Token kasy

WooCommerce pokazuje aktualne ceny przez wtyczkę Zippendo for WooCommerce i Token kasy (zaczyna się od zck_). Najpierw połącz sklep internetowy: Połącz WooCommerce. Otwórz swój kanał sprzedaży WooCommerce. Na karcie Zamówienia i koszyk znajdź kartę Token kasy: Wtyczka Zippendo for WooCommerce pokazuje w koszyku aktualne stawki wysyłki i punkty odbioru. Zainstaluj wtyczkę, a potem wklej ten token w jej ustawieniach.

Element	Co robi
Pobierz wtyczkę	Pobiera najnowszą wtyczkę jako plik `.zip` do zainstalowania w WordPress.
Wygeneruj token	Tworzy Twój pierwszy token i pokazuje go jeden raz.
Kopiuj	Kopiuje token. Zobaczysz Skopiowano token do schowka.
Zastąp token	Zastępuje token. Zippendo pyta: Zastąpić token kasy? Obecny token natychmiast przestanie działać i trzeba będzie wkleić nowy do wtyczki.
Unieważnij	Wyłącza token. Zippendo pyta: Unieważnić token kasy? Wtyczka przestanie działać, dopóki nie wygenerujesz nowego tokena. Potem zobaczysz Unieważniono token kasy.

Zaraz po wygenerowaniu lub zastąpieniu tokena karta ostrzega: Skopiuj ten token teraz. Później nie będzie można go zobaczyć, ponieważ Zippendo nie przechowuje jego czytelnej kopii. Wklej go w ustawieniach wtyczki w WordPress. Gdy token już istnieje, karta pokazuje, kiedy został utworzony. Jeśli coś się nie uda, zobaczysz Nie udało się wygenerować tokena kasy lub Nie udało się unieważnić tokena kasy. Wtyczka prosi Zippendo o ceny za pomocą tego tokena, zarówno dla opcji wysyłki, jak i dla pobliskich punktów odbioru, gdy klient zmienia kod pocztowy. Nie używa tokenu API. Testuj połączenie na karcie Połączenie sprawdza tylko klucze WooCommerce używane do importu zamówień.

Karta Token kasy z jednorazowym ostrzeżeniem, tokenem zck_, przyciskami Kopiuj, Unieważnij i Zastąp token — Token kasy: skopiuj token zck_ jeden raz, a potem wklej go do wtyczki

Twój własny sklep: API wyceny wysyłki

Własny kanał sprzedaży wysyła zamówienia do Zippendo, ale nie pokazuje cen w Twoim koszyku. Aby pokazywać aktualne ceny w sklepie, który budujesz samodzielnie, wywołaj:

POST /orgs/{orgId}/shipping-quote
Authorization: Bearer zipp_YOUR_TOKEN

{orgId} to ID Twojej organizacji, a nie nazwa z paska adresu aplikacji. Token potrzebuje uprawnienia Wyświetlanie reguł wysyłki: Tworzenie tokenu API. Gotowe klienty: Pakiety SDK. Wypróbuj w dokumentacji API.

Treść żądania

Pole	Wymagane	Uwagi
`destination.country`	Tak	Dwuliterowy kod kraju (ISO 3166-1 alpha-2), na przykład `DK`
`destination.postalCode`	Nie	Na przykład `1620`
`destination.province`	Nie	Kod stanu lub prowincji
`destination.city`	Nie	Na przykład `København`
`destination.address1` / `address2`	Nie	Wiersze ulicy
`items`	Tak, co najmniej jedna	Pozycje koszyka
`items[].name`	Tak	Na przykład `Uld trøje`
`items[].quantity`	Tak	Liczba całkowita, 1 lub więcej
`items[].grams`	Tak	Waga w gramach, 0 lub więcej
`items[].price`	Tak	Cena jednostkowa w groszach (øre), 0 lub więcej
`items[].sku` / `productId` / `variantId`	Nie
`currency`	Tak	Trzyliterowy kod waluty (ISO 4217), na przykład `DKK`
`totalPriceCents`	Nie	Suma koszyka po rabatach, w groszach. Pozwala regułom z limitem wartości zamówienia używać sumy po rabatach.

{
  "destination": {
    "country": "DK",
    "postalCode": "2100",
    "city": "Copenhagen"
  },
  "items": [
    {
      "name": "T-shirt",
      "quantity": 1,
      "grams": 250,
      "price": 29900
    }
  ],
  "currency": "DKK"
}

Zippendo sumuje grams × quantity i price × quantity po wszystkich pozycjach, a potem sprawdza każdą regułę wysyłki, która wysyła do destination.country. Każda pasująca reguła staje się stawką. Jeśli żadna reguła nie pasuje, dostajesz { "rates": [] } ze statusem 200, a nie błąd.

Obiekt stawki

Pole	Co to jest
`serviceName`	Nazwa reguły, tak jak ma ją widzieć klient
`serviceCode`	`{carrierSlug}:{productId}:{shippingRuleId}`
`totalPrice`	Cena wysyłki w groszach, jako tekst
`currency`	Trzyliterowy kod waluty
`description`	Opis reguły, jeśli go ma
`carrierName` / `carrierSlug` / `productId`	Przewoźnik i produkt reguły
`shippingRuleId`	Reguła, która wygenerowała stawkę
`minDeliveryDate` / `maxDeliveryDate`	Przewidywane daty dostawy, jeśli reguła je ma

Nieprawidłowy kraj lub treść zwraca 400 z { error, message }, na przykład Invalid destination country. Nieznana organizacja zwraca 404. Przykładowy kod: Szybki start z wycenami wysyłki.

Jak testować

Zippendo nie ma podglądu Twojego koszyka. Testuj w swoim sklepie internetowym:

Sklep internetowy	W Zippendo	W Twoim sklepie internetowym
Shopify	Zaznacz reguły, ustaw liczbę punktów odbioru, kliknij Sprawdź status	Przejdź przez koszyk, gdy Zippendo Shipping jest w Twojej strefie wysyłki
WooCommerce	Wygeneruj token	Wklej token w ustawieniach wtyczki i wypełnij koszyk
Twój własny sklep	Testuj przy regule wysyłki (sprawdza tylko regułę)	Wywołaj API wyceny wysyłki z przykładowym koszykiem

Jeśli brakuje ceny, sprawdź Kraje docelowe reguły, jej limity wagi i wartości zamówienia oraz inne ustawienia, zanim zaczniesz podejrzewać przewoźnika.

Gotowe, gdy Stawki wysyłki w koszyku w Shopify zawierają reguły, które chcesz (a Zippendo Shipping jest w Twojej strefie wysyłki), albo WooCommerce ma aktywny Token kasy wklejony do wtyczki, albo API wyceny wysyłki zwraca rates dla przykładowego koszyka.

Przegląd

Przesyłki

Zamówienia i kanały

Przewoźnicy

Połącz przewoźnika

Połącz integrację

Drukowanie

Automatyzacja

Konto

Wyszukiwanie i panel

API i zdarzenia

Czego potrzebujesz na początek