Configurare la stampante Epson con scontrini e logo

Cosa serve

• Una stampante per scontrini Epson con Server Direct Print e collegamento di rete (LAN o Wi-Fi), per esempio TM-m30III, TM-m30II-H/-NT/-S/-SL, TM-m50/TM-m50II, TM-T88VII, TM-T88VI, TM-L100, TM-H6000V, TM-T70II-DT2, TM-T88VI-DT2.
• Accesso a Internet per la stampante – basta un normale router, senza port forwarding.
• Carta termica larga 80 o 58 mm, adatta alla stampante. Stampanti di scontrini e display degli ordini si configurano solo qui, non nell'area admin della WebApp o dell'app.
• Un accesso come titolare o amministratore dell'associazione nell'Amministrazione su /admin.

Aggiungere la stampante in /admin

1. Aprite /admin, scegliete a sinistra la lista e andate su «Operatività» → «Stampanti scontrini».
2. Cliccate su «Aggiungi stampante scontrini» e inserite un nome, per esempio «Bancone».
3. In «Lista» scegliete la lista (o lasciate vuoto per tutte) e in «Larghezza carta» 80 mm o 58 mm.
4. In «Cosa stampa questa stampante?» spuntate cosa esce automaticamente: «Scontrini», «Chiusura Z» e «Comande» – i dettagli nella sezione «Instradamento stampe» più sotto. Senza spunte la stampante stampa solo prove di stampa e scontrini scelti esplicitamente.
5. Cliccate su «Salva». La finestra resta aperta e mostra l'indirizzo di prelievo, l'«ID (utente)» e la password – la password solo ora: copiatela con «Copia password». «Nuovo indirizzo» e «Nuova password» rendono non validi quelli vecchi.

Configurare la stampante

1. Trovate l'indirizzo IP della stampante: a stampante spenta tenete premuto il tasto di avanzamento (FEED) e accendetela – il foglio di stato mostra l'indirizzo IP.
2. Aprite http://indirizzo-IP nel browser di un computer della stessa rete – è l'interfaccia web della stampante (Web Config, sui modelli più vecchi EpsonNet Config). Andate su «Advanced Settings» → «Administrator Login» e accedete: sui modelli più recenti la password è il numero di serie della stampante (utente, se richiesto, «epson»). I modelli TM-i e TM-DT seguono lo stesso percorso.
3. Prima aggiornate i certificati radice della stampante: il nostro server usa un certificato Let's Encrypt (catena YR1 → ISRG Root YR → ISRG Root X1). Gli elenchi di certificati più vecchi nella stampante non lo conoscono: allora https:// fallisce senza avviso e da noi non arriva nessuna richiesta. Aprite «Advanced Settings» → «Network Security» → «Root Certificate Update» e cliccate su «Update»; la stampante scarica l'elenco attuale da Epson. In alternativa importate in «Network Security» → «CA Certificate» i file PEM «ISRG Root X1» e «ISRG Root YR» da letsencrypt.org/certificates.
4. Aprite «TMI Settings» → «Server Direct Print» e impostate «Server Direct Print» (nel manuale Epson «Use Server Direct Print») su «Enable».
5. Inserite in «URL» l'indirizzo copiato, in «Interval» 5 secondi e nei campi «ID» e «Password» utente e password da /admin. La stampante accede con questi dati tramite HTTP Digest, come descritto nel manuale Epson; il nostro server accetta Digest e Basic. Senza credenziali corrette risponde «401» e la stampante non riceve nulla. Meno di 5 secondi non serve: il nostro server accetta al massimo una richiesta ogni 400 ms per stampante.
6. Cliccate su «Apply» e poi, in «TM-i Settings» (indirizzo /webconfig-i), su «Apply & Restart»: solo allora la stampante applica Server Direct Print e si riavvia. Poi uscite con «Administrator Logout»: finché qualcuno è connesso come amministratore, la stampante è in modalità di configurazione e non stampa nulla.
7. In /admin cliccate su «Stampa di prova» nella riga della stampante. Lo scontrino di prova arriva al prossimo controllo – quindi entro circa 5 secondi – e nella colonna «Stato» compare «ultimo contatto» con l'ora.

In alternativa: stampanti Star con CloudPRNT

1. Al posto di Epson va bene anche una stampante Star con CloudPRNT, ad esempio TSP143IV, TSP100IV, mC-Print3 o mC-Print2. Nell'aggiunta scegliete «Star CloudPRNT (la stampante preleva gli scontrini)».
2. Aprite l'interfaccia web della stampante Star (indirizzo IP dalla stampa di autotest) e accedete come amministratore.
3. Attivate CloudPRNT, inserite in «Server URL» l'indirizzo di /admin, come intervallo di polling da 5 a 10 secondi e nell'autenticazione (Basic) utente e password di /admin.
4. Salvate, riavviate la stampante e cliccate «Stampa di prova» in /admin. Al primo contatto il server memorizza l'indirizzo MAC della stampante; un altro dispositivo con lo stesso indirizzo viene rifiutato.

Stampanti scontrini economiche tramite il proxy di stampa (USB o rete)

1. Al posto di una stampante Epson o Star con funzione cloud va bene anche una stampante scontrini ESC/POS economica – via USB o in rete, ad esempio Epson TM-T20, Xprinter, Munbyn o Rongta. Serve una taglierina automatica: ogni scontrino termina con un taglio. Le stampanti senza taglierina (barra di strappo, molte stampanti portatili da 58 mm) non sono supportate.
2. Per questo nella rete dell’associazione gira con Docker un piccolo proxy di stampa – su un Raspberry Pi (anche modelli meno recenti dal Pi 2; Pi 1 e il primo Pi Zero non funzionano), un NAS o un PC. Si collega da solo al nostro server, senza port forwarding.
3. In /admin aprite «Operatività» → «Stampanti scontrini» → «Proxy di stampa», inserite un nome e cliccate su «Associa proxy». Il token del dispositivo compare solo ora. Se la stampante è collegata al proxy via USB, spuntate «Stampante via USB sul proxy (/dev/usb/lp0)». Copiate con «Copia comando» il comando di avvio già pronto (docker run …). In alternativa «docker compose» mostra la stessa configurazione come docker-compose.yml: copiatelo con «Copia YAML», salvatelo in una cartella ed eseguite lì «docker compose up -d».
4. Eseguite il comando sul Raspberry Pi o sul computer. Al primo avvio Docker scarica da solo l’immagine drinklist/print-proxy da Docker Hub (https://hub.docker.com/r/drinklist/print-proxy, per amd64, arm64 e arm/v7). Docker riavvia il proxy da solo dopo un riavvio o un’interruzione di corrente; poco dopo il proxy risulta «connesso» in /admin. Suggerimento: con l’aggiunta --test-print e l’indirizzo IP della stampante (oppure /dev/usb/lp0) l’immagine stampa una pagina di prova senza server – per verificare cavo, indirizzo e taglierina.
5. Poi aggiungete la stampante: collegamento «Proxy di stampa: stampante ESC/POS economica via USB o rete (Docker, Raspberry Pi)», scegliete il proxy e in «Collegamento al proxy» rete (indirizzo IP della stampante nella rete dell’associazione, porta 9100) oppure USB (/dev/usb/lp0). Spuntate «La stampante ha una taglierina automatica», salvate e cliccate su «Stampa di prova». Instradamento, ristampa e lavori funzionano come per ogni altra stampante.
6. Se il proxy non è connesso (corrente, internet), gli scontrini attendono ed escono appena torna online – quelli più vecchi di due ore non vengono più stampati, la ristampa resta possibile. La colonna «Stato» mostra carta esaurita o coperchio aperto, se la stampante lo segnala; molte stampanti economiche non lo fanno. «Nuovo token» invalida quello vecchio, «Rimuovi» scollega definitivamente il proxy.

Instradamento stampe: cibo in cucina, bevande al bancone

1. In «Cosa stampa questa stampante?» ogni stampante decide cosa stampa automaticamente: «Scontrini» dopo ogni vendita in contanti, la «Chiusura Z» alla chiusura della cassa e le «Comande» per i nuovi ordini dall’ordinazione QR. Più stampanti possono stampare la stessa cosa, ad esempio gli scontrini al bancone e in ufficio.
2. Cucina: aggiungete la stampante «Cucina», spuntate «Comande» e in «Solo questi gruppi di prodotti (categorie)» scegliete la categoria dei piatti, ad esempio «Cibo» – così come è impostata sui prodotti.
3. Bancone: per la stampante «Bancone» spuntate «Scontrini» e «Comande» e in più «Tutti gli altri prodotti (categoria senza stampante propria)». Senza categoria e senza questa spunta una stampante stampa ogni ordine per intero.
4. Un ordine con 2 birre e 1 cotoletta ora produce due comande: la cotoletta in cucina, le birre al bancone – ognuna con numero d'ordine, tavolo o postazione, ora, ospite e note. Le voci senza stampante adatta non vengono stampate. A scelta ci sono «Prezzi sulla comanda» e «Stampa gli ordini annullati come comanda di storno».
5. Il pulsante «Instradamento stampe» mostra la panoramica: quale documento per quale lista e gruppo di prodotti esce su quale stampante. Se per la stampante non è scelta alcuna lista, «Per la lista» nella finestra della stampante limita i suoi instradamenti a una sola lista.

Display ordini al posto delle comande: uno schermo per cucina e bancone

1. Aprite «Operatività» → «Display ordini» e cliccate su «Aggiungi display ordini». Nome ad esempio «Cucina», poi come per la stampante «Solo questi gruppi di prodotti (categorie)» oppure «Tutti gli altri prodotti (categoria senza stampante propria)»: schermi e stampanti seguono le stesse regole.
2. Aprite il link o il codice QR sul tablet o sulla TV e scegliete «Aggiungi a schermata Home». Il display si avvia come app propria senza accesso, a schermo intero, e tiene lo schermo acceso. Un tocco attiva l'audio per i nuovi ordini.
3. Ogni ordine aperto compare come grande riquadro con numero, tavolo o postazione, ospite, note e solo le voci per questo schermo. Il tempo scorre e il riquadro diventa giallo dopo «Giallo dopo minuti» e rosso dopo «Rosso dopo minuti».
4. Toccate «In lavorazione» per prendere l'ordine (il bancone lo vede come preso) e «Pronto» per toglierlo da questo schermo – con «Annulla» per 10 secondi. Consegna e incasso restano al bancone. «Nuovo link» rende non valido quello vecchio, ad esempio se un tablet va perso.

Logo per scontrini, PDF e display TV

1. In /admin aprite «Organizzazione» → «Dati anagrafici» e scorrete fino alla sezione «Logo».
2. Cliccate su «Carica logo» e scegliete un'immagine JPG o PNG fino a 2 MB. Viene ruotata e ridimensionata automaticamente.
3. Scegliete dove compare il logo: «Sugli scontrini (stampante), in alto al centro», «Sul display TV/proiettore, in alto a destra» e «Sui PDF dell’associazione, in alto a destra (ricevute, estratti, report)».
4. Consiglio: la stampante stampa solo in bianco e nero, quindi il logo viene convertito in punti. Un logo semplice, con contorni netti e forte contrasto su fondo chiaro, rende meglio sullo scontrino.

Stampare gli scontrini

• Uno scontrino contiene il logo, le righe con lettera IVA, sconti e regole di prezzo, il totale, il metodo di pagamento e l'IVA per aliquota.
• «Giornali e conti» → «Giornale pagamenti»: «Stampa scontrino» nella riga di un pagamento invia lo scontrino alla stampante scelta – senza scelta alla prima stampante con «Scontrini». La ricevuta in PDF resta disponibile come sempre.
• «Operatività» → «Cassa e scontrino Z»: «Stampa chiusura Z» nella riga di una sessione di cassa chiusa stampa la chiusura Z su carta.
• «Operatività» → «Stampanti scontrini» → «Lavori di stampa»: tutti i lavori con stato ed errore. «Ristampa» stampa di nuovo uno scontrino.

Se qualcosa non va

• Nella colonna «Stato» resta «mai interrogata»: l'indirizzo manca o è sbagliato, Server Direct Print non è attivo oppure la stampante non raggiunge Internet. Controllate anche data e ora della stampante: se sono errate, la connessione HTTPS fallisce. Se non riuscite ad accedere all'interfaccia web, ripristinate le impostazioni di fabbrica della stampante con il tasto FEED come descritto nel manuale Epson.
• I lavori restano «in attesa» o «inviato»: la stampante è accesa, c'è carta e il coperchio è chiuso? La stampante preleva i lavori al prossimo contatto; senza risposta vengono riconsegnati e dopo alcuni tentativi segnati come non riusciti. Se /admin mostra per la stampante «Genera una nuova password (necessaria per Epson)», la password è precedente all'accesso Digest: generatene una nuova e inseritela nella stampante.
• Errore con un messaggio della stampante: di solito carta finita o coperchio aperto. Risolvete e il lavoro viene rinviato automaticamente.
• Testo tagliato o troppo stretto: la larghezza carta in /admin deve corrispondere alla carta inserita (80 o 58 mm).
• Lettere accentate o caratteri speciali errati: verificate che il firmware della stampante sia aggiornato – le versioni vecchie non gestiscono tutti i set di caratteri.

Epson: risoluzione dei problemi dalla pratica

• Al server non arriva nessuna richiesta anche se tutto è inserito: di solito la stampante non conosce il certificato Let's Encrypt del nostro server (visto con TM-m30III, firmware TM-i 01.39 e certificati radice 02.03). Eseguite «Advanced Settings» → «Network Security» → «Root Certificate Update» → «Update» oppure importate «ISRG Root X1» e «ISRG Root YR» (letsencrypt.org/certificates) in «Network Security» → «CA Certificate». Poi «Apply & Restart» in «TM-i Settings».
• Le impostazioni modificate non hanno effetto: Server Direct Print applica le modifiche solo dopo «Apply & Restart» in «TM-i Settings» (/webconfig-i).
• La stampante stampa un foglietto «WebConfig Start» e nient'altro: qualcuno è connesso all'interfaccia web come amministratore e la stampante è in modalità di configurazione. Uscite sempre con «Administrator Logout».
• L'autotest stampa ma dalla rete non arriva nulla – anche ePOS o la porta 9100 accettano dati senza stampare: il collegamento interno tra scheda di rete e meccanismo di stampa si è bloccato. Staccate la spina per circa 30 secondi.
• Inserite l'indirizzo con https://, non con http://: le richieste via http:// vengono reindirizzate ed Epson non segue i reindirizzamenti.
• In /admin, in «Operatività» → «Stampanti scontrini», «Letzter Kontakt» (ultimo contatto) nella finestra della stampante mostra le ultime richieste con il risultato; questa diagnostica è in tedesco. «Anmeldung angefordert (401 – bei Digest normal)» (accesso richiesto) è normale alla prima richiesta. Con «Digest-Anmeldung falsch (ID/Passwort prüfen)» (accesso Digest errato) generate una nuova password e inseritela nella stampante. Se compare «seit dem letzten Serverstart kein Abruf angekommen» (nessuna richiesta dall'ultimo avvio del server), la stampante non raggiunge il nostro server: controllate https://, certificati radice e rete.