Monitoraggio del Recupero e Statistiche
Il Monitoraggio del Recupero rileva automaticamente quando un ordine sollecitato viene pagato e lo registra come vendita recuperata, consentendoti di misurare l'impatto diretto dei tuoi promemoria di pagamento sul fatturato.
Disponibile dalla v1.3.0
Panoramica
Ogni volta che il tuo cron job invia un promemoria a un cliente, il modulo registra quell'ordine come "sollecitato". Se il cliente completa poi il pagamento e l'ordine passa a uno stato pagato, il modulo lo contrassegna immediatamente come recuperato e registra la data.
Il pannello Statistiche di Recupero nella dashboard del modulo mostra quattro indicatori principali — ordini sollecitati, ordini recuperati, fatturato recuperato e tasso di recupero — oltre a un riepilogo mensile degli ultimi sei mesi. Questo ti permette di vedere a colpo d'occhio se la tua sequenza di promemoria funziona, quali mesi ottengono i risultati migliori e quanto fatturato avresti altrimenti perso.
Il monitoraggio avviene automaticamente. Non è necessaria alcuna configurazione per abilitarlo e non influisce né sull'invio dei promemoria né sull'elaborazione degli ordini.
Configurazione
Il monitoraggio del recupero non dispone di impostazioni dedicate — è sempre attivo una volta installato il modulo. L'unica azione richiesta è assicurarsi che il cron job venga eseguito regolarmente in modo che i promemoria vengano inviati. Senza l'invio di promemoria, nessun ordine viene registrato come "sollecitato" e il pannello delle statistiche non apparirà.
Per trovare le statistiche:
- Vai su Moduli > Gestione moduli, trova Order Payment Reminders Pro e clicca su Configura.
- Il pannello Statistiche di Recupero appare sotto il checklist di configurazione nella dashboard principale.
Il pannello è nascosto finché non viene inviato il primo promemoria. Prima di allora, un messaggio segnaposto informa che le statistiche appariranno non appena il modulo inizierà a inviare.
Come Funziona
Rilevamento di un Ordine Recuperato
Quando lo stato di un ordine cambia nel tuo negozio, il modulo verifica due condizioni:
- Il nuovo stato dell'ordine è uno stato pagato?
- Questo ordine ha mai ricevuto un promemoria da questo modulo?
Per la prima verifica, il modulo riconosce un ordine come pagato quando il nuovo stato corrisponde a uno degli stati pagati integrati di PrestaShop (Pagamento Accettato e Pagamento Remoto Accettato) oppure quando lo stato dell'ordine ha il flag "pagato" attivo. Anche gli stati di pagamento personalizzati creati con il flag pagato spuntato attiveranno il monitoraggio del recupero.
Per la seconda verifica, il modulo cerca l'ordine nella sua tabella di monitoraggio interna. Se è stato inviato almeno un promemoria per quell'ordine e l'ordine non è già stato contrassegnato come recuperato, viene aggiornato: il flag di recupero viene impostato e vengono registrati la data e l'ora della conferma del pagamento.
Se l'ordine non ha mai ricevuto un promemoria, la variazione di stato viene ignorata e non viene scritto alcun record.
Quando Viene Creato un Record di Monitoraggio
Il record di monitoraggio per un ordine viene creato la prima volta che viene inviato un promemoria. In quel momento il modulo registra l'ID ordine, l'ID del messaggio di promemoria inviato, un conteggio promemoria pari a 1 e la data e l'ora del primo promemoria.
A ogni promemoria successivo per lo stesso ordine, vengono aggiornati l'ID dell'ultimo messaggio e il conteggio dei promemoria. Il flag di recupero e la data di recupero rimangono vuoti finché non viene rilevata una variazione verso uno stato pagato.
Lettura del Pannello Statistiche
Ordini Sollecitati
Il numero totale di ordini distinti che hanno ricevuto almeno un'email di promemoria negli ultimi sei mesi. Un ordine viene contato una sola volta, indipendentemente dal numero di email di promemoria ricevute. Il conteggio è basato sulla data del primo promemoria inviato, non sulla data dell'ordine stesso.
Ordini Recuperati
Il numero di ordini sollecitati che sono successivamente passati a uno stato pagato negli ultimi sei mesi. Un ordine viene considerato recuperato quando PrestaShop ne modifica lo stato in uno contrassegnato come "pagato". Il conteggio è basato sulla data di conferma del pagamento, non sulla data del promemoria.
Fatturato Recuperato
La somma di tutti i totali pagati degli ordini recuperati negli ultimi sei mesi. Utilizza il totale effettivamente pagato dell'ordine come registrato da PrestaShop, nella valuta predefinita del tuo negozio.
Il Fatturato Recuperato riflette il valore totale di ogni ordine recuperato. Non tenta di sottrarre il costo di invio dei promemoria né eventuali rimborsi parziali applicati dopo il pagamento.
Tasso di Recupero
Ordini Recuperati diviso per Ordini Sollecitati, espresso in percentuale e arrotondato a un decimale. Un tasso superiore al 20% viene evidenziato in verde; al di sotto del 20% appare in arancione. La soglia è un riferimento generale — il valore "buono" dipende dalla categoria di prodotto e dai tipici ritardi di pagamento.
Ordini Annullati Dopo i Promemoria
Sotto le quattro schede principali, una riga mostra quanti ordini sollecitati sono terminati nello stato Annullato di PrestaShop. Questo dato è puramente informativo e non incide sulle altre metriche. Può aiutarti a capire se la funzione di annullamento automatico sta rimuovendo una quota significativa di ordini non pagati.
Tabella di Riepilogo Mensile
Una tabella sotto le schede principali elenca gli ultimi sei mesi di calendario. Per ogni mese mostra:
| Colonna | Cosa mostra |
|---|---|
| Mese | Mese e anno di calendario (es. maggio 2026) |
| Sollecitati | Ordini che hanno ricevuto il loro primo promemoria in quel mese |
| Recuperati | Ordini il cui pagamento è stato confermato in quel mese |
| Fatturato | Importo totale pagato per gli ordini recuperati in quel mese |
Nota che le colonne Sollecitati e Recuperati utilizzano date di riferimento diverse, quindi lo stesso ordine può comparire in mesi differenti — sollecitato ad aprile, recuperato a maggio.
Caching delle Statistiche
Le statistiche di recupero richiedono join tra tabelle e aggregazione di dati fino a sei mesi. Per mantenere veloce la dashboard, il modulo memorizza nella cache il risultato calcolato per un'ora. Se elabori un pagamento subito dopo aver caricato la dashboard, i contatori non si aggiorneranno fino alla scadenza della cache. Ricaricare la pagina dopo un'ora mostrerà i dati più recenti.
Esempi d'Uso
Esempio: Valutare l'efficacia della sequenza di promemoria
Noti che il tuo tasso di recupero è rimasto al 12% per gli ultimi due mesi. Aprendo il riepilogo mensile, vedi che a maggio ci sono stati 40 ordini sollecitati ma solo 5 recuperati. Decidi di aggiungere un secondo promemoria più urgente a 48 ore e monitori se il tasso di recupero di giugno migliora.
Esempio: Monitorare l'impatto sul fatturato dopo l'abilitazione di un nuovo metodo di pagamento
Estendi il modulo a tutti i metodi di pagamento, non solo al bonifico bancario. Nei due mesi successivi, il Fatturato Recuperato nella dashboard sale da €400/mese a €1.100/mese, fornendoti un dato concreto da riportare.
Esempio: Calibrare la finestra di annullamento automatico
Vedi che 30 ordini al mese compaiono nel contatore "Annullati Dopo i Promemoria". Estendendo la finestra di annullamento automatico da 7 a 14 giorni, dai ai clienti più tempo per pagare dopo il tuo promemoria finale — e il conteggio dei Recuperati del mese successivo aumenta di 8 ordini.
Note Importanti
- Variazioni manuali di stato. Se modifichi manualmente lo stato di un ordine a uno stato pagato nel Back Office, il recupero viene registrato esattamente come un pagamento automatico. Il modulo non è in grado di distinguere tra un pagamento genuino del cliente e un override amministrativo.
- Variazioni verso stati non pagati. Se sposti un ordine a uno stato rimborsato, in disputa o qualsiasi altro stato non pagato dopo che era già stato contrassegnato come recuperato, il flag di recupero non viene rimosso. Una volta che un ordine è contrassegnato come recuperato rimane tale, anche se l'ordine viene successivamente rimborsato. Il Fatturato Recuperato riflette quindi quanto è stato incassato, non quanto è stato definitivamente trattenuto.
- Ordini già recuperati. L'aggiornamento si attiva solo quando un ordine non è ancora stato contrassegnato come recuperato. Una seconda variazione a stato pagato su un ordine già recuperato non ha alcun effetto.
- Ordini pagati prima dell'installazione del modulo. Gli ordini pagati prima che venisse inviato qualsiasi promemoria non appariranno mai nelle statistiche di recupero perché non esiste alcun record di monitoraggio per loro.
- Multi-negozio. Il monitoraggio del recupero si attiva globalmente su tutti i negozi. Un ordine di qualsiasi negozio verrà contrassegnato come recuperato purché abbia ricevuto un promemoria. Il pannello delle statistiche mostra dati aggregati su tutti i negozi; non è disponibile un filtro per singolo negozio nel pannello di recupero.
- Pagamenti parziali. Se il tuo negozio utilizza uno stato personalizzato per pagamenti parziali con il flag pagato attivo, quegli ordini verranno conteggiati come recuperati al loro valore
total_paidcompleto. - Finestra temporale delle statistiche. Tutte le statistiche coprono gli ultimi sei mesi di calendario a partire da oggi. Gli ordini più vecchi di sei mesi sono esclusi da tutti i conteggi, anche se sono stati recuperati di recente.
- Interazione con l'annullamento automatico. Un ordine annullato non è più idoneo a una variazione verso uno stato pagato, quindi non verrà mai contrassegnato come recuperato. Il contatore "Ordini Annullati Dopo i Promemoria" ti fornisce visibilità su quanti ordini sono stati rimossi in questo modo. Considera di impostare generosamente la finestra di annullamento in modo da dare ai clienti il tempo di pagare dopo aver ricevuto il tuo promemoria finale.
Risoluzione dei Problemi
| Problema | Soluzione |
|---|---|
| Il pannello Statistiche di Recupero non appare | Il pannello viene visualizzato solo dopo che è stato inviato almeno un promemoria. Esegui il cron job e verifica che gli ordini compaiano nel conteggio dei sollecitati. |
| Il tasso di recupero mostra 0% nonostante ordini pagati | Verifica che lo stato dell'ordine pagato abbia il flag "pagato" attivo in Ordini > Stati. Gli stati personalizzati devono avere questo flag spuntato per essere riconosciuti. |
| Il Fatturato Recuperato è inferiore al previsto | Sono inclusi solo gli ordini la cui data di recupero rientra negli ultimi sei mesi. Verifica se la conferma del pagamento è avvenuta più di sei mesi fa. |
| Le statistiche non si aggiornano dopo un pagamento | Le statistiche sono memorizzate nella cache per un'ora. Attendi la scadenza della cache e ricarica la pagina. |
| Le colonne Sollecitati e Recuperati mensili non corrispondono | È normale. Sollecitati è basato sulla data del primo promemoria; Recuperati è basato sulla data del pagamento. Un ordine sollecitato in un mese può essere pagato nel successivo. |
| Un ordine è stato pagato ma non conteggiato come recuperato | L'ordine deve aver ricevuto almeno un promemoria prima del pagamento. Se il promemoria non è mai stato inviato, il modulo non trova alcun record di monitoraggio e non fa nulla. Verifica che il cron job sia stato eseguito e che l'ordine rientrasse nell'ambito dei promemoria. |
Domande Frequenti
Il monitoraggio del recupero influisce sull'invio delle email o sull'elaborazione degli ordini?
No. Il monitoraggio del recupero aggiorna solo un flag nella tabella di monitoraggio interna del modulo quando viene confermato un pagamento. Non modifica gli stati degli ordini, non invia email aggiuntive né altera alcun dato di PrestaShop.
Posso azzerare le statistiche per ripartire da zero?
Le statistiche vengono calcolate in tempo reale dai record di monitoraggio del modulo. Nel Back Office non è presente alcun pulsante di reset. Se hai bisogno di cancellare i dati storici, dovresti modificare direttamente quella tabella nel database — operazione sconsigliata a meno che tu non comprenda pienamente le implicazioni per il monitoraggio in corso.
Se rimborso un ordine dopo che è stato contrassegnato come recuperato, il Fatturato Recuperato diminuirà?
No. Una volta che un ordine è contrassegnato come recuperato, quello stato e il relativo fatturato sono permanenti nei record del modulo. Il Fatturato Recuperato riflette quanto è stato incassato originariamente, non l'importo netto dopo i rimborsi.
Perché il mio tasso di recupero appare diverso da quello che calcolo manualmente?
Il tasso è Recuperati diviso Sollecitati all'interno della stessa finestra temporale di sei mesi, ma i due conteggi utilizzano date diverse — data del primo promemoria per Sollecitati, data del pagamento per Recuperati. Un ordine sollecitato nel mese 1 e pagato nel mese 2 contribuisce a mesi di calendario diversi nella tabella di riepilogo, ma entrambi i conteggi condividono la stessa finestra di sei mesi per il tasso complessivo. Gli ordini sollecitati più di sei mesi fa sono esclusi anche se sono stati pagati di recente.
Il modulo monitora il recupero per tutti i metodi di pagamento o solo per il bonifico bancario?
Il monitoraggio del recupero si applica a tutti gli ordini che hanno ricevuto un promemoria, indipendentemente dal metodo di pagamento utilizzato. Dalla versione 1.2.0 il modulo supporta qualsiasi metodo di pagamento configurato.
Cosa si intende per stato ordine "pagato"?
Il modulo riconosce i due stati pagati integrati di PrestaShop (Pagamento Accettato e Pagamento Remoto Accettato) più qualsiasi stato ordine personalizzato in cui hai spuntato l'opzione "pagato". Puoi consultare e modificare gli stati degli ordini in Ordini > Stati nel tuo Back Office.
Le statistiche di recupero funzioneranno correttamente dopo un aggiornamento da una versione precedente?
Sì. Lo script di aggiornamento aggiunge le colonne di monitoraggio necessarie alla tabella degli ordini esistente. Tutti gli ordini precedentemente sollecitati iniziano come non recuperati. Man mano che quegli ordini ricevono variazioni verso stati pagati in futuro, vengono contrassegnati come recuperati automaticamente.