# Codice sconto in Cassa

> Come applicare un codice promozionale allo scontrino, che cosa significano i messaggi di verifica e che cosa fare se lo sconto non corrisponde più al carrello.

Ultimo aggiornamento: 22 ottobre 2026. Fonte: https://narciso.io/docs/codice-sconto-in-cassa/

Il **codice sconto** applica a una vendita lo sconto di una promozione (vedi [Promozioni](https://narciso.io/docs/promozioni/)). Si scrive nella casella in fondo allo scontrino della [Cassa](https://narciso.io/docs/cassa/) e si **verifica** prima di incassare.

## Come si applica

La casella ha l'icona di un'etichetta e mostra «Sconto / Promo...» quando è vuota. Il testo viene trasformato automaticamente in maiuscolo. A destra ci sono due piccoli pulsanti senza suggerimento: la **spunta verde** (verifica il codice) e la **gomma rossa** (cancella il codice e toglie lo sconto).

1. Aggiungere allo scontrino le voci da vendere e, in Riscuoti, scegliere il cliente (alcuni codici valgono solo per certi clienti).
2. Scrivere il codice nella casella.
3. Premere **Invio** oppure cliccare la **spunta verde**. Con la casella vuota non succede nulla.
4. Se il codice è valido compare il messaggio verde «Codice applicato: NOME» e lo sconto appare nello scontrino come riga **Sconto Promo**, con il segno meno, sopra Imponibile, IVA e TOTALE.
5. Incassare come di consueto (vedi [Incassare](https://narciso.io/docs/incassare/)).

Un codice **scritto ma non verificato non ha effetto**. Per toglierlo si clicca la gomma rossa.

Il codice funziona con tutti i metodi di pagamento della modalità Riscuoti: contanti, altro, KlimaCard, POS (SumUp e Satispay) e messaggio. Dopo un incasso il codice viene cancellato dalla casella e, se la vendita è registrata, segnato come usato.

> **Attenzione.** Lo sconto viene calcolato **nel momento della verifica**. Se dopo la verifica si aggiungono o si tolgono voci, o si cambia cliente, l'importo mostrato non si aggiorna. Per ricalcolarlo si cancella il codice con la gomma e lo si verifica di nuovo. Al momento dell'incasso Narciso ricalcola comunque lo sconto sul carrello reale: se il totale mostrato non corrisponde più, la vendita non viene registrata.

## Messaggi di verifica

| Messaggio | Colore | Significato |
|---|---|---|
| «Codice applicato: NOME» | verde | Il codice è valido: lo sconto è nello scontrino |
| «Codice non valido o inesistente» | rosso | Il codice non esiste o non è attivo. Si ricontrollano le lettere |
| «Questa promozione è disponibile solo per clienti specifici. Seleziona un cliente per applicare il codice.» | rosso | Si sceglie il cliente nella colonna di sinistra |
| «Questa promozione non è disponibile per questo cliente.» | rosso | Il cliente scelto non rientra nella promozione |
| «Questa promozione è disponibile solo per clienti con etiquette: … Seleziona un cliente per applicare il codice.» (senza cliente scelto) oppure «Questa promozione è disponibile solo per clienti con una di queste etichette: …» (cliente senza l'etichetta) | rosso | Serve un cliente con l'etichetta richiesta. Il primo messaggio contiene «etiquette» al posto di «etichette»: è così nel programma |
| «Questa promozione richiede un minimo di spesa di € X. Il tuo carrello attuale è € Y» | rosso | Si aggiungono voci fino al minimo |
| «Questo codice ha raggiunto il limite massimo di utilizzi» | rosso | Il codice è esaurito |
| «Questo codice non è ancora valido» | rosso | La promozione non è ancora iniziata |
| «Questo codice è scaduto» | rosso | La promozione è finita |
| «Questo codice combo richiede: … che non sono nel carrello. Aggiungi tutti gli elementi del combo per applicare il codice.» | rosso | Mancano prodotti o servizi del pacchetto |
| «Questo codice non è applicabile ai prodotti nel carrello» oppure «… ai servizi nel carrello» | rosso | Le voci dello scontrino non sono quelle previste dalla promozione |
| «Errore durante la verifica del codice» | rosso | Problema di collegamento: si riprova |

## Dopo la verifica

- Lo sconto non può superare quanto resta da pagare: il totale non diventa mai negativo.
- Lo sconto di un codice non dipende dal ruolo di chi incassa.
- In regime forfettario lo scontrino mostra lo sconto e la dicitura sull'IVA (vedi [IVA e regime forfettario in Cassa](https://narciso.io/docs/iva-e-regime-forfettario/)).
- Se al momento dell'incasso il codice risulta scaduto, esaurito o non più valido per il cliente, la vendita non viene registrata e compare il motivo.
- Con i pagamenti che partono da un link o da un terminale (**KlimaCard**, **Messaggio**, **POS** SumUp e Satispay) lo sconto viene fissato nel momento in cui si preme **Riscuoti**: un codice non utilizzabile ferma tutto **prima** che il cliente paghi, e a pagamento avvenuto la vendita nasce con lo sconto già deciso, anche se nel frattempo il codice è scaduto o si è esaurito.
- Se la vendita viene registrata ma il codice non si riesce a segnare come usato (per esempio perché nel frattempo ha raggiunto il limite di utilizzi), compare in rosso «Vendita registrata, ma il codice sconto "NOME" non è stato segnato come usato: MOTIVO. Controlla manualmente il codice.»
- Il campo funziona anche in modalità **Paga**, ma l'ordine registrato non tiene conto dello sconto.

## Se la vendita viene rifiutata

Se dopo la verifica il carrello è cambiato compare, dopo «Errore durante la registrazione della vendita:», un messaggio del tipo «Validazione di integrità fallita: il totale inviato (€X) non coincide con la somma degli articoli (€Y). Differenza: €Z. Verifica prezzi e quantità.» Si risolve cancellando il codice con la gomma rossa e verificandolo di nuovo sul carrello definitivo.

## Problemi frequenti

| Problema | Che cosa fare |
|---|---|
| Ho scritto il codice ma lo sconto non c'è | Il codice va verificato con Invio o con la spunta verde |
| Ho cambiato le voci e lo sconto è rimasto uguale | Si cancella il codice con la gomma rossa e lo si verifica di nuovo |
| «Questa promozione è disponibile solo per clienti specifici» | Si sceglie prima il cliente nella colonna di sinistra |
| «Validazione di integrità fallita…» | Il totale non corrisponde più al carrello: si rifà la verifica del codice |

## Voci correlate

- [Cassa](https://narciso.io/docs/cassa/)
- [Incassare](https://narciso.io/docs/incassare/)
- [Promozioni](https://narciso.io/docs/promozioni/)