Bezpieczne nadawanie i odbieranie przesyłek to nie jedna wtyczka, a kilka procesów: konfiguracja metod dostawy, pakowanie, weryfikacja danych odbiorcy i procedura reklamacyjna. Ten artykuł dotyczy warstwy organizacyjnej, czyli tego, co dzieje się poza kodem, a najczęściej decyduje o tym, czy reklamacja zostanie uznana. Poniżej znajdziesz typowe błędy, checklistę wdrożeniową i odpowiedzi na pytania, które wracają w rozmowach z naszymi klientami.
W praktyce sklepu „bezpiecznie” znaczy jedno: paczka dociera, a jeśli nie dociera — masz dowody, żeby reklamację rozpatrzyć bez straty. To nie jest jedna funkcja do włączenia, a trzy niezależne warstwy. Najczęstszy błąd to szukanie problemu w kodzie, gdy faktycznie leży on w pakowaniu albo w braku procedury zwrotu. Zanim cokolwiek zmienisz, ustal, w której warstwie jest twój problem.
Druga rzecz to perspektywa. Sklep jest nadawcą, klient odbiorcą — ale przy zwrocie role się odwracają: klient nadaje, sklep odbiera. Jeśli nie masz procedury przyjęcia zwrotu (kto otwiera, co sprawdza, w jakim terminie rozlicza), „zgubione” zwroty będą się pojawiać regularnie, mimo że technicznie wszystko działa.
W dalszej części artykułu przejdziesz przez konfigurację integracji z InPost, DPD i DHL, wybór przewoźnika i metody dostawy pod konkretne zamówienie, zasady pakowania, obsługę reklamacji oraz realne koszty, które trzeba policzyć przed podpisaniem umowy.
Konfiguracja ma sens wtedy, gdy zrobisz ją w całości przed pierwszym zamówieniem. Poniżej kolejność, która oszczędza najwięcej czasu — punkty 1 i 4 pomijane najczęściej, a kosztują najwięcej.
Przy zmianie adresu sklepu pamiętaj, że webhooki i klucze API wskazują na stary adres — zobacz, jak bezpiecznie przeprowadzić zmianę domeny WordPress.
| Element konfiguracji | Gdzie szukać | Objaw pominięcia |
|---|---|---|
| Klucze API (test / produkcja) | Konfiguracja modułu przewoźnika | Błędy autoryzacji, brak etykiet |
| Numer klienta i umowy | Dane konta w panelu przewoźnika | Nie można wygenerować etykiety |
| Mapowanie metod dostawy | PrestaShop: Zamówienia > Przewoźnicy; WooCommerce: Ustawienia > Wysyłka | Zły cennik, etykiety na niewłaściwą usługę |
| Waga i wymiary produktów | Karta produktu (zakładka wysyłki) | Dopłata za gabaryt po stronie sklepu |
| Webhooki statusów | Konfiguracja API / integracje | Statusy zamówień niezgodne ze stanem faktycznym |
Metodę dostawy dobiera się do konkretnego zamówienia, nie do preferencji sklepu. Cztery zmienne decydują o wszystkim: waga, wymiary, wartość koszyka i typ klienta.
Limity. Typowy paczkomat przyjmuje przesyłki do 25 kg, a największy standardowy skrytka ma ok. 41 × 38 × 64 cm. Wartości te potwierdź w aktualnym cenniku przewoźnika — zmieniają się rzadziej niż ceny, ale się zdarzają. Co się dzieje po przekroczeniu limitu? Trzy scenariusze: paczka wraca do sklepu (płacisz dwa razy), przewoźnik dolicza dopłatę za gabaryt (płaci sklep), albo przesyłka trafia na awizo i klient odbiera ją po kilku dniach zniechęcony.
Kiedy paczkomat wygrywa. Małe i średnie paczki, klienci B2C, dostawa poza godzinami pracy sklepu, produkty odporne na wstrząsy. Kiedy przegrywa. Sprzęt kruchy, produkty ciężkie, zamówienia wysokowartościowe — tu klient chce kwitu odbioru i rozmowy z kurierem, a nie skrytki o 23:00.
Kurier zostaje dla zamówień B2B (faktura, stałe godziny dostaw), droższych koszyków oraz przesyłek pobraniowych z ubezpieczeniem. Punkt odbioru to rozwiązanie dla klientów bez paczkomatu w okolicy — wydłuża dostawę o 1–2 dni robocze, ale ratuje zamówienia z obszarów wiejskich.
Na koniec konfiguracja: dostępne metody muszą być filtrowane po produkcie. W WooCommerce robi się to klasami wysyłki, w PrestaShop — regułami przewoźnika po wadze i wymiarach. Bez tego klient bez problemu wybierze paczkomat dla 40-kilogramowego zamówienia, a ty zapłacisz za zwrot.
| Kryterium | Paczkomat | Kurier | Punkt odbioru |
|---|---|---|---|
| Waga do 25 kg | Tak | Tak | Zwykle tak (sprawdź cennik) |
| Produkty kruche | Nie zalecane | Zalecane | Ryzykowne |
| Wysoka wartość / kwit odbioru | Nie | Tak | Ograniczone |
| Klient B2B | Rzadko | Tak | Nie |
| Pobranie | Dostępne, sprawdź limit kwoty | Tak | Dostępne, sprawdź limit kwoty |
| Czas dostawy | Zwykle 1–2 dni | Zwykle 1 dzień | 1–2 dni dłużej niż paczkomat |
Zasada pierwsza: opakowanie dobierasz do zawartości, nie do rozmiaru kartonu, który akurat leży na magazynie. Paczka, która „jakoś się zamknie”, to najkrótsza droga do odrzuconej reklamacji.
Ubezpieczenie i deklaracja wartości mają sens, gdy towar przekracza standardowy limit odpowiedzialności przewoźnika (zwykle kwotowy albo wagowy – sprawdź go w regulaminie, bo właśnie on decyduje o wypłacie). Przy przesyłce za kilkaset złotych ubezpieczenie kosztuje kilka złotych, ale przy sporze o towar za kilka tysięcy bez deklaracji odzyskasz tylko część kwoty.
Dowody zbieraj wszystkie naraz: numer przesyłki i link do śledzenia wpisany do zamówienia, paragon lub faktura za usługę, zdjęcie zapakowanej paczki z widoczną etykietą (numer i waga), a przy odbiorze partii przez kuriera – protokół przekazania z liczbą sztuk i podpisem. Waga z etykiety jest przy sporze o „brak towaru” jedynym twardym dowodem po stronie nadawcy.
Przed nadaniem zweryfikuj trzy pola: kod pocztowy razem z miastem, numer telefonu odbiorcy i adres e-mail. Brak telefonu to najczęstsza przyczyna nieodebrania przesyłki w paczkomacie. I zasada twarda: paczka nie wychodzi z magazynu, jeśli w systemie nie ma jej numeru i statusu – bez tego nie masz podstawy do reklamacji.
| Typ zawartości | Pakowanie | Najczęstszy błąd |
|---|---|---|
| Płyny | Worek strunowy, taśma na nakrętce, drugi karton, 3–5 cm wypełnienia | Jedno opakowanie bez zabezpieczenia nakrętki |
| Elektronika | 2 warstwy folii bąbelkowej, 5 cm dystansu, pełne wypełnienie | Luźne akcesoria w tej samej komorze co urządzenie |
| Produkty sypkie | Podwójny worek, karton wypełniony do pełna | Puste miejsce w kartonie |
| Ostre elementy | Osłona z tektury, kątowniki, taśma na całym obwodzie | Brak zabezpieczenia krawędzi |
Zanim podpiszesz odbiór, oceń karton. Zagniecenie, ślad wilgoci, rozerwana taśma – wtedy otwierasz przesyłkę przy doręczycielu i spisujesz protokół szkody. Ten jeden dokument waży więcej niż tydzień korespondencji mailowej.
Terminy licz od dwóch różnych dat. U przewoźnika zwykle od dnia nadania: standardowo 7 dni na zgłoszenie uszkodzenia niewidocznego przy odbiorze i do 30 dni na niedoręczenie. W prawie konsumenckim liczysz od doręczenia: 14 dni na odstąpienie od umowy (plus 14 dni na wysłanie paczki) i 2 lata na niezgodność towaru z umową. To dwa odrębne roszczenia – nie mieszaj ich w jednym zgłoszeniu, bo przewoźnik odrzuci pismo oparte na przepisach konsumenckich.
Zwrot skracasz etykietą generowaną z panelu klienta: dane adresowe są już w systemie, klient nie wpisuje nic ręcznie, a Ty widzisz zgłoszenie w tym samym momencie, w którym powstaje etykieta. Przy paczkomacie klient dostaje kod zamiast wydruku i nie stoi w kolejce na poczcie.
Zagubiona czy opóźniona? Patrz na statusy z API. Brak jakiegokolwiek skanu przez 3–5 dni roboczych od „przyjęta” – eskaluj. Kolejne sortownie w statusach to zwykłe opóźnienie i reklamacja złożona za wcześnie zostanie odrzucona jako bezpodstawna. Brak statusu „doręczona” przez 7 dni od planowanej daty – pisz reklamację.
| Sytuacja | Od czego liczyć termin | Gdzie zgłaszasz |
|---|---|---|
| Uszkodzenie widoczne | Protokół przy odbiorze, tego samego dnia | Przewoźnik i sklep równolegle |
| Uszkodzenie ukryte | Od daty doręczenia (typowo 7 dni) | Przewoźnik, potem sklep |
| Niedoręczenie lub zagubienie | Od daty nadania (typowo do 30 dni) | Przewoźnik |
| Odstąpienie od umowy | Od daty doręczenia (14 dni) | Sklep |
| Niezgodność towaru z umową | Od daty doręczenia (2 lata) | Sklep |
Mapowanie statusów to jedno miejsce – plik, tabela albo wtyczka – w którym tłumaczysz statusy przewoźnika na statusy zamówienia. Bez tego każde zdarzenie z API ląduje w skrzynce i ktoś przepisuje je ręcznie.
register_post_status(), a e-maile dopinasz filtrem wc_email_actions lub gotową wtyczką do zarządzania statusami. Zmianę statusu robisz przez update_status() na obiekcie zamówienia.order_state, szablony maili w katalogu mails/pl/, a numer przesyłki w order_carrier.tracking_number. Nowy status wymaga wpisu w tabeli i szablonu maila – oba elementy naraz.Typowe mapowanie: „przyjęta” i „w transporcie” na status „Wysłane”, „gotowa do odbioru” na własny status z mailem „Czeka na Ciebie w paczkomacie”, „doręczona” na „Zrealizowane” – i dopiero wtedy wysyłaj prośbę o opinię. Status „zwrot do nadawcy” musi tworzyć zadanie dla obsługi, a nie tylko zmieniać etykietę w panelu.
E-maile i SMS-y trzymaj krótkie: numer przesyłki i link do śledzenia generowany z szablonu. SMS wysyłaj na dwa zdarzenia – nadanie i gotowe do odbioru. Więcej wiadomości nie zmniejsza liczby telefonów, tylko zwiększa liczbę wypisów z powiadomień.
Każde zdarzenie z API zapisuj do własnej tabeli: znacznik czasu, numer zamówienia, surowy status, status po mapowaniu, identyfikator zdarzenia (do idempotencji przy ponowieniach) i hash payloadu. Retencja 12 miesięcy wystarcza na typowy spór. Odpytywanie API ustaw na 15–30 minut i dodatkowo odbieraj webhooki, bo te gubią się przy restartach.
Jeśli planujesz zmianę domeny WordPress, zrób ją poza sezonem. Linki śledzenia i szablony maili zawierają adres sklepu, więc stare wiadomości prowadzą donikąd, dopóki nie przekierujesz ruchu. Dokumentację statusów i e-maili w WooCommerce znajdziesz w oficjalnej dokumentacji WooCommerce.
Klucz API przewoźnika daje dostęp do generowania etykiet, listów przewozowych i często do danych rozliczeniowych. Trzymanie go w pliku modułu albo w repozytorium Git to najczęstszy błąd, jaki widzimy przy przejmowaniu projektów po poprzednim wykonawcy.
public_html). W PrestaShop np. w pliku konfiguracyjnym poza webrootem lub w zmiennych środowiskowych serwera, w WooCommerce w wp-config.php. Do repozytorium trafia wersja z pustymi wartościami plus wpis w .gitignore.Zanim zgłosisz awarię wykonawcy, zrób pięć rzeczy: wygeneruj jedną etykietę testową, otwórz log modułu z ostatnich 24 godzin, sprawdź w bazie, czy zamówienie ma zapisany numer etykiety, porównaj status w panelu przewoźnika ze statusem w sklepie i sprawdź, czy request w ogóle wychodzi z serwera (curl do endpointu API). W większości przypadków to wystarcza, żeby wiedzieć, czy problem jest po stronie sklepu, czy przewoźnika.
| Objaw | Najczęstsza przyczyna | Pierwszy krok |
|---|---|---|
| Brak etykiet i cisza w logach | Wygasły lub odrzucony klucz API | Sprawdź datę ważności klucza i listę dozwolonych adresów IP |
| Klient wybrał paczkomat, etykieta jest kurierska | Złe mapowanie metod dostawy | Zamówienie testowe za 1 zł dla każdej metody |
| Dwie etykiety na jedno zamówienie | Brak blokady przed duplikatem | Sprawdź, czy moduł zapisuje ID przesyłki przed requestem |
| Dopłaty i zwroty od przewoźnika | Brak wagi i wymiarów produktów | Uzupełnij wagi, dodaj wagę opakowania |
| Status w sklepie inny niż u przewoźnika | Statusy zmieniane ręcznie przez obsługę | Ustaw synchronizację statusów tylko przez webhook |
Najdroższy w skutkach bywa brak blokady na duplikaty: obsługa klika „wyślij” drugi raz, bo pierwszy request trwał 8 sekund, a powstają dwie etykiety. Dobry moduł zapisuje identyfikator przesyłki przed wysłaniem zapytania i blokuje ponowne wywołanie dla tego samego zamówienia. Drugi nawyk to zsynchronizowane wagi i wymiary — sama waga produktu bez opakowania to typowe źródło dopłat, bo przewoźnik rozlicza wyższą wartość z dwóch. Przy mapowaniu metod dostawy zajrzyj do dokumentacji platformy, np. WooCommerce Documentation opisuje strefy i metody wysyłki, i porównaj je z konfiguracją w sklepie.
Podajemy widełki w godzinach, bo stawka godzinowa różni się między wykonawcami. Koszt to liczba godzin pomnożona przez stawkę z twojej umowy — plus opieka po wdrożeniu.
| Zakres | Widełki (godziny) | Kiedy ma sens |
|---|---|---|
| Konfiguracja istniejącej wtyczki, jeden przewoźnik | 4–8 | Standardowe paczki, gotowa wtyczka dla twojej platformy |
| Dwóch–trzech przewoźników, jeden panel | 16–32 | Chcesz wysyłać po najtańszym przewoźniku dla danego adresu |
| Własny moduł, nietypowe gabaryty lub pobrania | 60–140 | Wtyczka nie obsługuje twojego cennika umownego |
| Integracja z ERP/WMS i etykiety zbiorcze | 200–400 | Powyżej kilkuset przesyłek miesięcznie |
Gotowa wtyczka wystarcza, gdy wysyłasz paczki w standardowych wymiarach, masz jedną lub dwie metody dostawy i nie rozliczasz pobrań poza sklepem. Własny moduł jest potrzebny, gdy pojawiają się: nietypowe gabaryty, pobrania z własnym rozliczeniem, kilka paczek w jednym zamówieniu, integracja z ERP albo kody rabatowe na dostawę liczone od cennika umownego. Pisząc moduł pod PrestaShop, warto oprzeć się na PrestaShop Developer Documentation, a nie na reverse engineeringu cudzego kodu.
Opieka po wdrożeniu obejmuje SLA (np. reakcja w 4 godziny w godzinach pracy na awarię etykiet), aktualizacje po zmianach API przewoźnika i monitoring. Koszt ukryty to ręczna obsługa błędów: przy 300 przesyłkach miesięcznie i 3% błędów to 9 paczek po 10–15 minut, czyli 1,5–2,5 godziny pracy plus kilkadziesiąt maili „gdzie moja paczka”. Przy 1000 przesyłek to już niemal etat. Jeśli przy okazji porządków zmieniasz adres sklepu, przejdź najpierw procedurę bezpiecznej zmiany domeny WordPress.
Etykieta generowana dopiero po przekazaniu paczek kurierowi albo wcale.
Jak wykryć: Kurier już zabrał paczki, a w panelu sklepu nie ma numerów przesyłek ani statusów.
Jak naprawić: Generuj etykietę i zamawiaj kuriera z poziomu sklepu przed wydaniem paczek. Jeśli część paczek jedzie poza systemem, dopisz numer listu przewozowego do zamówienia ręcznie.
Brak uzupełnionej wagi i wymiarów produktów w katalogu.
Jak wykryć: Przewoźnik wystawia dopłaty za przekroczony gabaryt albo etykieta drukuje się z wagą domyślną wpisaną na sztywno.
Jak naprawić: Uzupełnij wagę i wymiary dla produktów, których nie da się wysłać standardowym gabarytem, i ustaw sensowną wartość domyślną dla pozostałych. Po zmianie cennika przewoźnika wróć do tych ustawień.
Adres i numer telefonu odbiorcy weryfikowane dopiero po nieudanej dostawie.
Jak wykryć: Klient pisze, że nie dostał powiadomienia o przesyłce, a w zamówieniu brak numeru telefonu lub brakuje numeru ulicy.
Jak naprawić: Ustaw pola wymagane w formularzu zamówienia i walidację formatu. Przy dostawie do paczkomatu numer telefonu jest obowiązkowy, więc nie może być polem opcjonalnym.
Brak zdjęcia paczki i protokołu przy droższych zamówieniach.
Jak wykryć: Reklamacja uszkodzenia kończy się odmową, bo nie ma dowodu, w jakim stanie paczka opuściła magazyn.
Jak naprawić: Wprowadź zdjęcie zapakowanej paczki przy przekazaniu kurierowi dla zamówień powyżej ustalonego progu, na przykład 500 zł, oraz zapisuj protokół odbioru od kuriera.
Reklamacje prowadzone w mailach i przypadkowych wątkach, bez jednego rejestru.
Jak wykryć: Nie potrafisz w minutę odpowiedzieć, ile spraw jest otwartych i która czeka najdłużej.
Jak naprawić: Prowadź jeden arkusz lub widok w panelu z datą zgłoszenia, numerem przesyłki, kwotą i decyzją przewoźnika. Ustal, kto go aktualizuje.
W sklepie da się wybrać metodę dostawy niemożliwą dla danego produktu.
Jak wykryć: Klient zamawia paczkomatem produkt, który nie mieści się w gabarycie, a paczka wraca albo czeka na awizo.
Jak naprawić: Powiąż metody dostawy z kategoriami produktów lub z regułami wagi i wymiarów, a niedostępne opcje ukryj zamiast zostawiać je aktywne.
Bezpieczne nadawanie i odbieranie to przede wszystkim powtarzalny proces: poprawna konfiguracja metod dostawy, sprawdzony adres, dobrze dobrane opakowanie i dowód nadania w systemie. Warstwa organizacyjna kosztuje niewiele, a jej brak kosztuje najwięcej: dopłaty gabarytowe, ponowne wysyłki i odrzucone reklamacje. Zacznij od czterech rzeczy: waga produktów, walidacja adresu i telefonu, karta pakowania oraz rejestr reklamacji. W większości sklepów da się to poprawić w ciągu jednego tygodnia.
Tak. Przewoźnicy udostępniają środowisko testowe, w którym etykieta nie ma mocy wysyłkowej. Osobne klucze chronią przed sytuacją, w której przypadkowe zamówienie testowe generuje prawdziwy list przewozowy i prawdziwą opłatę. Klucze produkcyjne włączaj dopiero wtedy, gdy proces jest przetestowany na sandboxie.
Konkretne wartości zależą od przewoźnika i zmieniają się razem z cennikiem, dlatego nie podajemy ich z pamięci. Sprawdź aktualne wymiary i maksymalną wagę dla poszczególnych gabarytów w regulaminie i cenniku przewoźnika, a potem wpisz je jako reguły w metodach dostawy w sklepie. Błędna liczba wpisana na sztywno kosztuje więcej niż jednorazowe sprawdzenie.
Wtedy, gdy wartość zamówienia przekracza standardowy limit ochrony danej usługi. Przy droższych koszykach deklaracja bywa tańsza niż ryzyko utraty towaru. Kwotę wpisuj zgodnie z faktyczną wartością, bo zaniżenie utrudnia późniejszą reklamację.
Nie wyrzucaj opakowania i nie próbuj naprawiać produktu. Zrób zdjęcia całej paczki, uszkodzonego elementu i etykiety, a następnie złóż reklamację u przewoźnika w terminie podanym w jego regulaminie. Jeśli da się spisać protokół szkody przy odbiorze, zrób to od razu; jeśli nie, zgłoś sprawę pisemnie i zachowaj potwierdzenie zgłoszenia.
Nie ma takiego powszechnego obowiązku, a wymaganie tego od klienta często kończy się sporem. Warto natomiast w mailu z potwierdzeniem wysyłki poprosić o sprawdzenie zawartości i zgłoszenie uszkodzenia jak najszybciej, najlepiej tego samego dnia. Skraca to czas reakcji i upraszcza reklamację.
To zależy od umowy z przewoźnikiem i od tego, po czyjej stronie był błąd. W praktyce koszt ponownej wysyłki najczęściej obciąża sklep, a odzyskanie go od klienta jest trudne i rzadko warte zachodu. Dlatego walidacja adresu i telefonu przed nadaniem jest tańsza niż każda taka pomyłka.
Przynajmniej tak długo, jak długo możesz złożyć reklamację u przewoźnika, a terminy różnią się między firmami i są opisane w ich regulaminach. W praktyce najprościej trzymać dowody nadania przez cały okres, w którym zamówienie może wrócić jako sprawa sporna, i nie kasować ich przy okazji porządków na dysku.
Jeśli chcesz uporządkować wysyłki w PrestaShop lub WooCommerce, od konfiguracji metod dostawy po procedurę reklamacji, napisz do nas i opisz, gdzie dziś tracisz najwięcej czasu. Przejrzymy proces i powiemy, co warto zmienić najpierw.