Poczta Polska w WooCommerce: konfiguracja eNadawcy WP Desk

Zacznij od ustalenia, kto obsługuje przesyłki: bezpośrednia wtyczka w WooCommerce czy zewnętrzny integrator. Nie pozostawiaj dwóch niezależnych mechanizmów tworzących paczkę dla tego samego zamówienia. Zapisz nazwę produktu, wersję i właściciela konfiguracji, aby dalsza diagnoza dotyczyła rzeczywistego połączenia.

Ta instrukcja odnosi się do dokumentacji eNadawcy WP Desk z aktualizacją 15 lipca 2026 r. Jest to produkt konkretnego dostawcy, więc nie nazywaj go automatycznie oficjalnym modułem Poczty Polskiej. Inna wtyczka może mieć inne wymagania i pola logowania.

Spisz używane wersje WordPressa, WooCommerce, PHP, eNadawcy oraz Flexible Shipping. Sprawdź potwierdzoną zgodność dodatku z HPOS i używanym checkoutem, w tym Cart/Checkout Blocks. Sam opis ogólnej konfiguracji nie jest dowodem zgodności każdego wydania z każdym wariantem ekranu.

Ustal również usługę wynikającą z konta i umowy. Dokumentacja wymienia między innymi Pocztex 2.0 Kurier, lecz historycznej listy opcji nie należy traktować jako aktualnej oferty całego kontraktu. Jeśli dopiero wybierasz model obsługi, zacznij od rozwiązań Poczty Polskiej dla e-commerce.

Według dokumentacji WP Desk połączenie korzysta z nazwy użytkownika i hasła eNadawcy. Nie szukaj niepotwierdzonego menu generowania klucza API. Dane muszą odpowiadać właściwemu środowisku i uprawnieniom konta. Dostęp do panelu WWW oraz poprawność komunikacji aplikacji sprawdza się osobno.

Na serwerze potrzebne jest rozszerzenie SOAP dla PHP obsługującego witrynę. Sprawdź je w stanie systemu WooCommerce lub z administratorem hostingu. Wynik dla PHP uruchomionego w terminalu może nie odpowiadać konfiguracji procesu WWW. Brak zależności należy wyjaśnić przed testowaniem kolejnych ustawień konta.

Bazowy Flexible Shipping jest zależnością opisywanej integracji. Samo narzędzie reguł kosztu nie zastępuje połączenia nadawczego. Zweryfikuj instalację i aktywację obu dodatków oraz zgodne wersje. Nie dokładaj kolejnej wtyczki stawek tylko dlatego, że metoda jeszcze nie pojawiła się w koszyku.

Dla prób przygotuj odrębne konto testowe zgodnie z dokumentacją dostawcy. Przełączenie opcji testowej nie zamienia automatycznie poświadczeń produkcyjnych w testowe. Na kopii nie pozostawiaj aktywnej automatyzacji, wiadomości ani integracji płatniczych. Sekrety przechowuj w przeznaczonym do tego miejscu, bez umieszczania ich w zrzutach ekranu i zgłoszeniach.

Po aktywacji wtyczki przejdź do WooCommerce, następnie Ustawienia, Wysyłka i eNadawca. To ścieżka opisanego produktu; inne wydania lub dodatki mogą zmieniać interfejs. Wybierz tryb testowy i wprowadź odpowiadające mu dane konta. Sprawdź status połączenia, nie wykonując produkcyjnego tworzenia paczki.

Pozostaw ręczny sposób generowania na czas odbioru. Włączenie automatyzacji przed sprawdzeniem mapowania może uruchomić operację po zmianie statusu syntetycznego zamówienia. Samo środowisko staging nie zapewnia izolacji, jeśli zachowuje produkcyjne poświadczenia i aktywne połączenia.

Zapisz nazwę zbioru, planowany sposób pracy oraz ustawienia konta potrzebne dla wybranej usługi. Sprawdź kartę i urząd nadania, jeśli dotyczą Twojego modelu. Nie kopiuj tych danych między sklepami bez ustalenia, który podmiot i miejsce faktycznie realizują paczki.

Odbiór połączenia oznacza jedynie potwierdzenie określonego etapu. Nie dowodzi poprawności ceny w koszyku, punktu odbioru ani etykiety. Zanotuj wersję i datę próby, a ewentualny komunikat błędu zachowaj po usunięciu danych dostępowych. Jeśli nie masz potwierdzonego środowiska testowego, ogranicz próbę do lokalnego podglądu z mockami.

W odpowiedniej strefie wysyłki utwórz metodę Flexible Shipping. W jej ustawieniach wskaż integrację eNadawca, a następnie usługę Poczty Polskiej odpowiadającą umowie i potrzebom sklepu. Nazwa widoczna dla kupującego powinna jasno odróżniać doręczenie pod adres od odbioru w punkcie.

Ustal reguły kosztu dla klienta. Nie zakładaj, że cena zostanie automatycznie pobrana z cennika przewoźnika albo że opłata w koszyku równa się rozliczeniu nadania. Osobno uwzględnij warunki umowy, dopłaty, podatek i ewentualne finansowanie dostawy przez sklep.

Sprawdź dopasowanie strefy dla syntetycznych adresów i zachowanie koszyka po ich zmianie. Brak metody może wynikać z adresu, reguły, parametrów towaru lub konfiguracji checkoutu. Nie naprawiaj go przez udostępnienie tej samej opcji bez ograniczeń dla całego świata.

Parametry produktów i paczki muszą pasować do wybranej usługi. Nie utożsamiaj automatycznie sumy mas produktów z gotową masą przesyłki wraz z opakowaniem. Ogólne zasady opisuje wysyłka w sklepie internetowym, a osobna diagnostyka wyjaśnia problemy z darmową dostawą. Próg darmowej dostawy również wymaga próby z rabatem i zmianą koszyka.

Odbiór w punkcie włączaj dla usługi, która go obsługuje. Samo dodanie mapy nie oznacza, że wybrany punkt jest dopuszczalny dla płatności i parametrów przesyłki. Zgodność trzeba ocenić także po zmianie adresu, sposobu dostawy lub pobrania.

W scenariuszu testowym wybierz punkt, zmień metodę na kurierską i wróć do odbioru. Sprawdź, czy nie pozostał nieaktualny identyfikator. Podobnie postąp po zmianie kodu pocztowego. Oczekiwane zachowanie opisz przed testem: prawidłowe zachowanie wyboru albo czytelne wymaganie ponownego wskazania punktu.

Porównaj identyfikator i opis punktu w widoku klienta oraz danych zamówienia testowego. Sama etykieta wyświetlona na mapie nie potwierdza, że ta sama wartość dotrze do danych paczki. Przy pobraniu zweryfikuj, czy wybrany punkt obsługuje ten wariant.

Odbierz także telefon i klawiaturę. Klient powinien móc otworzyć wybór, znaleźć punkt, zatwierdzić go i wrócić do podsumowania. Przy niedostępnej liście potrzebny jest zrozumiały komunikat, zamiast pozornego sukcesu. Diagnostykę cache punktów prowadź po ustaleniu stanu połączenia, bez wielokrotnych, przypadkowych ponowień.

W panelu zamówienia rozróżnij zapis danych od utworzenia przesyłki. Dokumentacja wskazuje, że utworzenie przekazuje dane do eNadawcy. Nie jest to niewinny podgląd, który można sprawdzać na koncie produkcyjnym. Próba tego etapu wymaga właściwej izolacji i danych testowych.

Etykieta oraz numer przesyłki nie dowodzą przekazania paczki przewoźnikowi ani doręczenia. Zbiór i jego przekazanie są etapami systemowymi, a fizyczne oddanie wymaga odrębnego potwierdzenia. W opisie procesu nie zamieniaj tych zdarzeń w jeden status wysłano.

Sprawdź mapowanie odbiorcy, usługi, pobrania, punktu i parametrów paczki na wzorcu testowym. Dokument powinien odpowiadać konkretnemu zamówieniu. Nie publikuj etykiet z rzeczywistymi danymi klientów jako dowodu poprawności konfiguracji; do odbioru używaj danych syntetycznych.

Ustal też, kto rozstrzyga błąd po wysłaniu żądania, gdy sklep nie otrzymał jednoznacznej odpowiedzi. Ponowienie bez sprawdzenia istniejącego rekordu może utworzyć duplikat. Powrót do wcześniejszego widoku lub usunięcie lokalnej informacji nie oznacza cofnięcia operacji w eNadawcy. Tę zależność uwzględnij przed uruchomieniem działań masowych.

Przy błędzie sprawdź kolejno środowisko, konto, ważność hasła, SOAP i komunikat zwrócony przez usługę. Poprawne logowanie do strony WWW nie potwierdza poprawnego adresu używanego przez integrację. Nie wklejaj pełnego logu z poświadczeniami do publicznego zgłoszenia.

Komunikat Elektronicznego Nadawcy wskazuje produkcyjne WebAPI pod adresem https://e-nadawca.api.poczta-polska.pl/websrv/. Panel WWW pozostaje pod domeną e-nadawca.poczta-polska.pl. Porównaj endpoint używany przez Twoją wersję wtyczki; nie zmieniaj adresów przez hurtowe zastępowanie tekstu w plikach. Aktualizację lub konfigurację wykonuj zgodnie z zaleceniem dostawcy i planem powrotu.

Błąd planowanej daty nadania w przeszłości może wymagać sprawdzenia zbioru i jego daty. Nie rozwiązuj go ponownym tworzeniem wszystkich paczek. Najpierw ustal stan istniejących rekordów. Sprawdź także kartę i miejsce nadania w kontekście konta.

Brak oczekiwanego statusu w WooCommerce nie dowodzi od razu awarii webhooka. Nie zakładaj, że opisywana wtyczka udostępnia dowolny callback albo standardowy status Wysyłka. Zestaw rzeczywiste ustawienia, dokumentację i logi. Zmiana statusu zamówienia może uruchamiać inne automatyzacje, dlatego diagnozuj ją na kopii.

Próba powinna obejmować także wyjątki. Poniższa macierz opisuje oczekiwania dla testów na kopii lub w potwierdzonym środowisku testowym, a nie działania do wykonania na produkcyjnym koncie.

Dołącz kontrolę kosztu, dokumentu testowego i zgodności używanej wersji checkoutu. Oddziel wynik połączenia od wyniku każdego scenariusza. Automatyzację według statusu lub działania masowe rozważ dopiero po opisaniu wyjątków, odpowiedzialności oraz zabezpieczenia przed duplikatami.

Nie ma uniwersalnej liczby zamówień, od której integracja się zwraca. Koszt obejmuje licencję, konfigurację, utrzymanie i obsługę błędów. Zakres integracji sklepu internetowego możesz omówić przez kontakt, podając wersje, usługę i objaw, bez haseł oraz danych odbiorców. Ten opis ułatwia wycenę konkretnej pracy, bez zgadywania ceny na podstawie samej nazwy przewoźnika.