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.5.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.

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. Messaggio sponsor (scelto a caso, vedi sotto)
8. QR code (se impostato un URL)
9. Dicitura "Documento non fiscale ai sensi dell'art. 1, c. 1, lett. a), DPR 696/1996"
10. 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)
• 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).

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.