Generare Codici Sconto in Massa su PrestaShop 8 e 9: documentazione
Installa il modulo, crea un lotto con la procedura guidata, proteggi i codici, inviali via email, stampali con codice QR, esportali e segui i risultati di ogni campagna.
Presentazione
Il modulo crea lotti di codici sconto unici che condividono le stesse regole. Ogni codice è una regola carrello nativa di PrestaShop: funziona nel carrello, compare in fattura e resta valido anche se il modulo viene disinstallato. I codici si distribuiscono via email, tramite stampa PDF con codice QR, tramite link diretto o esportazione CSV, e ogni lotto ha le proprie statistiche.
La dashboard riassume tutti i lotti: codici generati e usati, ordini convalidati, fatturato IVA esclusa e sconto concesso. L’elenco si può filtrare per nome, stato o canale, e una barra mostra il tasso di utilizzo di ogni lotto.

Installazione e aggiornamento
- In Moduli > Gestione moduli, clicca su Carica un modulo e seleziona
dfbulkcoupons-2.0.0.zip. - L’installazione crea la scheda Catalogo > Buoni sconto > Codici sconto in massa. Anche il pulsante Configura del modulo porta lì.
Compatibilità: PrestaShop 1.7.8, 8 e 9, PHP da 7.1 a 8.5, temi Classic e Hummingbird.
Aggiornamento dalla 1.0 o dalla 1.1: carica il nuovo ZIP sopra quello precedente. Lotti, codici, statistiche e impostazioni di invio vengono conservati. L’aggiornamento aggiunge un indice di unicità sui codici e la protezione del link diretto.
Creare un lotto
Clicca su Nuovo lotto. Una procedura guidata in sei passaggi ti accompagna: Campagna, Codici, Sconto, Condizioni, Restrizioni e Verifica. Nulla viene creato prima dell’ultimo passaggio. Puoi tornare a qualsiasi passaggio dalla barra di avanzamento, e un riepilogo a destra mostra in tempo reale un codice di esempio, lo sconto, la validità e il livello di sicurezza.
1. Campagna
Il nome del lotto è usato nelle statistiche e nelle esportazioni. Il canale indica dove verranno distribuiti i codici (email, newsletter, SMS, social network, influencer, affiliati, stampati, negozio fisico, servizio clienti o un nome libero). Serve a confrontare le campagne. Una nota interna è facoltativa.
2. Codici
- Codici anonimi: da 1 a 200.000 codici, da distribuire liberamente. Alcuni pulsanti di scelta rapida propongono 100, 500, 1.000, 5.000 e 10.000.
- Gruppi di clienti: un codice personale per ogni cliente attivo dei gruppi selezionati (account ospite esclusi), con l’opzione «Solo iscritti alla newsletter». Viene mostrato il numero di clienti di ogni gruppo.
- Elenco di email: un codice personale per ogni account cliente trovato nell’elenco incollato. Gli indirizzi senza account vengono ignorati e ne viene indicato il numero.
Un codice personale funziona solo per l’account cliente a cui è assegnato.
Il formato è composto da un prefisso, una parte casuale e un suffisso. Nella parte casuale, X è una lettera o una cifra, A una lettera e # una cifra; gli altri caratteri, come i trattini, vengono mantenuti. I formati pronti si scelgono con un clic. Il set «Facili da leggere» esclude 0, O, 1, I e L. L’anteprima mostra tre esempi, il numero di combinazioni possibili e un indicatore di sicurezza.

3. Sconto
Tipi: percentuale, importo fisso (IVA esclusa o inclusa, in una valuta, con opzione di utilizzo parziale), spedizione gratuita o omaggio (combinazione predefinita del prodotto). Una percentuale o un importo si applica all’intero ordine esclusa la spedizione o a un prodotto specifico; una percentuale può anche riguardare il prodotto meno caro o i prodotti della restrizione. Il nome mostrato al cliente compare nel carrello e in fattura, in ogni lingua.

4. Condizioni
Date di inizio e di fine (fuso orario del negozio), utilizzi per codice e per cliente (1 e 1 per codici monouso), importo minimo con valuta, tasse e spedizione, e priorità. L’opzione Codici esclusivi, attiva per impostazione predefinita, impedisce di usare due codici del lotto nello stesso ordine, oppure insieme a un altro sconto anch’esso esclusivo. Per i codici personali, il codice può essere mostrato nel carrello del suo titolare. I codici possono essere creati disattivati per essere attivati in seguito.
5. Restrizioni
Restrizione per prodotti (ricerca per nome, riferimento o ID), categorie o marche (elenchi filtrabili), con una quantità minima di prodotti corrispondenti. Gruppi di clienti, paesi di consegna e, in multinegozio, negozi autorizzati. Un campo lasciato vuoto non impone alcuna restrizione.
6. Verifica
L’ultimo passaggio riassume il lotto (codici, esempio, sconto, validità, utilizzo e restrizioni) con un link di modifica per ogni passaggio. Il pulsante Crea e genera i codici avvia la generazione.

Sicurezza dei codici
- I codici sono estratti da un generatore crittograficamente sicuro, confrontati con tutti i codici sconto esistenti e protetti da un indice univoco nel database.
- Un formato deve contare almeno 6 caratteri casuali e offrire almeno 10.000 combinazioni per codice richiesto. L’indicatore mostra la probabilità che un visitatore trovi un codice valido digitando a caso: troppo facile (rifiutato), accettabile, forte o molto forte.
- Il link diretto accetta al massimo 10 codici sconosciuti per connessione in 15 minuti, per impedire che venga usato per indovinare i codici.
- Le esportazioni CSV neutralizzano le formule dei fogli di calcolo in ogni cella.
Generazione dei codici
I codici vengono creati in blocchi da 500 con una barra di avanzamento, la velocità e il tempo rimanente. Un pulsante permette di mettere in pausa e riprendere. Puoi lasciare la pagina: la generazione riprende da dove si era fermata alla successiva apertura del lotto. Ogni blocco viene salvato per intero o per niente. Al termine vengono mostrati i primi codici con le scorciatoie verso l’esportazione CSV, l’invio via email, la stampa e le statistiche. Ogni codice è una regola carrello la cui descrizione inizia con [DFBC#id], visibile in Catalogo > Buoni sconto.

Pagina del lotto
Ogni lotto ha un’intestazione comune (stato, sconto, formato, validità) e delle schede: Panoramica, Codici, Email (codici personali) e Stampa.
Panoramica
Codici generati, codici usati e tasso di utilizzo, ordini convalidati, ordini da nuovi clienti, fatturato IVA esclusa e ordine medio, sconto concesso e rapporto fatturato / sconto. Un riepilogo mostra i codici generati, ancora utilizzabili e usati almeno una volta. Il pannello Distribuzione raggruppa email, stampa, esportazione e link diretto. Seguono il grafico degli ordini al giorno, i codici più usati, le esportazioni e gli ultimi ordini. Solo gli ordini convalidati contano nel fatturato e nello sconto, convertiti nella valuta predefinita.


Gestisci il lotto
- Dati: nome, canale e nota interna. Il nuovo nome viene riportato nella descrizione delle regole carrello.
- Fine validità: si applica a tutti i codici del lotto.
- Aggiungi codici a un lotto di codici anonimi, con lo stesso formato e le stesse regole.
- Duplica il lotto, disattiva o attiva tutti i codici.
- Zona pericolosa: elimina i codici mai usati, oppure elimina il lotto. Viene richiesta una conferma; gli ordini passati mantengono il loro sconto.
Elenco dei codici
La scheda Codici mostra i codici in pagine da 50, filtrati per stato (disponibile, usato, completamente usato, scaduto, disattivato) con il numero di codici per ogni stato. La ricerca riguarda l’inizio del codice o l’email del cliente. Per ogni codice: copia del codice o del suo link diretto, utilizzi, utilizzi rimanenti, data di invio, ultimo ordine, attivazione o disattivazione, e link alla regola carrello nativa.

Inviare i codici via email
Disponibile per i lotti di codici personali, nella scheda Email.
- Per ogni lingua, modifica l’oggetto e il messaggio. Le variabili
{firstname},{lastname},{code},{discount},{valid_until},{shop_name}e{link}si inseriscono con un clic. L’anteprima si aggiorna durante la digitazione. - Clicca su Inviami un’email di prova: viene inviata al tuo indirizzo di dipendente, nella tua lingua.
- Scegli i destinatari: codici non ancora inviati (e codici non riusciti), oppure tutti i codici per un promemoria. L’opzione «Solo i clienti che hanno accettato la newsletter» è selezionata per impostazione predefinita.
- Imposta il numero di email al minuto per restare sotto il limite del tuo server, poi clicca su Salva e invia.
L’invio avviene in pacchetti da 10, con una barra di avanzamento e un pulsante di pausa. Ogni cliente riceve la versione nella lingua del proprio account. I codici già usati, disattivati o scaduti e gli account eliminati o disattivati vengono saltati. Le email rifiutate dal server vengono elencate e ritentate all’invio successivo.

Il cliente riceve il suo codice in un riquadro, lo sconto, la data di fine e un pulsante che applica il codice al suo carrello. È allegata una versione testuale per i programmi di posta che non visualizzano l’HTML.

Le email passano per la configurazione di Parametri avanzati > Email. Se lì l’invio è disattivato, un avviso lo segnala in cima alla pagina.
Stampare i codici
La scheda Stampa genera un PDF A4:
- Schede: 10 per pagina (95 x 55 mm), con segni di taglio.
- Etichette: 21 per foglio (63,5 x 38,1 mm, fogli standard 3 x 7).
- Volantini: 4 per pagina in formato A6, con segni di taglio.
Scegli i codici (non usati mai stampati, tutti i non usati o tutti), il loro numero (al massimo 2.000 per file) e il numero di codici da saltare all’inizio. Imposta il titolo, le condizioni (variabili {valid_until}, {shop_name}, {customer}), il colore di accento, il codice QR, il nome del negozio e, per i codici personali, il nome del cliente. Un’anteprima di una scheda si aggiorna in tempo reale. L’opzione «Segna questi codici come stampati» evita di ristampare gli stessi codici.


Link diretto e codice QR
Ogni codice ha un indirizzo del tipo https://tuo-negozio.com/module/dfbulkcoupons/apply?code=CODE. Apre il negozio e applica il codice al carrello, con un messaggio di conferma nella lingua del visitatore (temi Classic e Hummingbird). Se il carrello è vuoto, il codice viene conservato per 30 giorni e applicato non appena si aggiunge un prodotto. Se il carrello non soddisfa ancora le condizioni, viene mostrato il motivo e il codice si applica automaticamente appena le soddisfa. Per un codice personale, il visitatore viene invitato ad accedere, poi il codice viene applicato. Questo link si trova dietro i codici QR stampati, sul pulsante delle email, nell’elenco dei codici e nell’esportazione CSV.

Esportazioni CSV
I file sono in UTF-8 con punto e virgola come separatore, leggibili direttamente in Excel.
- Codici (tutti, non usati o usati): codice, stato, utilizzi, utilizzi rimanenti, date di validità, email, nome e cognome del cliente, ultimo utilizzo, ultimo ordine, data di invio, data di stampa, link diretto.
- Utilizzo per ordine: data, ID, riferimento e stato dell’ordine, ordine convalidato o no, codice, cliente, sconto e totale IVA esclusa e inclusa, valuta.
Prestazioni per canale e ricerca di un codice
Non appena si usano più canali, la dashboard mostra una tabella per canale: lotti, codici, codici usati, tasso, ordini, fatturato IVA esclusa e sconto IVA esclusa, ordinata per fatturato. Il blocco Cerca un codice trova il lotto, il titolare, la data di fine e lo stato di un codice che un cliente ti comunica.
Disinstallazione
La disinstallazione elimina le tabelle del modulo (lotti, cronologia di invio e di stampa). I codici già generati restano regole carrello attive in Catalogo > Buoni sconto.
Risoluzione dei problemi
- La generazione si interrompe: riapri il lotto o clicca su Riprendi. Se il database rifiuta gli inserimenti viene mostrato un messaggio preciso; non resta alcun codice parziale.
- «Questo formato è troppo facile da indovinare»: aggiungi caratteri casuali o passa all’alfabeto completo.
- Email non riuscite: controlla Parametri avanzati > Email con un’email di prova, poi riavvia l’invio dei codici non inviati.
- Il codice QR non applica lo sconto al carrello: il messaggio mostrato indica la condizione mancante. Per un codice personale, il cliente deve accedere al proprio account.
- «Sono stati provati troppi codici»: la protezione del link diretto si rimuove da sola dopo 15 minuti.