Conectar tu impresora térmica

🚧
Documentación en construcción

Esta página se está redactando. Algunas capturas y secciones pueden faltar o estar incompletas.

Lava y Ya soporta tres modos de conexión para impresoras térmicas de tickets. El modo correcto depende de tu sistema operativo y del tipo de impresora que tengas.

Configuración → Impresora — elige el tipo de conexión según tu impresora

Resumen de modos de conexión

Ve a Configuración → Impresora y elige el modo que corresponde a tu caso:

Bluetooth — Para impresoras inalámbricas (BLE). Funciona en Android, Windows y Mac con Chrome o Edge. No requiere driver.

USB Directo (Mac / Linux) — Para impresoras USB conectadas directamente a una Mac o Linux. No requiere instalar ningún driver. Envía comandos ESC/POS directamente al dispositivo.

USB (Mac/Win) — "Guardar como Impresora Windows" — Usa el diálogo de impresión del navegador. Requiere que la impresora esté instalada como impresora en el sistema operativo con su driver.


USB Directo (Mac / Linux)

Este modo usa la API Web USB de Chrome para hablar directamente con la impresora, sin pasar por el sistema de impresión del sistema operativo.

¿Por qué no aparece ningún puerto?

El modo Puerto Serie busca puertos COM o Serial — canales de comunicación que el sistema operativo crea automáticamente cuando detecta un dispositivo compatible. En Windows esto aparece como COM3, COM4, etc. En Mac como /dev/cu.usbserial-XXXX.

La mayoría de impresoras térmicas USB no crean ese puerto en Mac. En lugar de presentarse como un dispositivo serial, se presentan como una "impresora USB" (clase USB 7). macOS las reconoce como dispositivo pero no les asigna un puerto serie, por lo que al hacer clic en "Buscar impresora Serial" no aparece nada.

ConsejoPuerto Serie vacío en Mac = señal de que la impresora es USB Printer Class. Usa USB Directo en su lugar — funciona sin driver y envía los mismos comandos ESC/POS que Bluetooth.
Si la lista de puertos está vacía, el botón USB Directo aparece justo debajo

USB Directo evita ese problema hablando con la impresora directamente a través de su conexión USB, sin depender de que el sistema operativo cree un puerto. El resultado es idéntico al modo Bluetooth: comandos ESC/POS nativos, impresión instantánea, sin diálogos.

Cómo configurarlo

Conecta la impresora por USB y enciéndela.

En Configuración → Impresora, selecciona la pestaña Puerto Serie.

Haz clic en "USB Directo (Mac / Linux)". Chrome mostrará un selector de dispositivos USB — elige tu impresora.

Haz clic en Guardar. A partir de ahora cada ticket se enviará directamente a la impresora sin diálogos adicionales.

NotaSolo funciona en Chrome o Edge. No está disponible en Safari ni Firefox.

USB (Mac/Win) — Impresora con driver del fabricante

Este modo usa el diálogo de impresión nativo del navegador (window.print). El navegador renderiza el ticket como una página HTML y lo envía al sistema de impresión del sistema operativo (CUPS en Mac, spooler en Windows). Tú eliges la impresora en el diálogo que aparece.

AdvertenciaSi ves caracteres extraños o código al imprimir, tu impresora está usando el driver "Generic PostScript". Descarga e instala el driver específico de tu modelo (Epson, Star, Xprinter, etc.) desde el sitio del fabricante, luego vuelve a intentarlo.

Cómo configurarlo

Conecta la impresora por USB e instala el driver del fabricante en tu equipo.

Verifica que funciona imprimiendo una página de prueba desde Configuración del sistema → Impresoras (Mac) o Dispositivos e impresoras (Windows).

En Configuración → Impresora, selecciona la pestaña USB (Mac/Win) y haz clic en "Guardar como Impresora Windows".

Al imprimir un ticket, se abrirá el diálogo del navegador — selecciona tu impresora térmica y ajusta el tamaño de papel a 80 mm o 58 mm según tu modelo.

Pestaña USB (Mac/Win) — requiere driver instalado previamente en el equipo

¿Cuál modo debo usar?

Mac con impresora USB → usa USB Directo. No necesitas driver, no hay diálogo de impresión, el ticket sale instantáneamente.

Windows con impresora USB → usa USB (Mac/Win) si ya tienes el driver instalado, o Puerto Serie si la impresora crea un puerto COM.

Impresora inalámbrica (Bluetooth) → usa el modo Bluetooth independientemente del sistema operativo.

ConsejoLa prueba más rápida: conecta la impresora y ve a Configuración → Impresora → Puerto Serie → "USB Directo (Mac/Linux)". Si tu impresora aparece en el selector de Chrome, ese es tu modo.