Totem Biglietti Coda
Il Totem Biglietti Coda è una postazione self-service: il cliente tocca un pulsante e stampa da solo il proprio numero di coda, al posto delle classiche ruote portanumeri di carta.
Il numero stampato entra nella stessa coda gestita dalla cassa: il cassiere continua a chiamarlo con Chiama Prossimo dall’interfaccia cassa e il Display Coda lo mostra normalmente quando viene chiamato.
Non c’è nessuna app da installare e non c’è niente da scansionare. Il totem è un normale tablet (o PC) con un browser: la postazione si apre e si associa direttamente dal browser, poi stampa e basta.
Cosa serve prima di iniziare
Il totem controlla questi prerequisiti e, se qualcosa manca, mostra un messaggio specifico invece di stampare.
| Prerequisito | Dove si configura |
|---|---|
| Sistema Coda attivo per l’area | Admin → Aree → modifica area → scheda Flusso |
| Stampante Biglietti Coda assegnata all’area | Admin → Configurazione Stampa → scheda Ricevute |
| La stampante in stampa immediata | Impostazione della stampante stessa |
| Una giornata operativa aperta | Admin → Giorni Evento |
La stampante dei biglietti deve essere in stampa immediata. Con una stampante in modalità stampa su richiesta i biglietti resterebbero in attesa nell’app Windows e non uscirebbero mai dal totem: per questo il menu a tendina propone solo stampanti compatibili e il sistema rifiuta la stampa se la stampante non è immediata.
Configurazione
Attiva il Sistema Coda sull’area
Vai in Admin → Aree, modifica l’area e attiva Sistema Coda nella scheda Flusso. Qui scegli anche la modalità di numerazione, sequenziale o alfanumerica.
Assegna la Stampante Biglietti Coda
Vai in Admin → Configurazione Stampa, seleziona l’area e apri la scheda Ricevute. Nel riquadro Stampante Biglietti Coda scegli la stampante che stamperà i numeri.
Il riquadro compare solo se il Sistema Coda è attivo per quell’area, e l’elenco mostra solo le stampanti impostate su stampa immediata.
Apri la postazione sul tablet
Sul tablet, accedi a SagraFacile e apri la dashboard operativa. Tocca la card Biglietti Coda e scegli l’area. Se l’organizzazione ha una sola area, viene selezionata automaticamente.
Associa il dispositivo
Nella barra dispositivo in alto tocca Associa e conferma con le credenziali admin. Puoi scegliere un dispositivo già creato da un amministratore oppure crearne uno nuovo direttamente da qui, dandogli un nome (es. Biglietti Coda – Tablet 1).
Da questo momento il tablet resta legato alla postazione e, alla riapertura, torna da solo sull’area scelta.
Creare i dispositivi in anticipo da Admin → Configurazione → Dispositivi Kiosk resta possibile ma non è necessario, perché puoi crearli e associarli dalla pagina del totem: vedi Modalità Kiosk e Dispositivi. Il link diretto alla postazione è disponibile anche in Link Pubblici, alla voce Biglietti Coda.
Come si usa
La schermata è volutamente minimale: mostra il prossimo numero che verrà stampato e un solo pulsante grande, STAMPA, pensato per essere usato dal cliente. Il cliente tocca, ritira il biglietto e attende che il proprio numero venga chiamato in cassa. La chiamata resta sempre in mano al cassiere.
Fra una stampa e l’altra c’è una pausa di 3 secondi: durante l’attesa il pulsante si disattiva e mostra il conto alla rovescia (Attendi 3s). Serve a evitare che qualcuno stampi decine di biglietti tenendo premuto.
Blocco kiosk sul totem
Se il dispositivo è associato, la modalità kiosk è attiva per l’organizzazione e non c’è nessun operatore collegato con PIN, la pagina si comporta da postazione rivolta al cliente: nella barra in alto spariscono il nome dell’operatore, il pulsante Logout, il pulsante Cambia Area e il ritorno alla dashboard. Restano visibili solo il titolo e il nome dell’area.
Per uscire dal blocco:
Tieni premuto l’angolo in basso a sinistra
Circa 1,5 secondi, sull’area invisibile nell’angolo inferiore sinistro dello schermo.
Sblocca la postazione
Si apre la normale schermata PIN (Sblocca dispositivo): puoi entrare con il PIN operatore oppure usare Accesso amministratore. Il pulsante Annulla in alto a destra chiude la schermata senza sbloccare.
Questa è la via di uscita prevista dal blocco kiosk: assicurati che chi presidia il totem la conosca, perché dallo schermo non è visibile nessun altro comando per tornare alle schermate operative.
Messaggi di errore
| Messaggio | Cosa significa | Cosa fare |
|---|---|---|
| Sistema code non attivo per quest’area | Il Sistema Coda è disattivo sull’area | Attivalo in Admin → Aree → scheda Flusso |
| Stampante biglietti coda non configurata per quest’area | Nessuna stampante assegnata al ruolo biglietti coda | Assegnala in Admin → Configurazione Stampa → scheda Ricevute |
| La stampante biglietti coda non è impostata sulla stampa immediata | La stampante scelta è in modalità stampa su richiesta | Cambia modalità alla stampante o scegline un’altra compatibile |
| Il PC con la stampante non risulta collegato | La stampante (o l’app Windows che la pilota) non è raggiungibile | Nessun numero viene consumato: riprova quando la stampante torna online |
| Area non trovata | Il dispositivo punta a un’area che non esiste più | Riassocia il dispositivo a un’area valida |
| Nessuna Giornata Operativa Aperta | Non c’è una giornata aperta | Apri la giornata da Giorni Evento |
Il controllo sulla raggiungibilità della stampante avviene prima di assegnare il numero: se la stampa non parte il contatore non avanza, quindi non si creano buchi nella numerazione. La barra di associazione del dispositivo resta utilizzabile anche quando manca la giornata operativa, così puoi preparare il totem in anticipo.
Cosa contiene il biglietto stampato
Il biglietto è volutamente essenziale. Dall’alto verso il basso riporta:
- Il nome dell’evento, in maiuscolo e a caratteri alti: è la prima riga, così il cliente capisce subito a quale manifestazione appartiene il biglietto
- Il nome dell’area, in maiuscolo e in grassetto
- La dicitura BIGLIETTO CODA
- Il numero, stampato molto grande (tre volte la dimensione normale) fra due righe di separazione
- Il blocco QR opzionale, con la scritta Inquadra per seguire la coda
- La riga Powered by sagrafacile.it
Se il nome dell’evento o quello dell’area non sono disponibili, la riga corrispondente viene omessa e il resto del biglietto resta invariato. Il biglietto non riporta più la scritta Attendere il proprio turno: lo spazio è stato dato al numero, che è la sola informazione che il cliente deve leggere da lontano.
QR sul biglietto stampato
Il biglietto può riportare un QR che apre il Display Coda sul telefono del cliente. Il cliente può così allontanarsi dalla fila e controllare il proprio turno dal telefono.
Il QR viene stampato solo se sono soddisfatte tutte e tre queste condizioni:
- Il QR cliente è abilitato a livello di installazione (variabile d’ambiente
PUBLIC_QUEUE_QR_ENABLED). Su SagraFacile Cloud è già attivo; sulla versione self-hosted è disattivo di default. - L’opzione area QR su Display Coda è attiva (Admin → Aree → scheda Flusso, sezione Sistema Coda).
- Il server conosce l’indirizzo pubblico del frontend (variabile d’ambiente
FRONTEND_BASE_URL).
Se anche solo una manca, il biglietto viene stampato regolarmente ma senza QR.
Su alcune stampanti ESC/POS più datate il QR esce come testo invece che come codice: in quel caso, nelle impostazioni della stampante, imposta Modalità QR su Immagine — compatibilità stampanti vecchie.
Nota di configurazione per le installazioni self-hosted: il file docker-compose.yml incluso nel pacchetto Community Edition non passa al servizio API né FRONTEND_BASE_URL né PUBLIC_QUEUE_QR_ENABLED. Finché non aggiungi manualmente queste due variabili all’ambiente del servizio api, il QR non comparirà — né sul biglietto stampato né sul Display Coda.
Azzerare la coda
Il Sistema Coda tiene due contatori distinti per ogni area: il numero chiamato in cassa, che avanza a ogni Chiama Prossimo, e il numero stampato dal totem, che avanza a ogni biglietto emesso. Nell’uso reale i due possono allontanarsi — una stampante rimasta offline, un rotolo cambiato a metà, un riavvio della postazione — e per questo esistono due operazioni diverse, entrambe nella sezione Sistema Coda di Admin → Aree → modifica area → scheda Flusso.
Azzera Coda
Il pulsante Azzera Coda fa ripartire la numerazione da 1. È riservato agli amministratori e richiede una conferma esplicita.
L’azzeramento riguarda entrambi i contatori insieme: il numero chiamato dalla cassa e quello stampato dal totem ripartono da 1 nello stesso momento. L’operazione non è annullabile.
Dopo l’azzeramento i biglietti già consegnati ai clienti non sono più validi. Usa questa funzione fra un servizio e l’altro, non a coda piena.
Numero Biglietti Totem
Il campo Numero Biglietti Totem imposta solo il numero che il totem stamperà sul prossimo biglietto. Il numero chiamato in cassa non viene toccato: la coda in corso prosegue da dove si trova. Serve a riallineare il totem senza interrompere il servizio.
A differenza di Azzera Coda è disponibile sia agli amministratori sia ai cassieri: chi presidia il totem deve poter rimettere in riga la numerazione senza cercare un amministratore. I cassieri hanno lo stesso comando direttamente nell’interfaccia di cassa, descritto in Sistema Code nell’interfaccia di cassa.
Apri la scheda Flusso dell’area
Admin → Aree → modifica area → scheda Flusso, sezione Sistema Coda, sotto Azzera Coda.
Scrivi il numero come appare sul biglietto
È la stessa convenzione di Chiama numero specifico: 42 nelle aree con numerazione sequenziale, A03 o B03 in quelle con numerazione alfanumerica. Un formato non valido per l’area viene rifiutato con un messaggio di errore.
Conferma
Il dialogo ricorda che l’operazione riguarda solo i biglietti del totem e mostra il numero che verrà stampato per primo.
Puoi impostare anche un numero più basso di quello attuale — è così che si recuperano i biglietti persi — ma il totem tornerà a stampare numeri già consegnati e due clienti potrebbero ritrovarsi con lo stesso biglietto in mano. La conferma te lo segnala esplicitamente.
Consigli pratici
- Metti il totem all’ingresso della fila, prima delle casse, con la stampante fissata e ben visibile
- Controlla il rotolo della stampante prima di ogni servizio
- Stampa qualche biglietto di prova a giornata aperta, prima dell’apertura al pubblico
- Dai al dispositivo un nome chiaro (es. Biglietti Coda – Ingresso) per ritrovarlo in Admin → Dispositivi Kiosk
- Tieni il tablet collegato alla corrente per tutta la durata del servizio
- Se il totem stampa numeri che non corrispondono più alla coda, usa Numero Biglietti Totem invece di azzerare tutto
Il totem è una funzione recente, provata finora su un primo giro di stampanti. Prima di aprire al pubblico stampa qualche biglietto di prova con la tua stampante e tieni a portata di mano la ruota portanumeri come piano B per la prima serata.
Argomenti Correlati
- Interfaccia di Cassa (POS) — il blocco coda in cassa, con la statistica TOTEM e il comando
⋯ - Display Coda — la schermata pubblica che mostra il numero chiamato
- Modalità Kiosk e Dispositivi — gestione dei tablet associati
- Configurazione Stampa — stampanti e schede per area
- Aree — impostazioni del Sistema Coda