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.
- Set di icone del tema — le icone mostrate nell’area cliente. Il tema Classic di PrestaShop usa Material Icons, mentre molti temi commerciali caricano FontAwesome. Scegli quello che il tuo tema carica davvero, oppure nessuna icona. Se nell’area cliente compare una parola isolata al posto di un’icona, significa semplicemente che questa impostazione non corrisponde al tuo tema.
- Prodotti esclusi dagli ordini programmati — un elenco di identificativi prodotto separati da virgole. Questi prodotti non vengono mai copiati in una programmazione né aggiunti a un carrello ricostruito. Vedi la sezione su regali e regole carrello.
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.
Proporre la ricorrenza durante l’ordine
Per impostazione predefinita il cliente programma il suo ordine a posteriori, a partire da un ordine già effettuato. Due opzioni facoltative permettono di proporgli la ricorrenza prima, nel momento dell’acquisto. Entrambe sono disattivate all’installazione: attivarle è una decisione, non un effetto collaterale di un aggiornamento.
Opzione nel processo d’ordine
Una casella «Trasforma questo acquisto in un ordine ricorrente» compare nel carrello e in cima al passaggio di pagamento, seguita da un selettore di frequenza che propone solo le frequenze da te attivate. Il cliente la seleziona, sceglie il suo ritmo e prosegue normalmente con l’ordine.
La scelta viene salvata sul carrello, non nella sessione. È un punto importante con i metodi di pagamento che reindirizzano il cliente su una pagina esterna: l’ordine viene spesso validato in un ritorno di pagamento in cui la sessione del cliente non esiste più, e una scelta conservata in sessione andrebbe persa senza alcun avviso.
La programmazione viene creata solo una volta validato l’ordine. Indirizzi, corriere e valuta provengono quindi da un ordine reale, e un nuovo tentativo di pagamento non può generare due programmazioni. La prima scadenza è calcolata a partire dalla data dell’ordine, secondo la frequenza scelta.
L’opzione compare solo per i clienti che hanno effettuato l’accesso, poiché una programmazione appartiene a un account cliente. Rispetta inoltre la quota di programmazioni per cliente e l’elenco dei prodotti esclusi.
Avviso nella scheda prodotto
Un breve avviso segnala al visitatore che il prodotto può essere ordinato in modo ricorrente e spiega il principio in due frasi semplici. I prodotti presenti nell’elenco di esclusione non lo mostrano mai.
Se non compare nulla
Entrambe le visualizzazioni si appoggiano a punti di aggancio standard di PrestaShop. Alcuni temi, e soprattutto i moduli di ordine in una sola pagina, non li forniscono tutti. La pagina di configurazione del modulo elenca questi punti di aggancio con il loro stato e propone un pulsante per registrarli di nuovo. Se uno resta inattivo dopo questo tentativo, significa che il tuo tema o il tuo modulo d’ordine non lo espone.
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.
Regali e regole carrello
Un prodotto regalato da una regola carrello non viene mai copiato nella programmazione. È una scelta voluta: il regalo non è stato scelto dal cliente, e la regola carrello lo aggiunge da sola a ogni ricostruzione del carrello, non appena le condizioni sono soddisfatte. Mantenerlo nella programmazione lo farebbe comparire due volte.
Il regalo continua quindi a essere offerto normalmente a ogni scadenza e segue lo stato attuale della tua regola: se modifichi la soglia o il prodotto regalato, gli ordini programmati ne tengono conto subito.
Se un regalo viene aggiunto da un modulo di terze parti anziché da una regola carrello nativa, il rilevamento automatico non può riconoscerlo. Inserisci allora il suo identificativo prodotto nell’impostazione Prodotti esclusi dagli ordini programmati. L’esclusione si applica anche alle programmazioni esistenti, senza che i tuoi clienti debbano ricrearle.
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, ciascuno in versione HTML e testo, in sette lingue: francese, inglese, spagnolo, italiano, portoghese, tedesco e polacco:
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.