GLS Track and Trace Pro - tracciamento automatico delle spedizioni GLS in PrestaShop

Come funziona?

Dopo aver installato il modulo e inserito i dati di accesso all’API GLS (che ricevi dal tuo referente GLS Poland), il modulo inizia a funzionare immediatamente. Quando un ordine nel tuo negozio raggiunge lo stato “Spedito”, il modulo avvia automaticamente il tracciamento del numero di spedizione assegnato. Da quel momento interroga periodicamente i server GLS per ottenere gli eventi di consegna aggiornati — ritiro del pacco, transito, consegna, problema di consegna oppure reso al mittente.

Ogni evento viene salvato nella cronologia insieme a data, ora, codice evento, località e paese. Sulla base di questi eventi il modulo modifica automaticamente lo stato dell’ordine in PrestaShop — ad esempio imposta “Consegnato” quando il corriere conferma la ricezione del pacco da parte del cliente. Il cliente riceve quindi una notifica e-mail con l’informazione sul cambio di stato, esattamente come in caso di modifica manuale dello stato da parte dell’amministratore.

Elenco completo delle funzionalità

• Tracciamento automatico delle spedizioni — il modulo avvia da solo il monitoraggio del pacco quando l’ordine passa allo stato “Spedito”. Non devi cliccare nulla né copiare manualmente i numeri di tracciamento.
• Integrazione diretta con l’API GLS Group — il modulo comunica con l’interfaccia di programmazione ufficiale di GLS (api.gls-group.eu), utilizzando il protocollo REST e l’autenticazione HTTP Basic Auth. I dati delle spedizioni vengono recuperati in formato JSON, garantendo velocità e affidabilità.
• Cambio automatico degli stati degli ordini — in base ai codici evento GLS il modulo riconosce cinque stati chiave della spedizione e aggiorna di conseguenza l’ordine:
  • In transito — il pacco è stato ritirato dal corriere ed è in viaggio (codici evento 1.x, 2.x, 11.x, 67.x)
  • Consegnato — il corriere ha confermato la consegna del pacco al destinatario (codice evento 3.x)
  • Problema di consegna — tentativo di consegna non riuscito, destinatario assente all’indirizzo (codici 4.x, 12.x)
  • Reso al mittente — il pacco sta tornando a te come mittente (codice 5.x)
  • In attesa di verifica — il numero di tracciamento è stato aggiunto, ma l’API non ha ancora restituito alcun evento
  Puoi associare ciascuno di questi stati a qualsiasi stato dell’ordine nel tuo negozio. Se non vuoi che un determinato stato modifichi lo stato dell’ordine — seleziona semplicemente l’opzione “Non modificare”.
• Cronologia completa degli eventi — ogni evento della spedizione viene salvato con data e ora precise, codice GLS, descrizione testuale, località del centro di smistamento o della filiale del corriere e codice paese. La cronologia è disponibile sia per l’amministratore del negozio sia per il cliente nella pagina dei dettagli dell’ordine.
• Notifiche e-mail per i clienti — quando il modulo modifica lo stato dell’ordine (ad es. in “Consegnato”), PrestaShop invia automaticamente al cliente una notifica e-mail con il nuovo stato. Il cliente viene informato in tempo reale sullo stato del proprio pacco senza alcuno sforzo da parte tua.
• Pannello di tracciamento per il cliente — nella pagina dei dettagli dell’ordine il cliente vede una chiara linea temporale (timeline) con i successivi eventi di consegna. Vede il numero di spedizione, lo stato attuale sotto forma di etichetta colorata e il link al tracciamento sul sito ufficiale GLS.
• Pannello amministrativo con elenco delle spedizioni — nel menu amministrativo di PrestaShop compare la scheda “GLS Tracking” con l’elenco completo di tutte le spedizioni tracciate. L’elenco include filtri, ordinamento, esportazione in CSV, azioni di massa e ricerca per numero di spedizione, stato, codice evento e intervallo di date.
• Filtro degli stati sotto forma di elenco a discesa — nell’intestazione della colonna “Stato” è presente un elenco a discesa (dropdown) con le opzioni: Consegnato, Restituito, In transito, Problema, In attesa di verifica. Un clic filtra l’elenco in base allo stato selezionato — ideale quando vuoi vedere rapidamente, ad esempio, tutti i pacchi con problemi.
• Anteprima della cronologia eventi in una finestra modale — cliccando sull’icona “Visualizza eventi” accanto a qualsiasi spedizione si apre una finestra popup (popup) con la linea temporale completa degli eventi, senza uscire dall’elenco. Anteprima rapida senza ricaricare la pagina, grazie alla tecnologia AJAX.
• Aggiornamento massivo degli stati — il pulsante “Aggiorna tutti i tracciamenti” nella barra degli strumenti recupera i dati aggiornati dall’API GLS per tutte le spedizioni non consegnate e non restituite contemporaneamente. Puoi anche selezionare le spedizioni desiderate e aggiornare solo i loro stati.
• Importazione automatica dal modulo GLS Poland — se utilizzi il modulo ufficiale glspoland per generare etichette di spedizione, il modulo GLS Track and Trace Pro è in grado di importare automaticamente i numeri di spedizione dalle tabelle di quel modulo. Non devi riscrivere i numeri manualmente — basta selezionare la fonte dati “Modulo GLS Poland” nella configurazione.
• Due fonti dei numeri di spedizione — il modulo supporta due modalità di acquisizione dei numeri di tracciamento:
  • PrestaShop nativo — legge il numero dal campo “Numero di tracciamento del corriere” nei dettagli di spedizione dell’ordine
  • Modulo GLS Poland — legge direttamente dalla tabella gls_poland_parcel creata dal modulo ufficiale glspoland
• Meccanismo cron in due fasi — il task cron è composto da due fasi:
  • Fase 1 — importazione automatica dei nuovi numeri di spedizione dal modulo GLS Poland (eseguita a ogni chiamata del cron)
  • Fase 2 — interrogazione dell’API GLS per ottenere gli eventi aggiornati di tutte le spedizioni attive (eseguita secondo l’intervallo impostato, per impostazione predefinita ogni 15 minuti)
• Due modalità di esecuzione del cron — puoi configurare il cron in due modi:
  • HTTP — incolli l’URL fornito nel pannello hosting come task cron (ad es. in cPanel, DirectAdmin, Plesk)
  • CLI — esegui il comando PHP dalla riga di comando, soluzione più efficiente su server VPS e dedicati
  Nella configurazione del modulo troverai indirizzi e comandi pronti da copiare, insieme a un esempio di voce crontab.
• Intervallo di interrogazione configurabile — decidi tu con quale frequenza il modulo deve controllare gli stati delle spedizioni nell’API GLS. Il valore predefinito è 15 minuti. L’API GLS memorizza nella cache le risposte per 5 minuti, quindi valori inferiori a 5 minuti non hanno senso e non accelereranno gli aggiornamenti.
• Pulsante di test della connessione API — nel modulo di configurazione troverai il pulsante “Testa connessione API”, che verifica immediatamente se i dati di accesso inseriti sono corretti e se il server GLS risponde. Non devi aspettare il primo cron per sapere se la configurazione è corretta.
• Ambiente di test e di produzione — il modulo supporta sia l’ambiente di produzione GLS (api.gls-group.eu) sia quello di test (qs1.gls-group.eu). Puoi testare in sicurezza l’integrazione su un server di sviluppo prima di attivarla sul negozio in produzione.
• Supporto completo multistore — il modulo è stato progettato pensando ai negozi multistore di PrestaShop (multistore). Ogni negozio nella rete multistore può avere i propri dati API GLS, le proprie impostazioni dell’intervallo cron e le proprie mappature degli stati degli ordini. L’elenco delle spedizioni nel pannello amministrativo filtra automaticamente i risultati in base al negozio attualmente selezionato, al gruppo di negozi o a tutti i negozi.
• Aggiunta manuale dei numeri di tracciamento — nella pagina dell’ordine nel pannello amministrativo troverai un modulo per inserire manualmente il numero di spedizione GLS. Il modulo valida il numero (solo lettere, cifre e trattini, massimo 64 caratteri) e avvia subito il tracciamento.
• Protezione contro i duplicati — il modulo non consente di aggiungere due volte lo stesso numero di spedizione allo stesso ordine. Sia l’interfaccia utente sia il meccanismo del database (chiave univoca) proteggono da voci duplicate, anche in caso di richieste simultanee.
• Link al tracciamento sul sito GLS — per ogni spedizione viene visualizzato un link che porta direttamente alla pagina di tracciamento sul portale ufficiale GLS. Sia l’amministratore sia il cliente possono verificare con un solo clic tutte le informazioni sulla spedizione sul sito del corriere.
• Etichette di stato colorate — gli stati delle spedizioni sono contrassegnati da etichette colorate (badge) per una leggibilità immediata:
  • verde — consegnato
  • rosso — restituito al mittente
  • blu — in transito
  • arancione — problema di consegna
  • grigio — in attesa di verifica
• Compatibilità con PrestaShop da 1.7.6 a 9.x — il modulo è compatibile con PrestaShop dalla versione 1.7.6, attraverso tutta la serie 8.x, fino alle più recenti versioni 9.x. Supporta sia il vecchio sistema di traduzioni (legacy) sia il nuovo sistema di traduzioni di PrestaShop. Utilizza il meccanismo bootstrap per una corretta visualizzazione nel pannello amministrativo.

Per chi è questo modulo?

GLS Track and Trace Pro è destinato a qualsiasi negozio online su PrestaShop che utilizzi i servizi di corriere GLS Poland o GLS in un altro paese europeo. Il modulo è adatto sia a un piccolo negozio che spedisce pochi pacchi al giorno, sia a un grande negozio che elabora centinaia di ordini — grazie al meccanismo di interrogazione batch dell’API (batch processing, fino a 20 spedizioni in una sola richiesta) il modulo gestisce in modo efficiente grandi volumi.

Se finora controllavi manualmente lo stato delle spedizioni GLS sul sito web del corriere e modificavi manualmente gli stati degli ordini in PrestaShop — questo modulo elimina completamente questo lavoro. I clienti vengono informati in tempo reale, gli ordini si aggiornano da soli e tu guadagni tempo da dedicare alla crescita del business.

Requisiti

• PrestaShop versione 1.7.6 o successiva (incluse 8.x e 9.x)
• Dati di accesso a GLS WebAPI (nome utente e password) — li riceverai dal tuo referente commerciale di GLS Poland
• Server con supporto per PHP 7.1+ ed estensione cURL
• Possibilità di configurare un task cron sul server hosting (disponibile nella maggior parte dei pannelli hosting)

Supporto e aggiornamenti

Il modulo è sviluppato e supportato da PrestaDev.pl — un team polacco specializzato nella creazione di moduli e soluzioni per PrestaShop. In caso di domande, problemi di configurazione o necessità di adattare il modulo a esigenze individuali — contattaci all’indirizzo info@prestadev.pl.