Skip to main content

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

MarcaModelli testatiInterfacce
EpsonTM-T88V, TM-T88VI, TM-T20III, TM-m30USB, Ethernet, Bluetooth
StarTSP143IV, TSP654II, mPOPUSB, Ethernet, Bluetooth
CustomK80, KUBE IIUSB, Ethernet
BixolonSRP-350IIIUSB, Ethernet
GenericheQualsiasi compatibile ESC/POSUSB, Ethernet

Per le stampanti fiscali Epson (FP-81II, FP-90III), consultare la sezione dedicata nel protocollo FP.

Connessione USB (Windows)

Procedura

  1. Collegare la stampante al PC tramite cavo USB
  2. 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
  3. Nell'app cassa, andare in Impostazioni > Stampanti > Aggiungi stampante
  4. Selezionare "USB" come tipo di connessione
  5. Scegliere la stampante dall'elenco dei dispositivi rilevati
  6. 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

  1. Stampare la pagina di configurazione della stampante (solitamente tenendo premuto il pulsante Feed durante l'accensione)
  2. Annotare l'indirizzo IP corrente della stampante
  3. 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
  4. Assegnare un IP nella stessa subnet della rete del punto vendita (es. 192.168.1.201)
  5. Impostare il gateway corretto e disabilitare il DHCP sulla stampante

Configurazione nell'app cassa

  1. Andare in Impostazioni > Stampanti > Aggiungi stampante
  2. Selezionare "Rete" come tipo di connessione
  3. Inserire l'indirizzo IP della stampante (es. 192.168.1.201)
  4. Inserire la porta (default: 9100 per la maggior parte dei modelli)
  5. Assegnare un nome descrittivo (es. "Cucina 1", "Bar", "Cassa")
  6. 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)

  1. Accendere la stampante e attivare il Bluetooth (consultare il manuale del modello)
  2. Sul tablet, andare in Impostazioni > Bluetooth > Cerca dispositivi
  3. Selezionare la stampante dall'elenco e completare l'abbinamento (PIN predefinito: solitamente 1234 o 0000)
  4. Nell'app cassa, andare in Impostazioni > Stampanti > Aggiungi stampante
  5. 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:

  1. In Impostazioni > Stampanti > Regole di stampa
  2. Per ogni tipo di documento (scontrino, comanda cucina, comanda bar, report X) assegnare la stampante di destinazione
  3. 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

  1. Aprire il coperchio della stampante
  2. Rimuovere delicatamente la carta inceppata tirandola nella direzione di uscita
  3. Inserire un nuovo rotolo assicurandosi che la carta esca dalla parte corretta (lato termico verso la testina)
  4. 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

Questa pagina ti è stata utile?