GLS Track and Trace Pro - automatyczne śledzenie przesyłek GLS w PrestaShop

Jak to działa?

Po zainstalowaniu modułu i wpisaniu danych dostępowych do API GLS (które otrzymujesz od swojego opiekuna w GLS Poland), moduł zaczyna działać natychmiast. Gdy zamówienie w Twoim sklepie osiąga status „Wysłano", moduł automatycznie rozpoczyna śledzenie przypisanego numeru przesyłki. Od tego momentu cyklicznie odpytuje serwery GLS o aktualne zdarzenia dostawy — odbiór paczki, tranzyt, dostarczenie, problem z dostawą czy zwrot do nadawcy.

Każde zdarzenie jest zapisywane w historii wraz z datą, godziną, kodem zdarzenia, lokalizacją i krajem. Na podstawie tych zdarzeń moduł automatycznie zmienia status zamówienia w PrestaShop — na przykład ustawia „Dostarczono", gdy kurier potwierdzi odbiór paczki przez klienta. Klient otrzymuje wtedy powiadomienie e-mail z informacją o zmianie statusu, dokładnie tak jak przy ręcznej zmianie statusu przez administratora.

Pełna lista funkcji

• Automatyczne śledzenie przesyłek — moduł sam rozpoczyna monitorowanie paczki, gdy zamówienie przejdzie w status „Wysłano". Nie musisz nic klikać ani kopiować numerów śledzenia ręcznie.
• Bezpośrednia integracja z API GLS Group — moduł komunikuje się z oficjalnym interfejsem programistycznym GLS (api.gls-group.eu), korzystając z protokołu REST i uwierzytelniania HTTP Basic Auth. Dane przesyłek pobierane są w formacie JSON, co zapewnia szybkość i niezawodność.
• Automatyczna zmiana statusów zamówień — na podstawie kodów zdarzeń GLS moduł rozpoznaje pięć kluczowych stanów przesyłki i odpowiednio aktualizuje zamówienie:
  • W tranzycie — paczka została odebrana przez kuriera i jest w drodze (kody zdarzeń 1.x, 2.x, 11.x, 67.x)
  • Dostarczono — kurier potwierdził doręczenie paczki odbiorcy (kod zdarzenia 3.x)
  • Problem z dostawą — nieudana próba doręczenia, brak odbiorcy pod adresem (kody 4.x, 12.x)
  • Zwrot do nadawcy — paczka wraca do Ciebie jako nadawcy (kod 5.x)
  • Oczekuje na sprawdzenie — numer śledzenia został dodany, ale API nie zwróciło jeszcze żadnych zdarzeń
  Każdy z tych stanów możesz powiązać z dowolnym statusem zamówienia w Twoim sklepie. Jeśli nie chcesz, aby dany stan zmieniał status zamówienia — po prostu wybierz opcję „Nie zmieniaj".
• Pełna historia zdarzeń — każde zdarzenie przesyłki jest zapisywane z dokładną datą i godziną, kodem GLS, opisem tekstowym, lokalizacją sortowni lub oddziału kurierskiego oraz kodem kraju. Historia jest dostępna zarówno dla administratora sklepu, jak i dla klienta na stronie szczegółów zamówienia.
• Powiadomienia e-mail dla klientów — gdy moduł zmieni status zamówienia (np. na „Dostarczono"), PrestaShop automatycznie wyśle klientowi powiadomienie e-mail z nowym statusem. Klient jest na bieżąco informowany o losach swojej paczki bez żadnego wysiłku z Twojej strony.
• Panel śledzenia dla klienta — na stronie szczegółów zamówienia klient widzi czytelną oś czasu (timeline) z kolejnymi zdarzeniami dostawy. Widzi numer przesyłki, aktualny status w formie kolorowej etykiety oraz link do śledzenia na oficjalnej stronie GLS.
• Panel administracyjny z listą przesyłek — w menu administracyjnym PrestaShop pojawia się zakładka „GLS Tracking" z kompletną listą wszystkich śledzonych przesyłek. Lista zawiera filtry, sortowanie, eksport do CSV, akcje masowe i wyszukiwanie po numerze przesyłki, statusie, kodzie zdarzenia i zakresie dat.
• Filtr statusów w formie listy rozwijanej — w nagłówku kolumny „Status" znajduje się lista rozwijana (dropdown) z opcjami: Dostarczono, Zwrócono, W tranzycie, Problem, Oczekuje na sprawdzenie. Jedno kliknięcie filtruje listę do wybranego stanu — idealne, gdy chcesz szybko zobaczyć np. wszystkie paczki z problemami.
• Podgląd historii zdarzeń w oknie modalnym — kliknięcie ikony „Zobacz zdarzenia" przy dowolnej przesyłce otwiera wyskakujące okno (popup) z pełną osią czasu zdarzeń, bez opuszczania listy. Szybki podgląd bez przeładowywania strony, dzięki technologii AJAX.
• Masowe odświeżanie statusów — przycisk „Odśwież wszystkie śledzenia" w pasku narzędzi pobiera aktualne dane z API GLS dla wszystkich niedostarczonych i niezwróconych przesyłek jednocześnie. Możesz też zaznaczyć wybrane przesyłki i odświeżyć tylko ich statusy.
• Automatyczny import z modułu GLS Poland — jeśli korzystasz z oficjalnego modułu glspoland do generowania etykiet przewozowych, moduł GLS Track and Trace Pro potrafi automatycznie importować numery przesyłek z tabel tego modułu. Nie musisz przepisywać numerów ręcznie — wystarczy wybrać źródło danych „Moduł GLS Poland" w konfiguracji.
• Dwa źródła numerów przesyłek — moduł obsługuje dwa tryby pozyskiwania numerów śledzenia:
  • Natywny PrestaShop — odczytuje numer z pola „Numer śledzenia przewoźnika" w szczegółach wysyłki zamówienia
  • Moduł GLS Poland — odczytuje bezpośrednio z tabeli gls_poland_parcel utworzonej przez oficjalny moduł glspoland
• Mechanizm cron z dwoma fazami — zadanie cron składa się z dwóch faz:
  • Faza 1 — automatyczny import nowych numerów przesyłek z modułu GLS Poland (uruchamiana przy każdym wywołaniu crona)
  • Faza 2 — odpytywanie API GLS o aktualne zdarzenia dla wszystkich aktywnych przesyłek (uruchamiana zgodnie z ustawionym interwałem, domyślnie co 15 minut)
• Dwa sposoby uruchamiania crona — możesz skonfigurować cron na dwa sposoby:
  • HTTP — wklejasz podany adres URL do panelu hostingowego jako zadanie cron (np. w cPanel, DirectAdmin, Plesk)
  • CLI — uruchamiasz polecenie PHP z linii poleceń, co jest bardziej wydajne na serwerach VPS i dedykowanych
  W konfiguracji modułu znajdziesz gotowe adresy i polecenia do skopiowania, wraz z przykładowym wpisem crontab.
• Konfigurowalny interwał odpytywania — sam decydujesz, jak często moduł ma sprawdzać statusy przesyłek w API GLS. Domyślna wartość to 15 minut. API GLS cache'uje odpowiedzi przez 5 minut, więc wartości krótsze niż 5 minut nie mają sensu i nie przyspieszą aktualizacji.
• Przycisk testowania połączenia z API — w formularzu konfiguracji znajdziesz przycisk „Testuj połączenie API", który natychmiast sprawdza, czy podane dane logowania są prawidłowe i czy serwer GLS odpowiada. Nie musisz czekać na pierwszy cron, żeby dowiedzieć się, czy konfiguracja jest poprawna.
• Środowisko testowe i produkcyjne — moduł obsługuje zarówno środowisko produkcyjne GLS (api.gls-group.eu), jak i testowe (qs1.gls-group.eu). Możesz bezpiecznie przetestować integrację na serwerze deweloperskim przed uruchomieniem na sklepie produkcyjnym.
• Pełna obsługa multistore — moduł został zaprojektowany z myślą o sklepach wielostanowiskowych (multistore) PrestaShop. Każdy sklep w sieci multistore może mieć własne dane API GLS, własne ustawienia interwału crona i własne mapowania statusów zamówień. Lista przesyłek w panelu administracyjnym automatycznie filtruje wyniki do aktualnie wybranego sklepu, grupy sklepów lub wszystkich sklepów.
• Ręczne dodawanie numerów śledzenia — na stronie zamówienia w panelu administracyjnym znajdziesz formularz do ręcznego wpisania numeru przesyłki GLS. Moduł waliduje numer (tylko litery, cyfry i myślniki, maksymalnie 64 znaki) i od razu rozpoczyna śledzenie.
• Ochrona przed duplikatami — moduł nie pozwala dodać tego samego numeru przesyłki dwa razy do tego samego zamówienia. Zarówno interfejs użytkownika, jak i mechanizm bazy danych (klucz unikalny) chronią przed zduplikowanymi wpisami, nawet w przypadku jednoczesnych żądań.
• Link do śledzenia na stronie GLS — przy każdej przesyłce wyświetlany jest link prowadzący bezpośrednio do strony śledzenia na oficjalnym portalu GLS. Zarówno administrator, jak i klient mogą jednym kliknięciem sprawdzić pełne informacje o przesyłce na stronie przewoźnika.
• Kolorowe etykiety statusów — statusy przesyłek oznaczone są kolorowymi etykietami (badge) dla natychmiastowej czytelności:
  • zielony — dostarczono
  • czerwony — zwrócono do nadawcy
  • niebieski — w tranzycie
  • pomarańczowy — problem z dostawą
  • szary — oczekuje na sprawdzenie
• Kompatybilność z PrestaShop 1.7.6 do 9.x — moduł jest kompatybilny z PrestaShop od wersji 1.7.6 przez całą serię 8.x aż do najnowszych wersji 9.x. Obsługuje zarówno starszy (legacy), jak i nowy system tłumaczeń PrestaShop. Wykorzystuje mechanizm bootstrap do poprawnego wyświetlania w panelu administracyjnym.

Dla kogo jest ten moduł?

GLS Track and Trace Pro jest przeznaczony dla każdego sklepu internetowego na PrestaShop, który korzysta z usług kurierskich GLS Poland lub GLS w innym kraju europejskim. Moduł sprawdzi się zarówno w małym sklepie wysyłającym kilka paczek dziennie, jak i w dużym sklepie przetwarzającym setki zamówień — dzięki mechanizmowi wsadowego odpytywania API (batch processing, do 20 przesyłek w jednym zapytaniu) moduł efektywnie obsługuje duże wolumeny.

Jeśli do tej pory sprawdzałeś status przesyłek GLS ręcznie na stronie internetowej przewoźnika i ręcznie zmieniałeś statusy zamówień w PrestaShop — ten moduł całkowicie eliminuje tę pracę. Klienci są informowani na bieżąco, zamówienia aktualizują się same, a Ty zyskujesz czas na rozwijanie biznesu.

Wymagania

• PrestaShop w wersji 1.7.6 lub nowszej (w tym 8.x i 9.x)
• Dane dostępowe do GLS WebAPI (nazwa użytkownika i hasło) — otrzymasz je od swojego opiekuna handlowego w GLS Poland
• Serwer z obsługą PHP 7.1+ i rozszerzeniem cURL
• Możliwość konfiguracji zadania cron na serwerze hostingowym (dostępna w większości paneli hostingowych)

Wsparcie i aktualizacje

Moduł jest rozwijany i wspierany przez PrestaDev.pl — polski zespół specjalizujący się w tworzeniu modułów i rozwiązań dla PrestaShop. W przypadku pytań, problemów z konfiguracją lub potrzeby dostosowania modułu do indywidualnych potrzeb — skontaktuj się z nami pod adresem info@prestadev.pl.