Instalacja
Ważne informacje
- Korzystanie z wtyczki wymaga posiadania konta w systemie eNadawcy:
- 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.
Ustawienie główne
Przejdź do menu WooCommerce → Ustawienia → Wysyłka → eNadawca.
Logowanie
Użytkownik i hasło - wpisz dane logowanie 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 o zbliżającym się wygaśnięciu hasła.
Tryb testowy - zaznacz aby włączyć tryb testowy i przetestować działanie wtyczki.
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 - jeśli dane logowania są poprawne zobaczysz komunikat Poprawne połączenie z eNadawcą. Gdyby dane były nie poprawne pojawi się komunikat Brak połączenia z eNadawcą, sprawdź czy wpisałeś prawidłowe dane dla wybranego trybu (produkcyjnego lub testowego).
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 masz kilka sklepów korzystających z integracji z eNadawcą. Domyślnie wpisany jest tutaj 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
Nowość 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 - domyślnie przesyłki możesz nadawać ręcznie w edycji zamówienia lub masowo na liście zamówień. Aby nadawać przesyłki automatycznie wybierz opcję Automatycznie i ustaw dodatkowe opcje.
Status zamówienia - jeśli wybrałeś automatyczny sposób generowania przesyłek wybierz dla jakiego statusu zamówienia przesyłki będą generowane.
Zrealizuj zamówienia - możesz ustawić automatyczna zmianę statusu zamówienia na Zrealizowane po nadaniu przesyłki.
Etykiety ustawienia generowania
Nowość Drukowanie - jeśli posiadasz wtyczkę Flexible Printing, możesz włączyć automatyczne drukowanie wygenerowanych etykiet lub zapisywanie na dysku.
Metody wysyłki
Wtyczka eNadawca jest zintegrowana z naszą wtyczką Flexible Shipping. Integrację z eNadawcą można dodać do każdej metody wysyłki stworzonej za pomocą wtyczki Flexible Shipping. Sprawdź jak tworzyć nowe metody wysyłki →
Przy tworzeniu metody wysyłki możesz dodatkowo włączyć integrację z eNadawcą:
eNadawca - zaznacz, aby włączyć integrację z eNadawcą dla tej metody wysyłki.
Usługa Poczty Polskiej - wybierz usługę Poczty Polskiej, która będzie domyślnie wybrana dla danego zamówienia.
Odbiór w punkcie - jeśli dana usługa Poczty Polskiej ma możliwość odbioru w punkcie, możesz ją aktywować. W formularzu zamówienia pojawi się opcja Odbiór w punkcie oraz możliwość wyszukania punktu z listy lub mapy.
Nowość Wybierz punkt na mapie - opcja dostępna w formularzu zamówienia po wybraniu usługi odbioru w punkcie. Po kliknięciu w link zostanie wyświetlona mapa z wyszukiwarką punktów Poczty Polskiej. Dla włączonej opcji za pobraniem zostaną wyświetlone tylko punkty obsługujące taką metodę płatności.
Nowość Atrybuty usługi - w zależności od wybranej usługi możesz ustawić wybrane atrybuty na stałe. Dzięki takiej konfiguracji w edycji zamówienia wystarczy tylko nadać paczkę bez dodatkowej konfiguracji. Możliwe do ustawienia parametry:
- Kategoria: Priorytet, Ekonomiczny
- Serwis (dla Usługi paczkowej): Paczka 24, Paczka 48, Paczka Ekstra 24
- Gabaryt
- Opakowanie
- Pobranie
- Ubezpieczenie
Formy dostawy i usługi eNadawcy:
- przesyłka polecona,
- przesyłka firmowa polecona,
- paczka pocztowa,
- usługa paczkowa (Paczka24, Paczka48, Paczka Ekstra 24),
- Pocztex - Kurier Ekspres 24,
- Pocztex - Kurier Krajowy,
- Pocztex Kurier 48 (Przesyłka biznesowa),
- zagraniczna przesyłka polecona,
- zagraniczna paczka do UE,
- Global Expres.
Nadawanie, tworzenie przesyłki i generowanie nalepki
Nadawanie pojedynczych przesyłek
Po złożeniu zamówienia przez klienta i wyborze wysyłki zintegrowanej z eNadawcą do strony zamówienia zostanie dodany box z opcjami przesyłki.
Jeśli przesyłka nie wymaga dodatkowej konfiguracji parametrów, kliknij przycisk Zapisz. W tym momencie zostanie wygenerowany numer nadania. Nie jest to jeszcze równoznaczne ze stworzeniem przesyłki, w tym momencie tworzy się bufor z przesyłkami, który należy w kolejnym kroku przekazać do systemu eNadawcy (opis poniżej).
Po wygenerowaniu numeru nadania możesz pobrać etykietę wysyłkową dla tej przesyłki oraz od tego momentu pojawi się przycisk umożliwiający śledzenie przesyłki.
Powtórz te kroki dla każdego zamówienia, które chcesz nadać za pomocą systemu eNadawcy. Zostaną one dodane do buforu i będą oczekiwać na przekazanie do Poczty Polskiej. Na tym etapie przesyłkami możesz już zarządzać z panelu eNadawcy.
Nadawanie wielu przesyłek
Nowość Integracja z eNadawcą umożliwia ręczne nadawanie wielu przesyłek z listy zamówień WooCommerce.
Aby nadać przesyłki dla wielu zamówień wybierz je na liście zamówień WooCommerce, a następnie z Masowe działania wybierz opcję Nadaj przesyłki i kliknij przycisk 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
Nowość Integracja z eNadawcą umożliwia całkowicie automatyczne nadawanie przesyłek na podstawie statusu zamówienia.
Jak włączyć automatyczne nadawanie przesyłek przeczytasz w sekcji Generowanie przesyłek - 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 była już nadana zostanie utworzona nowa ale pamiętaj aby usunąć poprzednią z buforu eNadawcy.
Możesz ustawić dodatkowe atrybuty dla przesyłki np. Ostrożnie.
Rachunek dla pobrania - jeśli wybrałeś pobranie dla przesyłki, kwota zostanie pobrana z wartości zamówienia. Domyślnie zostanie wybrany główny rachunek skonfigurowany w WooCommerce.
Masa - jeśli produkty mają ustawioną wagę to do pola Masa [kg] zostanie pobrana łączna waga zamówienia.
Przekazanie przesyłek do Poczty Polskiej
Kolejnym krokiem jest przekazanie przesyłek do wybranej placówki. 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.
Urząd nadania - wybierz urząd nadania, wybrany urząd zostanie zapisany jako domyślny.
Nadaj wszystkie przesyłki - kliknij, aby nadać wszystkie przesyłki z listy do wybranej placówki.
Wydruk nalepek - kliknij, aby pobrać wszystkie nalepki 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
Za pomocą filtra:
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');
istnieje możliwość modyfikacji domyślnych kwot ubezpieczenia na własne. W powyższym przypadku wysokość ubezpieczenia zostanie 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 do pliku functions.php motywu/motywu potomnego 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ł.
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.
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ść wysyłki
- opis wysyłki
- wartość wysyłki
- potwierdzenie odbioru (typ potwierdzenia, dane do potwierdzenia)
- ubezpieczenie wysyłki
- dokumenty zwrotne
- numer nadania
- rodzaj integracji
- identyfikator nadawcy
Przykładowe dane zwracane przez wtyczkę
"fs_shipping_lines": [
{
"usluga": "pocztex_ekspres_24",
"masa": "1",
"odbior_w_punkcie": "1",
"punkt_odbioru": "368173",
"data_doreczenia": "",
"godzina_doreczenia": "DO 08:00",
"pobranie": "1",
"pobranie_kwota": "13.53",
"pobranie_konto": "40124021356280584750730207",
"pobranie_tytul": "Zamówienie 245, woo38.wpdesk.dev",
"zawartosc": "",
"opis": "Zamówienie #245",
"wartosc": "",
"potwierdzenie_odbioru_forma": "LIST_ZWYKLY_PRIORYTETOWY",
"typ_potwierdzenia": "sms",
"numer_telefonu": "",
"adres_email": "",
"ubezpieczenie_kwota": "5000",
"dokumenty_zwrotne_forma": "PACZKA_EKSTRA_24",
"numer_nadania": "EE984333490PL",
"guid": "95B65B270479731BFB3ADB8B9D7CC644",
"idBufor": 20185521,
"_integration": "enadawca",
"shipping_id": 205
}
],
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.
