Configurazione Stampanti ESC/POS e di Rete
Panoramica
Il sistema POS supporta stampanti termiche ESC/POS per l'emissione di scontrini, comande cucina e report. La gestione della stampa avviene tramite il modulo PrintRouterService nell'app cassa, che instrada i lavori di stampa in base a regole configurabili (tipo documento, reparto, stampante di destinazione).
Modelli supportati
| Marca | Modelli testati | Interfacce |
|---|---|---|
| Epson | TM-T88V, TM-T88VI, TM-T20III, TM-m30 | USB, Ethernet, Bluetooth |
| Star | TSP143IV, TSP654II, mPOP | USB, Ethernet, Bluetooth |
| Custom | K80, KUBE II | USB, Ethernet |
| Bixolon | SRP-350III | USB, Ethernet |
| Generiche | Qualsiasi compatibile ESC/POS | USB, Ethernet |
Per le stampanti fiscali Epson (FP-81II, FP-90III), consultare la sezione dedicata nel protocollo FP.
Connessione USB (Windows)
Procedura
- Collegare la stampante al PC tramite cavo USB
- Installare i driver: la maggior parte delle stampanti Epson e Star vengono riconosciute automaticamente da Windows. In caso contrario, scaricare i driver dal sito del produttore
- Nell'app cassa, andare in Impostazioni > Stampanti > Aggiungi stampante
- Selezionare "USB" come tipo di connessione
- Scegliere la stampante dall'elenco dei dispositivi rilevati
- Stampare una pagina di test per verificare il funzionamento
Note USB
- Su Windows, le stampanti USB vengono gestite tramite il driver di porta seriale virtuale
- Verificare che la stampante non sia impostata come "stampante predefinita di Windows" per evitare conflitti
Connessione Ethernet (Rete)
Configurazione IP della stampante
- Stampare la pagina di configurazione della stampante (solitamente tenendo premuto il pulsante Feed durante l'accensione)
- Annotare l'indirizzo IP corrente della stampante
- Configurare un IP statico tramite l'utility del produttore:
- Epson: EpsonNet Config o pagina web della stampante (
http://<IP_STAMPANTE>) - Star: Star Quick Setup Utility
- Custom: PrinterSet
- Epson: EpsonNet Config o pagina web della stampante (
- Assegnare un IP nella stessa subnet della rete del punto vendita (es.
192.168.1.201) - Impostare il gateway corretto e disabilitare il DHCP sulla stampante
Configurazione nell'app cassa
- Andare in Impostazioni > Stampanti > Aggiungi stampante
- Selezionare "Rete" come tipo di connessione
- Inserire l'indirizzo IP della stampante (es.
192.168.1.201) - Inserire la porta (default:
9100per la maggior parte dei modelli) - Assegnare un nome descrittivo (es. "Cucina 1", "Bar", "Cassa")
- Stampare una pagina di test
Consiglio
Riservare un range IP dedicato per le stampanti (es. 192.168.1.200-210) e documentare la mappatura IP-stampante-postazione per semplificare la manutenzione futura.
Connessione Bluetooth
Abbinamento (Android)
- Accendere la stampante e attivare il Bluetooth (consultare il manuale del modello)
- Sul tablet, andare in Impostazioni > Bluetooth > Cerca dispositivi
- Selezionare la stampante dall'elenco e completare l'abbinamento (PIN predefinito: solitamente
1234o0000) - Nell'app cassa, andare in Impostazioni > Stampanti > Aggiungi stampante
- Selezionare "Bluetooth" e scegliere la stampante abbinata
Note Bluetooth
- La connessione Bluetooth e consigliata solo per postazioni mobili (cameriere) a causa della latenza maggiore
- Distanza massima consigliata: 10 metri con linea di vista
- Su Windows, il supporto Bluetooth dipende dall'hardware e dai driver BLE installati
Regole di Instradamento Stampa
Dopo aver configurato le stampanti, definire le regole di routing:
- In Impostazioni > Stampanti > Regole di stampa
- Per ogni tipo di documento (scontrino, comanda cucina, comanda bar, report X) assegnare la stampante di destinazione
- Le regole possono essere basate su: tipo di articolo, reparto, categoria prodotto
Le regole vengono gestite dal PrintRouterService e possono essere configurate anche tramite l'Editor Stampa (modulo editor_stampa_ui).
Risoluzione Problemi
La stampante non stampa
- Verificare che la stampante sia accesa e che la spia di stato sia verde
- Controllare il collegamento fisico (cavo USB/Ethernet)
- Per le stampanti di rete: verificare che il PC e la stampante siano sulla stessa subnet (
ping <IP_STAMPANTE>) - Verificare che la porta 9100 sia raggiungibile e non bloccata dal firewall
- Nell'app cassa, riprovare con "Stampa pagina di test"
Testo illeggibile o caratteri errati
- Verificare che la stampante sia impostata sulla code page corretta (CP858 o CP437 per l'italiano)
- Controllare la larghezza carta: 80mm (standard cassa) o 58mm (portatili)
- Se i caratteri accentati non vengono stampati correttamente, verificare le impostazioni della code page nelle impostazioni avanzate della stampante nell'app
Stampante fiscale: errore ERR01.16
Questo errore ("NON PREVISTO") sulle Epson FP-81II indica un formato dati non corretto. Il campo descrizione nei comandi fiscali (1080, 1083, 1084) deve essere esattamente di 20 caratteri. Verificare che non siano configurati padding a 42 caratteri.
Inceppamento carta
- Aprire il coperchio della stampante
- Rimuovere delicatamente la carta inceppata tirandola nella direzione di uscita
- Inserire un nuovo rotolo assicurandosi che la carta esca dalla parte corretta (lato termico verso la testina)
- Chiudere il coperchio e premere Feed per verificare l'avanzamento
FAQ
D: Quante stampanti posso configurare per postazione? R: Non c'e un limite tecnico. Una configurazione tipica prevede: 1 stampante scontrini alla cassa, 1-2 stampanti comande in cucina, 1 stampante al bar.
D: Posso usare stampanti non ESC/POS? R: Il sistema genera nativamente comandi ESC/POS. Stampanti con protocolli diversi (es. Star Line Mode) potrebbero non essere completamente compatibili. Si consiglia di impostare la stampante in modalita ESC/POS dove disponibile.
D: Come configuro una stampante fiscale (RT)? R: Le stampanti fiscali (Epson FP, Custom Kube Fiscal) hanno una configurazione dedicata con protocollo socket specifico. Consultare la documentazione del protocollo FP per i dettagli di configurazione.
Vedi Anche
- Installazione App Cassa -- Setup applicazione cassa
- Risoluzione Problemi Comuni -- Errori frequenti e soluzioni