Impresora Térmica
Configurar impresora térmica ESC/POS para tickets en TPV El Haido
Configurar Impresora Térmica
Guía para configurar tu impresora térmica y poder imprimir tickets de venta.
Impresoras Compatibles
TPV El Haido soporta cualquier impresora compatible con el protocolo ESC/POS:
| Marca | Modelos Probados |
|---|---|
| Epson | TM-T20, TM-T88, TM-T82 |
| Star | TSP100, TSP650, mPOP |
| Bixolon | SRP-330, SRP-350 |
| Sewoo | LK-TL200, LK-TL320 |
| Genéricas | Impresoras USB/Serial 58mm, 80mm |
La mayoría de impresoras térmicas de TPV usan el estándar ESC/POS y son compatibles.
Conexión Física
USB (Recomendado)
Conectar la impresora
- Conecta el cable USB de la impresora a tu ordenador
- Enciende la impresora
- Espera a que el sistema operativo la detecte
Identificar el puerto
Windows:
- Abre "Administrador de dispositivos"
- Busca en "Puertos (COM y LPT)"
- Anota el número COM (ej: COM3)
macOS/Linux:
- Abre terminal
- Ejecuta:
ls /dev/tty.*(macOS) ols /dev/ttyUSB*(Linux) - Anota el dispositivo (ej:
/dev/ttyUSB0)
Red (Ethernet/WiFi)
Configurar IP en la impresora
- Consulta el manual de tu impresora
- Configura una IP estática (recomendado)
- Ejemplo:
192.168.1.100
Configurar en TPV
- En Ajustes → Impresora
- Selecciona tipo de conexión: Red
- Introduce la IP y puerto (normalmente 9100)
Bluetooth
Emparejar la impresora
- Pon la impresora en modo de emparejamiento
- En tu sistema, busca dispositivos Bluetooth
- Empareja la impresora
Configurar en TPV
- En Ajustes → Impresora
- Selecciona tipo de conexión: Bluetooth
- Selecciona la impresora de la lista
El soporte Bluetooth puede variar según el sistema operativo y modelo de impresora.
Configuración en TPV El Haido
Acceder a Ajustes
- En el menú lateral, haz clic en Ajustes
- Ve a la sección Impresora
Configurar conexión
| Campo | Descripción | Ejemplo |
|---|---|---|
| Tipo | USB, Red, Bluetooth | USB |
| Puerto/IP | Puerto COM o dirección IP | COM3, 192.168.1.100 |
| Puerto de red | Solo para conexión de red | 9100 |
Ancho de papel
| Ancho | Caracteres por línea | Uso común |
|---|---|---|
| 58mm | ~32 caracteres | Portátiles, pequeñas |
| 80mm | ~48 caracteres | Estándar de mostrador |
Probar conexión
Haz clic en Probar Impresora para imprimir un ticket de prueba.
Personalizar Tickets
Cabecera del Ticket
En Ajustes → Impresora → Ticket:
| Campo | Descripción |
|---|---|
| Nombre negocio | Se muestra en grande en la cabecera |
| Dirección | Línea 1 de la dirección |
| Localidad | Ciudad y código postal |
| CIF/NIF | Identificación fiscal |
| Teléfono | Número de contacto |
Logo
Para añadir un logo:
- Prepara la imagen en formato BMP monocromo
- Tamaño recomendado: 384px de ancho para 80mm, 256px para 58mm
- En Ajustes, haz clic en "Subir logo"
- Selecciona el archivo
Usa una imagen de alto contraste para mejor impresión térmica.
Pie del Ticket
Configura un mensaje personalizado al final del ticket:
- "¡Gracias por su visita!"
- "Síguenos en @tunegocio"
- Horario de apertura
Comandos Soportados
TPV El Haido usa el sidecar thermal-printer-cli que soporta:
| Comando | Función |
|---|---|
| text | Imprimir texto con formato |
| cut | Cortar papel (si la impresora lo soporta) |
| feed | Avanzar papel (saltos de línea) |
| cashdrawer | Abrir cajón portamonedas |
| barcode | Imprimir código de barras |
| qr | Imprimir código QR |
| image | Imprimir imagen/logo |
Apertura de Cajón
Configurar cajón
- Conecta el cajón al puerto RJ-11 de la impresora
- En Ajustes → Impresora, activa "Abrir cajón automáticamente"
Apertura automática
El cajón se abre automáticamente cuando:
- Se completa un pago en efectivo
- Configurable para todos los pagos o solo efectivo
Apertura manual
En la barra de herramientas o en Ajustes, botón Abrir Cajón.
Impresora de Cocina
Si tienes una segunda impresora para cocina:
Añadir impresora de cocina
- En Ajustes → Impresora → Impresoras adicionales
- Haz clic en Añadir impresora
- Configura como "Cocina"
- Introduce los datos de conexión
Asignar categorías
- Ve a Categorías
- Para cada categoría de comida, activa "Enviar a cocina"
- Los productos de esas categorías se imprimirán en la impresora de cocina
Solución de Problemas
La impresora no imprime
- Verifica que el puerto COM es correcto
- Comprueba en Administrador de dispositivos que no hay errores
- Reinstala el driver si es necesario
- Prueba con otro cable USB
- Verifica permisos:
sudo chmod 666 /dev/tty.* - Comprueba que la impresora aparece en
/dev/ - Reinicia la impresora
- Añade tu usuario al grupo dialout:
sudo usermod -a -G dialout $USER - Cierra sesión y vuelve a entrar
- Verifica permisos del dispositivo
Caracteres extraños
- Verifica que el ancho de papel es correcto (58mm vs 80mm)
- Comprueba la codificación (debería ser compatible con ESC/POS)
El cajón no abre
- Verifica que el cable RJ-11 está bien conectado
- Comprueba el voltaje del cajón (12V o 24V)
- Algunos cajones requieren configuración específica
Impresión lenta
- Usa conexión USB en lugar de red/Bluetooth
- Reduce el tamaño del logo
- Simplifica el diseño del ticket
Especificaciones Técnicas
Protocolo ESC/POS
El sistema envía comandos ESC/POS estándar:
ESC @ - Inicializar impresora
ESC a - Alineación
ESC ! - Estilo de texto
GS V - Cortar papel
ESC p - Abrir cajónPuerto de red
- Puerto estándar: 9100 (raw printing)
- Protocolo: TCP/IP directo