# Lettore di codici a barre

> Come funziona il lettore di codici a barre in Cassa e nel Magazzino: modalità, messaggi e che cosa succede con un codice sconosciuto.

Ultimo aggiornamento: 22 ottobre 2026. Fonte: https://narciso.io/docs/lettore-di-codici-a-barre/

Il **lettore di codici a barre** (da scrivania o «pistola») è collegato al **Narciso Hub** della sede. La lettura di un codice non «scrive» nei campi come una tastiera: arriva al programma tramite il Hub e viene interpretata in base alla **modalità** in cui si trova il lettore. Che cos'è il Hub e come si controllano i lettori è spiegato in [Apparecchi collegabili](https://narciso.io/docs/apparecchi-collegabili/).

## Le modalità

| Modalità | Che cosa succede leggendo un codice |
|---|---|
| **Magazzino** | La lettura va alla pagina aperta: alla finestra di carico e scarico del Magazzino (vedi [Carico e scarico](https://narciso.io/docs/carico-e-scarico/)) o alla scheda di un nuovo prodotto. Se non è aperta nessuna di queste non succede nulla |
| **Aggiungi veloce** | Aggiunge **1 pezzo** al prodotto con quel codice, senza aprire nulla |
| **Rimuovi veloce** | Toglie **1 pezzo** al prodotto con quel codice |
| **Cassa** | Aggiunge il prodotto allo scontrino (vedi sotto) |

Ogni lettore (scrivania e pistola) ha la propria modalità. Quando cambia compare per 5 secondi un avviso del tipo «Pistola Barcode - Modalità attivata: Cassa».

### Aggiungi veloce e Rimuovi veloce

Il prodotto viene cercato nella sede del Hub con il codice identico. Le due modalità cambiano la giacenza direttamente, anche se nessuna pagina del prodotto è aperta.

| Esito | Messaggio |
|---|---|
| Carico riuscito | Notifica verde «Aggiunto 1x NOME (Stock: N) alle HH:MM» |
| Scarico riuscito | Notifica verde «Rimosso 1x NOME (Stock: N) alle HH:MM» |
| Scarico con giacenza a zero | Notifica rossa «Impossibile completare lo scarico: la quantità per "NOME" (1 pz) supera la quantità disponibile (0 pz).» |
| Codice sconosciuto | Notifica rossa di 8 secondi «Operazione fallita: nessun prodotto registrato in magazzino con il codice CODICE.» con il pulsante **Crea prodotto**, che porta alla scheda Prodotti del Magazzino, dove il prodotto si crea a mano (vedi [Prodotti](https://narciso.io/docs/prodotti/)) |

## Il lettore in Cassa

Con il lettore in modalità **Cassa**, ogni codice letto aggiunge il prodotto corrispondente allo scontrino della [Cassa](https://narciso.io/docs/cassa/). Il lettore aggiunge solo prodotti a codice, mai servizi.

| Caso | Che cosa succede |
|---|---|
| Codice riconosciuto | Una unità in più nello scontrino e messaggio verde «Prodotto aggiunto: NOME» |
| Quantità oltre la giacenza | Messaggio rosso «Impossibile aggiungere in Cassa: la quantità per "NOME" (N pz) supera la quantità disponibile (M pz).» |
| Codice sconosciuto | Messaggio rosso «Prodotto non trovato: CODICE» e si apre la calcolatrice per le voci non inventariate (vedi [Incassare](https://narciso.io/docs/incassare/)) |
| Stesso codice sconosciuto letto di nuovo | Invece di ripetere la calcolatrice, la Cassa aumenta di uno la quantità della riga e mostra «Quantità aggiornata per: NOME» |
| Lettore in un'altra modalità | Avviso giallo «Attualmente lo Scanner Desktop (oppure la Pistola Barcode) ha attiva la modalità NOME. Attivazione della modalità Cassa in corso...» |

Nell'ultimo caso il menu laterale si apre da solo, porta il lettore in modalità Cassa e, finita l'operazione, aggiunge il codice che era in attesa.

## Se manca il Hub o il lettore

| Situazione | Avviso |
|---|---|
| La sede non ha un Hub | «Per gestire i barcode, devi prima acquistare Narciso Hub. Contatta qui l'assistenza per maggiori info». Il link **qui** apre WhatsApp con un messaggio per l'assistenza |
| Il Hub è spento o non raggiungibile | «Il Narciso Hub risulta offline. Verifica che sia acceso e connesso alla rete.» |

L'acquisto, la registrazione e la configurazione del Hub li fa l'assistenza (vedi [Assistenza](https://narciso.io/docs/assistenza/)).

## Senza lettore

Un lettore collegato direttamente al computer, senza Hub, si comporta come una tastiera: scrive il codice nel campo selezionato. Non attiva le modalità descritte qui. In Cassa i prodotti si aggiungono con un clic sull'elenco.

## Voci correlate

- [Apparecchi collegabili](https://narciso.io/docs/apparecchi-collegabili/)
- [Cassa](https://narciso.io/docs/cassa/)
- [Carico e scarico](https://narciso.io/docs/carico-e-scarico/)
- [Magazzino](https://narciso.io/docs/magazzino/)