Integracja Poczta Polska (eNadawca)

Moduł Poczta Polska łączy zamówienia WooCommerce ze śledzeniem Poczty Polskiej. Wpisujesz numer przesyłki w zamówieniu, a wtyczka buduje link do emonitoringu i pobiera aktualny status przewoźnika do ekranu zamówienia, strony zamówienia klienta oraz wiadomości e-mail.

Konfiguracja

Dane dostępowe Poczty Polskiej są zapisywane w opcji polski_pro_shipping i zapisuje się je przez endpoint REST ustawień PRO polski-pro/v1/settings. Osobny ekran wysyłki w kokpicie jest planowany, ale jeszcze nie powstał, więc dzisiaj wartości ustawia się przez ten endpoint albo bezpośrednio w opcji.

Klucz	Opis
`poczta_enabled`	Włącza dostawcę Poczta Polska
`poczta_login`	Login do systemu eNadawca
`poczta_password`	Hasło do systemu eNadawca

Dane dostępowe uzyskasz rejestrując się w systemie eNadawca na stronie poczta-polska.pl.

Opcja przyjmuje także klucze poczta_environment, poczta_default_service i poczta_cod_bank_account. W tym wydaniu nic ich nie odczytuje, są zarezerwowane dla niewydanego kodu etykiet, o którym mówi sekcja Etykiety i automaty paczkowe niżej.

Dostawca jest uznawany za dostępny dopiero wtedy, gdy poczta_enabled jest włączone oraz login i hasło są uzupełnione. Samo zapytanie do emonitoringu jest publiczne, ale wtyczka nie wykona go, dopóki dane dostępowe nie zostaną wpisane.

Wpisywanie numeru śledzenia

Otwórz zamówienie w WooCommerce > Zamówienia
Pod adresem wysyłki znajdź sekcję Śledzenie przesyłki
W polu Przewoźnik wybierz Poczta Polska
Wklej numer przesyłki w pole Numer śledzenia
Zostaw URL śledzenia pusty, aby link powstał automatycznie, albo wpisz własny, aby go nadpisać
Zaktualizuj zamówienie

Wygenerowany link ma taki format:

https://emonitoring.poczta-polska.pl/?numer={numer}

Śledzenie na żywo

Gdy zamówienie ma już przewoźnika i numer, w sekcji Śledzenie przesyłki pojawia się Podgląd na żywo ze statusem przewoźnika i historią przesyłki pobraną z emonitoringu. Odpowiedź jest zapisywana w pamięci podręcznej na 10 minut, więc kolejne otwarcia zamówienia nie odpytują Poczty Polskiej za każdym razem.

Przycisk Odśwież śledzenie na żywo czyści tę pamięć podręczną dla zamówienia i przeładowuje ekran ze świeżym zapytaniem. Użyj go, gdy paczka właśnie zmieniła status, a w sekcji nadal widnieje poprzednie zdarzenie.

Gdzie widać śledzenie

Miejsce	Co jest pokazywane
Lista zamówień	Kolumna Śledzenie z przewoźnikiem i numerem
Ekran zamówienia	Sekcja Śledzenie przesyłki ze statusem na żywo, historią i przyciskiem odświeżania
Moje konto > Zamówienia	Akcja Śledź przesyłkę przy zamówieniu
Szczegóły zamówienia i e-maile do klienta	Ramka śledzenia ze statusem, przewoźnikiem, numerem i przyciskiem Śledź przesyłkę

Moduł realizacji zamówień dodaje też do listy zamówień akcje masowe Spakowane, Wysłane i Dostarczone, którymi prowadzi się statusową część przesyłki Poczty Polskiej.

Etykiety i automaty paczkowe

Generowanie etykiet i wyszukiwanie automatów paczkowych są napisane, ale niepodłączone. PocztaPolskaProvider::generateLabel() i wyszukiwanie punktów odbioru są w kodzie, ale nic w kokpicie ani w kasie do nich nie sięga, więc nie ma przycisku generowania etykiety, akcji masowej ani pobierania etykiet, a numer przesyłki tworzysz w eNadawca (albo innym narzędziu Poczty Polskiej) i wklejasz do zamówienia ręcznie.

Wymagania techniczne

Śledzenie na żywo korzysta ze zwykłych zapytań HTTPS, więc do tego, co moduł robi dzisiaj, nie jest potrzebne żadne dodatkowe rozszerzenie PHP. Rozszerzenia PHP SOAP (ext-soap) wymagałby dopiero kod etykiet, którego nic nie wywołuje. Sprawdzisz je tak:

phpinfo(); // Szukaj sekcji "soap"

Większość hostingów PHP ma SOAP domyślnie włączony.