# Incassare

> Come registrare un incasso nella modalità Riscuoti della Cassa: voci non inventariate, metodi di pagamento (contanti, KlimaCard, POS, messaggio, altro), controlli, messaggi ed errori.

Ultimo aggiornamento: 22 ottobre 2026. Fonte: https://narciso.io/docs/incassare/

**Incassare** significa registrare la vendita di prodotti e servizi a un cliente nella modalità **Riscuoti** della [Cassa](https://narciso.io/docs/cassa/). Questa voce descrive i passi e i metodi di pagamento; per la disposizione della pagina si veda [Cassa](https://narciso.io/docs/cassa/).

## Procedura: incassare in contanti

1. Controllare di essere in modalità **Riscuoti**.
2. Cliccare il cliente nella colonna di sinistra (facoltativo: senza cliente la vendita è anonima).
3. Cliccare i prodotti e i servizi da vendere e regolare le quantità con i pulsanti più e meno.
4. (Facoltativo) Scrivere un codice sconto e premere Invio (vedi [Codice sconto in Cassa](https://narciso.io/docs/codice-sconto-in-cassa/)).
5. Con le frecce del metodo scegliere **CONTANTI**.
6. Controllare il **TOTALE** sullo scontrino.
7. Cliccare **Riscuoti**.
8. Compare il messaggio verde «Vendita registrata con successo!» e il browser riproduce un breve suono di cassa (vedi [Avvisi e suoni](https://narciso.io/docs/avvisi-e-suoni/)). Lo scontrino si svuota e il codice sconto viene cancellato.

La selezione del cliente **resta**: se il cliente successivo è un altro, va tolta a mano.

Se la vendita non riesce lo scontrino resta com'era: nulla viene svuotato, si può correggere e riprovare.

## Voci non inventariate: la calcolatrice

Per incassare qualcosa che non è in catalogo (una mancia, un prodotto non registrato, un servizio occasionale) si usa il pulsante **calcolatrice** sopra l'elenco dei prodotti. La calcolatrice sostituisce l'elenco e contiene, dall'alto:

1. la casella **nome della voce**, obbligatoria. Finché è vuota mostra a rotazione quattro frasi di aiuto, come se qualcuno stesse scrivendo; appena la si clicca o si scrive compare «Nome voce»;
2. un **display verde** con il prezzo, inizialmente 0;
3. la casella **descrizione**, «Descrizione (opzionale)»;
4. il **tastierino**: 7 8 9 e **C**; 4 5 6 e il tasto che cancella l'ultima cifra; 1 2 3 e **OK**; 0, 00 e la virgola.

### Tastierino

| Tasto | Effetto |
|---|---|
| Cifre 0-9 e 00 | Aggiungono cifre al prezzo. Il prezzo parte da 0: la prima cifra diversa da zero lo sostituisce |
| Virgola | Inserisce la virgola dei decimali (una sola). Dopo la virgola si accettano al massimo **due decimali** |
| C | Riporta il prezzo a 0 |
| Freccia con la x | Toglie l'ultima cifra; se ne resta una sola il prezzo torna a 0 |
| OK | Aggiunge la voce allo scontrino |

### Tastiera del computer

Con la calcolatrice aperta la tastiera pilota la calcolatrice anche se nessuna casella è selezionata:

| Tasto | Effetto |
|---|---|
| 0-9 | Digita nel **prezzo** (non nel nome) |
| Virgola o punto | Inserisce la virgola dei decimali |
| Invio | Come OK |
| Canc, Esc, lettera C | **Azzerano il prezzo**. Esc non chiude la calcolatrice |
| Backspace | Cancella l'ultima cifra del prezzo (se si sta scrivendo nel nome o nella descrizione cancella una lettera del testo) |
| Altre lettere e spazio | Vanno nel **nome**, anche se la casella non è selezionata; vanno nella descrizione solo se ci si sta scrivendo |
| Ctrl, Alt, Tab | Ignorati (Ctrl+V funziona nella casella selezionata) |

### Con OK

- Se il nome è vuoto non succede nulla e non compare nessun messaggio: va scritto prima il nome.
- Altrimenti la voce entra nello scontrino con quantità 1 e il prezzo indicato, e la calcolatrice si chiude. La descrizione non viene conservata.
- La stessa voce si può aggiungere più volte: ogni volta è una riga nuova. Le voci non inventariate compaiono solo nello scontrino, mai nell'elenco.
- All'incasso la voce viene registrata come **riga libera** con il nome e il prezzo indicati e con l'aliquota IVA dell'attività. Non dà punti fedeltà.
- Se l'attività non ha un'aliquota IVA impostata l'incasso è bloccato (vedi [IVA e regime forfettario in Cassa](https://narciso.io/docs/iva-e-regime-forfettario/)).

Se si legge con il lettore un codice a barre sconosciuto la calcolatrice si apre da sola (vedi [Lettore di codici a barre](https://narciso.io/docs/lettore-di-codici-a-barre/)).

## I metodi di pagamento

Il **selettore del metodo** è in fondo allo scontrino, nella prima riga dei comandi. I metodi, nell'ordine:

| Metodo | Quando compare | Che cosa fa |
|---|---|---|
| **KLIMACARD** | Sempre (è il primo mostrato) | Apre un pagamento su un terminale KlimaCard (POS 1, 2 o 3) tramite Stripe |
| **CONTANTI** | Sempre | Registra subito la vendita come contanti |
| **POS** | Solo se esiste un POS che riceve davvero l'importo dalla Cassa | SumUp con il lettore Solo abbinato alla sede, oppure Satispay collegato |
| **ALTRO** | Sempre | Registra subito la vendita come bonifico |
| **MESSAGGIO** | Solo se il cliente scelto ha un numero WhatsApp | Manda al cliente un link di pagamento su WhatsApp |

I nomi dei metodi hanno colori diversi (KlimaCard verde, Contanti ambra, POS blu, Altro viola, Messaggio verde WhatsApp).

Le vendite che la Cassa registra direttamente sono solo **contanti** e **bonifico** (Altro). Le vendite con **carta/POS**, **Satispay** e **KlimaCard** nascono solo dal pagamento verificato dal sistema: la Cassa non le registra da sola.

Per **KlimaCard**, **Messaggio** e **POS** compare accanto al metodo un secondo selettore:

| Metodo | Che cosa si sceglie | Voci |
|---|---|---|
| KLIMACARD | Il terminale | POS 1, POS 2, POS 3 |
| MESSAGGIO | Il canale (fisso) | WhatsApp |
| POS | Il circuito del POS | Solo i circuiti che incassano: SumUp (con lettore abbinato) e Satispay (collegato) |

Un nome **barrato** nel selettore indica che il circuito non può essere usato: per KlimaCard il nome del POS è barrato quando Stripe non è collegato; per il metodo POS il circuito è barrato se non può ricevere l'importo.

> **Nota.** **myPOS, Axerve e Nexi** (e SumUp senza lettore abbinato) si possono collegare nei Collegamenti, ma **non ricevono l'importo dalla Cassa** e non si possono usare per incassare da qui. Chi ha un terminale esterno incassa registrando la vendita come **Contanti** oppure **Altro**, oppure manda il cliente a pagare con il link (metodo **Messaggio**). Vedi [Collegamenti della Cassa](https://narciso.io/docs/collegamenti-della-cassa/).

## Procedure per metodo

### KlimaCard

1. Preparare lo scontrino.
2. Scegliere **KLIMACARD**.
3. Scegliere il terminale (POS 1, POS 2 o POS 3). Il nome non deve essere barrato.
4. Cliccare **Riscuoti**.
5. Se il terminale è libero compare il messaggio verde «Link di pagamento KlimaCard creato: in attesa di pagamento sul POS N. La vendita verrà registrata quando il cliente paga.» Lo scontrino si svuota e il codice sconto viene cancellato.
6. Se su quel terminale c'è già un pagamento in attesa compare il messaggio giallo «Il POS N di KlimaCard risulta già occupato» con il pulsante **Libera**. **Libera** chiude il pagamento in attesa e ne crea subito uno nuovo per lo scontrino corrente. Attenzione: liberare un terminale annulla il pagamento che era in attesa lì.

La vendita compare nelle liste solo dopo che il cliente ha pagato. Il pagamento in attesa scade dopo **30 minuti**; l'importo minimo è **0,50 €**. Si può usare anche senza scegliere un cliente. Serve Stripe collegato (vedi [Collegamenti della Cassa](https://narciso.io/docs/collegamenti-della-cassa/)).

### Messaggio (link di pagamento su WhatsApp)

1. Scegliere il cliente (obbligatorio): il metodo **MESSAGGIO** compare solo se ha un numero WhatsApp.
2. Preparare lo scontrino e scegliere **MESSAGGIO**.
3. Cliccare **Riscuoti**.
4. Compare il messaggio verde «Link di pagamento inviato su WhatsApp: la vendita verrà registrata quando il cliente paga.» Lo scontrino si svuota.

Al cliente arriva il testo «Ciao NOME! Ecco il link per pagare € X: … Il link è valido 30 minuti. Grazie!». Il link vale 30 minuti e l'importo minimo è 0,50 €. La vendita **non viene registrata subito**: nasce solo quando il pagamento è confermato (con magazzino, punti e documento commerciale come per ogni vendita). Se il link scade senza pagamento non resta nulla da annullare.

Errori in rosso: «Invio del link WhatsApp non riuscito: MOTIVO», per esempio «Impossibile inviare il messaggio WhatsApp: numero mancante o WhatsApp non collegato per questa sede» o «Stripe non configurato per questo tenant». In questi casi non viene inviato nulla e lo scontrino resta com'è.

### POS con SumUp e lettore Solo

Vale solo se SumUp è collegato e alla sede è abbinato un lettore Solo (vedi [Collegamenti della Cassa](https://narciso.io/docs/collegamenti-della-cassa/)).

1. Preparare lo scontrino, scegliere **POS** e il circuito **SumUp**.
2. Cliccare **Riscuoti**. L'importo parte sul lettore e lo scontrino si svuota. Compare l'avviso giallo «In attesa del pagamento sul lettore SumUp (€ X). La vendita verrà registrata quando il cliente paga.» con il pulsante **Annulla**, disponibile fino a 10 minuti.
3. Il cliente paga sul lettore. Il programma controlla l'esito ogni 2 secondi:
   - pagamento riuscito: messaggio verde «Pagamento SumUp riuscito: vendita registrata.» e suono di cassa. La vendita nasce solo ora;
   - pagamento non riuscito: messaggio rosso «Pagamento sul lettore SumUp non riuscito: MOTIVO. Nessuna vendita registrata: ricomponi il carrello e riprova.»;
   - **Annulla** prima che il cliente paghi: «Pagamento sul lettore annullato: nessuna vendita registrata.» Se nel frattempo il pagamento è già riuscito, l'annullamento non cambia l'esito e compare quello vero. Se l'annullamento non riesce: «Annullamento non riuscito: MOTIVO».
4. Se il pagamento non parte compare «Pagamento sul lettore SumUp non avviato: MOTIVO» (per esempio lettore occupato o non pronto).

Con l'opzione **Scontrino dichiarato da SumUp** attiva, Narciso non trasmette all'Agenzia delle Entrate le vendite pagate con il lettore (vedi [Collegamenti della Cassa](https://narciso.io/docs/collegamenti-della-cassa/)).

### POS con Satispay

Vale solo se Satispay è collegato.

1. Preparare lo scontrino, scegliere **POS** e il circuito **Satispay**.
2. Cliccare **Riscuoti**. Lo scontrino si svuota, si apre la schermata Satispay con il **QR** o il campo per il **numero di telefono** del cliente e compare l'avviso giallo «In attesa del pagamento Satispay (€ X). La vendita verrà registrata quando il cliente paga.» con il pulsante **Annulla**, disponibile fino a 10 minuti.
3. Il cliente approva il pagamento nella sua app Satispay. Il programma controlla l'esito ogni 2 secondi:
   - pagamento riuscito: «Pagamento Satispay riuscito: vendita registrata.» e suono di cassa;
   - pagamento non riuscito: «Pagamento Satispay non riuscito: MOTIVO. Nessuna vendita registrata: ricomponi il carrello e riprova.»;
   - **Annulla** prima che il cliente paghi: «Pagamento Satispay annullato: nessuna vendita registrata.» Se l'annullamento non riesce: «Annullamento non riuscito: MOTIVO».
4. Se il pagamento non parte compare «Pagamento Satispay non avviato: MOTIVO».

Chiudere la schermata Satispay con la **X** non annulla il pagamento: l'attesa resta e si annulla dall'avviso giallo.

### Altro e terminali non collegati

**ALTRO** registra la vendita come bonifico, senza controlli sui collegamenti. È il metodo da usare, insieme a **CONTANTI**, quando il pagamento è passato su un terminale che non è collegato alla Cassa (myPOS, Axerve, Nexi o altri): si incassa sul terminale e poi si registra la vendita.

## Che cosa controlla il programma

Prima di registrare, nell'ordine:

| Situazione | Messaggio rosso | Che cosa fare |
|---|---|---|
| Scontrino vuoto | (nessuno: il pulsante è spento) | Aggiungere voci |
| Cliente appena scelto | «I dati del cliente non sono ancora arrivati. Riprova tra un istante.» | Riprovare dopo un attimo |
| Metodo POS e nessun POS che incassa | «Non è possibile incassare con il POS: serve SumUp con il lettore abbinato oppure Satispay collegato. myPOS, Axerve e Nexi non ricevono l'importo dalla Cassa.» | Usare un altro metodo |
| Metodo POS e circuito che non può ricevere l'importo | «NOME non può ricevere l'importo dalla Cassa (manca il lettore abbinato). Scegli un POS che incassa, oppure un altro metodo.» (la parte tra parentesi compare solo per SumUp) | Scegliere con le frecce un circuito non barrato |
| KlimaCard o Messaggio e Stripe non collegato | «Non è possibile ricevere pagamenti con link Stripe: il provider Stripe non è stato ancora configurato.» | Collegare Stripe nei Collegamenti |
| Messaggio senza cliente | «Seleziona un cliente con numero WhatsApp per inviare il link di pagamento.» | Scegliere il cliente |
| Voce senza aliquota IVA | «Una o più voci non hanno un'aliquota IVA: completa la scheda del prodotto/servizio (o l'aliquota del salone) prima di incassare.» | Completare l'aliquota (vedi [IVA e regime forfettario in Cassa](https://narciso.io/docs/iva-e-regime-forfettario/)) |
| KlimaCard e creazione non riuscita | «Errore durante la creazione del pagamento KlimaCard: MOTIVO» | Leggere il motivo (per esempio importo sotto 0,50 €) e riprovare |
| Registrazione non riuscita | «Errore durante la registrazione della vendita: MOTIVO» | Leggere il motivo (vedi sotto) |

### Motivi di errore della registrazione

| Testo dopo «Errore durante la registrazione della vendita:» | Significato |
|---|---|
| «Uno o più servizi non trovati o non appartengono al tenant» | Un servizio dello scontrino è stato eliminato nel frattempo. Si ricarica la pagina e si rifà lo scontrino |
| «Uno o più prodotti non trovati o non appartengono al tenant» | Un prodotto dello scontrino è stato eliminato nel frattempo. Si ricarica la pagina e si rifà lo scontrino |
| «Stock insufficiente per NOME. Disponibile: N, Richiesto: M» | La giacenza reale è inferiore a quanto richiesto (per esempio un collega ha venduto lo stesso prodotto). Si riduce la quantità |
| «Cliente non trovato o non appartiene al tenant» | Il cliente scelto non esiste più. Si toglie la selezione |
| «Validazione di integrità fallita: il totale inviato (€X) non coincide con la somma degli articoli (€Y)…» | Il totale mostrato non corrisponde più alle voci, tipicamente perché dopo aver verificato un codice sconto lo scontrino è cambiato. Si cancella il codice e lo si verifica di nuovo (vedi [Codice sconto in Cassa](https://narciso.io/docs/codice-sconto-in-cassa/)) |

## Che cosa viene registrato

Quando la vendita va a buon fine:

- **La vendita** viene salvata nella sede in cui si sta lavorando, con data e ora attuali, totale, metodo di pagamento e righe di prodotti e servizi.
- **Il magazzino**: per ogni prodotto la giacenza scende della quantità venduta e viene annotato un movimento di scarico «Vendita #…» (vedi [Magazzino](https://narciso.io/docs/magazzino/)).
- **Il cliente**, se scelto: il totale speso aumenta dell'importo, l'ultima visita diventa oggi e il cliente viene associato alla sede.
- **I punti fedeltà**: vedi [Pagamenti e POS](https://narciso.io/docs/pagamenti-e-pos/).
- **Il codice sconto**, se applicato, viene segnato come usato. Se questo passaggio non riesce (per esempio perché nel frattempo il codice ha raggiunto il limite di utilizzi), la vendita resta registrata e compare in rosso «Vendita registrata, ma il codice sconto "NOME" non è stato segnato come usato: MOTIVO. Controlla manualmente il codice.»
- **L'appuntamento**: se si è arrivati dal Checkout di un appuntamento, diventa **Completato** (con KlimaCard, SumUp, Satispay e Messaggio, quando il cliente ha pagato). Un appuntamento genera al massimo una vendita. Se la vendita viene eliminata, l'appuntamento torna Confermato (vedi [Scheda appuntamento](https://narciso.io/docs/scheda-appuntamento/)).
- **Il documento commerciale** all'Agenzia delle Entrate, se lo scontrino elettronico è attivo (vedi [Pagamenti e POS](https://narciso.io/docs/pagamenti-e-pos/)).

In Riscuoti non si apre nessuna finestra di ricevuta e non parte nessuna stampa: sullo schermo lo scontrino si svuota. Per ritrovare la vendita si usano le pagine di riepilogo (vedi [Storico transazioni](https://narciso.io/docs/storico-transazioni/)).

## Arrivare dal Checkout di un appuntamento

Il pulsante **Checkout** della [Scheda appuntamento](https://narciso.io/docs/scheda-appuntamento/) apre la Cassa in modalità Riscuoti con il **cliente** già selezionato e nello scontrino **tutti i servizi e i prodotti** dell'appuntamento, con le loro quantità e al prezzo di listino attuale. Da lì si procede come per una vendita normale. Se il cliente non si trova compare «Cliente non trovato.». Cambiare modalità dalla Cassa svuota lo scontrino.

## Problemi frequenti

| Problema | Che cosa fare |
|---|---|
| Nel selettore non c'è il metodo POS | Nessun POS che incassa è collegato: servono SumUp con lettore abbinato o Satispay |
| Il metodo Messaggio non compare | Il cliente scelto non ha un numero WhatsApp, oppure non è stato scelto nessun cliente |
| Dopo KlimaCard o Messaggio la vendita non compare | È normale: nasce solo quando il cliente ha pagato. Se il link scade (30 minuti) non si registra nulla |
| Il pulsante Riscuoti è spento | Lo scontrino è vuoto oppure c'è un incasso in corso |
| «Stock insufficiente…» | Un collega ha venduto lo stesso prodotto: si riduce la quantità |
| Il prezzo di una voce è diverso da quello dell'appuntamento | Il Checkout porta le voci al prezzo di listino attuale |

## Voci correlate

- [Cassa](https://narciso.io/docs/cassa/)
- [Codice sconto in Cassa](https://narciso.io/docs/codice-sconto-in-cassa/)
- [IVA e regime forfettario in Cassa](https://narciso.io/docs/iva-e-regime-forfettario/)
- [Pagamenti e POS](https://narciso.io/docs/pagamenti-e-pos/)
- [Collegamenti della Cassa](https://narciso.io/docs/collegamenti-della-cassa/)