Ordini Ricorrenti e Programmati — Documentazione PrestaShop 8 e 9
Installare, pianificare e gestire gli ordini ricorrenti: dal cron quotidiano al link carrello inviato al cliente.
Cosa fa il modulo
Il modulo consente ai vostri clienti di programmare la ripetizione di un ordine dal proprio account: ogni settimana, ogni mese, ogni trimestre, ogni anno, oppure secondo un intervallo libero espresso in giorni.
Prima di ogni scadenza, un pianificatore invia al cliente un’email contenente un link sicuro. Quando il cliente clicca, il suo carrello viene ricostruito in quel preciso momento e viene reindirizzato al consueto processo d’ordine, dove paga con il metodo che preferisce.
Nessun addebito automatico. Il modulo non memorizza alcuno strumento di pagamento e non attiva alcun addebito. Non c’è quindi alcun mandato ricorrente da raccogliere, nessuna carta da tokenizzare e nessuna autenticazione forte da ripetere. Il cliente conferma e paga da sé ogni ordine.
Installazione
- Nel back office aprite Moduli — Gestore moduli, poi Carica un modulo.
- Trascinate il file ZIP fornito, oppure copiate la cartella
dfrecurringordernella directorymodules/del vostro negozio. - Cliccate su Installa. Tabelle, schede di amministrazione e valori predefiniti vengono creati automaticamente.
- Configurate l’attività pianificata descritta nella sezione seguente. Senza di essa nessuna email di promemoria partirà.
Il modulo aggiunge un menu Ordini — Ordini ricorrenti composto da tre schermate: l’elenco delle programmazioni, lo storico degli invii e la configurazione.
Configurare il pianificatore
Il modulo deve essere richiamato una volta al giorno. Una sola esecuzione quotidiana è sufficiente: il pianificatore elabora in un unico passaggio tutte le programmazioni giunte a scadenza.
Tramite URL
La pagina di configurazione del modulo mostra l’URL esatta, token incluso. Si presenta così:
https://vostro-negozio.tld/module/dfrecurringorder/cron?token=VOSTRO_TOKENQuesta URL è utilizzabile con il modulo ufficiale Attività cron di PrestaShop, con un servizio cron esterno o da una crontab di server:
0 6 * * * wget -q -O - "https://vostro-negozio.tld/module/dfrecurringorder/cron?token=VOSTRO_TOKEN"Da riga di comando
È il metodo consigliato su un server dedicato: evita i limiti di esecuzione del server web.
0 6 * * * php /percorso/al/negozio/modules/dfrecurringorder/cli/run.php --token=VOSTRO_TOKENL’opzione --id_shop=N limita l’esecuzione a un solo negozio in contesto multinegozio. Senza di essa vengono elaborati tutti i negozi.
Verificare che funzioni
La pagina di configurazione propone un pulsante Esegui il pianificatore ora. Avvia un passaggio immediato e mostra un resoconto: programmazioni elaborate, email inviate ed eventuali errori. La chiamata tramite URL restituisce lo stesso resoconto in formato JSON.
Il token può essere rigenerato in qualsiasi momento dalla pagina di configurazione. Ricordate allora di aggiornare la crontab, altrimenti le chiamate successive verranno rifiutate.
Configurazione del modulo
Esperienza del cliente
- Consentire ai clienti di creare le proprie programmazioni — mostra il pulsante «Programma questo ordine» nel dettaglio dell’ordine e nella pagina di conferma. Disattivatelo se preferite creare voi stessi le programmazioni dal back office.
- Numero massimo di programmazioni per cliente — 0 per illimitato. Il valore predefinito è 20.
- Intervallo minimo in giorni — impedisce la creazione di programmazioni troppo ravvicinate.
Frequenze disponibili
Ogni frequenza si attiva o disattiva in modo indipendente: giornaliera, settimanale, quindicinale, mensile, bimestrale, trimestrale, semestrale, annuale e personalizzata in giorni. Nel modulo del cliente compaiono solo le frequenze attivate.
Per impostazione predefinita sono attive settimanale, quindicinale, mensile, bimestrale, trimestrale, semestrale e annuale. La giornaliera e l’intervallo personalizzato sono disattivati, poiché rispondono soprattutto a casi B2B specifici.
Email e link di pagamento
- Inviare l’email X giorni prima della scadenza — valore predefinito applicato alle nuove programmazioni. Il cliente può regolarlo per la propria. Tre giorni sono un buon punto di partenza: abbastanza presto per reagire, abbastanza tardi per restare impressi.
- Durata di validità del link di pagamento — in giorni, 14 per impostazione predefinita. Trascorso tale periodo il link mostra un messaggio di scadenza e invita il cliente a rigenerarne uno dal proprio account.
- Ignorare i prodotti non disponibili — attivo per impostazione predefinita. Vedi la sezione sui casi particolari.
- Inviare una copia al commerciante — utile in fase di rodaggio per verificare la resa reale delle email.
Pianificatore
- Programmazioni elaborate per esecuzione — 50 per impostazione predefinita. Aumentate il valore se il vostro volume giornaliero supera tale limite, oppure lanciate il cron più volte al giorno.
- Eliminare tutti i dati alla disinstallazione — disattivato per impostazione predefinita. Vedi la sezione Disinstallazione.
Lato cliente: programmare un ordine
Il percorso parte sempre da un ordine già effettuato, il che garantisce la coerenza di prodotti, indirizzo e corriere.
- Il cliente apre uno dei suoi ordini dallo storico, oppure resta sulla pagina di conferma subito dopo un acquisto.
- Clicca su Programma questo ordine.
- Regola le quantità se necessario. Una quantità impostata a 0 rimuove il prodotto dalla programmazione.
- Sceglie la frequenza, la data del prossimo ordine e, se lo desidera, una data di fine o un numero massimo di ordini.
- Salva. Un’email di conferma riepiloga la programmazione.
La programmazione compare quindi in Il mio account — I miei ordini programmati. Da questa schermata il cliente può in qualsiasi momento:
- modificare frequenza, data o quantità;
- sospendere e poi riattivare, con la prossima scadenza ricalcolata nel futuro;
- eliminare definitivamente la programmazione;
- cliccare su Ordina ora per attivare subito il carrello senza attendere la scadenza.
Lato commerciante: seguire le programmazioni
Elenco degli ordini ricorrenti
Per ogni programmazione mostra il cliente, la frequenza, il numero di prodotti, la prossima scadenza, quante email sono già state inviate, quanti ordini sono stati realmente effettuati e lo stato. La colonna degli ordini è la misura più utile: indica quante programmazioni si traducono effettivamente in fatturato.
La scheda dettagliata di una programmazione permette di inviare immediatamente il link di pagamento al cliente, comodo in assistenza quando un cliente segnala di non aver ricevuto la sua email.
Storico degli invii
Ogni link generato produce una riga di storico il cui stato evolve lungo il percorso:
- Inviato — l’email è partita, il link non è ancora stato aperto.
- Link aperto — il cliente ha cliccato e un carrello è stato costruito.
- Convertito in ordine — il carrello è diventato un ordine. Il riferimento dell’ordine viene collegato automaticamente.
- Scaduto — la validità è trascorsa senza ordine.
- Errore — l’invio dell’email è fallito. Verificate la configurazione email del negozio.
Nella scheda ordine
Un pannello in fondo alla scheda ordine elenca le programmazioni create a partire da quell’ordine, con accesso diretto al loro dettaglio.
Come funziona il link di pagamento
Comprendere questo meccanismo aiuta a rispondere alle domande dei vostri clienti.
- All’invio dell’email il modulo non crea alcun carrello. Genera soltanto un token casuale di 48 caratteri, monouso e con marca temporale.
- Quando il cliente clicca, il modulo verifica il token e la sua data di scadenza.
- Se il cliente non ha effettuato l’accesso, viene reindirizzato alla pagina di login standard e poi riportato automaticamente al suo link. Il link non autentica mai il visitatore da solo.
- Una volta identificato, il carrello viene costruito a partire dalla programmazione, con prezzi, promozioni, regole carrello e giacenze del momento.
- Il cliente viene reindirizzato al processo d’ordine. Un secondo clic sullo stesso link riutilizza il carrello già creato finché non è diventato un ordine.
È proprio perché il carrello viene costruito al clic, e non all’invio, che resta sempre corretto. Un carrello pre-generato al momento dell’email diventerebbe errato non appena un prezzo, una promozione o una giacenza cambiasse nel frattempo.
Casi particolari
Prodotto non disponibile alla scadenza
Con l’opzione Ignorare i prodotti non disponibili attiva, il prodotto interessato viene semplicemente escluso e gli altri articoli restano ordinabili. Il carrello viene rifiutato solo se nessun prodotto è disponibile: il cliente vede allora un messaggio che lo invita a contattarvi o a modificare la sua programmazione.
Se disattivate questa opzione, un esaurimento blocca la ricostituzione del carrello. Questo comportamento è adatto ai negozi i cui ordini devono partire completi o non partire affatto.
Indirizzo eliminato tra due scadenze
Se l’indirizzo di consegna registrato nella programmazione è stato eliminato dal cliente, il modulo passa automaticamente al suo primo indirizzo disponibile. L’indirizzo di fatturazione segue la stessa logica. Il cliente può sempre cambiare indirizzo nel processo d’ordine.
Fine mese
Una programmazione mensile avviata il 31 gennaio non deriva. Il modulo riporta la data all’ultimo giorno del mese quando questo è più corto: il 28 o 29 febbraio, poi il 31 marzo. Il giorno di origine resta memorizzato e non viene quindi mai perso.
Multinegozio
Ogni programmazione è legata al negozio su cui è stata creata. Le email partono con l’identità di quel negozio e il link di pagamento punta al suo dominio.
Fine di una programmazione
Una programmazione termina automaticamente quando la data di fine è superata o quando viene raggiunto il numero massimo di ordini. Passa allora allo stato Terminata e smette di inviare email, pur restando consultabile nello storico.
Personalizzare le email
Il modulo fornisce due modelli, in francese e in inglese, ciascuno in versione HTML e testo:
dfro_reminder— il promemoria inviato prima di ogni scadenza, con il link di pagamento.dfro_created— la conferma inviata alla creazione di una programmazione.
Sono modificabili da Design — Tema e logo — Email, oppure direttamente nella cartella mails/ del modulo. Le variabili disponibili nel promemoria sono: nome e cognome del cliente, etichetta e frequenza della programmazione, data del prossimo ordine, tabella dei prodotti, totale stimato, link di pagamento, link di gestione, durata di validità del link e nome del negozio.
Il totale mostrato nell’email è una stima calcolata all’invio, a titolo indicativo. L’importo realmente fatturato è quello del carrello ricostruito al clic. Non presentate quindi mai quel totale come un impegno di prezzo.
Risoluzione dei problemi
Non viene inviata alcuna email
Verificate nell’ordine: che l’attività pianificata venga effettivamente eseguita, che il token della crontab corrisponda a quello mostrato in configurazione, che almeno una programmazione attiva abbia raggiunto la scadenza, e che il negozio sia in grado di inviare email. Il pulsante Esegui il pianificatore ora isola rapidamente il problema: se invia le email, la responsabile è l’attività pianificata.
Il link mostra «Link non valido»
Il token non esiste o è stato troncato dal client di posta. Rigenerate un link dalla scheda della programmazione nel back office.
Il cliente resta bloccato sulla pagina di login
Accade quando il link viene aperto con un account diverso da quello del destinatario. Il cliente deve disconnettersi e riaprire il link.
Il carrello ricostruito è vuoto
Tutti i prodotti della programmazione sono disattivati o esauriti. Verificate il loro stato nel catalogo, oppure disattivate temporaneamente l’opzione di esclusione dei prodotti non disponibili per rendere esplicita la diagnosi.
Disinstallazione
Per impostazione predefinita la disinstallazione conserva le tabelle e le programmazioni. Una reinstallazione successiva ritrova quindi tutti i dati. Per eliminare tutto, attivate l’opzione Eliminare tutti i dati alla disinstallazione prima di disinstallare il modulo.
Questa eliminazione è definitiva e riguarda le programmazioni, le loro righe prodotto e lo storico completo degli invii. Eseguite un backup del database prima di attivarla.