Poczta Polska w sklepie internetowym to kilka połączonych decyzji: jaką usługę wybiera klient, gdzie zapisujesz punkt odbioru, który system przygotowuje przesyłkę i skąd wraca jej status. Sama mapa w koszyku nie zamyka tego procesu. Ten poradnik pomaga dobrać Pocztex oraz uporządkować integrację z Elektronicznym Nadawcą, bez mylenia ceny dostawy z rozliczeniem przewoźnika.
Krótka odpowiedź
Wdrożenie Poczty Polskiej w sklepie zacznij od wyboru usługi Pocztex i warunków umowy. Następnie połącz metodę dostawy z danymi paczki oraz punktem odbioru, jeśli klient wybiera Punkt lub Automat. Integracja z Elektronicznym Nadawcą musi osobno obsługiwać przygotowanie przesyłki, dokumenty i status.
Sprawdź aktualny adres WebAPI. Wygenerowana etykieta nie potwierdza fizycznego nadania paczki.
Usługi KC Mobile
Ustalmy, jak mają działać dostawy w sklepie
Podaj platformę sklepu, przewoźników i reguły kosztów dostawy. Jeśli metoda znika w koszyku, opisz przykład zamówienia bez danych klienta. Ustalimy zakres konfiguracji i testów.
Dobierz Pocztex do sposobu doręczenia i asortymentu
Na oficjalnej stronie Pocztex rozdzielono doręczenie pod adres, do punktu oraz do automatu. W sklepie nazwij te opcje zgodnie z faktycznie obsługiwaną usługą. Automat Pocztex nie jest usługą InPost, a ogólny napis punkt odbioru nie wyjaśnia klientowi, jakiej sieci dotyczy wybór.
Zacznij od rzeczywistej paczki po zapakowaniu. Porównaj wymiary, masę i rodzaj zawartości z warunkami wybranej opcji. Nie zakładaj, że produkt mieszczący się do przesyłki kurierskiej zmieści się również do każdego automatu. Sprawdź osobno towary delikatne, nietypowe opakowania i zamówienia z kilkoma sztukami. Reguła dostawy powinna reagować na ograniczenia zamówienia, a nie tylko na nazwę kategorii.
Termin przewidywany nie jest gwarancją doręczenia. Jeśli pokazujesz czas dostawy, oddziel przygotowanie w magazynie od przewozu i uwzględnij warunki konkretnej usługi. Nie przepisuj obietnicy z innego serwisu Pocztex na wszystkie metody. Przy wysyłce zagranicznej zweryfikuj produkt przewoźnika, kraj i dopuszczalną zawartość osobno; krajowa konfiguracja nie opisuje automatycznie eksportu.
Sposób naliczania i dostępność metod w koszyku rozwija poradnik wysyłki w sklepie internetowym. Tutaj efektem tego etapu ma być krótka lista usług, które sklep faktycznie potrafi przygotować i obsłużyć.
Podaj platformę sklepu, przewoźników i reguły kosztów dostawy. Jeśli metoda znika w koszyku, opisz przykład zamówienia bez danych klienta. Ustalimy zakres konfiguracji i testów. Omów konfigurację dostaw
Ustal konto, umowę i system odpowiedzialny za nadanie
Elektroniczny Nadawca umożliwia przygotowanie przesyłek, etykiet i dokumentów oraz wymianę danych z systemami zewnętrznymi. Możesz korzystać z jego interfejsu albo integrować proces z oprogramowaniem sklepu. To, że narzędzie udostępnia daną funkcję, nie oznacza jeszcze, że każda wtyczka WooCommerce ją obsługuje.
Poczta Polska w FAQ o WebAPI wskazuje konieczność umowy i konta EN przy przygotowywaniu przesyłek przez ten interfejs. Potwierdź z opiekunem zakres usług i dostępów przewidzianych dla firmy. Konto do obsługi w przeglądarce, ustawienia połączenia oraz warunki handlowe uporządkuj przed konfiguracją automatycznych zadań.
Wybierz jedno miejsce odpowiedzialne za tworzenie przesyłki: panel sklepu, system magazynowy albo pośrednik integracyjny. Pozostałe systemy powinny korzystać z ustalonego powiązania i numeru przesyłki. Jeśli dwa procesy reagują na ten sam status zamówienia, mogą niezależnie przygotować dokumenty do tej samej paczki.
Przed wyborem konektora poproś o listę obsługiwanych usług, typów koszyka i operacji. Sprawdź zapis punktu odbioru, obsługę wielu paczek, pobrania oraz odczytu błędów, jeśli te funkcje są potrzebne. Nie kieruj się wyłącznie nazwą Poczta Polska w katalogu rozszerzeń. Zanotuj też właściciela licencji i osobę odpowiedzialną za aktualizację po zmianie API.
Oddziel mapę punktów od tworzenia przesyłki
Mapa pozwala wybrać miejsce odbioru. Integracja nadawcza musi jeszcze otrzymać jego właściwy identyfikator, powiązać go z zamówieniem i wykorzystać podczas przygotowania przesyłki. Sam widoczny znacznik na mapie nie potwierdza, że dane zostały zapisane w sklepie.
Prześledź cały przepływ: wybór metody, otwarcie mapy, wskazanie punktu, zapis wyboru i odczyt przez konektor. Sprawdź, czy zmiana metody z automatu na doręczenie pod adres usuwa nieaktualny wybór. Przy ponownym przejściu do punktu klient powinien widzieć jednoznaczny stan, a nie dane pozostawione przez poprzednią metodę.
Odbierz działanie na telefonie oraz w faktycznie używanym koszyku i checkout. Jeżeli moduł współpracuje z klasycznym formularzem, nie zakładaj zgodności z blokowym tylko dlatego, że mapa się otwiera. Wymagaj dowodu zapisu danych i ich późniejszego odczytu przez system nadawczy. Nie przypisuj konkretnej wtyczce obsługi mapy bez sprawdzenia jej dokumentacji i wersji.
Przy braku punktu ustal, czy zawiodło ładowanie listy, wybór użytkownika, zapis zamówienia czy eksport danych. W zgłoszeniu technicznym podaj etap oraz syntetyczny przykład. Nie zastępuj brakującego punktu losową placówką. Lepiej pokazać czytelny komunikat wymagający poprawnego wyboru niż przygotować paczkę do niewłaściwego miejsca.
Zmapuj paczkę, odbiorcę i wybraną usługę
Przygotuj tabelę danych wejściowych: metoda sklepu, usługa przewoźnika, odbiorca, adres lub punkt, masa, wymiary oraz wymagane opcje. Dla każdego pola zapisz źródło. Część informacji może pochodzić z produktu, część z zamówienia, a parametry gotowej paczki z procesu pakowania.
Masa towaru bez opakowania nie musi odpowiadać masie nadawczej. Podobnie suma wymiarów produktów nie opisuje poprawnie kartonu. Jeśli system sam dobiera opakowanie, odbierz jego reguły na typowych i granicznych zestawach. Przy ręcznym pakowaniu zapewnij możliwość zatwierdzenia rzeczywistych parametrów przed przygotowaniem przesyłki.
Pobranie, wartość i dodatkowe usługi konfiguruj tylko tam, gdzie wynikają z zamówienia oraz warunków przewoźnika. Nie mapuj każdej opłaconej transakcji na pobranie. Sprawdź walutę i kwotę przekazywaną między systemami, zamiast polegać na podobnych etykietach pól. Pomyłka w tym miejscu dotyczy rozliczenia, nawet jeśli etykieta wygląda poprawnie.
Dane katalogowe warto uporządkować zgodnie z poradnikiem konfiguracji produktów. W testowej macierzy uwzględnij produkt prosty, wariant, kilka sztuk i zamówienie wymagające więcej niż jednej paczki. Każda paczka potrzebuje czytelnego powiązania z zamówieniem; jeden status sklepu nie wyjaśnia całej wysyłki wielopaczkowej.
Rozdziel etykietę, przekazanie paczki i potwierdzenie
W procesie magazynowym nazwij osobno przygotowanie danych, uzyskanie dokumentu, wydruk, przekazanie przewoźnikowi i późniejsze zdarzenia transportowe. Etykieta jest dokumentem do obsługi przesyłki. Nie dowodzi, że kurier odebrał karton ani że paczka została fizycznie nadana w placówce.
Ustal, czy odbiór przez kuriera wynika z umówionego harmonogramu, czy wymaga osobnej czynności. Nie traktuj przycisku generowania etykiety jako automatycznego zamówienia podjazdu, chyba że taką funkcję potwierdza dokumentacja używanego rozwiązania i konfiguracja firmy. Pracownik magazynu powinien wiedzieć, jaki krok pozostaje po wydruku.
Zapisuj identyfikatory operacji oraz numer przesyłki w systemie odpowiedzialnym za nadanie. Po utracie odpowiedzi nie twórz od razu kolejnej etykiety: najpierw sprawdź, czy poprzednia operacja została wykonana. Mechanizm ponawiania powinien zapobiegać powielaniu przygotowania tej samej paczki, także gdy zadanie uruchomi harmonogram i pracownik.
Porównanie z konfiguracją DHL w sklepie pokazuje podobny podział etapów, lecz dane dostępowe, nazwy usług i API pozostają właściwe danemu przewoźnikowi. Nie kopiuj ustawień jednego operatora do drugiego tylko dlatego, że oba moduły drukują etykiety.
Uzgodnij statusy, zwroty i koszt dostawy
Status zamówienia w sklepie oraz status przesyłki opisują różne procesy. Zamówienie może być opłacone i nadal czekać na spakowanie. Numer nadawczy może już istnieć, choć nie ma jeszcze zdarzenia transportowego. W panelu obsługi pokaż te informacje oddzielnie i zachowaj czas ostatniego odczytu statusu.
Jeśli śledzenie nie wraca do sklepu, sprawdź numer przesyłki, działanie harmonogramu, uprawnienia i ostatnią odpowiedź integracji. Brak nowego statusu nie musi oznaczać zagubienia paczki. Odróżnij brak zdarzenia u przewoźnika od błędu pobierania lub zapisu. Dla opóźnionych danych ustal, kto sprawdza sprawę i jaki komunikat może przekazać klientowi.
Zwrot przesyłki do nadawcy nie jest automatycznie rozliczeniem zwrotu zakupu. Uzgodnij obieg informacji między magazynem, obsługą i księgowością. Jeśli integracja wspiera osobną usługę zwrotną, sprawdź jej zakres, wymagane dane i warunki. Nie uruchamiaj zwrotu pieniędzy wyłącznie na podstawie ogólnej etykiety statusu transportowego.
Koszt pobrany w checkout jest regułą cenową sklepu. Rozliczenie przewoźnika zależy od umowy i faktycznie przygotowanej przesyłki, w tym ewentualnych opcji lub dopłat. Porównując różnicę, zbierz metodę, parametry paczki, usługę i dokument rozliczeniowy. Sama inna kwota nie dowodzi błędu wtyczki. Politykę darmowej dostawy i dopłat ustal oddzielnie od technicznego nadania.
Sprawdź nowy adres WebAPI i odbierz zmianę bez nadania
Komunikat Elektronicznego Nadawcy o adresach wskazuje produkcyjny endpoint `https://e-nadawca.api.poczta-polska.pl/websrv/`. Adres strony WWW systemu pozostaje bez zmian. Stare adresy API są wymienione jako przeznaczone do wyłączenia. Nie wystarczy więc potwierdzić, że pracownik nadal potrafi zalogować się w przeglądarce.
Poproś wykonawcę o wskazanie adresu używanego przez rzeczywisty proces integracji, także zadania w tle i oprogramowanie pośredniczące. Sprawdź konfigurację aplikacji, wersję konektora oraz reguły sieciowe serwera. Nie testuj połączenia przez prawdziwe utworzenie przesyłki. Sama podmiana hosta również nie jest pełnym odbiorem mapowania i odpowiedzi.
Na odizolowanej kopii użyj danych syntetycznych i symulowanych odpowiedzi albo środowiska testowego uzgodnionego z dostawcą. Zablokuj produkcyjne API, generowanie prawdziwych etykiet, zamawianie kuriera, pocztę, płatności i konwersje. Sprawdź mapowanie Kurier/Punkt/Automat, brak punktu, błąd danych, przerwanie połączenia i powtórne zadanie. Zapisz wynik każdej próby oraz sposób bezpiecznego wznowienia.
Przed uruchomieniem przygotuj instrukcję dla magazynu i właściciela wyjątków. W ramach sklepów internetowych oraz automatyzacji można połączyć dane zamówienia, pakowanie i diagnostykę nadania. Przez kontakt przekaż nazwę konektora, wersję i etap problemu. Do pierwszej diagnozy wystarczy zanonimizowany opis; nie wysyłaj haseł ani etykiet zawierających dane odbiorców.
Więcej poradników w tym temacie
Wspomniane narzędzia
Najczęściej zadawane pytania
Czym różnią się Pocztex Kurier, Punkt i Automat?
Czy konto Elektronicznego Nadawcy zastępuje wtyczkę sklepu?
Co zrobić, gdy w zamówieniu brakuje punktu odbioru?
Dlaczego rozliczenie Poczty Polskiej różni się od ceny w koszyku?
Dlaczego status przesyłki Pocztex nie aktualizuje się w sklepie?
Jak przetestować integrację EN bez prawdziwej przesyłki?
Ustalmy, jak mają działać dostawy w sklepie
Podaj platformę sklepu, przewoźników i reguły kosztów dostawy. Jeśli metoda znika w koszyku, opisz przykład zamówienia bez danych klienta. Ustalimy zakres konfiguracji i testów.
