# Presenze

> Il cartellino delle presenze del salone: come si timbrano entrata e uscita con il lettore di codici, quali regole controllano la timbratura, come si leggono, si cercano ed esportano le timbrature e chi vede le assenze per malattia.

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

La scheda **Presenze** è il cartellino del salone: un elenco delle timbrature di entrata e di uscita dei collaboratori, con l'orario, la durata del turno e lo stato. Le timbrature **non si inseriscono a mano**: si registrano passando un codice sul lettore collegato al salone (vedi [Lettore di codici a barre](https://narciso.io/docs/lettore-di-codici-a-barre/)).

## Come si apre

Nel gruppo **Scartoffie** si sceglie **Personale** e poi la linguetta **Presenze** (vedi [Personale](https://narciso.io/docs/personale/)). La scheda è aperta a tutti e tre i ruoli. Il titolo della pagina è «Cartellino Presenze» e quello della scheda del browser «Registro presenze & Timbrature orarie — Narciso».

L'elenco mostra le timbrature **della sede in cui si sta lavorando**; per vedere un'altra sede si cambia sede dalla [Mappa sedi e sede attiva](https://narciso.io/docs/mappa-sedi/).

## Le colonne

| Colonna | Che cosa mostra |
|---|---|
| **Data** | Il giorno della timbratura, nella forma gg/mm/aaaa |
| **Dipendente** | Nome e cognome, in grassetto |
| **Entrata / Uscita** | Gli orari nella forma «09:00 - 18:00». Un orario che manca appare come «--:--» |
| **Durata** | Il tempo lavorato in ore, minuti e secondi (per esempio «8h 30m 12s»). Per un turno **in corso** il testo è verde, lampeggia lentamente, si aggiorna ogni secondo e porta la dicitura «(in corso)» |
| **Stato** | Un'etichetta colorata, vedi sotto |
| **Note** | Testo libero; compare «-» se non c'è nulla. Passando il mouse si legge per intero |

Ogni intestazione ha un'icona «i» che spiega il contenuto della colonna.

### Gli stati

| Etichetta | Colore | Quando |
|---|---|---|
| **In Turno** | Verde | L'entrata è registrata, l'uscita non ancora |
| **Completato** | Grigio | Entrata e uscita sono registrate |
| **Ferie** | Azzurro | La giornata è segnata come ferie |
| **Malattia** | Rosso | La giornata è segnata come malattia (vedi più sotto chi la vede) |
| **Assente** | Grigio | La giornata è segnata come assenza |
| **Permesso** | Ambra | La giornata è segnata come permesso |

Da questa scheda **non si possono inserire né cambiare** ferie, malattie e note: le colonne mostrano ciò che è già registrato.

## Come si leggono le timbrature

- Le timbrature sono ordinate dalla **più recente** alla meno recente.
- Si caricano **a blocchi mentre si scorre**: non c'è un limite al numero di timbrature. Mentre un blocco arriva compaiono righe grigie; se non arriva compare «Non è stato possibile caricare le presenze.» con il pulsante **Riprova**.
- La barra in basso mostra **Totale record: N**, cioè quante timbrature esistono nella sede (o quante corrispondono alla ricerca).
- La pagina si **aggiorna da sola** quando arriva una timbratura, senza bisogno di ricaricarla.
- Si può ordinare per **Data**, **Dipendente** ed **Entrata / Uscita**, anche su più colonne insieme (fino a tre). L'ordinamento riguarda tutte le timbrature, non solo quelle già caricate. Durata e Stato non si ordinano.

Il comportamento generale della tabella (selezione delle righe, larghezza delle colonne, pulsante Copia, scelta delle colonne con **Visibilità**) è quello descritto in [Le tabelle dei dati](https://narciso.io/docs/tabelle-dati/). Questa scheda non ha i pulsanti Modifica e Unisci.

## Cercare

1. Premere **Ricerca**: il campo propone «Cerca per dipendente...».
2. Scrivere parte del nome o del cognome (anche «Mario Rossi») oppure un pezzo delle **note**. Maiuscole e minuscole non contano.
3. La ricerca parte appena si smette di scrivere e servono almeno 2 lettere; un numero vale anche di una sola cifra.

Con la ricerca attiva anche **Totale record** e l'esportazione riguardano solo le timbrature trovate. **Invio** chiude il campo mantenendo il filtro; la **X** azzera la ricerca.

## Esportare

Il pulsante **Esporta** prepara il file con **tutte** le timbrature che corrispondono alla ricerca (non solo quelle visibili) oppure, se ci sono righe selezionate, solo quelle, con le colonne visibili. I formati sono Excel, CSV, JSON e PDF (tabella A4 in orizzontale, titolata «Cartellino presenze»). Il file si chiama `presenze_AAAA-MM-GG` con l'estensione scelta.

Le esportazioni sono limitate a **20 ogni 10 minuti**. Se l'esportazione fallisce compare «Esportazione non riuscita. Riprova tra qualche istante.»

## Chi vede le assenze per malattia

La malattia è un dato sulla salute e per questo è protetta. Lo stato **Malattia** e le relative note li vedono solo:

- il **Titolare**;
- la **persona interessata**, sulle proprie righe.

Per tutti gli altri la riga appare come **«Assente»** e le note risultano vuote. Lo stesso vale per la ricerca e per i file esportati.

## Timbrare con il lettore

### Che cosa si passa sul lettore

Il lettore riconosce come timbratura solo due tipi di codice:

- il **badge dell'app**, un codice QR personale che identifica il collaboratore;
- il **codice fiscale** del collaboratore, letto dal codice a barre della tessera sanitaria.

Qualsiasi altro codice è trattato come un normale codice a barre di magazzino. L'**entrata o l'uscita si decidono da sole**: se il collaboratore non ha una presenza aperta, la scansione registra l'entrata; se ce l'ha, registra l'uscita. Non serve scegliere nulla.

### Le regole

1. **L'entrata si registra solo se il collaboratore ha un turno in quella sede e in quell'orario**, con una tolleranza di **30 minuti di anticipo**. Vale per tutti i ruoli, Titolare e Responsabile compresi. I turni si impostano nella scheda [Turni](https://narciso.io/docs/turni/).
2. Chi ha già un'entrata aperta in **un'altra sede** (da meno di 16 ore) non può timbrare qui senza aver prima timbrato l'uscita: una persona è in una sola sede alla volta.
3. L'**uscita non ricontrolla il turno**: chi finisce dopo l'orario previsto può timbrare comunque.
4. Due scansioni ravvicinate non aprono due entrate né chiudono due volte la stessa presenza.
5. La durata è la differenza tra uscita ed entrata.
6. L'orario della scansione viene accettato anche se il lettore era senza collegamento, ma non può essere nel futuro oltre 5 minuti né più vecchio di 48 ore: in quel caso la timbratura non viene registrata.

### Gli avvisi

Ogni timbratura produce un avviso a comparsa in tempo reale, in qualunque pagina del programma sia aperta.

| Situazione | Avviso | Tipo |
|---|---|---|
| Entrata registrata | «Timbratura ENTRATA per Nome Cognome» | Verde |
| Uscita registrata | «Timbratura USCITA per Nome Cognome» | Informazione |
| Il codice non corrisponde a nessun collaboratore | «Utente "CODICE" non trovato nel personale» | Rosso |
| Nessun turno in questa sede adesso | «Nome Cognome non ha un turno in questa sede in questo orario» | Rosso |
| Già presente in un'altra sede | «Nome Cognome risulta già presente in "SEDE": timbra prima l'uscita» | Rosso |
| Orario della scansione non accettato | «Timbratura non registrata: …» con il motivo (per esempio che l'orario del lettore va controllato) | Rosso |

### Che cosa fare se la timbratura è rifiutata

| Avviso | Che cosa fare |
|---|---|
| «non ha un turno in questa sede in questo orario» | Nella scheda [Turni](https://narciso.io/docs/turni/) si assegna o si corregge il turno del collaboratore; la timbratura è possibile da 30 minuti prima dell'inizio. Poi si ripete la scansione |
| «Utente … non trovato nel personale» | Il codice non corrisponde a nessuna scheda: si controlla che il codice fiscale in [Anagrafica del personale](https://narciso.io/docs/anagrafica-personale/) sia scritto correttamente |
| «risulta già presente in …» | Il collaboratore deve timbrare l'uscita nella sede precedente |
| «Timbratura non registrata: … orario … nel futuro» | L'ora del lettore non è esatta: va corretta prima di riprovare |

## Il pulsante Aggiungi

Il pulsante **Aggiungi** non apre nessuna maschera: mostra l'avviso «Usa il lettore Barcode/QR per timbrare le presenze».

## Problemi frequenti

| Situazione | Che cosa fare |
|---|---|
| La timbratura non compare | Si controllano gli avvisi: di solito manca il turno nella sede o c'è un'entrata aperta in un'altra sede |
| Una timbratura è sparita dall'elenco | L'elenco mostra solo la sede attiva: si controlla la sede in alto (vedi [Mappa sedi e sede attiva](https://narciso.io/docs/mappa-sedi/)) |
| Una persona risulta «Assente» e non «Malattia» | È voluto: la malattia la vedono solo il Titolare e la persona interessata |
| La ricerca non trova nulla | Servono almeno 2 lettere; si cerca per nome, cognome o note |

## Voci correlate

- [Personale](https://narciso.io/docs/personale/)
- [Turni](https://narciso.io/docs/turni/)
- [Anagrafica del personale](https://narciso.io/docs/anagrafica-personale/)
- [Lettore di codici a barre](https://narciso.io/docs/lettore-di-codici-a-barre/)