InPost - Paczkomaty, Listy, Kurier - WooCommerce

Instalacja

Instrukcja instalacji →

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

• Instalacja bezpłatnej wtyczki Flexible Shipping jako integracji bazowej.

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.

Jeżeli nie masz pewności jak poprawnie skonfigurować przesyłkę pobraniową, odpowiedź znajdziesz w naszym poradniku - Jak skonfigurować przesyłkę za pobraniem w WooCommerce?

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.

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.

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:

• rodzaj integracji
• sposób utworzenia
• usługa
• ID paczkomatu do odbioru
• gabaryt przesyłki
• sposób wysyłki
• ubezpieczenie wysyłki
• kwota ubezpieczenia wysyłki
• przesyłka za pobraniem
• kwota pobrania
• waga przesyłki
• wymiary przesyłki
• sposób wysyłki
• ID paczkomatu do wysyłki

Przykładowe dane zwracane przez wtyczkę

"fs_shipping_lines": [
{
"_integration": "paczkomaty",
"_shipping_id": "54",
"created_via": "checkout",
"_paczkomaty_usluga": "paczkomaty",
"_paczkomat_id": "BEL085",
"_paczkomat_size": "A",
"_paczkomat_sending_method": "dispatch_order",
"_paczkomat_ubezpieczenie": "1",
"_paczkomat_cod": "1",
"_paczkomat_dropoff_parcel_machine": "BBI02A",
"_paczkomat_dropoff_pop": "",
"_paczkomat_dropoff_dispatch_point": "",
"_paczkomat_customer_ref": "Zamówienie 135",
"_paczkomat_ubezpieczenie_amount": "13.53",
"_paczkomat_cod_amount": "13.53",
"_paczkomat_weight": "1",
"_flexible_shipping_status": "created",
"_paczkomat_width": "",
"_paczkomat_height": "",
"_paczkomat_length": "",
"_paczkomat_shipment_id": "218436",
}
],

Zamiana nadawcy z odbiorcą

Istnieje możliwość zamiany domyślnego nadawcy z odbiorcą za pomocą filtra woocommerce_paczkomaty_inpost_shipment_data. Filtr ten otrzymuje na wejściu dane przesyłki, które wtyczka wysyła do API oraz obiekt przesyłki WPDesk_Flexible_Shipping_Shipment_Paczkomaty, z którego oprócz danych ustawionych w metaboxie można pobrać także dane zamówienia.

Klient może wtedy zostać nadawcą, a sklep odbiorcą przesyłki. Rozwiązanie to znajduje zastosowanie np. w sytuacji gdy sklep funkcjonuje jako skup i to klienci nadają do niego przesyłki z przedmiotami.

Użycie filtra:

/**
* @param stdClass $shipment_data .
* @param WPDesk_Flexible_Shipping_Shipment_Paczkomaty $order .
*
* @return stdClass
*/
function modify_paczkomaty_inpost_shipment_data( $shipment_data, $shipment ) {
$order = $shipment->get_order();
return $shipment_data;
}
add_filter( 'woocommerce_paczkomaty_inpost_shipment_data', 'modify_paczkomaty_inpost_shipment_data', 10, 2 );

Przykładowe zastosowanie:

/**
* @param stdClass $shipment_data .
* @param WPDesk_Flexible_Shipping_Shipment_Paczkomaty $order .
*
* @return stdClass
*/
function replace_sender_and_receiver_in_inpost_shipment_data( $shipment_data, $shipment ) {
$shipment_data->sender = $shipment_data->receiver;

$receiver = new stdClass();
$receiver->address = new stdClass();

$receiver->address->street = 'ul. Przykladowa';
$receiver->address->building_number = '23/1';
$receiver->address->city = 'Warszawa';
$receiver->address->post_code = '01-231';
$receiver->address->country_code = 'PL';

$receiver->company_name = 'Nazwa firmy';
$receiver->first_name = 'Jan';
$receiver->last_name = 'Kowalski';
$receiver->email = 'example@domain.pl';
$receiver->phone = '123456789';

$shipment_data->receiver = $receiver;

return $shipment_data;
}
add_filter( 'woocommerce_paczkomaty_inpost_shipment_data', 'replace_sender_and_receiver_in_inpost_shipment_data', 10, 2 );

Zmiana treści notatek do zamówienia / wysyłanych wiadomości SMS

Za pomocą hook'a woocommerce_new_order_note_data istnieje możliwość modyfikacji dodawanej do zamówienia notatki po nadaniu przesyłki i wygenerowaniu etykiety, zawierającej link trackingowy. Informacja ta jest również wysyłana do klienta, a możliwość jej zmiany ma szczególne znaczenie w przypadku korzystania z dodatkowych systemów powiadomień drogą SMSową.

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' );

Błąd cURL error 35: OpenSSL SSL_connect: SSL_ERROR_SYSCALL in connection to api-shipx-pl.easypack24.net:443

Jeżeli na stronie składania zamówienia metody wysyłki InPost nie wyświetlają się poprawnie, a w ustawieniach wtyczki przy statusie połączenia występuje błąd:

to najprawdopodobniej ma to związek z obsługą przez serwer szyfrowanych połączeń, a dokładniej z biblioteką SSL. Zazwyczaj błąd ten pojawia się w przypadku używania na serwerze mocno przedawnionych wersji OpenSSL, cURL lub PHP i jego komponentów, a rozwiązaniem okazuje się najczęściej po prostu ich aktualizacja do nowszych wydań.