Impressoras térmicas e recibos
Como conectar impressoras térmicas ao POS, configurar templates de recibo e resolver problemas de impressão.
Atualizado: 5 de abril de 2026
O POS do contable.io imprime recibos em impressoras térmicas padrão de 58 mm ou 80 mm, conectadas via USB, LAN ou Bluetooth. A configuração é feita uma vez por estação e a impressão é automática após cada venda confirmada.
Modelos compatíveis
O contable.io funciona com qualquer impressora térmica que suporte ESC/POS (padrão da indústria). Modelos testados:
| Marca | Modelos |
|---|---|
| Epson | TM-T20, TM-T88, TM-m30 |
| Bixolon | SRP-275, SRP-330 |
| Star | TSP143, TSP100 |
| Genéricas chinesas (XPrinter, Rongta) | XP-58, XP-80, RP58, RP80 |
Se sua impressora não está listada mas suporta ESC/POS, deve funcionar. Tente com o driver “Generic Text Only”.
Como funciona a impressão
O POS não conecta diretamente à impressora a partir do navegador (navegadores não permitem acesso livre a USB por segurança). Em vez disso, usa o diálogo de impressão nativo do SO: ao confirmar uma venda, o sistema abre a tela de impressão e a impressora térmica aparece como opção.
Para impressão silenciosa automática (sem diálogo), defina a impressora térmica como padrão no SO e habilite “imprimir sem perguntar” no navegador.
Definir a impressora como padrão
Windows
- Conecte a impressora (USB ou LAN) e ligue.
- Vá em Configurações → Dispositivos → Impressoras e scanners.
- Toque em Adicionar impressora. Se não for detectada, use A impressora não está listada e escolha o driver do fabricante ou “Generic / Text Only”.
- Clique direito na impressora → Definir como padrão.
- Imprima uma página de teste do Windows para confirmar.
macOS
- Vá em Ajustes do Sistema → Impressoras e Scanners.
- Toque em
+e selecione a impressora detectada. - O macOS baixa o driver automaticamente.
- Defina como padrão no menu suspenso.
Linux
Instale o CUPS e adicione a impressora a partir de http://localhost:631.
Configurar largura do papel no POS
- No POS, vá ao menu lateral → Configurações de impressão.
- Escolha a largura do papel: 58 mm ou 80 mm.
- Escolha o template de recibo (padrão, compacto, com logo).
- Faça upload do logo (recomendado 200×200 px PNG com fundo transparente).
- Toque em Imprimir teste para verificar.
Habilitar impressão automática (sem diálogo)
Por padrão, cada venda confirmada mostra o diálogo de impressão. Para imprimir silenciosamente:
Chrome / Edge (recomendado)
Inicie com esta flag:
chrome.exe --kiosk-printingNo macOS:
open -a "Google Chrome" --args --kiosk-printingFirefox
Sem equivalente direto. Use Chrome ou Edge para impressão silenciosa.
Templates de recibo
O contable.io inclui três templates predefinidos:
| Template | Conteúdo |
|---|---|
| Padrão | Logo + dados do negócio + cliente + itens + totais + CUDE/QR + rodapé |
| Compacto | Sem logo, fonte pequena, otimizado para 58 mm |
| Com cópia | Imprime duas cópias seguidas (negócio + cliente) |
Você pode editar texto de cabeçalho e rodapé em Configurações de impressão → Editar template. Suporta variáveis como {company_name}, {phone}, {nit}.
Erros comuns
- “Impressora não encontrada”: verifique se está ligada, conectada e definida como padrão no SO.
- “Imprime caracteres estranhos”: o driver não é compatível UTF-8. Mude para “Generic Text Only” ou instale o driver do fabricante.
- “Imprime muito pequeno / muito grande”: revise a largura de papel configurada no POS (58 vs 80 mm).
- “Não corta o papel automaticamente”: seu modelo não tem cortador ou o comando de corte não está habilitado no driver.