Instalacja
Ważne informacje
Aby wtyczka działała poprawnie i aby dało się utworzyć paczki w systemie oraz wygenerować etykiety wymagane są następujące rzeczy:
- Dla usługi Kurier InPost umowa na usługi kurierskie oraz konto dla przesyłek kurierskich (dla ShipX) https://kurier.inpost.pl/.
- Dla usługi Paczkomaty konto w managerze paczek lub umowę na w.w. usługi. Jeśli nie masz konta, załóż je tutaj. Wtyczka obsługuje Paczkomaty zarówno w API ShipX, jak i w API XML.
- Wymagane jest podanie numeru telefonu komórkowego przez kupującego w polu WooCommerce (billing_phone) – domyślnie to pole jest wymagane, więc jeśli nie robiłeś żadnych modyfikacji w formularzu zamówienia to wystarczy, że upewnisz się, że klienci będą podawać nr telefonu komórkowego.
Wymagania techniczne
Z uwagi na fakt, że wtyczka korzysta z API dostarczonego przez Paczkomaty upewnij się, że:
- na serwerze jest włączone ustawienie
allow_url_fopen = On, - wtyczka posiada prawa zapisu do katalogu
woocommerce-paczkomaty-inpost/api/data.
W 99% przypadków nie musisz się o to martwić, jeśli natomiast konfiguracja Twojego serwera tego nie uwzględnia to skontaktuj się ze swoim dostawcą hostingowym i poproś, aby odpowiednio skonfigurował serwer.
Konfiguracja
Ustawienia wtyczki znajdują się w menu WooCommerce → Ustawienia → Wysyłka → InPost.
Ustawienia główne
Pierwszym krokiem do dalszej konfiguracji integracji InPost jest wprowadzenie Twojego tokena.
Bez tokena nie zostanie nawiązane połączenie z API, co nie tylko uniemożliwia nadawanie paczek, ale i dalszą konfigurację. Bez połączenia z API część opcji konfiguracyjnych jest niedostępna (np. wybór organizacji).
Po wprowadzeniu tokena na dole strony konfiguracyjnej znajdziesz przycisk Zapisz. Strona odświeży się.
Adres URL dla API (webhook) – wygenerowany adres URL zarejestruj w InPost, prześlij adres do swojego opiekuna InPost.
Organizacja – jeśli zarejestrowałeś w InPost kilka organizacji wybierz właściwą dla twojego sklepu.
Nowość Usługi InPost – w API ShipX możesz nie mieć domyślnie włączonych wszystkich usług. Jeśli nadal korzystasz z API XML, upewnij się w tym miejscu, że masz dostępną usługę Paczkomatów w API ShipX. Jeśli nie, skontaktuj się ze swoim opiekunem InPost, który włączy tę usługę na Twoim koncie.
Ustawienia przesyłek
Domyślny sposób nadania – wybierz domyślny sposób nadania przesyłek. Pamiętaj, że przesyłek kurierskich nie można nadawać w Paczkomatach!
Generowanie przesyłek – automatyzacja nadawania
Nowość Integracja z InPost 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ć automatyczną zmianę statusu zamówienia na Zrealizowane po nadaniu przesyłki. Funkcjonalność zadziała tylko przy automatycznym generowaniu przesyłek.
Etykiety – ustawienia generowania
Nowość Format etykiet – wybierz format generowanych etykiet.
Nowość Typ etykiety – wybierz normalny lub A6.
Nowość Drukowanie – jeśli posiadasz wtyczkę Flexible Printing, możesz włączyć automatyczne drukowanie wygenerowanych etykiet lub zapisywanie na dysku.
Opcje zaawansowane
Tryb testowy – po zaznaczeniu tej opcji pojawi się pole do wprowadzenia tokena dla trybu testowego.
Zapis zdarzeń – włączenie tej opcji przydaje się do diagnozowania problemów. Zdarzenia zapisywane są w dzienniku WooCommerce.
Nowość Typ listy paczkomatów – wtyczka umożliwia wybór typu listy paczkomatów. Domyślnie jest to Select2, który wyświetla listę paczkomatów z możliwością wyszukiwania. Ten typ ładuje pełną listę paczkomatów z możliwością wyszukiwania. W przypadku Select2 (AJAX) mechanizm ten wyszukuje paczkomat nie na liście, a bezpośrednio w bazie. Paczkomat pokaże się na liście dopiero po wpisaniu min. 3 znaków.
Typy listy paczkomatów:
- Select – zwykła lista wyboru z możliwością wyboru paczkomatów
- Select2 – lista wyboru paczkomatów z możliwością wyszukiwania bezpośrednio na liście
- Select2 (AJAX) – lista wyboru paczkomatów z wyszukiwaniem paczkomatów bezpośrednio w bazie.
Status połączenia – jeśli napotkasz na problemy w korzystaniu z integracji (np. generowanie etykiet), w tym miejscu możesz sprawdzić, czy jest poprawne połączenie z API.
API XML (Paczkomaty)
Jeśli nadal korzystasz z API XML, możesz skonfigurować dane dostępowe w tej sekcji. Zalecamy jednak jak najszybszą migrację na API ShipX!
Login i hasło – podaj swój login (e-mail) i hasło w systemie Paczkomaty.
Domyślny sposób nadania – paczkomat lub kurier (możliwa jest edycja tej opcji w każdym zamówieniu).
Jeśli chcesz skorzystać z trybu testowego w API XML, włącz tryb testowy w ustawieniach.
Po włączeniu tej opcji oprócz pola dla tokena trybu testowego w sekcji API XML (Paczkomaty) również pojawią się dodatkowe pola:
W tym miejscu możesz skorzystać z ogólnodostępnego konta:
- login: test@testowy.pl
- hasło: WqJevQy*X7)
lub założyć własne na stronie https://sandbox-manager.paczkomaty.pl/.
Tworzenie metody wysyłki
Wtyczka InPost jest zintegrowana z naszą wtyczką Flexible Shipping. Integrację z usługami InPost 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 InPost i ustawić opcje dodatkowe:
Integracja – wybierz InPost, aby włączyć integrację dla tej metody wysyłki.
Usługa InPost – wybierz Paczkomat, Paczka E-Commerce lub Kurier.
Usługa Kurier – dla usługi InPost Kurier wybierz typ usługi np. Standard.
Rozmiar paczki – dla usługi Paczkomaty wybierz gabaryt paczki A, B lub C. Gabaryt możesz zawsze wybrać lub zmienić w metabox InPost w edycji zamówienia.
Długość, Szerokość i Wysokość paczki – dla usługi kurierskiej wymagane jest podanie wymiarów paczki. Aby nadawać przesyłki automatycznie możesz stworzyć wiele metod wysyłki o różnych gabarytach i skonfigurować ich wyświetlanie wg. ustawionych reguł.
Ubezpieczenie – możesz włączyć opcję ubezpieczenia dla wybranej metody wysyłki (Paczkomat, Kurier). Kwota zostanie naliczona automatycznie na podstawie wartości zamówienia.
Pobranie – możesz włączyć opcję pobrania dla wybranej metody wysyłki (Paczkomat, Kurier). Kwota pobrania zostanie naliczona automatycznie na podstawie wartości zamówienia. Konto dla pobrania zostanie pobrane z konta InPost. W formularzu zamówienia lista dostępnych Paczkomatów będzie ograniczona do posiadających opcje płatności.
Nadawanie przesyłek
Nadawanie pojedynczych przesyłek
Po złożeniu zamówienia przez klienta i wyborze wysyłki za pomocą InPost do strony zamówienia zostanie dodany boks z opcjami InPost.
Wybraną usługę InPost możesz zmienić przed nadaniem przesyłki.
Jeśli wszystkie dane są poprawne kliknij Utwórz przesyłkę – przesyłka zostanie wygenerowana w systemie InPost – tej operacji nie można cofnąć z poziomu wtyczki. Jeśli nie chcesz jeszcze utworzyć paczki kliknij Zapisz, aby zapisać ustawienia i utworzyć paczkę w późniejszym terminie.
Po utworzeniu paczki możesz pobrać etykietę.
Dla przesyłki kurierskiej możesz odświeżyć status wysyłki jeśli nie odświeżył się automatycznie klikając Odśwież status. Przesyłki kurierskie jako pierwszy otrzymują status created, a dopiero po opłaceniu przesyłki (automatycznie) system InPost zwróci status confirmed i dla tego statusu będzie możliwe pobranie etykiety nadawczej.
Nadawanie wielu przesyłek
Nowość Integracja z InPost 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 InPost 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
Dodatkowe przesyłki InPost
Nowość Wtyczka WooCommerce InPost – Paczkomaty, Listy, Kurier umożliwia dodawanie przesyłek do zamówień utworzonych ręcznie oraz do zamówień z aktywną inną integracją wysyłkową WP Desk.
W edycji zamówienia dostępny jest box Dodaj przesyłkę. Wybierz integrację InPost, a następnie kliknij Dodaj. Pojawi się nowy box InPost w którym będzie możliwe skonfigurowanie przesyłki InPost i jej nadanie.
Najczęstsze problemy
Podczas tworzenia etykiet kurierskich wyświetla się błąd dotyczący organizacji
Jeśli w trakcie generowania etykiety otrzymujesz następujący komunikat: No route matches POST v1/organizations/shipments, oznacza to że nie ma wybranej organizacji w konfiguracji wtyczki:
Jeśli masz w tym miejscu puste pole bez możliwości wyboru, skontaktuj się z opiekunem klienta InPost. Pamiętaj że na usługi kurierskie musisz mieć podpisaną umowę. Zdarza się, że przedstawiciele InPostu wysyłają dane dostępowe bez aktywowanego dostępu do ShipX. W takim przypadku wybór organizacji jest możliwy, ale błąd nadal występuje. Poproś opiekuna o dostęp do ShipX i wygenerowanie nowego tokenu.
Lista paczkomatów wyświetla się nieprawidłowo
Może się zdarzyć, że motyw w sklepie nie wyświetli prawidłowo pola typu select2 które prezentuje listę punktów odbioru InPost. Możesz zmienić typ pola na select ale pamiętaj, że pole tego typu nie obsługuje wyszukiwania na liście. Aby zmienić typ pola dodaj do pliku functions.php w motywie potomnym sklepu następujący kod:
add_filter( 'woocommerce_paczkomaty_inpost_checkout_select2', '__return_false' );