Czym jest shipping w PrestaShop: strefy, przewoźnicy, przedziały

W PrestaShop koszt dostawy nie siedzi w jednym polu. To łańcuch czterech elementów, które muszą do siebie pasować:

• Strefa (Międzynarodowe → Lokalizacje → Strefy) — zbiór krajów, np. „Polska”, „UE”, „Reszta świata”. Jeden kraj może należeć do kilku stref, co później utrudnia diagnozę.
• Przewoźnik (Wysyłka → Przewoźnicy) — metoda dostawy: kurier, paczkomat, odbiór osobisty. Ma własne opóźnienie, podatek, limity wagi i przypisane strefy.
• Przedział wagowy lub cenowy — widełki typu 0–1 kg albo koszyk 200–500 zł, w których obowiązuje jedna opłata.
• Opłata — kwota za przedział, stała albo zależna od wagi czy wartości koszyka.

Kolejność działania jest zawsze taka sama: adres dostawy wyznacza strefę, strefa wskazuje dostępnych przewoźników, waga lub wartość koszyka wybiera przedział, z przedziału pobierana jest opłata, do opłaty doliczany jest VAT przewoźnika, a wynik jest zaokrąglany zgodnie z ustawieniami sklepu. Każdy z tych kroków potrafi wyczyścić listę metod: brak kraju w strefie, brak przedziału dla paczki 7,5 kg albo przewoźnik odznaczony dla strefy i klient na podsumowaniu widzi brak dostawy.

Koszt wysyłki zależy więc jednocześnie od adresu, wagi koszyka, jego wartości i stawki podatku przypisanej do przewoźnika. Dwie firmy z identyczną tabelą cennika kuriera mogą pokazać klientowi inne kwoty tylko dlatego, że jedna ustawiła przedziały cenowe, a druga wagowe — a trzecia dodała do tego geolokalizację zmieniającą domyślny kraj.

Struktura tych obiektów jest opisana w dokumentacji PrestaShop dla deweloperów. Jeśli wolisz, żeby strefy i przedziały poskładał ktoś, kto robi to na co dzień, zobacz nasze wdrożenia PrestaShop — konfigurację krok po kroku i integracje kurierskie opisujemy w pozostałych sekcjach.

Konfiguracja wysyłki w PrestaShop krok po kroku

Procedura od zera do działającego cennika. Ścieżki podaję dla panelu PrestaShop 8 i 9 — nazwy zakładek są takie same lub bardzo zbliżone.

1. Strefy — Międzynarodowe → Lokalizacje → Strefy. Zostaw jedną strefę dla Polski, jedną dla UE, jedną dla reszty świata. Nie rozbijaj UE na 27 stref, jeśli cennik jest wspólny.
2. Przewoźnicy — Wysyłka → Przewoźnicy → Dodaj nowego. Uzupełnij czas dostawy („1–2 dni”), sposób wyboru opłaty (waga lub cena), podatki oraz limity.
3. Przedziały — Wysyłka → Przedziały (osobno wagowe i cenowe). Zdefiniuj je raz, a potem przypisz do przewoźników.
4. Opłaty — na karcie przewoźnika w sekcji kosztów wysyłki wpisz kwotę dla każdej pary strefa + przedział. Puste pole oznacza brak metody, nie darmową dostawę.
5. Podatki — ustaw stawkę dla przewoźnika i sprawdź, czy kraj ma regułę podatkową. Stawka 0% w kraju UE bez numeru VAT to błąd, nie optymalizacja.
6. Geolokalizacja — Międzynarodowe → Geolokalizacja. Włączona potrafi podmienić kraj na podstawie IP i pokazać cennik zagraniczny Polakowi. Jeśli jej nie używasz, wyłącz.
7. Test — złóż zamówienie testowe z adresem polskim i zagranicznym, na wadze granicznej (5 kg, 10 kg) i tuż pod darmową dostawą.

Ustawienia zaawansowane: darmowa dostawa przez opłatę 0 zł plus warunek w Promocje → Reguły koszyka („Wysyłka za darmo” od kwoty), obsługa dużych paczek przez limit maksymalnej wagi u przewoźnika i osobny przedział, opóźnienia przez pole czasu dostawy. Zrób zrzuty ekranu z zakładek: Przewoźnicy, Przedziały, koszt wysyłki dla strefy oraz podsumowanie koszyka z brakującą metodą — to dokumentacja, do której wrócisz przy każdej zmianie cennika. Wdrożenie integracji kurierskiej bez przestoju w zamówieniach opisujemy w tekście wdrożenie InPost w PrestaShop krok po kroku.

Strefy i przedziały wagowe bez błędów

Najczęstsza awaria to dziura między przedziałami. Jeśli zdefiniujesz 1–5 kg i 6–10 kg, paczka 5,5 kg nie trafi do żadnego z nich i klient zobaczy brak metody dostawy. Przedziały powinny stykać się dokładnie: 0–1, 1–5, 5–10, 10–20 kg. Wtedy paczka 5 kg trafia do jednego, z góry ustalonego progu — sprawdź to testem, bo przy wartościach granicznych łatwo o niespodziankę.

Strefy i przedziały wagowe bez błędów — ciąg dalszy

Jak wykryć lukę: zbuduj koszyk o wadze dokładnie 1,00 kg, 5,00 kg, 10,00 kg i 10,01 kg. Jeśli przy którejś z tych wartości lista przewoźników jest pusta, brakuje przedziału. Ta sama zasada dotyczy przedziałów cenowych — 199,99 zł i 200,00 zł to dwa różne koszyki i mogą dostać różną opłatę.

VAT i zaokrąglenia zmieniają kwotę, którą widzi klient. Opłata za wysyłkę jest osobną pozycją koszyka, a PrestaShop liczy podatek od każdej pozycji osobno i zaokrągla zgodnie z ustawieniami w Parametry sklepu → Ustawienia ogólne (typ zaokrąglenia i sposób: dla każdej pozycji albo dla całości). Przy cenniku 12,00 zł netto klient zapłaci 14,76 zł, ale przy kilku pozycjach i zaokrąglaniu od sumy różnica sięga kilku groszy. Jeśli wystawiasz faktury z cennika netto, ustal jeden tryb zaokrągleń i nie zmieniaj go sezonowo.

Brak strefy dla kraju objawia się komunikatem o braku dostępnych przewoźników dla wybranego adresu, a przy płatnościach ograniczonych przewoźnikiem — także zniknięciem metod płatności. Kolejność naprawy jest krótka:

• Międzynarodowe → Lokalizacje → Strefy: sprawdź, czy kraj jest przypisany do strefy.
• Wysyłka → Przewoźnicy: na karcie przewoźnika upewnij się, że strefa jest zaznaczona.
• Sprawdź, czy przewoźnik ma przedział obejmujący wagę koszyka — nawet poprawna strefa nic nie da bez przedziału.
• Wyczyść cache i sprawdź koszyk w trybie incognito.

Integracje kurierskie: InPost, DPD, DHL

Masz trzy realne warianty. Oficjalny moduł od przewoźnika: instalujesz z panelu nadawczego, wklejasz klucze API, konfigurujesz domyślne gabaryty i gotowe. Zakres: etykiety A6 w PDF, numer trackingowy, punkty odbioru w checkoutcie. Koszt zwykle zero, wdrożenie 1–3 dni. Ryzyko: tempo aktualizacji pod nowe wersje PrestaShop bywa różne, a wsparcie idzie przez przewoźnika, nie przez Twojego wykonawcę.

Moduł płatny od zewnętrznego dostawcy: jeden panel do kilku kurierów, polskie wsparcie, częstsze wydania poprawek. Koszt to zwykle kilkaset złotych jednorazowo plus subskrypcja. Ma sens, gdy wysyłasz dwoma–trzema kurierami i chcesz jedno miejsce do nadawania i zwrotów.

Własny moduł na API: pełna kontrola, ale utrzymanie po Twojej stronie — rotacja tokenów, mapowanie statusów przesyłki na statusy zamówienia, limity zapytań, zmiany wersji API. Realnie 1–2 tygodnie pracy plus poprawki po każdej zmianie po stronie przewoźnika. Opłaca się przy nietypowej logice, np. własnym algorytmie wyboru kuriera po wadze i strefie.

Niezależnie od wariantu wdrożenie musi objąć cztery elementy: etykiety generowane z poziomu zamówienia, numer trackingowy zapisany w zamówieniu i wysyłany mailem, wybór punktu odbioru (widget mapy przy przewoźniku) oraz statusy zamówień. Bez mapowania statusów klient nie dostaje informacji „wysłane” i pisze na czacie. Osobno zaplanuj zwroty i nadania zwrotne. Szczegóły dla paczkomatów opisujemy w tekstach o wdrożeniu InPost w PrestaShop krok po kroku oraz o InPost i PrestaShop 9 bez przestojów.

Darmowa dostawa i progi koszyka

Próg darmowej dostawy ustawia się raz i wraca do niego co kwartał. Punkt wyjścia to trzy liczby: średnia wartość koszyka (AOV), koszt wysyłki netto i marża procentowa na produkcie. Przykład: AOV 180 zł, marża 35%, koszt kuriera 15 zł netto. Dodatkowe zakupy muszą wygenerować co najmniej 15 zł marży, czyli około 43 zł wartości koszyka. Próg 200 zł jest w tym układzie stratny o kilka złotych na zamówienie — przy 300 zamówieniach miesięcznie robi się z tego poważna kwota w skali roku.

Wzór do zapisania: próg ≈ koszt wysyłki / marża procentowa + obecne AOV, zaokrąglony w górę do „ładnej” kwoty. Policz to samo dla paczkomatu (tańszy koszt = niższy próg) i dla przesyłki pobraniowej, gdzie dochodzi opłata za pobranie.

Reguły koszyka: Katalog → Rabaty i promocje → nowa reguła, warunek „Wartość koszyka >= próg”, akcja „Darmowa dostawa”. Pułapka: kod rabatowy obniża wartość koszyka. Klient z kodem -20 zł spada poniżej progu, darmowa dostawa znika, a on porzuca koszyk. Sprawdź też, czy reguła nie nakłada się na inną promocję i nie daje darmowej wysyłki dwa razy.

Test: w trybie gościa złóż zamówienie dla każdej strefy i każdego przewoźnika — Polska, UE, strefa „reszta świata”, kurier, paczkomat, pobranie. Sprawdź, czy próg działa identycznie i czy podatek nie rozjeżdża kwoty końcowej o kilka groszy.

Ryzyko: paczki ponadstandardowe (gabaryt lub waga powyżej limitu standardowego) jadą po cenie zwykłej przesyłki, choć koszt rzeczywisty bywa kilkukrotnie wyższy. Rozwiązanie: osobny przewoźnik „Przesyłka gabarytowa” z wyższą stawką i wyłączeniem z reguły darmowej dostawy. Kontekst techniczny znajdziesz w dokumentacji dla deweloperów PrestaShop, a szerszy obraz zmian w zakładce o PrestaShop.

Płatność za pobraniem i opłaty dodatkowe

PrestaShop nie ma natywnego pola „opłata za pobranie”. W praktyce widzimy dwa podejścia. Opłata w koszcie przewoźnika: duplikujesz przewoźnika jako „Kurier — pobranie” i w jego cenniku ustawiasz stawkę wyższą o kwotę opłaty, np. 18 zł zamiast 15 zł. Plus: zero modułów, działa od razu. Minus: klient widzi „Wysyłka 18 zł”, a nie „pobranie 3 zł”, więc pojawiają się pytania na czacie.

Osobna pozycja w koszyku: moduł dopinający opłatę albo override klasy liczącej koszyk. Plus: czytelny koszyk z rozbiciem. Minus: do utrzymania przy aktualizacjach, dlatego lepiej wybrać moduł niż własny override — o nadpisywaniu kodu bez błędów piszemy w tekście o PrestaShop override.

VAT: sposób opodatkowania opłaty za pobranie zależy od tego, czy traktujesz ją jako element dostawy, czy jako odrębną usługę — spotykamy w firmach obie interpretacje. Nie zgaduj: ustal to z księgową, a potem ustaw spójnie regułę podatkową dla przewoźnika w Ustawienia → Podatki i pilnuj, czy ceny w cenniku wpisujesz netto czy brutto.

Ograniczenia: maksymalną kwotę pobrania ustala umowa z przewoźnikiem — sprawdź ją przed włączeniem metody. Nie każdy kurier obsługuje pobranie za granicę, a jeśli obsługuje, dochodzi opłata dodatkowa. Ogranicz metodę do wybranych krajów i przewoźników zamiast włączać ją globalnie.

Kolejność naliczania: 1) rabaty obniżają wartość towarów, 2) doliczany jest koszt wysyłki, 3) dochodzi opłata za pobranie, 4) VAT liczony jest od całości. Odwrotna kolejność — np. pobranie liczone od kwoty po rabacie, a wysyłka przed rabatem — rozjeżdża koszyk o kilka groszy i klient to zauważy.

Wydajność, cache i override przy zmianach wysyłki

Zmiana przewoźnika w działającym sklepie najczęściej kończy się zgłoszeniem „klient nie widzi mojej metody dostawy”. W większości przypadków winny jest cache, a nie konfiguracja. Kolejność czyszczenia ma znaczenie, bo warstw jest kilka.

• Cache PrestaShop — Parametry zaawansowane → Wydajność → „Wyczyść cache”. Jeśli edytujesz szablony, tymczasowo ustaw kompilację szablonów na „Wymuszaj kompilację”.
• Cache Smarty — opróżnij zawartość katalogu var/cache/{prod|dev}/smarty/compile, nie ruszając plików źródłowych w katalogu themes/.
• OPcache — po edycji plików PHP i override klas zrestartuj php-fpm (albo wywołaj opcache_reset()). Bez tego serwer nadal wykonuje stary kod.
• Cache CDN — purge całej strefy. Reguły cache nie mogą obejmować koszyka i stron zamówienia; cache CDN na stronach statycznych pomaga w Core Web Vitals, ale w koszyku grozi pokazaniem stawki innego klienta.

Override klas to druga pułapka. Nadpisanie Carrier.php czy Cart.php w katalogu override/classes/ działa do pierwszego upgrade'u, a gdy dwa moduły nadpisują tę samą klasę, wygrywa ostatni i pierwszy po cichu przestaje działać. Sięgaj po override tylko wtedy, gdy nie ma hooka — a przy wysyłce hooków jest sporo: actionCarrierProcess, actionValidateOrder, actionCartSave. Zasady i typowe błędy zebraliśmy w artykule PrestaShop override: jak nadpisywać kod bez błędów.

Diagnostyka w praktyce: włącz _PS_MODE_DEV_ w config/defines.inc.php, sprawdź logi w var/logs/, a potem złóż testowy koszyk z produktem o wadze granicznej (np. 1,00 kg przy przedziale 1–5 kg). Po testach wyłącz tryb debug — pokazuje błędy klientom i potrafi psuć AJAX koszyka.

Migracja metod wysyłki z PrestaShop 1.7 do 8/9

Sama lista przewoźników przenosi się dobrze. Psuje się to, co wokół: moduły kurierskie, pobranie i mapowanie statusów.

Do przeniesienia są konkretne tabele: ps_carrier, ps_carrier_lang, ps_carrier_shop, ps_carrier_group, ps_carrier_tax_rules_group_shop, ps_zone, ps_range_weight, ps_range_price i ps_delivery. Kluczowa zasada: zachowaj te same ID, bo ps_delivery wskazuje jednocześnie na przewoźnika, strefę i przedział. Jeśli w nowym sklepie najpierw dodasz przewoźników ręcznie, ID się rozjadą i macierz stawek wskaże na obcego przewoźnika. Najbezpieczniej zaimportować tabele na czystą instalację, zanim dopiszesz własnych przewoźników, i dopiero wtedy zweryfikować ceny.

Moduły kurierskie: sprawdź deklarację kompatybilności w pliku konfiguracyjnym modułu (ps_versions_compliancy) oraz to, czy panel działa w oparciu o Symfony. Moduł z 1.7 potrafi wyłączyć się bez komunikatu i zostawić sklep bez generowania etykiet. Organizację takiego wdrożenia opisujemy w tekście InPost i PrestaShop 9: organizacja wdrożenia bez przestojów. Warto zajrzeć też do dokumentacji dla deweloperów PrestaShop przy weryfikacji struktury tabel.

Testy po migracji, minimum pięć zamówień: etykieta generuje się i drukuje, numer tracking wraca do zamówienia i do maila, koszyk pokazuje właściwą stawkę w każdej strefie, faktura zawiera koszt dostawy zgodny z zapłatą, statusy przechodzą przez wszystkie etapy. Sprawdź wartości graniczne wag: 0,99 kg, 1,00 kg, 1,01 kg — tam najczęściej wychodzą luki w przedziałach. Przed migracją zrób backup bazy i plików oraz eksport listy przewoźników z zakresami do CSV jako punkt odniesienia.

Checklista wdrożenia i audyt wysyłki

Poniższa lista ma 14 punktów. Pierwsze dziewięć odklikaj przed startem, pozostałe pięć to monitoring po wdrożeniu. Przejście przez całość zajmuje zwykle 2–3 godziny i łapie 2–3 błędy, które inaczej wyszłyby dopiero w koszykach klientów.

1. Strefy pokrywają wszystkie kraje, do których wysyłasz; strefy nie nakładają się na siebie.
2. Każdy przewoźnik ma uzupełniony czas dostawy, logo, zakresy i grupę podatkową.
3. Przedziały wagowe i cenowe są ciągłe — żadna waga nie trafia w lukę.
4. Pole „waga” jest wypełnione we wszystkich produktach; uwzględnij wagę opakowania.
5. Darmowa wysyłka sprawdzona dla koszyka tuż poniżej i tuż powyżej progu.
6. Reguły podatkowe przewoźnika zgodne ze stawką (23% kraj, 0% WDT).
7. Pobranie doliczane raz, bez dublowania z kosztem przewoźnika.
8. Ograniczenia przewoźnik × metoda płatności (np. paczkomat i przelew) ustawione i przetestowane.
9. Integracja kurierska generuje etykietę i druk zbiorczy.
10. Numer tracking wraca do zamówienia i trafia do maila „wysłane”.
11. Statusy zamówień mapują się na etapy u kuriera.
12. Faktura pokazuje koszt dostawy zgodny z tym, co zapłacił klient.
13. Cache i sesje odświeżają metody dostawy po zmianach.
14. Przez 7 dni po wdrożeniu sprawdzasz logi w var/logs/ i krok dostawy w statystykach koszyków.

Kryteria akceptacji są trzy: brak błędów w koszyku, poprawna etykieta i zgodny tracking. Jeśli którykolwiek punkt nie przechodzi, nie wdrażaj dalej. Pełny zakres prac — konfigurację, integracje i stronę serwerową — opisujemy w sekcji PrestaShop.

Najczęstsze błędy i jak je wykryć

Lista kontrolna do odklikania

• Strefy pokrywają wszystkie kraje sprzedaży — Międzynarodowe → Lokalizacja → Strefy. Sprawdź to przed każdą kampanią kierowaną za granicę.
• Każdy przewoźnik ma przypisane strefy — Międzynarodowe → Wysyłka → Przewoźnicy. Przewoźnik bez strefy jest niewidoczny w koszyku.
• Przedziały wagowe są ciągłe, bez luk — Testuj wagi graniczne: 1,00 kg, 1,01 kg, 5,00 kg, 5,01 kg i wartość powyżej najwyższego progu.
• Przedziały cenowe ustawione tam, gdzie stawka zależy od wartości koszyka — Sprawdź koszyk poniżej i powyżej progu cenowego; zwróć uwagę na kolejność: najpierw rabat, potem próg.
• Opłaty dodatkowe (pobranie, obsługa) są przypisane do przewoźnika — Zamów testowe z pobraniem i sprawdź, czy opłata pojawia się jako osobna, opodatkowana pozycja.
• Podatek przewoźnika zgadza się ze strefą podatkową — Weryfikuj przy zmianie stawek VAT i przy wejściu na nowy rynek.
• Geolokalizacja nie blokuje stref — Jeśli korzystasz z geolokalizacji, sprawdź koszyk z adresem zagranicznym i po wyczyszczeniu ciasteczek.
• Próg darmowej dostawy ustawiony per strefa — Testuj kwotę tuż poniżej i dokładnie na progu — to najczęstsze miejsce błędów zaokrągleń.
• Paczki ponadstandardowe mają własną regułę — Sprawdź zachowanie koszyka powyżej limitu wagi i wymiarów przewoźnika.
• Zamówienie testowe z adresem polskim — Przejdź pełną ścieżkę: koszyk, wybór przewoźnika, płatność, mail potwierdzający, faktura.
• Zamówienie testowe z adresem zagranicznym — Tylko dla krajów, do których realnie wysyłasz. Sprawdź stawkę i czas dostawy.
• Cache wyczyszczony po każdej zmianie wysyłki — Cache PrestaShop, Smarty i CDN. Weryfikacja zawsze w trybie incognito.
• Logi i tryb debug przy nietypowych błędach — Włączaj tylko na czas testu i wyłączaj po zakończeniu — debug na produkcji spowalnia sklep.
• Wysyłka przetestowana po migracji z 1.7 na 8 lub 9 — Po aktualizacji powtórz cały test koszyka, także dla zamówień z pobraniem i z kodem rabatowym.

Najczęściej zadawane pytania

Źródła i materiały

• Google Search Central – tworzenie treści dla ludzi
• Google Search Central – dane strukturalne
• Google Search Central – Core Web Vitals
• PrestaShop – dokumentacja dla deweloperów
• Google Ads – dokumentacja API