GLS Track and Trace Pro - suivi automatique des colis GLS dans PrestaShop

Comment cela fonctionne-t-il ?

Après l’installation du module et la saisie des données d’accès à l’API GLS (que vous recevez de votre interlocuteur chez GLS Poland), le module commence à fonctionner immédiatement. Lorsque la commande dans votre boutique atteint le statut « Expédié », le module lance automatiquement le suivi du numéro de colis attribué. À partir de ce moment, il interroge périodiquement les serveurs GLS pour obtenir les événements de livraison actuels — prise en charge du colis, transit, livraison, problème de livraison ou retour à l’expéditeur.

Chaque événement est enregistré dans l’historique avec la date, l’heure, le code d’événement, le lieu et le pays. Sur la base de ces événements, le module modifie automatiquement le statut de la commande dans PrestaShop — par exemple, il définit « Livré » lorsque le transporteur confirme la réception du colis par le client. Le client reçoit alors une notification par e-mail l’informant du changement de statut, exactement comme lors d’un changement manuel de statut par l’administrateur.

Liste complète des fonctionnalités

• Suivi automatique des colis — le module commence lui-même à surveiller le colis lorsque la commande passe au statut « Expédié ». Vous n’avez rien à cliquer ni à copier manuellement les numéros de suivi.
• Intégration directe avec l’API GLS Group — le module communique avec l’interface de programmation officielle de GLS (api.gls-group.eu), en utilisant le protocole REST et l’authentification HTTP Basic Auth. Les données des colis sont récupérées au format JSON, ce qui garantit rapidité et fiabilité.
• Changement automatique des statuts de commande — sur la base des codes d’événements GLS, le module reconnaît cinq états clés du colis et met à jour la commande en conséquence :
  • En transit — le colis a été pris en charge par le transporteur et est en cours d’acheminement (codes d’événements 1.x, 2.x, 11.x, 67.x)
  • Livré — le transporteur a confirmé la remise du colis au destinataire (code d’événement 3.x)
  • Problème de livraison — tentative de livraison échouée, destinataire absent à l’adresse (codes 4.x, 12.x)
  • Retour à l’expéditeur — le colis vous revient en tant qu’expéditeur (code 5.x)
  • En attente de vérification — le numéro de suivi a été ajouté, mais l’API n’a encore renvoyé aucun événement
  Vous pouvez associer chacun de ces états à n’importe quel statut de commande dans votre boutique. Si vous ne souhaitez pas qu’un état donné modifie le statut de la commande — choisissez simplement l’option « Ne pas modifier ».
• Historique complet des événements — chaque événement du colis est enregistré avec la date et l’heure exactes, le code GLS, une description textuelle, l’emplacement du centre de tri ou de l’agence de transport, ainsi que le code pays. L’historique est disponible à la fois pour l’administrateur de la boutique et pour le client sur la page de détail de la commande.
• Notifications par e-mail pour les clients — lorsque le module modifie le statut de la commande (par ex. en « Livré »), PrestaShop envoie automatiquement au client une notification par e-mail avec le nouveau statut. Le client est informé en temps réel du sort de son colis sans aucun effort de votre part.
• Panneau de suivi pour le client — sur la page de détail de la commande, le client voit une chronologie claire (timeline) avec les événements successifs de la livraison. Il voit le numéro de colis, le statut actuel sous forme d’étiquette colorée ainsi qu’un lien de suivi sur le site officiel de GLS.
• Panneau d’administration avec liste des colis — dans le menu d’administration de PrestaShop apparaît un onglet « GLS Tracking » avec la liste complète de tous les colis suivis. La liste comprend des filtres, le tri, l’export CSV, des actions groupées et la recherche par numéro de colis, statut, code d’événement et plage de dates.
• Filtre des statuts sous forme de liste déroulante — dans l’en-tête de la colonne « Statut » se trouve une liste déroulante (dropdown) avec les options : Livré, Retourné, En transit, Problème, En attente de vérification. Un seul clic filtre la liste selon l’état choisi — idéal si vous souhaitez voir rapidement, par exemple, tous les colis avec des problèmes.
• Aperçu de l’historique des événements dans une fenêtre modale — cliquer sur l’icône « Voir les événements » à côté de n’importe quel colis ouvre une fenêtre contextuelle (popup) avec la chronologie complète des événements, sans quitter la liste. Aperçu rapide sans rechargement de la page, grâce à la technologie AJAX.
• Actualisation groupée des statuts — le bouton « Actualiser tous les suivis » dans la barre d’outils récupère les données actuelles de l’API GLS pour tous les colis non livrés et non retournés en même temps. Vous pouvez également sélectionner des colis précis et actualiser uniquement leurs statuts.
• Import automatique depuis le module GLS Poland — si vous utilisez le module officiel glspoland pour générer des étiquettes d’expédition, le module GLS Track and Trace Pro peut importer automatiquement les numéros de colis depuis les tables de ce module. Vous n’avez pas besoin de recopier les numéros manuellement — il suffit de choisir la source de données « Module GLS Poland » dans la configuration.
• Deux sources de numéros de colis — le module prend en charge deux modes d’obtention des numéros de suivi :
  • PrestaShop natif — lit le numéro depuis le champ « Numéro de suivi du transporteur » dans les détails d’expédition de la commande
  • Module GLS Poland — lit directement depuis la table gls_poland_parcel créée par le module officiel glspoland
• Mécanisme cron en deux phases — la tâche cron se compose de deux phases :
  • Phase 1 — import automatique des nouveaux numéros de colis depuis le module GLS Poland (lancé à chaque appel du cron)
  • Phase 2 — interrogation de l’API GLS pour obtenir les événements actuels de tous les colis actifs (lancée selon l’intervalle défini, par défaut toutes les 15 minutes)
• Deux méthodes d’exécution du cron — vous pouvez configurer le cron de deux façons :
  • HTTP — vous collez l’URL fournie dans le panneau d’hébergement comme tâche cron (par ex. dans cPanel, DirectAdmin, Plesk)
  • CLI — vous exécutez une commande PHP en ligne de commande, ce qui est plus efficace sur les serveurs VPS et dédiés
  Dans la configuration du module, vous trouverez des adresses et commandes prêtes à copier, ainsi qu’un exemple d’entrée crontab.
• Intervalle d’interrogation configurable — vous décidez vous-même de la fréquence à laquelle le module doit vérifier les statuts des colis dans l’API GLS. La valeur par défaut est de 15 minutes. L’API GLS met les réponses en cache pendant 5 minutes, donc des valeurs inférieures à 5 minutes n’ont pas de sens et n’accéléreront pas les mises à jour.
• Bouton de test de connexion à l’API — dans le formulaire de configuration, vous trouverez un bouton « Tester la connexion API », qui vérifie immédiatement si les identifiants fournis sont corrects et si le serveur GLS répond. Vous n’avez pas besoin d’attendre le premier cron pour savoir si la configuration est correcte.
• Environnement de test et de production — le module prend en charge à la fois l’environnement de production GLS (api.gls-group.eu) et l’environnement de test (qs1.gls-group.eu). Vous pouvez tester l’intégration en toute sécurité sur un serveur de développement avant de la lancer sur la boutique de production.
• Prise en charge complète du multiboutique — le module a été conçu pour les boutiques multiboutiques (multistore) de PrestaShop. Chaque boutique du réseau multiboutique peut avoir ses propres données API GLS, ses propres paramètres d’intervalle cron et ses propres correspondances de statuts de commande. La liste des colis dans le panneau d’administration filtre automatiquement les résultats selon la boutique actuellement sélectionnée, le groupe de boutiques ou toutes les boutiques.
• Ajout manuel des numéros de suivi — sur la page de commande dans le panneau d’administration, vous trouverez un formulaire permettant de saisir manuellement le numéro de colis GLS. Le module valide le numéro (lettres, chiffres et tirets uniquement, 64 caractères maximum) et lance immédiatement le suivi.
• Protection contre les doublons — le module ne permet pas d’ajouter deux fois le même numéro de colis à la même commande. L’interface utilisateur comme le mécanisme de base de données (clé unique) protègent contre les entrées dupliquées, même en cas de requêtes simultanées.
• Lien de suivi sur le site GLS — pour chaque colis, un lien menant directement à la page de suivi sur le portail officiel GLS est affiché. L’administrateur comme le client peuvent vérifier en un clic toutes les informations sur le colis sur le site du transporteur.
• Étiquettes de statut colorées — les statuts des colis sont marqués par des étiquettes colorées (badge) pour une lisibilité immédiate :
  • vert — livré
  • rouge — retourné à l’expéditeur
  • bleu — en transit
  • orange — problème de livraison
  • gris — en attente de vérification
• Compatibilité avec PrestaShop 1.7.6 à 9.x — le module est compatible avec PrestaShop à partir de la version 1.7.6, sur toute la série 8.x, jusqu’aux versions les plus récentes 9.x. Il prend en charge à la fois l’ancien système (legacy) et le nouveau système de traductions de PrestaShop. Il utilise le mécanisme bootstrap pour un affichage correct dans le panneau d’administration.

À qui s’adresse ce module ?

GLS Track and Trace Pro est destiné à toute boutique en ligne sous PrestaShop qui utilise les services de livraison GLS Poland ou GLS dans un autre pays européen. Le module convient aussi bien à une petite boutique expédiant quelques colis par jour qu’à une grande boutique traitant des centaines de commandes — grâce au mécanisme d’interrogation par lots de l’API (batch processing, jusqu’à 20 colis dans une seule requête), le module gère efficacement de gros volumes.

Si jusqu’à présent vous vérifiiez manuellement le statut des colis GLS sur le site internet du transporteur et modifiiez manuellement les statuts des commandes dans PrestaShop — ce module élimine totalement ce travail. Les clients sont informés en temps réel, les commandes se mettent à jour toutes seules, et vous gagnez du temps pour développer votre activité.

Exigences

• PrestaShop version 1.7.6 ou plus récente (y compris 8.x et 9.x)
• Données d’accès à la GLS WebAPI (nom d’utilisateur et mot de passe) — elles vous seront fournies par votre interlocuteur commercial chez GLS Poland
• Serveur avec prise en charge de PHP 7.1+ et de l’extension cURL
• Possibilité de configurer une tâche cron sur le serveur d’hébergement (disponible dans la plupart des panneaux d’hébergement)

Support et mises à jour

Le module est développé et pris en charge par PrestaDev.pl — une équipe polonaise spécialisée dans la création de modules et de solutions pour PrestaShop. En cas de questions, de problèmes de configuration ou de besoin d’adapter le module à des besoins spécifiques — contactez-nous à l’adresse info@prestadev.pl.