Guida Utente

1 Requisiti e installazione

Requisiti di sistema

• Windows 10 / 11 (64 bit)
• Stampante termica ESC/POS (USB locale o di rete TCP/IP) — opzionale per i soli test
• Nessun runtime da installare: l'applicazione è self-contained (include .NET 9)
• Nessuna connessione internet richiesta per il funzionamento

Installazione

1. Scaricare ScontrinoEtico_Setup_3.9.exe dalla pagina di download
2. Eseguire l'installer e seguire le istruzioni a schermo
3. Al termine avviare Scontrino Etico dal menu Start o dall'icona sul desktop

L'installer non richiede privilegi di amministratore: viene installato nella cartella dell'utente. Questa guida in PDF viene installata insieme al programma ed è apribile dal menu Start (Guida Utente (PDF)) o dal bottone Guida PDF nelle Impostazioni.

2 Primo avvio

Al primo avvio l'applicazione:

1. Crea automaticamente il database db.sqlite nella cartella del programma (compare il messaggio "Primo Avvio, Database creato").
2. Popola le categorie predefinite: Bevande, Cibo, Speciale, Dolci.
3. Esegue subito un primo backup del database.

Il catalogo prodotti è inizialmente vuoto: vanno aggiunti dalla schermata Impostazioni (vedi §6).

Passi consigliati al primo avvio

1. Aprire Impostazioni (bottone in cassa).
2. Impostare la stampante principale.
3. Aggiungere il logo e il nome organizzazione.
4. Creare/adeguare le categorie e assegnare eventuali stampanti dedicate.
5. Inserire i prodotti.
6. Fare qualche vendita di prova e poi azzerare i dati del giorno di test (vedi §12).

3 La schermata di cassa

È la schermata principale, pensata per l'uso touch-screen con bottoni grandi.

Ogni aggiunta a carrello produce un breve feedback sonoro. Al pagamento il pannello lampeggia in verde (successo) o rosso (errore, es. carrello vuoto o incassato insufficiente).

4 Registrare una vendita

1. Toccare i prodotti per aggiungerli al carrello; regolare le quantità con + / − se necessario.
2. Selezionare il metodo di pagamento:
   • Contanti → compare il campo Incassato. Digitare l'importo ricevuto col tastierino: il resto viene calcolato automaticamente. Alla conferma il cassetto si apre.
   • Carta o Buono Pasto → nessun importo da inserire, nessun resto, nessuna apertura cassetto.
3. Premere REGISTRA E STAMPA.

Alla conferma:

• La vendita viene salvata nel database con un numero d'ordine giornaliero progressivo (riparte da 1 ogni giorno).
• Compare il messaggio "Pagamento registrato. Ordine #N — Resto: … €".
• Il carrello si svuota e parte la stampa in background (l'interfaccia resta reattiva).

Modificare una riga del carrello

Con doppio clic su una riga del carrello (oppure selezionandola e premendo ✎ Modifica) si apre una finestra per correggere:

• Quantità — con i grandi pulsanti + e − (minimo 1).
• Prezzo — con un tastierino numerico a schermo (cifre, virgola per i decimali, azzera e backspace), pensato per le casse senza tastiera.

Il prezzo modificato vale solo per quella riga della vendita corrente: il prezzo di listino del prodotto a catalogo non viene toccato.

5 La schermata Impostazioni

Si apre a schermo intero ed è suddivisa in tre colonne:

• Colonna 1 — Gestione Prodotti: tabella prodotti con Aggiungi / Modifica / Elimina e riordino drag & drop.
• Colonna 2 — Utility: stampante principale, logo, nome organizzazione, testi di scontrino/comanda/sponsor, URL QR code, opzioni di stampa, e i bottoni azione (Ristampa, Statistiche, Scontrini, Categorie, Stat. Avanzate, Guida PDF).
• Colonna 3 — Statistiche Vendita: scontrini per giorno, dettaglio prodotti per giorno, e il bottone Cancella giorno selezionato.

In fondo: Chiudi (torna alla cassa) ed Esci dal programma.

6 Gestione prodotti

Nella colonna Gestione Prodotti:

• Aggiungi — crea un nuovo prodotto.
• Modifica — modifica il prodotto selezionato (anche doppio clic sulla riga).
• Elimina — rimuove il prodotto selezionato (chiede conferma).
• Trascina per ordinare — trascina le righe per cambiare l'ordine dei bottoni in cassa.

Campi di un prodotto

I prodotti disattivati sono mostrati in grigio nella tabella. Utile per articoli stagionali o temporaneamente esauriti senza perderne lo storico vendite.

Esporta / Importa CSV (novità v3.8)

Due bottoni sotto Aggiungi/Modifica/Elimina permettono di gestire il listino con Excel:

• Esporta CSV — salva l'intero catalogo in un file Nome;Categoria;Prezzo;Ordine;Attivo;StampaComandaPerQta, apribile direttamente con Excel (separatore ;, prezzi con la virgola, accenti corretti).
• Importa CSV — rilegge il file e sostituisce tutto il catalogo (o tutto o niente: un file con errori viene rifiutato in blocco con l'elenco delle righe sbagliate). Prima dell'importazione compare una conferma con il numero di prodotti eliminati/importati e l'avviso su eventuali categorie inesistenti.

Per l'import bastano le prime 3 colonne (Nome;Categoria;Prezzo): l'ordine viene assegnato automaticamente e Attivo vale sì. Nei campi Sì/No sono accettati 1/0, si/no, vero, x. In modalità multicassa l'operazione vale per tutte le casse (il catalogo è condiviso).

7 Gestione categorie

Bottone Categorie (colonna Utility). Ogni categoria è configurabile con:

Questo permette flussi come: Bevande → stampante bar, Cibo → stampante cucina, Dolci → nessuna comanda.

8 Configurazione stampanti

Stampante principale

Nella colonna Utility, campo Stampante Principale: si può scegliere dall'elenco delle stampanti installate in Windows oppure digitare un indirizzo di rete.

Stampanti locali (USB)

Selezionare dal menu a tendina il nome della stampante come appare in Windows (default suggerito: POS-80). La stampa avviene tramite le API di Windows (winspool) con codepage CP858 (per le lettere accentate).

Stampanti di rete (TCP/IP)

Digitare l'indirizzo nel formato:

192.168.1.50        →  porta predefinita 9100
192.168.1.50:9100   →  porta esplicita

Il sistema riconosce automaticamente un indirizzo IP e usa la stampa di rete diretta. Se la stampante di rete non è raggiungibile, i lavori vengono accodati e ritentati automaticamente (retry periodico), così le vendite non si bloccano per un problema temporaneo di rete.

Stampante per categoria

Ogni categoria può avere una stampante dedicata diversa dalla principale (vedi §7). Se il campo è lasciato vuoto, la comanda va sulla stampante principale.

Apertura cassetto

• Automatica al pagamento in contanti.
• Manuale in qualsiasi momento col bottone dedicato in cassa.

Il comando è ESC/POS standard (ESC p), compatibile con i cassetti collegati alla stampante.

9 Personalizzazione scontrino e comande

Tutti i testi si impostano nella colonna Utility e vengono salvati subito nel database.

Scontrino cliente

Lo scontrino stampato include, nell'ordine:

1. Logo (se impostato)
2. Nome organizzazione
3. Elenco articoli con quantità e importo di riga
4. Totale, metodo di pagamento, ed eventuale resto
5. Data/ora e numero scontrino (Sc.Nr., sempre presente)
6. PRENOTAZIONE NR: N (numero prenotazione in grande, solo se la relativa gestione è attiva)
7. NOME e TAVOLO (se le relative richieste sono attive e i campi sono stati compilati, vedi sotto)
8. Messaggio sponsor (scelto a caso, vedi sotto)
9. QR code (se impostato un URL)
10. Dicitura "Documento non fiscale ai sensi dell'art. 1, c. 1, lett. a), DPR 696/1996"
11. Taglio carta automatico

Comande

Per ogni categoria con Stampa separata attiva viene stampata una comanda con:

• PRENOTAZIONE NR: N in grande (se la gestione del numero di prenotazione è attiva)
• NOME e TAVOLO (se le relative richieste sono attive e i campi sono stati compilati)
• Elenco articoli di quella categoria (quantità × nome), stampato in caratteri grandi per una lettura rapida al banco/in cucina
• Il Messaggio comanda configurabile

Numero di prenotazione

Di norma ad ogni vendita viene assegnato un numero di prenotazione progressivo (riparte da 1 ogni giorno), stampato in grande sullo scontrino e sulle comande per chiamare i clienti al ritiro.

Questo comportamento si può disattivare con l'impostazione "Gestisci e stampa il numero di prenotazione" nel pannello Utility (attiva di default):

• Attiva: il numero viene incrementato e stampato come PRENOTAZIONE NR: N su scontrino e comande.
• Disattivata: il numero di prenotazione non viene più incrementato né stampato. Il numero dello scontrino (Sc.Nr.) resta invece sempre stampato — è obbligatorio — e riporta l'identificativo univoco della vendita.

Comanda per singola quantità

Normalmente un articolo con quantità 3 compare come una sola riga 3 x Nome nella comanda di categoria. È però possibile stampare una comanda separata per ogni singolo pezzo (es. 3 piatti di tortelli → 3 comande distinte, una per piatto), utile per distribuire il lavoro in cucina.

Si attiva a due livelli:

• Per singolo articolo — flag "Stampa comanda per singola quantità" nella scheda del prodotto (vedi §6). Vale solo per quell'articolo, che viene stampato in comande separate dal resto dell'ordine.
• Globale — impostazione "Stampa una comanda per ogni singola quantità (tutti gli articoli)" nel pannello Utility. Se attiva sovrascrive i flag dei singoli articoli e vale per tutti i prodotti.

In entrambi i casi le comande vengono stampate sulle stampanti di riferimento delle rispettive categorie. Lo scontrino cliente resta invariato (mostra sempre 3 x Nome in un'unica riga).

Richiesta nome prenotazione e tavolo (novità v3.6)

Due impostazioni opzionali (disattivate di default) nel pannello Utility:

• "Richiedi il nome sulla prenotazione prima dello scontrino"
• "Richiedi il tavolo prima dello scontrino"

Se attive, alla pressione di Registra e Stampa compare — prima dell'emissione — una finestra con il campo di testo e una tastiera a monitor sotto al campo (utilizzabile anche con la tastiera fisica). Se sono attive entrambe, le due richieste compaiono in sequenza: prima il nome, poi il tavolo.

• ✓ conferma il valore inserito (può anche essere lasciato vuoto);
• ✕ (o Esc) annulla l'intera operazione: lo scontrino non viene emesso e il carrello resta invariato.

Le informazioni inserite, se presenti, vengono stampate in evidenza (NOME: e TAVOLO:) sullo scontrino cliente e su ogni comanda di settore, e vengono salvate nel database insieme allo scontrino.

Doppia copia dello scontrino (novità v3.6)

Con l'impostazione "Stampa lo scontrino generale 2 volte (prima delle comande)" (disattivata di default) lo scontrino cliente viene stampato in due copie identiche sulla stampante principale, prima della stampa delle comande di settore.

Campi personalizzabili

10 Statistiche e report

Pannello statistiche (colonna 3)

• Scontrini per giorno — per ciascun giorno: numero scontrini e totale incassato. L'icona 🖨 accanto a ogni giorno stampa il report giornaliero su stampante termica.
• Prodotti venduti per giorno — quantità per prodotto; selezionando un giorno nella tabella superiore l'elenco si filtra su quel giorno.

Statistiche avanzate

Bottone Stat. Avanzate — dashboard con filtro date (da / a):

• Incasso medio per scontrino
• Vendite per fascia oraria (ore di punta)
• Top 10 prodotti per quantità e incasso
• Confronto tra giorni (numero scontrini, totale, media)
• Vendite per metodo di pagamento
• Vendite per categoria

Report giornaliero stampato

Il report su carta termica riporta: totale incasso del giorno, numero scontrini, suddivisione per metodo di pagamento e i prodotti più venduti.

11 Gestione scontrini e ristampe

• Scontrini (colonna Utility) — mostra gli ultimi 10 scontrini emessi. Da qui è possibile eliminare un singolo scontrino (operazione protetta da password).
• Ristampa — ristampa l'ultimo scontrino emesso, con intestazione di ristampa.

12 Cancellazione dati e modalità test

Durante l'installazione e il collaudo è normale fare vendite di prova che sporcano i dati reali. Per ripulirle senza toccare gli altri giorni:

Cancella giorno selezionato (novità v3.4)

Nella colonna Statistiche Vendita:

1. Selezionare il giorno da azzerare nella tabella Scontrini per giorno.
2. Premere Cancella giorno selezionato.
3. Inserire la password richiesta.
4. Confermare l'avviso di operazione irreversibile.

Vengono eliminati tutti gli scontrini e le relative righe di quel giorno; gli altri giorni restano intatti. Al termine le statistiche si aggiornano e viene mostrato il numero di scontrini rimossi.

13 Backup automatico

Il database viene salvato automaticamente, senza intervento dell'operatore:

• Ad ogni avvio dell'applicazione
• Ogni ora durante l'uso
• Vengono conservati gli ultimi 10 backup (i più vecchi vengono eliminati)

Posizione dei backup:

%AppData%\ScontrinoEtico\backup\db_AAAAMMGG_HHMMSS.sqlite

Per un ripristino manuale è sufficiente copiare uno di questi file al posto del db.sqlite nella cartella del programma (ad applicazione chiusa).

14 Aggiornamenti

All'avvio l'applicazione controlla in background se esiste una versione più recente. Se disponibile, in basso in cassa compare un banner giallo cliccabile con numero di versione e nota; cliccandolo si apre la pagina di download nel browser.

Il banner si può chiudere con il pulsante ✕ sulla destra: sparisce per la sessione corrente e ricompare al prossimo avvio se l'aggiornamento è ancora disponibile.

Il controllo è silenzioso: se non c'è connessione o non ci sono aggiornamenti, non viene mostrato nulla e l'uso non è mai bloccato.

15 Riferimento impostazioni

Tutte le impostazioni sono salvate nel database locale db.sqlite (tabelle Impostazioni, Categorie, Prodotti).

16 Password del sistema

Alcune operazioni distruttive sono protette da password:

17 Risoluzione problemi

Se il problema persiste, scrivi a supporto@scontrinoetico.it.

18 Multicassa: più casse in rete (novità v3.9)

Più casse (consigliate 3-4) possono lavorare contemporaneamente sugli stessi dati e sulle stesse stampanti comande. Una cassa fa da Server — possiede il database, assegna i numeri di prenotazione e stampa le comande — e le altre sono Client che si collegano via rete locale.

Le tre modalità

Nel pannello Utility, campo Multicassa:

Come si configura

1. Sulla cassa-server: impostare Server multicassa e salvare. Al primo avvio del servizio, Windows mostra l'avviso del firewall: consentire l'accesso alle reti private (indispensabile, altrimenti i client non la raggiungono).
2. Sulle casse client: impostare Client multicassa e riavviare. All'avvio la cassa trova da sola il server in rete; se ne trova più d'uno (o nessuno) compare una finestra di scelta con la possibilità di ripetere la ricerca, inserire l'indirizzo manualmente (es. 192.168.1.50 o 192.168.1.50:8720) o tornare alla modalità cassa singola. L'indirizzo scelto viene ricordato per gli avvii successivi.
3. Il bottone Cerca server nelle Impostazioni permette di verificare in ogni momento quali casse-server sono visibili in rete.

Chi stampa cosa

• Lo scontrino cliente esce sempre dalla stampante locale della cassa dove è stata battuta la vendita (impostazione Stampante Principale, che è per-postazione).
• Le comande di settore le stampa sempre la cassa-server sulle stampanti delle categorie, in coda ordinata: anche se due casse vendono nello stesso istante, le comande non si mischiano mai e i numeri di prenotazione restano unici e progressivi.

Impostazioni condivise e per-postazione

Prodotti, categorie, testi, sponsor, QR code e opzioni di stampa sono condivisi: modificarli da una cassa qualsiasi vale per tutte. Restano invece proprie di ogni postazione: la stampante scontrino, il logo, la modalità multicassa, la porta e l'indirizzo del server.

Se la connessione si interrompe

Se la cassa-server non è più raggiungibile, sulla cassa client compare un banner rosso in alto e le vendite vengono bloccate con un avviso (nessuna vendita persa o salvata a metà: il carrello resta intatto). La cassa riprova da sola ogni pochi secondi e il banner sparisce appena il collegamento torna.