# Generare Codici Sconto in Massa su PrestaShop 8 e 9: documentazione > Presentazione Il modulo crea lotti di codici sconto unici che condividono le stesse regole. Ogni codice è una regola carrello nativa di PrestaShop. I codici si distribuiscono via email, in… - Pagina: - Lingua: it - Aggiornato il: 2026-09-24 - Altre lingue: [fr](https://www.datafirefly.com/documentation/bulk-coupon-codes-prestashop/index.md), [en](https://www.datafirefly.com/en/documentation/bulk-coupon-codes-prestashop/index.md), [es](https://www.datafirefly.com/es/documentation/bulk-coupon-codes-prestashop/index.md), [de](https://www.datafirefly.com/de/documentation/bulk-coupon-codes-prestashop/index.md), [pl](https://www.datafirefly.com/pl/documentation/bulk-coupon-codes-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/bulk-coupon-codes-prestashop/index.md), [pt](https://www.datafirefly.com/pt/documentation/bulk-coupon-codes-prestashop/index.md) - Indice: ## Presentazione Il modulo crea lotti di codici sconto unici che condividono le stesse regole. Ogni codice è una regola carrello nativa di PrestaShop. I codici si distribuiscono via email, in PDF stampabile con codice QR o tramite esportazione CSV, e ogni lotto ha le proprie statistiche di utilizzo. ## Installazione 1. In **Moduli > Gestione moduli**, clicca su **Carica un modulo** e seleziona `dfbulkcoupons-1.1.0.zip`. 2. L'installazione crea la scheda **Catalogo > Sconti > Codici sconto in massa**. Anche il pulsante **Configura** del modulo porta lì. 3. Il modulo attiva la funzionalità delle regole carrello se era disattivata. Aggiornamento dalla 1.0.0: carica il nuovo ZIP sopra il precedente. Lo script di aggiornamento aggiunge le colonne di invio e stampa e l'hook del link diretto, senza modificare i lotti esistenti. ## Creare un lotto Clicca su **Nuovo lotto** e compila il modulo dall'alto verso il basso. ### Lotto Il **nome del lotto** compare nelle statistiche e nelle esportazioni. Il **canale** indica dove verranno distribuiti i codici (email, newsletter, SMS, social network, influencer, affiliati, stampa, negozio fisico, servizio clienti, altro o un nome libero). Serve a confrontare le campagne nella tabella del rendimento per canale. ### Formato dei codici Un codice è composto da prefisso, parte casuale e suffisso. Nella parte casuale, `X` è una lettera o una cifra, `A` una lettera e `#` una cifra. Gli altri caratteri, come i trattini, restano invariati. Esempio: prefisso `ESTATE-` e parte `XXXX-XXXX` danno `ESTATE-K7MQ-3HWD`. Il set di caratteri «Facili da leggere» esclude 0, O, 1, I e L per evitare errori di battitura. Servono almeno 4 caratteri casuali, e il formato deve offrire almeno 20 volte più combinazioni dei codici richiesti: l'anteprima e il contatore delle combinazioni lo indicano durante la digitazione. ### Destinatari e quantità - **Codici anonimi**: indica il numero di codici, da 1 a 200.000. Si distribuiscono liberamente. - **Un codice personale per cliente dei gruppi selezionati**: un codice per ogni cliente attivo dei gruppi spuntati, con l'opzione «Solo iscritti alla newsletter». - **Un codice personale per cliente da un elenco di email**: incolla gli indirizzi, uno per riga o separati da virgole. Gli indirizzi senza account cliente vengono ignorati e conteggiati. Un codice personale funziona solo per l'account cliente a cui è assegnato. ### Sconto Il nome mostrato ai clienti compare nel carrello e in fattura, in ogni lingua. Tipi: percentuale, importo fisso (IVA esclusa o inclusa, in una valuta), spedizione gratuita od omaggio (viene offerta la combinazione predefinita del prodotto). Una percentuale o un importo si applica all'intero ordine senza spedizione o a un prodotto specifico. Una percentuale può applicarsi anche al prodotto meno caro o ai prodotti della restrizione. ### Validità e utilizzo Date di inizio e fine, **utilizzi per codice** e **utilizzi per cliente**: imposta 1 e 1 per codici monouso. Importo minimo dell'ordine (con valuta, tasse e spedizione), priorità, opzione «Non cumulabile con altri sconti», visualizzazione del codice nel carrello del titolare (solo codici personali) e attivazione immediata. ### Restrizioni Restrizione per prodotti, categorie o marche con una quantità minima di prodotti corrispondenti, gruppi di clienti autorizzati, paesi di consegna autorizzati e, in multinegozio, negozi autorizzati. Un campo vuoto non impone alcuna restrizione. ## Generazione dei codici Dopo la conferma, la pagina di generazione crea i codici a blocchi di 250 con una barra di avanzamento. Tieni la pagina aperta. Se viene chiusa, la generazione riprende da dove si era fermata alla successiva apertura del lotto (link **Riprendi** nell'elenco). Ogni codice è una regola carrello la cui descrizione inizia con `[DFBC#id]`, visibile in Catalogo > Sconti. ## Pagina del lotto ### Statistiche Codici generati, codici usati e tasso di utilizzo, ordini convalidati, ordini da nuovi clienti (clienti senza un ordine convalidato precedente), fatturato IVA esclusa e ordine medio, sconto concesso IVA esclusa e rapporto fatturato / sconto, codici ancora utilizzabili. Seguono un grafico degli utilizzi al giorno, i 15 codici più usati e gli ultimi 30 ordini. Solo gli ordini convalidati contano nel fatturato e nello sconto, convertiti nella valuta predefinita. ### Gestire 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. - **Aggiungere codici**: per un lotto di codici anonimi, con lo stesso formato e le stesse regole. - **Disattivare o attivare tutti i codici**, **eliminare i codici mai usati**, **duplicare** o **eliminare** il lotto. Gli ordini passati mantengono lo sconto. ### Elenco dei codici Il pulsante **Sfoglia i codici** mostra i codici 50 per pagina, con schede per stato: disponibile, usato, esaurito, scaduto, disattivato. La ricerca si basa sull'inizio del codice o sull'email del cliente. Per ogni codice: copia del codice o del 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, dal pannello **Distribuzione** della pagina del lotto. 1. Per ogni lingua, modifica oggetto e messaggio. Variabili disponibili: `{firstname}`, `{lastname}`, `{code}`, `{discount}`, `{valid_until}`, `{shop_name}`, `{link}`. L'email mostra sempre il codice in un riquadro, lo sconto, la data di fine e un pulsante che applica il codice al carrello. 2. Clicca su **Inviami un'email di prova**: arriva al tuo indirizzo di dipendente, nella tua lingua, con un codice del lotto. 3. Scegli i destinatari: codici non ancora inviati (e quelli non riusciti), oppure tutti i codici di nuovo come promemoria. L'opzione «Solo i clienti che hanno accettato la newsletter» è selezionata per impostazione predefinita. 4. Imposta il numero di email al minuto per restare sotto il limite del tuo server di posta o provider SMTP, poi clicca su **Salva e invia**. L'invio avviene a pacchetti di 10 con una barra di avanzamento e un pulsante di pausa. Ogni cliente riceve la versione nella lingua del suo account. I codici già usati, disattivati o scaduti e gli account eliminati o disattivati vengono ignorati. Le email rifiutate dal server vengono elencate e ritentate al successivo invio dei codici non inviati. Le email usano la configurazione di **Parametri avanzati > Email**. Se lì l'invio è disattivato, un avviso lo segnala in cima alla pagina. ## Stampare i codici Il pulsante **Stampa i codici** genera un PDF A4: - **Schede**: 10 per pagina (95 x 55 mm), con linee di taglio. - **Etichette**: 21 per foglio (63,5 x 38,1 mm, fogli 3 x 7 comuni). - **Volantini**: 4 per pagina in formato A6, con linee di taglio. Scegli i codici (non usati mai stampati, tutti i non usati o tutti), quanti (fino a 2.000 per file) e quanti saltarne 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. L'opzione «Segna questi codici come stampati» evita di stampare due volte gli stessi codici. ## Link diretto e codice QR Ogni codice ha un indirizzo del tipo `https://tuo-negozio.it/module/dfbulkcoupons/apply?code=CODICE`. Apre il negozio e applica il codice al carrello. Se il visitatore non ha ancora un carrello, o il carrello non rispetta le condizioni (importo minimo, prodotti, account del titolare), il codice viene conservato 30 giorni nel suo cookie e applicato appena il carrello le rispetta. Questo link si trova dietro i codici QR stampati, nel pulsante delle email, nell'elenco dei codici e nell'esportazione CSV. ## Esportazioni CSV I file sono in UTF-8 con separatore punto e virgola e si aprono 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 con e senza IVA, valuta. ## Rendimento per canale Appena si usano più canali, l'elenco dei lotti mostra una tabella per canale: numero di lotti e codici, codici usati, tasso, ordini, fatturato e sconto IVA esclusa, ordinata per fatturato. ## Disinstallazione La disinstallazione elimina le tabelle del modulo (lotti, cronologia di invio e stampa). I codici già generati restano regole carrello attive in Catalogo > Sconti. ## Risoluzione dei problemi - **La generazione si interrompe**: riapri il lotto e la generazione riprende. Se il database rifiuta gli inserimenti, compare un messaggio di errore preciso. - **«Questo formato lascia troppe poche combinazioni»**: aggiungi caratteri casuali o passa all'alfabeto completo. - **Email non riuscite**: verifica Parametri avanzati > Email con un'email di prova, poi invia di nuovo i codici non inviati. - **Il codice QR non riduce il carrello**: apri il carrello, il codice viene applicato appena le sue condizioni sono rispettate. Per un codice personale, il cliente deve aver effettuato l'accesso al suo account.