Instalacja
Wymagania techniczne
- Wtyczka wymaga na serwerze zainstalowanej minimalnie wersji PHP 5.4,
- Wtyczka wymaga danych dostępowych do API uzyskanych od obsługi Orlen Paczki (wcześniej Paczki w Ruchu). Możesz je uzyskać pisząc na adres: dh@orlenpaczka.pl
- Instalacja bezpłatnej wtyczki Flexible Shipping jako integracji bazowej.
Ważne informacje
W związku z ograniczeniami wprowadzonymi jeszcze przez Paczkę w Ruchu bezpośrednio w API, przesyłki nadane za pomocą wtyczki nie będą widoczne w Menadżerze Paczek Orlen Paczki.
Ustawienia główne
Przejdź do menu WooCommerce → Ustawienia → Wysyłka → Orlen Paczka:

Włącz/wyłącz – zaznacz tą opcję, aby aktywować funkcjonalności wtyczki i umożliwić jej działanie.
PartnerID i PartnerKey - wpisz dane logowania otrzymane do konta Orlen Paczki.
Tryb testowy - zaznacz ten checkbox jeżeli chcesz aktywować wtyczkę w trybie testowym.
Klucz API Google Maps - wprowadź wygenerowany klucz API Google Maps. Jest on potrzebny, aby móc korzystać z map dostarczanych przez Google i wybierać za ich pomocą punkt odbioru przesyłki na ekranie składania zamówienia. Jeżeli jeszcze go nie posiadasz - zobacz Jak uzyskać klucz API Google Maps →
Wyłącz mapę na stronie zamówienia - zaznacz tą opcję jeśli API Google Maps jest już wczytywane w Twoim sklepie w innym miejscu. Spowoduje to rozwiązanie ewentualnych konfliktów.
Wyłącz mapę na stronie zamówienia w panelu administracyjnym - analogicznie jak powyżej, jednakże dla panelu administracyjnego. Włącz tą opcję jeżeli API Google Maps jest już ładowane dla panelu administracyjnego gdzie indziej w ramach Twojej witryny, a aktywacja wtyczki powoduje błąd duplikacji skryptu.

Dane nadawcy - wpisz dane nadawcy, które będą widoczne na etykiecie paczki. Podanie danych nadawcy jest wymagane do zapisania ustawień. Jeśli dane będą zapisane poprawne zobaczysz komunikat OK, a przypadku błędnych Brak danych nadawcy.
Status połączenia z API - jeśli wpisałeś wszystkie dane poprawnie powinieneś otrzymać komunikat Połączono. Gdyby coś poszło nie tak zobaczysz Nie połączono i otrzymasz komunikat o błędzie.

Metody wysyłki
Wtyczka Orlen Paczka jest zintegrowana z naszą wtyczką Flexible Shipping. Integrację z Orlen Paczką 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 Orlen Paczką:
Integracja: Orlen Paczka – wybierz, aby włączyć integrację z Orlen Paczką dla tej metody wysyłki Flexible Shipping.
Rodzaj paczki – wskaż usługę Orlen Paczki, która będzie domyślnie wybrana dla danego zamówienia.
Formularz zamówienia i wybór punktu odbioru
Po wybraniu przez klienta wysyłki za pomocą Orlen Paczki w formularzu zamówienia pojawi się dodatkowa opcja Odbiór w punkcie.
Punkt odbioru można wybrać lub wyszukać po rozwinięciu pola Wybierz punkt odbioru.

Dostępna jest również mapa z wyszukiwarką dostępna po kliknięciu w link Wybierz punkt odbioru na mapie.

Zamówienie i awizacja paczek
Po złożeniu zamówienia przez klienta i wyborze metody wysyłki zintegrowanej z Orlen Paczką na stronie szczegółów zamówienia zostanie dodany metabox Orlen Paczka z opcjami przesyłki:

Dodaj pierwszą paczkę / Dodaj kolejną paczkę - użyj tych przycisków by utworzyć dowolną liczbę paczek dla danego zamówienia.

Rodzaj paczki - wybierz usługę Orlen Paczki, za pomocą której ma zostać nadana przesyłka. Domyślnie zostaje ustawiony rodzaj paczki wybrany na ekranie konfiguracji metody wysyłki Flexible Shipping.
Rozmiar paczki - wskaż rozmiar paczki spośród dostępnych opcji - S / M / L.
Dane paczki - indywidualne informacje dotyczące paczki - jej numer oraz link do śledzenia. Dane te zostaną automatycznie uzupełnione i pojawią się po zaawizowaniu paczki.
Etykieta - możesz z tego miejsca pobrać etykiety dla pojedynczych paczek osobno korzystając z przycisku Pobierz etykietę nadawczą lub wszystkich razem, jeżeli jest ich więcej niż jedna, klikając w button poniżej metaboxa Pobierz etykiety nadawcze wszystkich paczek.
Usuń paczkę - możesz usuwać poszczególne paczki i ponownie je nadawać w ramach danego zamówienia.
Odbiór w punkcie - możesz zmienić punkt odbioru paczki wybrany przez klienta. Zmiana punktu odbioru jest możliwa tylko dla nieawizowanych paczek.
Awizuj dodane paczki - dane o paczkach zostają przekazane do systemu API Orlen Paczki. Po zaawizowaniu możesz sprawdzić w kolumnie Dane paczki numer paczki lub kliknąć link do śledzenia i przejść bezpośrednio na stronę Orlen Paczki.

Zestawienie paczek do nadania
Po zaawizowaniu paczek przejdź do menu WooCommerce → Orlen Paczka:

Zestawienie paczek
Numer paczki - klikając numer paczki w nowej karcie przeglądarki nastąpi przekierowanie do strony Orlen Paczki umożliwiającej śledzenie przesyłki. Możesz również z poziomu szybkich linków, które pojawią się po najechaniu kursorem na numer paczki (Zamówienie nr #123 | Usuń paczkę) przejść do bezpośrednio do zamówienia w Twoim sklepie, którego dotyczy paczka lub ją usunąć.
Punkt odbioru - wybrany przez klienta punkt odbioru paczki (lub zmieniony z poziomu ekranu edycji zamówienia).
Adres dostawy - wprowadzony przez klienta na ekranie finalizacji zamówienia adres rozliczeniowy.
Rodzaj paczki - wybrany typ usługi Orlen Paczki.
Data nadania - jest to data zaawizowania paczki z poziomu ekranu edycji zamówienia.
Etykieta - jeśli nie pobrałeś jeszcze etykiety z poziomu ekranu edycji zamówienia możesz to zrobić teraz z tego miejsca za pomocą odnośnika Pobierz etykietę.
Działania masowe
Pobierz protokół nadania - wybierz paczki z listy i pobierz dla nich wymagany protokół nadania. Po prawidłowym wygenerowaniu protokołu zobaczysz komunikat z linkiem do pobrania dokumentu w formacie .pdf.

Pobierz etykiety nadawcze - możesz pobrać etykiety nadawcze dla wszystkich, bądź tylko wybranych paczek. Po wygenerowaniu etykiet zobaczysz komunikat z linkiem do pobrania dokumentu w formacie .pdf.

Usuń paczki - możesz usunąć wszystkie lub tylko wybrane paczki z listy.
Statusy paczek
Nowe - wszystkie paczki, które zostały zaawizowane z poziomu ekranu edycji zamówienia.
Przetworzone - paczki, dla których został wygenerowany protokół nadania.
Starsze - paczki powyżej 30 dni od nadania.
Edycja produktu i wyłączenie wysyłki Orlen Paczką
Jeśli chcesz wyłączyć możliwość wysyłki wybranych produktów za pomocą Orlen Paczki przejdź do ekranu edycji właściwego produktu, a następnie w zakładce Wysyłka zaznacz opcję Jeśli ten produkt znajduje się w koszyku wyłącz wysyłkę za pomocą Orlen Paczka i zapisz zmiany. Poskutkuje to ukryciem metody wysyłki Flexible Shipping z podpiętą integracją Orlen Paczka jeśli produkt ten znajdzie się w koszyku.
Dotyczy to również sytuacji, w której w koszyku będą również inne produkty – wystarczy, aby jeden produkt obecny w koszyku miał zaznaczoną tę opcję, aby wysyłka Orlen Paczką została uniemożliwiona.

Powiadomienie e-mail o nadaniu paczki
Po wygenerowaniu protokołu nadania do zamówienia zostanie dodana standardowa notatka dla klienta WooCommerce o następującej treści:

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

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
- typ usługi Orlen Paczki
- punkt odbioru
Przykładowe dane zwracane przez wtyczkę
"fs_shipping_lines": [
{
"_integration": "paczkawruchu",
"paczka_w_ruchu_type": "paczka_standardowa",
"paczka_w_ruchu_punkt_odbioru": "KT-559349-53-49",
"delivery_point_id": "KT-559349-53-49",
"delivery_point_name": "Kiosk z wejściem, zlokalizowany w Biedronce.",
"delivery_point_address": "OFIAR OŚWIĘCIMIA 31",
"delivery_point_postcode": "32-620",
"delivery_point_city": "Brzeszcze",
}
],