Impresoras térmicas y recibos

El POS de contable.io imprime tirillas en impresoras térmicas estándar de 58 mm o 80 mm, conectadas por USB, red local (LAN) o Bluetooth. La configuración es una sola vez por estación y la impresión es automática después de cada venta confirmada.

Modelos compatibles

contable.io trabaja con cualquier impresora térmica que soporte el comando ESC/POS (estándar de la industria). Modelos probados:

Marca	Modelos
Epson	TM-T20, TM-T88, TM-m30
Bixolon	SRP-275, SRP-330
Star	TSP143, TSP100
Genéricas chinas (XPrinter, Rongta)	XP-58, XP-80, RP58, RP80

Si tu impresora no aparece en la lista pero soporta ESC/POS, debería funcionar. Pruébala en el modo “Impresora genérica de texto”.

Cómo funciona la impresión

El POS no se conecta directamente a la impresora desde el navegador (los navegadores no permiten USB libre por seguridad). En su lugar, usa el diálogo de impresión nativo del sistema operativo: cuando confirmas una venta, el sistema abre la pantalla de impresión y la impresora térmica aparece como una opción más.

Para que la impresión sea automática y silenciosa (sin diálogo), necesitas configurar la impresora térmica como predeterminada en tu sistema y habilitar la opción “imprimir sin preguntar” en el navegador.

Configurar la impresora en el sistema operativo

Windows

Conecta la impresora (USB o LAN) y enciéndela.
Ve a Configuración → Dispositivos → Impresoras y escáneres.
Toca Agregar impresora. Si no aparece automáticamente, usa La impresora que quiero no está en la lista y elige el driver del fabricante o “Generic / Text Only”.
Haz clic derecho sobre la impresora → Establecer como predeterminada.
Imprime una página de prueba desde Windows para confirmar.

macOS

Ve a Ajustes del Sistema → Impresoras y escáneres.
Toca el + y selecciona la impresora detectada.
macOS descarga el driver automáticamente.
Marca como predeterminada desde el menú desplegable.

Linux

Instala CUPS y agrega la impresora desde http://localhost:631. La mayoría de modelos térmicos son detectados automáticamente.

Configurar el ancho del papel en el POS

En el POS, ve al menú lateral → Configuración de impresión.
Selecciona el ancho del papel: 58 mm o 80 mm.
Elige la plantilla de tirilla (estándar, compacta, con logo).
Sube tu logo (recomendado 200×200 px en PNG con fondo transparente).
Toca Imprimir prueba para verificar.

Habilitar impresión automática (sin diálogo)

Por defecto, cada vez que confirmes una venta el navegador muestra el diálogo de impresión. Para que imprima directo sin preguntar:

Chrome / Edge (recomendado)

Lanza el navegador con esta flag (una sola vez, crea un acceso directo):

chrome.exe --kiosk-printing

En macOS:

open -a "Google Chrome" --args --kiosk-printing

Con --kiosk-printing activado, el navegador imprime directamente a la impresora predeterminada sin mostrar diálogo. Es la mejor forma de operar el POS en producción.

Firefox

No tiene equivalente directo a --kiosk-printing. Usa Chrome o Edge si necesitas impresión silenciosa.

Plantillas de tirilla

contable.io incluye tres plantillas predefinidas:

Plantilla	Contenido
Estándar	Logo + datos empresa + cliente + items + totales + CUDE/QR + pie de página
Compacta	Sin logo, fuente pequeña, optimizada para 58 mm
Con copia	Imprime dos copias seguidas (negocio + cliente)

Puedes editar el texto del encabezado y el pie de página desde Configuración de impresión → Editar plantilla. Soporta variables como {nombre_empresa}, {telefono}, {nit}.

Errores comunes

“No se encuentra la impresora”: verifica que está encendida, conectada y configurada como predeterminada en el sistema operativo.
“Imprime caracteres extraños / símbolos raros”: el driver no es compatible con UTF-8. Cambia al driver “Generic Text Only” o instala el driver oficial del fabricante.
“Imprime muy pequeño / muy grande”: revisa el ancho de papel configurado en el POS (58 vs 80 mm).
“No corta el papel automáticamente”: tu modelo no tiene cortador o el comando de corte no está habilitado en el driver.