# Regole dei codici promozionali

> Quando un codice sconto viene accettato in Cassa e quando no, come si calcola lo sconto, come si consuma un codice, che cosa sono i codici automatici di compleanno e onomastico, gli auguri delle feste e quali sono gli stati di una promozione.

Ultimo aggiornamento: 22 ottobre 2026. Fonte: https://narciso.io/docs/regole-codici-promozionali/

Questa voce raccoglie le **regole** che il programma applica a un codice promozionale. Come si crea una promozione è in [Promozioni](https://narciso.io/docs/promozioni/); come si scrive il codice in Cassa e i messaggi di verifica sono in [Codice sconto in Cassa](https://narciso.io/docs/codice-sconto-in-cassa/).

## Dove si usa un codice

Un codice si applica **solo in Cassa**, in modalità **Riscuoti**, nella casella «Sconto / Promo...». Nella creazione o modifica di un appuntamento **non c'è** un campo per il codice: il prezzo dell'appuntamento è la somma dei prezzi di listino. Quando dall'appuntamento si passa al checkout la Cassa si apre con le voci dell'appuntamento e lì si scrive il codice come per qualunque altra vendita.

Un codice vale solo nella **sede** in cui la promozione è stata creata.

## Le regole, nell'ordine in cui vengono controllate

Il programma si ferma alla **prima** regola non rispettata e mostra il messaggio corrispondente.

| # | Controllo | Messaggio rosso se non rispettato |
|---|---|---|
| 1 | Il codice esiste nella sede attiva ed è **attivo** (non spento né eliminato). Le minuscole diventano maiuscole da sole | «Codice non valido o inesistente» |
| 2 | **Cliente dedicato**: serve un cliente scelto in Cassa e deve essere proprio quello. Se i clienti selezionati sono più di uno, conta solo il primo | «Questa promozione è disponibile solo per clienti specifici. Seleziona un cliente per applicare il codice.» oppure «Questa promozione non è disponibile per questo cliente.» |
| 3 | **Etichette**: se la promozione ha un Evento correlato, il cliente deve avere un'etichetta con quel nome | Messaggi sull'«etichetta» (vedi [Codice sconto in Cassa](https://narciso.io/docs/codice-sconto-in-cassa/)) |
| 4 | **Minimo di spesa**: la somma dei prezzi delle voci dello scontrino (prima dello sconto) deve raggiungerlo | «Questa promozione richiede un minimo di spesa di €N.NN. Il tuo carrello attuale è €M.MM» |
| 5 | **Limite di utilizzi**: gli utilizzi già fatti devono essere meno del massimo | «Questo codice ha raggiunto il limite massimo di utilizzi» |
| 6 | **Date**: il momento della verifica deve essere dopo l'inizio e prima della fine | «Questo codice non è ancora valido» oppure «Questo codice è scaduto» |
| 7 | **Voci dello scontrino** (solo sconti con prodotti o servizi scelti): vedi sotto | «Questo codice non è applicabile ai prodotti nel carrello», «… ai servizi nel carrello» oppure «Questo codice combo richiede: … che non sono nel carrello. Aggiungi tutti gli elementi del combo per applicare il codice.» |

**Regola delle voci.** Se la promozione elenca **un solo** elemento, quell'elemento deve essere nello scontrino. Se ne elenca **due o più**, **devono esserci tutti**: vale anche con l'ambito «Prodotti specifici» o «Servizi specifici», non solo con «Combo». Per i codici in omaggio questo controllo non c'è.

Il cliente dedicato e le etichette si valutano sul cliente scelto in **Riscuoti**.

## Come si calcola lo sconto

| Tipo | Calcolo | Esempio |
|---|---|---|
| **Sconto percentuale** | La percentuale si applica al **totale di tutto lo scontrino**, non solo alle voci a cui la promozione si riferisce | Promo 10% «solo sul prodotto A»; scontrino: prodotto A 20 € + servizio 30 €. Sconto = 10% di 50 € = **5 €** (non 2 €) |
| **Sconto fisso** | L'importo in euro, qualunque sia il totale; il totale dello scontrino non scende sotto zero | Promo -10 € su uno scontrino da 8 € → totale 0 € |
| **Prodotto o servizio in omaggio** | Il codice viene riconosciuto e compare «Codice applicato», ma lo sconto è **0 €** | — |

> **Attenzione.** Per i codici **in omaggio** la Cassa oggi **non aggiunge** il prodotto o il servizio regalato allo scontrino e non riduce il totale: il regalo si consegna a mano. Il codice conta comunque come usato quando la vendita viene registrata.

- Lo sconto viene calcolato **una sola volta**, quando il codice viene verificato. Se poi cambiano le voci o il cliente, si cancella il codice con la gomma rossa e lo si verifica di nuovo.
- Si applica **un solo codice per scontrino**: verificarne un altro sostituisce il primo.
- Il codice **non si somma** al codice di un premio fedeltà, che non si scrive in questa casella ([Premi fedeltà](https://narciso.io/docs/premi-fedelta/)).

## Quando un codice viene consumato

Quando la vendita viene registrata il programma segna il codice come **usato**: il contatore **Utilizzi** sale di uno e per quella vendita si registrano la promozione e lo sconto ([Utilizzi dei codici sconto](https://narciso.io/docs/utilizzi/)).

- Il **limite totale** è controllato nel momento dell'uso: il contatore non supera mai il massimo, nemmeno con due vendite contemporanee («Codice non più utilizzabile: raggiunto il limite di utilizzi.»).
- Una stessa promozione non si può applicare due volte alla stessa vendita («Questa promozione è già stata applicata a questa vendita.»).
- Il **limite per cliente** («un utilizzo a testa», impostato dai codici automatici di compleanno e onomastico) è controllato **solo a vendita già registrata**: se il cliente lo ha già raggiunto, lo sconto è stato comunque dato e la Cassa mostra in rosso «Vendita registrata, ma il codice sconto "CODICE" non è stato segnato come usato: Questo cliente ha già raggiunto il limite di utilizzi di questo codice. Controlla manualmente il codice.»
- Se una vendita viene **annullata**, gli utilizzi che aveva consumato tornano disponibili.
- Lo sconto che compare poi nello storico della vendita per una percentuale è calcolato sul totale già scontato: può risultare più basso di quello dato in Cassa. Per i conti precisi vale il totale della vendita.

## I codici automatici di compleanno e onomastico

Se in **Comunicazioni**, nelle impostazioni dell'assistente, sono attivi **Gestione compleanni** e/o **Gestione festività** (vedi [Impostazioni di Comunicazioni](https://narciso.io/docs/impostazioni-comunicazioni/)), ogni giorno il programma crea da solo un codice personale:

| Evento | Quando | Nome della promozione | Chi |
|---|---|---|---|
| **Compleanno** | Ogni giorno alle **08:00** | «Buon Compleanno NomeCliente» | I clienti che compiono gli anni oggi |
| **Onomastico** | Ogni giorno alle **08:05** | «Buon Onomastico NomeCliente» | I clienti il cui nome coincide con il santo del giorno (per un nome composto, ogni parola conta) |

- È uno **sconto del 15%** su tutto lo scontrino, **dedicato a quel cliente**, valido **30 giorni** da quel momento, con limite di **un utilizzo per cliente**.
- A ogni cliente ne spetta **uno solo all'anno** per ciascun evento.
- Il codice viene mandato al cliente nel messaggio di auguri, sull'ultimo canale che il cliente ha usato (o sul primo disponibile).
- La promozione compare nella tabella della prima sede a cui il cliente è collegato, con **Creato da** «Automazione compleanno» o «Automazione onomastico». Non serve fare nulla; come le altre, si può spegnere o eliminare.

In Cassa il cliente va **scelto in Riscuoti**: senza cliente compare «Questa promozione è disponibile solo per clienti specifici...».

## Gli auguri delle feste (senza codice)

Con **Gestione festività** attiva, alle **08:05** di ogni giorno il programma manda anche gli **auguri delle feste generali**: solo il messaggio, **senza codice sconto**. Il testo è del tipo «🎄 Buon Natale, Anna! Da parte di NomeSalone.»

| Quando | Feste |
|---|---|
| Date fisse | Capodanno, Epifania, San Valentino, Festa della Donna, Ferragosto, Halloween, Immacolata, Vigilia di Natale, Natale, Santo Stefano, San Silvestro, Giornata internazionale dell'uomo |
| Date che cambiano ogni anno | Giovedì grasso, Martedì grasso, Pasqua, Pasquetta, Black Friday, Cyber Monday |

- Gli auguri partono solo ai clienti che hanno dato il **consenso alle comunicazioni commerciali**.
- La **Festa della Donna** va solo alle clienti donna e la **Giornata internazionale dell'uomo** solo ai clienti uomo; senza il genere indicato nella scheda cliente non partono.
- Ogni cliente riceve gli auguri di ciascuna festa **una sola volta all'anno**.
- Il messaggio parte sull'ultimo canale che il cliente ha usato (o sul primo disponibile), come per compleanno e onomastico.
- Le feste civili come 25 aprile, 1° maggio, 2 giugno, Ognissanti o San Francesco non generano messaggi.

Compleanno e onomastico, al contrario, non richiedono il consenso alle comunicazioni commerciali.

## Regole d'uso in sintesi

| Domanda | Risposta |
|---|---|
| Quando vale un codice? | Dalla data di inizio (o dalla creazione) alla data di fine, e solo se è attivo |
| Quante volte si può usare? | Illimitate, salvo un «Limite utilizzi massimi» impostato nella promozione |
| Su quali sedi vale? | Solo su quella in cui è stato creato |
| A quali clienti? | A tutti, a un cliente dedicato o ai clienti con una certa etichetta |
| Su quali voci? | Su tutto lo scontrino o su voci scelte (vedi sopra la regola «tutti se sono due o più») |
| È cumulabile? | No: un solo codice per scontrino |
| Si può cambiare il codice? | No |
| Si può riaccendere una promozione spenta? | No: se ne crea una nuova ([Promozioni](https://narciso.io/docs/promozioni/)) |
| Con più promozioni valide per lo stesso cliente? | Nessuna scelta automatica: chi incassa scrive il codice giusto |

## Gli stati di una promozione

| Stato | Come si riconosce | Il codice in Cassa |
|---|---|---|
| **Attiva** | Nella tabella, con l'interruttore verde | Funziona se rispetta tutte le regole sopra |
| **Non ancora valida** | Nella tabella, con una data di inizio futura (la colonna Scadenza non lo dice: l'inizio si vede nel passo 3 della modifica) | «Questo codice non è ancora valido» |
| **Scaduta** | Nella tabella, con **Scadenza** passata e interruttore ancora verde | «Questo codice è scaduto» |
| **Esaurita** | Nella tabella, con **Utilizzi** uguali al massimo (per esempio «10 / 10») | «Questo codice ha raggiunto il limite massimo di utilizzi» |
| **Spenta o eliminata** | **Non compare più** nella tabella | «Codice non valido o inesistente» |

## Cosa fare se...

| Situazione | Che cosa fare |
|---|---|
| «Questa promozione è disponibile solo per clienti specifici...» | Si sceglie in Riscuoti il cliente a cui il codice è dedicato, prima di verificare |
| «... clienti con etichetta: …» | La promozione è stata creata con un Evento correlato e vale solo per i clienti con quell'etichetta. Se serve per tutti, se ne crea una nuova senza evento |
| «Questo codice combo richiede...» | Si aggiungono allo scontrino **tutti** gli elementi scelti nella promozione, anche se l'ambito era «Prodotti specifici» |
| Compare «Codice applicato» ma il totale non scende | Il codice è in omaggio: il regalo si consegna a mano |
| Il cliente ha un codice di compleanno ma non lo ha ricevuto | Si controlla che «Gestione compleanni» sia attivo e che la scheda del cliente abbia la data di nascita |

## Voci correlate

- [Promozioni](https://narciso.io/docs/promozioni/)
- [Utilizzi dei codici sconto](https://narciso.io/docs/utilizzi/)
- [Codice sconto in Cassa](https://narciso.io/docs/codice-sconto-in-cassa/)
- [Premi fedeltà](https://narciso.io/docs/premi-fedelta/)