GLS Track and Trace Pro - automatische Sendungsverfolgung von GLS in PrestaShop

Wie funktioniert das?

Nach der Installation des Moduls und der Eingabe der Zugangsdaten zur GLS API (die Sie von Ihrem Ansprechpartner bei GLS Poland erhalten), beginnt das Modul sofort zu arbeiten. Wenn eine Bestellung in Ihrem Shop den Status „Versendet“ erreicht, startet das Modul automatisch die Sendungsverfolgung der zugewiesenen Sendungsnummer. Ab diesem Moment fragt es die GLS-Server zyklisch ab, um aktuelle Zustellereignisse zu erhalten — Abholung des Pakets, Transit, Zustellung, Zustellproblem oder Rücksendung an den Absender.

Jedes Ereignis wird in der Historie gespeichert zusammen mit Datum, Uhrzeit, Ereigniscode, Standort und Land. Auf Grundlage dieser Ereignisse ändert das Modul automatisch den Bestellstatus in PrestaShop — zum Beispiel setzt es „Zugestellt“, wenn der Kurier die Annahme des Pakets durch den Kunden bestätigt. Der Kunde erhält dann eine E-Mail-Benachrichtigung über die Statusänderung, genau wie bei einer manuellen Statusänderung durch den Administrator.

Vollständige Funktionsliste

• Automatische Sendungsverfolgung — das Modul beginnt selbstständig mit der Überwachung des Pakets, sobald die Bestellung den Status „Versendet“ erreicht. Sie müssen nichts anklicken oder Sendungsnummern manuell kopieren.
• Direkte Integration mit der API der GLS Group — das Modul kommuniziert mit der offiziellen Programmierschnittstelle von GLS (api.gls-group.eu) unter Verwendung des REST-Protokolls und der HTTP-Basic-Auth-Authentifizierung. Die Sendungsdaten werden im JSON-Format abgerufen, was Geschwindigkeit und Zuverlässigkeit gewährleistet.
• Automatische Änderung der Bestellstatus — auf Grundlage der GLS-Ereigniscodes erkennt das Modul fünf zentrale Sendungszustände und aktualisiert die Bestellung entsprechend:
  • Im Transit — das Paket wurde vom Kurier abgeholt und ist unterwegs (Ereigniscodes 1.x, 2.x, 11.x, 67.x)
  • Zugestellt — der Kurier hat die Zustellung des Pakets an den Empfänger bestätigt (Ereigniscode 3.x)
  • Zustellproblem — erfolgloser Zustellversuch, Empfänger an der Adresse nicht angetroffen (Codes 4.x, 12.x)
  • Rücksendung an den Absender — das Paket kommt zu Ihnen als Absender zurück (Code 5.x)
  • Wartet auf Prüfung — die Sendungsnummer wurde hinzugefügt, aber die API hat noch keine Ereignisse zurückgegeben
  Jeden dieser Zustände können Sie mit einem beliebigen Bestellstatus verknüpfen in Ihrem Shop. Wenn Sie nicht möchten, dass ein bestimmter Zustand den Bestellstatus ändert — wählen Sie einfach die Option „Nicht ändern“.
• Vollständige Ereignishistorie — jedes Sendungsereignis wird mit genauem Datum und Uhrzeit, GLS-Code, Textbeschreibung, Standort des Sortierzentrums oder der Kurierfiliale sowie Ländercode gespeichert. Die Historie ist sowohl für den Shop-Administrator als auch für den Kunden auf der Seite mit den Bestelldetails verfügbar.
• E-Mail-Benachrichtigungen für Kunden — wenn das Modul den Bestellstatus ändert (z. B. auf „Zugestellt“), sendet PrestaShop dem Kunden automatisch eine E-Mail-Benachrichtigung mit dem neuen Status. Der Kunde wird ohne jeglichen Aufwand Ihrerseits laufend über den Verlauf seiner Sendung informiert.
• Tracking-Panel für den Kunden — auf der Seite mit den Bestelldetails sieht der Kunde eine übersichtliche Zeitachse (Timeline) mit den aufeinanderfolgenden Zustellereignissen. Er sieht die Sendungsnummer, den aktuellen Status in Form eines farbigen Labels sowie einen Link zur Sendungsverfolgung auf der offiziellen GLS-Website.
• Administrationspanel mit Sendungsliste — im Administrationsmenü von PrestaShop erscheint die Registerkarte „GLS Tracking“ mit einer vollständigen Liste aller verfolgten Sendungen. Die Liste enthält Filter, Sortierung, CSV-Export, Massenaktionen und die Suche nach Sendungsnummer, Status, Ereigniscode und Datumsbereich.
• Statusfilter in Form einer Dropdown-Liste — in der Kopfzeile der Spalte „Status“ befindet sich eine Dropdown-Liste (Dropdown) mit den Optionen: Zugestellt, Zurückgesendet, Im Transit, Problem, Wartet auf Prüfung. Ein Klick filtert die Liste auf den ausgewählten Zustand — ideal, wenn Sie schnell z. B. alle problematischen Pakete sehen möchten.
• Vorschau der Ereignishistorie im Modal-Fenster — ein Klick auf das Symbol „Ereignisse anzeigen“ bei einer beliebigen Sendung öffnet ein Pop-up-Fenster (Popup) mit der vollständigen Ereignis-Zeitachse, ohne die Liste zu verlassen. Schnelle Vorschau ohne Neuladen der Seite dank AJAX-Technologie.
• Massenaktualisierung der Status — die Schaltfläche „Alle Trackings aktualisieren“ in der Symbolleiste ruft aktuelle Daten aus der GLS API für alle noch nicht zugestellten und nicht zurückgesendeten Sendungen gleichzeitig ab. Sie können auch ausgewählte Sendungen markieren und nur deren Status aktualisieren.
• Automatischer Import aus dem Modul GLS Poland — wenn Sie das offizielle Modul glspoland zur Erstellung von Versandetiketten verwenden, kann das Modul GLS Track and Trace Pro Sendungsnummern automatisch importieren aus den Tabellen dieses Moduls. Sie müssen die Nummern nicht manuell übertragen — wählen Sie einfach in der Konfiguration die Datenquelle „Modul GLS Poland“.
• Zwei Quellen für Sendungsnummern — das Modul unterstützt zwei Modi zur Ermittlung von Trackingnummern:
  • Natives PrestaShop — liest die Nummer aus dem Feld „Trackingnummer des Versanddienstleisters“ in den Versanddetails der Bestellung
  • Modul GLS Poland — liest direkt aus der Tabelle gls_poland_parcel, die vom offiziellen Modul glspoland erstellt wurde
• Cron-Mechanismus mit zwei Phasen — die Cron-Aufgabe besteht aus zwei Phasen:
  • Phase 1 — automatischer Import neuer Sendungsnummern aus dem Modul GLS Poland (wird bei jedem Cron-Aufruf ausgeführt)
  • Phase 2 — Abfrage der GLS API nach aktuellen Ereignissen für alle aktiven Sendungen (wird gemäß dem eingestellten Intervall ausgeführt, standardmäßig alle 15 Minuten)
• Zwei Möglichkeiten zum Ausführen des Cronjobs — Sie können den Cronjob auf zwei Arten konfigurieren:
  • HTTP — Sie fügen die angegebene URL im Hosting-Panel als Cron-Aufgabe ein (z. B. in cPanel, DirectAdmin, Plesk)
  • CLI — Sie führen den PHP-Befehl über die Kommandozeile aus, was auf VPS- und dedizierten Servern effizienter ist
  In der Modulkonfiguration finden Sie fertige Adressen und Befehle zum Kopieren, zusammen mit einem Beispiel für einen Crontab-Eintrag.
• Konfigurierbares Abfrageintervall — Sie entscheiden selbst, wie oft das Modul die Sendungsstatus in der GLS API prüfen soll. Der Standardwert beträgt 15 Minuten. Die GLS API cached Antworten für 5 Minuten, daher sind Werte unter 5 Minuten nicht sinnvoll und beschleunigen die Aktualisierung nicht.
• Schaltfläche zum Testen der API-Verbindung — im Konfigurationsformular finden Sie die Schaltfläche „API-Verbindung testen“, die sofort prüft, ob die angegebenen Zugangsdaten korrekt sind und ob der GLS-Server antwortet. Sie müssen nicht auf den ersten Cronjob warten, um zu erfahren, ob die Konfiguration korrekt ist.
• Test- und Produktionsumgebung — das Modul unterstützt sowohl die GLS-Produktionsumgebung (api.gls-group.eu) als auch die Testumgebung (qs1.gls-group.eu). Sie können die Integration sicher auf einem Entwicklungsserver testen, bevor Sie sie im Live-Shop einsetzen.
• Vollständige Multistore-Unterstützung — das Modul wurde für PrestaShop-Shops mit mehreren Verkaufsstellen (Multistore) entwickelt. Jeder Shop im Multistore-Netzwerk kann eigene GLS-API-Daten, eigene Einstellungen für das Cron-Intervall und eigene Zuordnungen der Bestellstatus haben. Die Sendungsliste im Administrationspanel filtert die Ergebnisse automatisch auf den aktuell ausgewählten Shop, die Shop-Gruppe oder alle Shops.
• Manuelles Hinzufügen von Trackingnummern — auf der Bestellseite im Administrationspanel finden Sie ein Formular zur manuellen Eingabe der GLS-Sendungsnummer. Das Modul validiert die Nummer (nur Buchstaben, Ziffern und Bindestriche, maximal 64 Zeichen) und startet sofort die Verfolgung.
• Schutz vor Duplikaten — das Modul erlaubt nicht, dieselbe Sendungsnummer zweimal derselben Bestellung hinzuzufügen. Sowohl die Benutzeroberfläche als auch der Datenbankmechanismus (eindeutiger Schlüssel) schützen vor doppelten Einträgen, selbst bei gleichzeitigen Anfragen.
• Link zur Sendungsverfolgung auf der GLS-Website — bei jeder Sendung wird ein Link angezeigt, der direkt zur Tracking-Seite auf dem offiziellen GLS-Portal führt. Sowohl der Administrator als auch der Kunde können mit einem Klick die vollständigen Informationen zur Sendung auf der Website des Versanddienstleisters prüfen.
• Farbige Status-Labels — die Sendungsstatus sind zur sofortigen besseren Lesbarkeit mit farbigen Labels (Badge) gekennzeichnet:
  • grün — zugestellt
  • rot — an den Absender zurückgesendet
  • blau — im Transit
  • orange — Zustellproblem
  • grau — wartet auf Prüfung
• Kompatibilität mit PrestaShop 1.7.6 bis 9.x — das Modul ist mit PrestaShop ab Version 1.7.6 über die gesamte 8.x-Serie bis hin zu den neuesten 9.x-Versionen kompatibel. Es unterstützt sowohl das ältere (Legacy) als auch das neue Übersetzungssystem von PrestaShop. Es nutzt den Bootstrap-Mechanismus für die korrekte Darstellung im Administrationspanel.

Für wen ist dieses Modul gedacht?

GLS Track and Trace Pro ist für jeden PrestaShop-Onlineshop bestimmt, der Kurierdienste von GLS Poland oder GLS in einem anderen europäischen Land nutzt. Das Modul eignet sich sowohl für kleine Shops, die täglich einige Pakete versenden, als auch für große Shops, die Hunderte von Bestellungen verarbeiten — dank des Mechanismus zur gebündelten API-Abfrage (Batch Processing, bis zu 20 Sendungen in einer Anfrage) verarbeitet das Modul große Volumen effizient.

Wenn Sie bisher den Status von GLS-Sendungen manuell auf der Website des Versanddienstleisters geprüft und die Bestellstatus in PrestaShop manuell geändert haben — dieses Modul eliminiert diese Arbeit vollständig. Kunden werden laufend informiert, Bestellungen aktualisieren sich von selbst, und Sie gewinnen Zeit für die Weiterentwicklung Ihres Geschäfts.

Anforderungen

• PrestaShop in Version 1.7.6 oder neuer (einschließlich 8.x und 9.x)
• Zugangsdaten zur GLS WebAPI (Benutzername und Passwort) — Sie erhalten diese von Ihrem Kundenbetreuer bei GLS Poland
• Server mit Unterstützung für PHP 7.1+ und der Erweiterung cURL
• Möglichkeit zur Konfiguration einer Cron-Aufgabe auf dem Hosting-Server (in den meisten Hosting-Panels verfügbar)

Support und Updates

Das Modul wird von PrestaDev.pl entwickelt und unterstützt — einem polnischen Team, das sich auf die Erstellung von Modulen und Lösungen für PrestaShop spezialisiert hat. Bei Fragen, Problemen mit der Konfiguration oder dem Bedarf, das Modul an individuelle Anforderungen anzupassen — kontaktieren Sie uns unter info@prestadev.pl.