eNadawca Poczta Polska WooCommerce

Instalacja

Instrukcja instalacji →

Ważne informacje

• Korzystanie z wtyczki wymaga posiadania konta w systemie eNadawcy:
  • załóż konto biznesowe (firmowe) tutaj.
  • załóż konto indywidualne tutaj.
• Niektóre przesyłki wymagają posiadania konta biznesowego, które z kolei wymaga podpisania umowy z Pocztą Polską.
• Do prawidłowego funkcjonowania listy punktów odbioru oraz ich mapy na ekranie finalizacji zamówienia, konieczne jest wprowadzenie danych dostępowych konta w systemie eNadawca (nazwa użytkownika i hasło) na ekranie konfiguracyjnym wtyczki.
• Włączenie trybu testowego wymaga założenia oddzielnego konta testowego eNadawcy.

Wymagania techniczne

• Zainstalowane rozszerzenie SOAP na serwerze - na znacznej większości instalacji PHP na serwerach współdzielonych jest już ono domyślnie zainstalowane. Informacje na temat czy serwer posiada zainstalowane rozszerzenie SOAP znaleźć można w Statusie systemu WooCommerce →
• Od wersji 1.2 do poprawnego działania wtyczki eNadawca niezbędna jest instalacja bezpłatnej wtyczki Flexible Shipping jako integracji bazowej.

Konfiguracja

Po zainstalowaniu i zaktywowaniu wtyczki eNadawca Poczta Polska WooCommerce w ustawieniach wysyłki WooCommerce (WooCommerce → Ustawienia → Wysyłka) powinien pojawić się dodatkowy odnośnik eNadawca:

Po jego kliknięciu nastąpi przekierowanie do ekranu konfiguracyjnego wtyczki eNadawca Poczta Polska WooCommerce:

Ustawienia główne

Logowanie

Użytkownik i Hasło - wpisz dane logowania do systemu eNadawcy.

Hasło przypomnienie - eNadawca wymaga zmiany hasła dostępowego co 30 dni. Zaznacz tę opcję, jeśli chcesz, żeby w panelu pojawiła się informacja przypominająca o zbliżającym się terminie wygaśnięcia hasła.

Tryb testowy - zaznacz ten checkbox, aby zaktywować Tryb testowy eNadawcy. Jeżeli powyższy checkbox nie zostanie zaznaczony, wtyczka domyślnie będzie funkcjonować w trybie produkcyjnym.

Użytkownik i Hasło (tryb testowy) - wpisz dane logowania do serwisu testowego eNadawcy. Serwis testowy dostępny jest pod adresem https://en-testwebapi.poczta-polska.pl/.

Status połączenia - w tym miejscu sprawdzisz, czy połączenie z API eNadawcy zostało nawiązane prawidłowo po wprowadzeniu przez Ciebie wspomnianych wyżej danych logowania - Użytkownika i Hasła.

Ustawienia zbioru eNadawcy

Zbiór - wpisz nazwę zbioru, który będzie używany do przesyłek. Nazwa zbioru pozwoli ci łatwo rozpoznać sklep w systemie eNadawcy. Wpisanie unikalnej nazwy jest bardzo pomocne zwłaszcza, gdy posiadasz kilka sklepów korzystających z integracji z eNadawcą. Domyślnie wpisany jest w tym miejscu adres URL sklepu.

Aktywna karta - jeśli nie posiadasz podpisanej umowy z Pocztą Polską i korzystasz z konta indywidualnego konieczne będzie wybranie aktywnej karty. Aktywna karta to zbiór punktów nadania wg. lokalizacji.

Domyślny urząd nadania - wybierz domyślny urząd nadania (możesz zmienić wybór za każdym razem podczas nadawania zbioru). Wykorzystaj wybór urzędu nadania do przeszukiwania aktywnych kart.

Generowanie przesyłek i automatyzacja nadawania

Integracja z eNadawcą Poczty Polskiej umożliwia całkowicie automatyczne nadawanie przesyłek na podstawie statusu zamówienia lub ręczne nadawanie wielu przesyłek z listy zamówień WooCommerce.

Sposób generowania - wybierz Ręczne lub Automatyczne generowanie etykiet dla przesyłek eNadawcy w Twoim sklepie. Domyślnie przesyłki możesz nadawać ręcznie na stronie edycji zamówienia lub hurtowo z poziomu listy zamówień. Po wybraniu automatycznego sposobu generowania przesyłek poniżej wyświetli się dodatkowa opcja - Status zamówienia.

Status zamówienia - wybierz jaki status musi przyjąć zamówienie, aby przesyłka eNadawcy została wygenerowana automatycznie.

Zrealizuj zamówienia - zaznacz tę opcję jeżeli chcesz, aby po nadaniu przesyłki status zamówienia automatycznie zmieniał się na Zrealizowane.

Etykiety

Typ etykiet - wybierz układ w jakim zostaną wygenerowane etykiety wysyłkowe eNadawcy spośród dostępnych opcji:

• PDF - każda etykieta w osobnym pliku
• PDF - jeden plik, wiele etykiet na jednej stronie

Drukowanie - jeśli posiadasz również wtyczkę Flexible Printing, możesz w tym miejscu zaznaczyć checkbox, aby włączyć automatyczne drukowanie lub zapisywanie etykiet na dysku od razu po ich wygenerowaniu.

Opcje zaawansowane

Cache punktów odbioru - użyj przycisku Wyczyść cache i odśwież listę punktów odbioru, aby ręcznie wymusić pobranie od nowa listy punktów odbioru.

Domyślnie lista punktów odbioru aktualizowana jest raz dziennie na podstawie nawiązanego połączenia i pobranych danych bezpośrednio z API eNadawcy. Jeżeli połączenie zostanie nawiązane pomyślnie, lista dostępnych punktów odbioru zostanie zaktualizowana w tle. Jeżeli z jakiegoś powodu nie będzie to możliwe, zostanie użyta poprzednio zapisana lista, a kolejna próba aktualizacji odbędzie się po godzinie.

Wraz z wersją 1.11.0 wtyczki eNadawca została także dodana możliwość ręcznego wyczyszczenia pamięci cache z zapisaną listą punktów odbioru za pomocą poniższego przycisku:

Opcja ta jest szczególnie przydatna w sytuacjach wymagających natychmiastowego odświeżenia/aktualizacji listy punktów odbioru lub np. w przypadku ogłoszenia przez Pocztę Polską zaplanowanej przerwy technicznej, podczas której nie będzie możliwy dostęp do API. Wyczyszczenie cache i odświeżenie listy punktów odbioru krótko przed rozpoczęciem przerwy technicznej poskutkuje wówczas zapisaniem listy punktów odbioru do pamięci podręcznej i zapobiegnie problemom z wyborem punktu odbioru przez klienta w ramach składania zamówienia podczas trwania przerwy technicznej.

Zapis zdarzeń - aktywacja tej opcji okazuje się przydatna podczas diagnozowania problemów, w celu rejestrowania wszystkich działań podejmowanych przez wtyczkę. Zdarzenia zapisywane są wówczas w logu WooCommerce (WooCommerce → Status → Logi).

Dodawanie metody wysyłki z integracją eNadawca

Wtyczka eNadawca jest dalszą integracją wysyłkową dla wtyczki Flexible Shipping, stanowiącej moduł bazowy, umożliwiający tworzenie metod wysyłki i precyzyjne definiowanie reguł obliczania jej kosztów.

Do poprawnego funkcjonowania wtyczki eNadawca niezbędna jest zatem instalacja wtyczki Flexible Shipping, a następnie wybranie w utworzonej za jej pomocą metodzie wysyłki opcji Integracja: eNadawca.

Po utworzeniu metody wysyłki Flexible Shipping, na jej ekranie konfiguracyjnym przejdź do sekcji Integracja wysyłkowa:

Integracja - wskaż eNadawcę jako integrację wysyłkową dla tej metody wysyłki Flexible Shipping.

Usługa Poczty Polskiej - wybierz usługę Poczty Polskiej, która będzie domyślnie wybrana do wysyłki zamówionych produktów, jeżeli klient wybierze tą metodę wysyłki składając zamówienie.

Odbiór w punkcie

- jeśli dana usługa Poczty Polskiej ma możliwość odbioru w punkcie, możesz ją aktywować zaznaczając ten checkbox. W formularzu zamówienia pojawi się wówczas opcja Odbiór w punkcie oraz możliwość wyszukania punktu odbioru z listy lub mapy:

Wybierz punkt na mapie

- opcja dostępna w formularzu zamówienia po wcześniejszym zaznaczeniu checkboxa Odbiór w punkcie dla danej usługi na ekranie konfiguracyjnym metody wysyłki. Po kliknięciu w odnośnik klientom sklepu zostanie wyświetlona mapa z wyszukiwarką dostępnych punktów odbioru Poczty Polskiej:

Dodatkowe atrybuty usług Poczty Polskiej

- w zależności od wybranej usługi Poczty Polskiej możesz ustawić dla niej na stałe wybrane dodatkowe atrybuty. Dzięki takiej konfiguracji, na ekranie edycji zamówienia nie będzie zachodziła już konieczność wybierania ich za każdym razem ręcznie dla każdej przesyłki przed jej nadaniem. Możliwe do ustawienia parametry to:

• Kategoria (dla usług: Przesyłka polecona, Przesyłka firmowa polecona, Paczka pocztowa, Zagraniczna paczka do UE):
  • Priorytet
  • Ekonomiczna
• Serwis (dla usług: Usługa paczkowa):
  • Paczka 24
  • Paczka 48
  • Paczka Ekstra 24
• Miejscowa (dla usług: Przesyłka firmowa polecona):
  • Zamiejscowa
  • Miejscowa
• Gabaryt:
  • Gabaryt A (dla usług: Paczka pocztowa)
  • Gabaryt B (dla usług: Paczka pocztowa)
  • Gabaryt XS (dla usług: Pocztex Kurier 48 (Przesyłka biznesowa))
  • Gabaryt S (dla usług: Pocztex Kurier 48 (Przesyłka biznesowa))
  • Gabaryt M (dla usług: Pocztex Kurier 48 (Przesyłka biznesowa))
  • Gabaryt L (dla usług: Pocztex Kurier 48 (Przesyłka biznesowa))
  • Gabaryt XL (dla usług: Pocztex Kurier 48 (Przesyłka biznesowa))
  • Gabaryt XXL (dla usług: Pocztex Kurier 48 (Przesyłka biznesowa))
• Format:
  • S (dla usług: Przesyłka polecona, Pocztex 2.0 Kurier)
  • M (dla usług: Przesyłka polecona, Pocztex 2.0 Kurier)
  • L (dla usług: Przesyłka polecona, Pocztex 2.0 Kurier)
  • XL (dla usług: Pocztex 2.0 Kurier)
  • 2XL (dla usług: Pocztex 2.0 Kurier)
• Opakowanie (gabaryt) (dla usług: Usługa paczkowa):
  • Paczka do 0,5 kg
  • Koperta firmowa do 1 kg
• Pobranie (dla usług: Usługa paczkowa, Pocztex - Kurier Ekspres 24, Pocztex Kurier 48 (Przesyłka biznesowa), Pocztex 2.0 Kurier, Pocztex 2.0 Na Dziś (Kraj))
• Ubezpieczenie (dla usług: Usługa paczkowa, Pocztex - Kurier Ekspres 24, Pocztex Kurier 48 (Przesyłka biznesowa), Pocztex 2.0 Kurier, Pocztex 2.0 Na Dziś (Kraj))
• Zawartość (dla usług: Pocztex 2.0 Kurier, Pocztex 2.0 Na dziś (Kraj), Global Expres)
• Sposób nadania (dla usług: Pocztex 2.0 Kurier):
  • Kurier
  • Placówka pocztowa

Tworzenie przesyłki, generowanie etykiet i nadawanie przesyłek

Nadawanie pojedynczych przesyłek

Po złożeniu zamówienia przez klienta i wyborze metody wysyłki zintegrowanej z eNadawcą do strony zamówienia zostanie dodany metabox Poczta Polska umożliwiający utworzenie przesyłki oraz wybór dla niej dodatkowych opcji:

Jeżeli przesyłka nie wymaga dodatkowej konfiguracji lub modyfikacji widocznych w metaboxie Poczta Polska parametrów, za pomocą przycisków widocznych w dolnej części metaboxa można wykonać następujące czynności:

• Zapisz - zapisuje dane przesyłki, lecz jeszcze bez ich przekazywania i tworzenia przesyłki w systemie eNadawca.
• Utwórz przesyłkę - tworzy przesyłkę w systemie eNadawca. Po utworzeniu przesyłki jej dane nie będą już możliwe do edycji z poziomu metaboxa Poczta Polska.

Po utworzeniu przesyłki za pomocą przycisku Utwórz przesyłkę metabox Poczta Polska zostanie odświeżony:

Dane przesyłki zostaną wyszarzone, widoczne wcześniej w dolnej części buttony zostaną ulegną zmianie na:

• Usuń - utworzona przed chwilą przesyłka zostanie usunięta, a jej dane będą ponownie możliwe do edycji.
• Pobierz etykietę - umożliwia pobranie etykiety nadawczej wygenerowanej w wybranym wcześniej z poziomu Ustawień głównych eNadawcy formacie i układzie.

a nad nimi pojawi się wygenerowany, analogiczny do widocznego na powyższym zrzucie ekranu numer przesyłki z linkiem trackingowym (PX6003026950), umożliwiającym jej śledzenie.

Integracja z Allegro

Jeżeli w swoim sklepie posiadasz również zainstalowaną wtyczkę Allegro WooCommerce w dolnej części metaboxa Poczta Polska pojawi się dodatkowy checkbox Przesyłka Allegro:

po zaznaczeniu którego zostaną wyświetlone dodatkowe opcje umożliwiające powiązanie tworzonej przesyłki z zamówieniem Allegro:

Źródło - wybierz w jaki sposób integracja Allegro łączy się z Twoim sklepem WooCommerce spośród dostępnych możliwości:

• Allegro REST API
• Manager Sprzedaży
• Allegro WebAPI

ID zamówienia Allegro - wprowadź numer zamówienia z Allegro, dla którego ma zostać utworzona przesyłka.

Numer ID dla złożonego zamówienia Allegro znajdziesz po zalogowaniu na swoje konto Allegro w sekcji Szczegóły zamówienia w kolumnie Numer zamówienia. Ma on formę ciągu liter i cyfr rozdzielonych myślnikami, np. 8b3d04a1-3f32-11ed-8c53-772d26bbfabb:

ID sprzedającego Allegro - wprowadź numer Twojego konta sprzedawcy Allegro.

Należy w tym miejscu mieć na uwadze, aby w powyższym polu wprowadzić numer konta Allegro, a nie jego nazwę / nick / pseudonim. Swój numer konta Allegro możesz sprawdzić logując się na swoje konto, a następnie przechodząc pod poniższy adres:

https://allegro.pl/login/user →

Numerem ID sprzedającego Allegro będzie wartość wyświetlona dla parametru userId.

Sposób dostawy Allegro - wybierz usługę Poczty Polskiej, z wykorzystaniem której ma zostać nadana przesyłka Allegro.

Pobieranie etykiety nadawczej i śledzenie przesyłki

Po utworzeniu przesyłki i wygenerowaniu jej numeru, możesz pobrać jej etykietę wysyłkową korzystając z przycisku Pobierz etykietę. Kliknięcie w link trackingowy z numerem przesyłki (PX6003026950) otworzy w nowej karcie przeglądarki dedykowaną stronę do śledzenia przesyłek Poczty Polskiej.

Powtórz te kroki opisane w sekcji Nadawanie pojedynczych przesyłek dla każdego zamówienia, które chcesz nadać za pomocą systemu eNadawca. Zostaną one dodane do buforu i będą oczekiwać na przekazanie do Poczty Polskiej.

Utworzenie przesyłki jest jednoznaczne z wysłaniem danych do eNadawcy. Od tego momentu przesyłka będzie już widoczna i będzie można nią zarządzać w panelu eNadawca, z poziomu zakładki Przesyłki → Przygotowane:

Nadawanie wielu przesyłek

Integracja z eNadawcą umożliwia ręczne nadawanie wielu przesyłek z poziomu listy zamówień WooCommerce.

Aby nadać przesyłki dla wielu zamówień jednocześnie zaznacz za pomocą checkboxów zamówienia, dla których chcesz utworzyć przesyłki, a następnie z rozwijalnej listy Działania masowe wybierz opcję Nadaj przesyłki i zatwierdź operację przyciskiem Zastosuj:

Więcej na temat zarządzania wysyłką na liście zamówień WooCommerce przeczytasz w instrukcji zarządzania wysyłką →

Automatyczne nadawanie przesyłek

Integracja z eNadawcą umożliwia także całkowicie automatyczne nadawanie przesyłek na podstawie statusu zamówienia.

O tym jak włączyć automatyczne nadawanie przesyłek przeczytasz w sekcji Generowanie przesyłek i automatyzacja nadawania.

Edycja przesyłki

W każdej chwili możesz zmienić ustawienia przesyłki, a nawet zmienić typ usługi. Jeśli przesyłka została już nadana, zostanie utworzona nowa, ale pamiętaj, aby usunąć poprzednią z buforu eNadawcy.

Edytując przesyłkę możesz m.in. ustawić jej dodatkowe atrybuty np. Ostrożnie, itp.

Rachunek dla pobrania

- jeśli wybrałeś/-aś pobranie dla przesyłki, wysokość kwoty pobrania zostanie automatycznie pobrana z wartości zamówienia, a jako konto, na które ma zostać przekazane pobranie zostanie domyślnie wybrany główny rachunek bankowy sklepu skonfigurowany w WooCommerce.

Masa - jeśli sprzedawane przez Ciebie w sklepie produkty mają ustawioną wagę to pole Masa [kg] zostanie automatycznie uzupełnione wartością łącznej wagi zamówionych produktów.

Przekazanie przesyłek do Poczty Polskiej

Kolejnym, finalnym krokiem procesu nadawania przesyłek Poczty Polskiej jest przekazanie przesyłek do wybranej placówki. W tym celu przejdź do menu WooCommerce → Poczta Polska:

Znajdziesz tutaj wszystkie przesyłki utworzone w buforze. Nadanie przesyłek jest równoznaczne z zamknięciem buforu i przekazaniem danych do wybranej placówki.

Data nadania - wybierz datę nadania przesyłek, kiedy zostaną one dostarczone do urzędu nadania.

Urząd nadania - wybierz placówkę Poczty Polskiej, do której zostaną fizycznie dostarczone nadawane przez Ciebie przesyłki. Wybrany w tym miejscu urząd nadania zostanie zapisany jako domyślny.

Zapisz - użyj tej opcji, aby zapisać wprowadzone zmiany, lecz jeszcze bez nadawania czekających w buforze przesyłek.

Nadaj wszystkie przesyłki - użyj tego przycisku, aby ostatecznie zatwierdzić nadawanie wszystkich utworzonych przesyłek z listy w wybranej placówce pocztowej.

Wydruk etykiet - kliknij, aby pobrać wszystkie etykiety nadawcze w pliku PDF.

Opcje dla zaawansowanych użytkowników

Poniżej prezentujemy możliwości modyfikacji wtyczki dla zaawansowanych użytkowników, którzy znają podstawy PHP, HTML i CSS.

Ustawienie własnej kwoty ubezpieczenia (wersje wtyczki przed 2.0.0)

W starszych wersjach wtyczki eNadawca WooCommerce, wcześniejszych niż 2.0.0 ustawienie własnej domyślnej kwoty ubezpieczenia możliwe było dzięki zastosowaniu poniższego filtra w pliku functions.php aktualnie używanego motywu / motywu potomnego:

function atrybut_ubezpieczenie_select_1000( $value ) {
if ( isset( $value ) ) {
$value = 1000;
} else {
$value = '';
}
return $value;
}
add_filter('atrybut_Ubezpieczenie_Select_1000', 'atrybut_ubezpieczenie_select_1000');

W powyższym przypadku domyślna wysokość ubezpieczenia zostaje zmieniona na 1000 zł. Należy pamiętać jednak o tym, że nie wszystkie usługi Poczty Polskiej pozwalają na zmianę domyślnej wysokości ubezpieczenia. Zmiana spowodowana dodaniem powyższego filtra zostanie zastosowana tylko dla usług Poczty Polskiej, których ubezpieczenie może wynosić 1000 zł. W pozostałych przypadkach zostanie użyty standardowy próg 5000 zł.

Począwszy od wersji 2.0.0 wtyczki eNadawca WooCommerce i nowszych, ustawienie własnej kwoty ubezpieczenia nie wymaga już stosowania powyższego filtra - jest to standardowa funkcjonalność wtyczki dostępna z poziomu metaboxa Poczta Polska widocznego na stronie szczegółów zamówienia:

Po wprowadzeniu w polu Kwota ubezpieczenia [zł] własnej wartości, do API eNadawcy zostanie przesłana najbliższa wartość wyższego akceptowalnego dla danej usługi Poczty Polskiej progu ubezpieczenia.
 
Przykładowo, jeżeli w metaboxie Poczta Polska dla usługi Usługa paczkowa i serwisu Paczka 24 zostanie zaznaczony checkbox Ubezpieczenie i wprowadzona wartość 1000 jako Kwota ubezpieczenia [zł], to do API eNadawcy zostanie przekazana informacja o ustawieniu wysokości ubezpieczenia na 10 000 zł jako kolejnego, wyższego od wprowadzonej kwoty i akceptowalnego dla tej usługi progu ubezpieczenia.

Przesyłanie danych do zewnętrznych integracji wysyłkowych

Wtyczka umożliwia pobieranie danych związanych z utworzonymi przesyłkami i wysyłanie ich to zewnętrznych integracji wysyłkowych takich jak Baselinker czy ShipStation.

Jeżeli np. udostępniłeś/-aś swoim klientom możliwość wysyłki zamówionych produktów do wskazanego przez nich punktu odbioru Poczty Polskiej, informacja o wybranym punkcie wraz z jego ID zostanie automatycznie przekazana ze szczegółów zamówienia do Baselinkera:

Pobieranie danych

Pobieranie danych z przesyłek możliwe jest przez REST API WooCommerce. Do danych zamówienia dołączane są dane przesyłek w polu fs_shiping_lines.

Pole fs_shipping_lines jest tablicą, która zawiera co najmniej jedną przesyłkę. Przy większej ilości przesyłek, będą one umieszczone w kolejności w jakiej zostały utworzone.

Dane dostępne dla zewnętrznych integracji wysyłkowych

Wtyczka umożliwia pobieranie następujących danych:

• usługa eNadawcy
• masa paczki
• odbiór w punkcie
• punkt odbioru
• data doręczenia
• godzina doręczenia
• pobranie (kwota, konto, tytuł)
• zawartość przesyłki
• opis przesyłki
• wartość przesyłki
• potwierdzenie odbioru (typ potwierdzenia, dane do potwierdzenia)
• ubezpieczenie przesyłki
• dokumenty zwrotne
• numer nadania
• rodzaj integracji
• identyfikator nadawcy

Przykładowe dane zwracane przez wtyczkę

"fs_shipping_lines": [
{
"usluga": "pocztex_ekspres_24",
"masa": "2",
"odbior_w_punkcie": "1",
"punkt_odbioru": "988630",
"delivery_point_id": "988630",
"delivery_point_name": "Wrocław-Krzyki",
"delivery_point_address": "Krakowska 11",
"delivery_point_postcode": "50424",
"delivery_point_city": "Wrocław",
"pobranie": "1",
"pobranie_kwota": "13.53",
"pobranie_konto": "11112222333344445555666677",
"pobranie_tytul": "Zamówienie 245, adressklepu.pl",
"ubezpieczenie": "1",
"ubezpieczenie_kwota": "5000",
"zawartosc_global_express": "Produkty",
"_integration": "enadawca",
"shipping_id": 16
}
],

Najczęstsze problemy

Sprawdzenie terminu ważności hasła

Jeżeli posiadając zainstalowaną w swoim sklepie wtyczkę eNadawca napotkałeś/-aś na poniższy komunikat błędu:

Elektroniczny Nadawca, sprawdzenie terminu ważności hasła: SOAP-ERROR: Parsing WSDL: Couldn't load from 'https://e-nadawca.poczta-polska.pl/websrv/en.wsdl' : failed to load external entity "https://e-nadawca.poczta-polska.pl/websrv/en.wsdl"

oznacza to, że upłynął czas ważności Twojego hasła w systemie Poczty Polskiej eNadawca. Zgodnie z poniżej zamieszczonym fragmentem dokumentacji API eNadawcy jest ono ważne 30 dni i po tym okresie wygasa. Rozwiązaniem jest po prostu jego zmiana na nowe.