GLS Track and Trace Pro - automatické sledování zásilek GLS v PrestaShopu

Jak to funguje?

Po instalaci modulu a zadání přístupových údajů k API GLS (které obdržíte od svého opatrovníka v GLS Poland) začne modul fungovat okamžitě. Když objednávka ve vašem obchodě dosáhne stavu „Odesláno", modul automaticky zahájí sledování přiřazeného čísla zásilky. Od tohoto okamžiku cyklicky dotazuje servery GLS na aktuální události doručení — převzetí balíku, tranzit, doručení, problém s doručením nebo vrácení odesílateli.

Každá událost je ukládána do historie spolu s datem, časem, kódem události, lokalitou a zemí. Na základě těchto událostí modul automaticky mění stav objednávky v PrestaShopu — například nastaví „Doručeno", když kurýr potvrdí převzetí balíku zákazníkem. Zákazník pak obdrží e-mailové oznámení s informací o změně stavu, přesně tak jako při ruční změně stavu administrátorem.

Úplný seznam funkcí

• Automatické sledování zásilek — modul sám zahájí monitorování balíku, když objednávka přejde do stavu „Odesláno". Nemusíte na nic klikat ani ručně kopírovat sledovací čísla.
• Přímá integrace s API GLS Group — modul komunikuje s oficiálním programovacím rozhraním GLS (api.gls-group.eu) s využitím protokolu REST a ověřování HTTP Basic Auth. Údaje o zásilkách jsou načítány ve formátu JSON, což zajišťuje rychlost a spolehlivost.
• Automatická změna stavů objednávek — na základě kódů událostí GLS modul rozpoznává pět klíčových stavů zásilky a odpovídajícím způsobem aktualizuje objednávku:
  • V tranzitu — balík byl převzat kurýrem a je na cestě (kódy událostí 1.x, 2.x, 11.x, 67.x)
  • Doručeno — kurýr potvrdil doručení balíku příjemci (kód události 3.x)
  • Problém s doručením — neúspěšný pokus o doručení, příjemce nebyl na adrese zastižen (kódy 4.x, 12.x)
  • Vrácení odesílateli — balík se vrací k vám jako odesílateli (kód 5.x)
  • Čeká na kontrolu — sledovací číslo bylo přidáno, ale API zatím nevrátilo žádné události
  Každý z těchto stavů můžete propojit s libovolným stavem objednávky ve vašem obchodě. Pokud nechcete, aby daný stav měnil stav objednávky — jednoduše vyberte možnost „Neměnit".
• Úplná historie událostí — každá událost zásilky je ukládána s přesným datem a časem, kódem GLS, textovým popisem, lokalitou třídírny nebo kurýrní pobočky a kódem země. Historie je dostupná jak pro administrátora obchodu, tak pro zákazníka na stránce detailu objednávky.
• E-mailová oznámení pro zákazníky — když modul změní stav objednávky (např. na „Doručeno"), PrestaShop automaticky odešle zákazníkovi e-mailové oznámení s novým stavem. Zákazník je průběžně informován o osudu svého balíku bez jakéhokoli úsilí z vaší strany.
• Panel sledování pro zákazníka — na stránce detailu objednávky zákazník vidí přehlednou časovou osu (timeline) s jednotlivými událostmi doručení. Vidí číslo zásilky, aktuální stav ve formě barevného štítku a odkaz na sledování na oficiální stránce GLS.
• Administrativní panel se seznamem zásilek — v administrativním menu PrestaShopu se objeví záložka „GLS Tracking" s kompletním seznamem všech sledovaných zásilek. Seznam obsahuje filtry, řazení, export do CSV, hromadné akce a vyhledávání podle čísla zásilky, stavu, kódu události a rozsahu dat.
• Filtr stavů ve formě rozbalovacího seznamu — v záhlaví sloupce „Stav" se nachází rozbalovací seznam (dropdown) s možnostmi: Doručeno, Vráceno, V tranzitu, Problém, Čeká na kontrolu. Jedno kliknutí vyfiltruje seznam podle vybraného stavu — ideální, když chcete rychle zobrazit např. všechny balíky s problémy.
• Náhled historie událostí v modálním okně — kliknutí na ikonu „Zobrazit události" u libovolné zásilky otevře vyskakovací okno (popup) s úplnou časovou osou událostí, aniž byste opustili seznam. Rychlý náhled bez znovunačítání stránky díky technologii AJAX.
• Hromadné obnovení stavů — tlačítko „Obnovit všechna sledování" na panelu nástrojů načte aktuální data z API GLS pro všechny nedoručené a nevrácené zásilky najednou. Můžete také označit vybrané zásilky a obnovit pouze jejich stavy.
• Automatický import z modulu GLS Poland — pokud používáte oficiální modul glspoland pro generování přepravních štítků, modul GLS Track and Trace Pro umí automaticky importovat čísla zásilek z tabulek tohoto modulu. Nemusíte čísla ručně přepisovat — stačí v konfiguraci vybrat zdroj dat „Modul GLS Poland".
• Dva zdroje čísel zásilek — modul podporuje dva režimy získávání sledovacích čísel:
  • Nativní PrestaShop — načítá číslo z pole „Sledovací číslo dopravce" v detailu odeslání objednávky
  • Modul GLS Poland — načítá přímo z tabulky gls_poland_parcel vytvořené oficiálním modulem glspoland
• Cron mechanismus se dvěma fázemi — cron úloha se skládá ze dvou fází:
  • Fáze 1 — automatický import nových čísel zásilek z modulu GLS Poland (spouštěný při každém volání cronu)
  • Fáze 2 — dotazování API GLS na aktuální události pro všechny aktivní zásilky (spouštěné podle nastaveného intervalu, výchozí každých 15 minut)
• Dva způsoby spouštění cronu — cron můžete nakonfigurovat dvěma způsoby:
  • HTTP — vložíte poskytnutou URL adresu do hostingového panelu jako cron úlohu (např. v cPanelu, DirectAdminu, Plesku)
  • CLI — spustíte PHP příkaz z příkazové řádky, což je efektivnější na VPS a dedikovaných serverech
  V konfiguraci modulu najdete hotové adresy a příkazy ke zkopírování, včetně ukázkového záznamu crontab.
• Konfigurovatelný interval dotazování — sami rozhodujete, jak často má modul kontrolovat stavy zásilek v API GLS. Výchozí hodnota je 15 minut. API GLS ukládá odpovědi do cache na 5 minut, takže hodnoty kratší než 5 minut nedávají smysl a aktualizace neurychlí.
• Tlačítko pro testování připojení k API — v konfiguračním formuláři najdete tlačítko „Testovat připojení k API", které okamžitě ověří, zda jsou zadané přihlašovací údaje správné a zda server GLS odpovídá. Nemusíte čekat na první cron, abyste zjistili, zda je konfigurace správná.
• Testovací a produkční prostředí — modul podporuje jak produkční prostředí GLS (api.gls-group.eu), tak testovací (qs1.gls-group.eu). Integraci můžete bezpečně otestovat na vývojovém serveru před spuštěním v produkčním obchodě.
• Plná podpora multistore — modul byl navržen s ohledem na vícepobočkové obchody (multistore) PrestaShopu. Každý obchod v síti multistore může mít vlastní API údaje GLS, vlastní nastavení intervalu cronu a vlastní mapování stavů objednávek. Seznam zásilek v administrativním panelu automaticky filtruje výsledky podle aktuálně vybraného obchodu, skupiny obchodů nebo všech obchodů.
• Ruční přidávání sledovacích čísel — na stránce objednávky v administrativním panelu najdete formulář pro ruční zadání čísla zásilky GLS. Modul číslo validuje (pouze písmena, číslice a pomlčky, maximálně 64 znaků) a ihned zahájí sledování.
• Ochrana proti duplicitám — modul neumožňuje přidat stejné číslo zásilky dvakrát ke stejné objednávce. Jak uživatelské rozhraní, tak mechanismus databáze (unikátní klíč) chrání před duplicitními záznamy, a to i v případě současných požadavků.
• Odkaz na sledování na stránce GLS — u každé zásilky se zobrazuje odkaz vedoucí přímo na stránku sledování na oficiálním portálu GLS. Administrátor i zákazník mohou jedním kliknutím zkontrolovat úplné informace o zásilce na stránce dopravce.
• Barevné štítky stavů — stavy zásilek jsou označeny barevnými štítky (badge) pro okamžitou přehlednost:
  • zelený — doručeno
  • červený — vráceno odesílateli
  • modrý — v tranzitu
  • oranžový — problém s doručením
  • šedý — čeká na kontrolu
• Kompatibilita s PrestaShop 1.7.6 až 9.x — modul je kompatibilní s PrestaShopem od verze 1.7.6 přes celou řadu 8.x až po nejnovější verze 9.x. Podporuje jak starší (legacy), tak nový systém překladů PrestaShopu. Využívá bootstrap mechanismus pro správné zobrazení v administrativním panelu.

Pro koho je tento modul určen?

GLS Track and Trace Pro je určen pro každý internetový obchod na PrestaShopu, který využívá kurýrní služby GLS Poland nebo GLS v jiné evropské zemi. Modul se osvědčí jak v malém obchodě odesílajícím několik balíků denně, tak ve velkém obchodě zpracovávajícím stovky objednávek — díky mechanismu dávkového dotazování API (batch processing, až 20 zásilek v jednom dotazu) modul efektivně obsluhuje velké objemy.

Pokud jste dosud kontrolovali stav zásilek GLS ručně na webové stránce dopravce a ručně měnili stavy objednávek v PrestaShopu — tento modul tuto práci zcela eliminuje. Zákazníci jsou průběžně informováni, objednávky se aktualizují samy a vy získáváte čas na rozvoj podnikání.

Požadavky

• PrestaShop ve verzi 1.7.6 nebo novější (včetně 8.x a 9.x)
• Přístupové údaje k GLS WebAPI (uživatelské jméno a heslo) — obdržíte je od svého obchodního zástupce v GLS Poland
• Server s podporou PHP 7.1+ a rozšířením cURL
• Možnost konfigurace cron úlohy na hostingovém serveru (dostupná ve většině hostingových panelů)

Podpora a aktualizace

Modul je vyvíjen a podporován společností PrestaDev.pl — polským týmem specializujícím se na tvorbu modulů a řešení pro PrestaShop. V případě dotazů, problémů s konfigurací nebo potřeby přizpůsobení modulu individuálním potřebám — kontaktujte nás na adrese info@prestadev.pl.