Skip to main content

Errori Comuni Stampanti e Soluzioni

Questa guida raccoglie i problemi piu frequenti con le stampanti termiche ESC/POS e le stampanti fiscali Epson FP, con le relative soluzioni.

Problemi Stampanti ESC/POS (Termiche)​

La stampante non stampa nulla​

Sintomi: il job di stampa viene inviato ma nessun output fisico.

Verifiche:

  1. Controllare che la stampante sia accesa e connessa alla rete (ping all'IP)
  2. Verificare che la porta sia 9100 e non bloccata dal firewall
  3. Controllare che il campo isActive del PrinterDevice sia true
  4. Verificare che esista almeno una PrintRoutingRule attiva che punta a quel dispositivo
  5. Controllare i log del PrintRouterService per eventuali errori di connessione socket

Soluzione rapida: dal terminale, testare la connessione con telnet <IP> 9100. Se non risponde, il problema e di rete.

Testo illeggibile o caratteri strani​

Sintomi: la stampa esce con caratteri incomprensibili o simboli.

Cause possibili:

  • Protocollo errato: verificare che protocol sia impostato su escpos (e non star o altro)
  • Codepage non compatibile: il driver usa CP437 di default
  • Caratteri non ASCII nel testo: il generatore rimuove automaticamente i caratteri fuori range 0x20-0x7E, ma se il font della stampante non li supporta si vedono simboli

Soluzione: verificare il protocollo nel PrinterDevice e assicurarsi che corrisponda al modello fisico.

Carta inceppata o taglio parziale​

Sintomi: la carta si blocca dopo il taglio o il taglio e incompleto.

Verifiche:

  1. Controllare che il tipo di taglio sia supportato (taglio totale vs parziale)
  2. Verificare che il FeedBlock prima del CutBlock abbia abbastanza righe (minimo 3)
  3. Pulire la lama di taglio con aria compressa
  4. Sostituire il rotolo se la carta e troppo sottile o umida

Problemi Stampanti Fiscali Epson FP​

ERR01.16 - "NON PREVISTO"​

Causa: il campo dati non ha la lunghezza attesa dal firmware della stampante.

Soluzione: il campo DESC (descrizione) deve essere esattamente 20 caratteri per i modelli FP-81II. Verificare che il codice faccia desc.padRight(20) e non usi una lunghezza diversa. Questo errore si verifica su tutti i comandi che includono DESC: 1080, 1083, 1084.

ERR01.01 - Comando non riconosciuto​

Causa: il codice comando (CMD a 4 cifre) non e valido per quel modello di stampante.

Soluzione: verificare la versione firmware della stampante. Alcuni comandi (es. 1063 per documenti gestionali) potrebbero non essere disponibili su firmware datati. Aggiornare il firmware tramite l'utility Epson.

ERR03.xx - Errori di stato stampante​

CodiceProblemaAzione
fpStatus[0] = 3Offline (coperchio aperto o carta esaurita)Chiudere il coperchio, sostituire la carta
fpStatus[1] = 2Memoria fiscale da formattareContattare assistenza tecnica Epson
fpStatus[1] = 5Memoria fiscale pienaSostituzione della DGFE necessaria

Timeout risposta (10 secondi)​

Causa: la stampante non risponde al comando entro il timeout.

Verifiche:

  1. Verificare che l'IP e la porta siano corretti
  2. Controllare che la stampante non sia gia impegnata in un'altra operazione (es. stampa Z in corso)
  3. Verificare che non ci siano firewall o VLAN che bloccano il traffico
  4. Riavviare la stampante se il problema persiste

NAK su apertura scontrino (1085)​

Causa: la stampante non riesce ad aprire un nuovo scontrino fiscale.

Verifiche:

  1. Potrebbe esserci uno scontrino precedente ancora aperto (controllare fpStatus[3])
  2. La giornata fiscale potrebbe essere chiusa (fpStatus[2] = 1): eseguire un comando di apertura giornata
  3. La stampante potrebbe essere in stato di errore: controllare lo status con il comando 1074

Diagnostica Generale​

Per diagnosticare problemi di stampa, abilitare i log di debug del PrintRouterService e del driver EpsonFpDriver. I log includono:

  • Dati inviati (comando, lunghezza payload)
  • Risposta ricevuta (hex dump completo)
  • Rilevamento errori (parsing ERR code)

Usare developer.log in Flutter per visualizzare i log nella console di debug. In questo progetto, solo print() e visibile nella console Flutter.

FAQ​

Come verifico che la stampante fiscale funziona? Inviare un comando di status (1074). Se la risposta contiene fpStatus con la prima cifra 0, la stampante e operativa.

Il rapporto X non viene stampato, cosa faccio? Verificare che la giornata fiscale sia aperta (fpStatus[2] = 0). Se la giornata e chiusa, il rapporto X non ha dati da mostrare.

Posso usare stampanti USB con il POS? Si, il PrinterDevice supporta connectionType: 'usb', ma il protocollo TCP socket non si applica. Le stampanti USB richiedono un driver specifico per piattaforma.

Vedi Anche​

Questa pagina ti è stata utile?