Cómo configurar una impresora térmica en tu TPV — Guía completa 2026

La mayoría de los TPV cloud del mercado español no incluyen soporte real para impresoras térmicas. Los clientes acaban dependiendo de drivers del fabricante, middleware como QZ Tray (licencia de pago), PrintNode ($9/mes por impresora) o apps Android como RawBT. Configuraciones frágiles, puntos de fallo, costes recurrentes.

FactuTPV integra la impresión térmica de serie en todos los planes — incluido el gratuito. Es la única solución del mercado español que permite conectar cualquier impresora térmica ESC/POS sin excepción, sin comisiones por impresora, sin licencias de terceros.

La clave: el Agente FactuTPV, un pequeño programa que instalas una vez en el ordenador de tu local (Windows, Mac o Linux) y que actúa como puente universal entre el navegador y la impresora. USB, red, Bluetooth, Serie — cualquier tipo de conexión, cualquier marca, cualquier modelo.

Y lo mejor: con una sola instalación del agente, cualquier dispositivo del local puede imprimir en esa impresora. iPad, Android, Mac, PC, móvil — todos envían los tickets al agente del mismo ordenador y el agente se encarga del resto.

El Agente FactuTPV es el componente que diferencia a FactuTPV de cualquier otro TPV cloud del mercado. Es un pequeño binario (~12 MB) que se ejecuta como servicio en background en el ordenador del local y hace lo siguiente:

• Descubre impresoras automáticamente: escanea USB, red local (7 puertos ESC/POS típicos incluidos 9100, 4000, 8008, 80) y Bluetooth.
• Habla con la impresora usando su protocolo nativo, sea USB raw, TCP 9100, Epson ePOS-Print, Star WebPRNT, RFCOMM Bluetooth o Windows Spooler.
• Recibe trabajos de impresión desde dos caminos: el navegador local (fast-path) y el backend de FactuTPV (reverse-WS para impresión multi-dispositivo).
• Reintenta con retroceso exponencial si la impresora está ocupada, con cola persistente que sobrevive reinicios.
• Se auto-recupera si la impresora cambia de IP por DHCP (la busca por su MAC address en la red).

Está disponible para los tres sistemas operativos de escritorio:

Descárgalo desde github.com/ulisesbaena/factutpv-agent-releases. Tras la instalación se abre automáticamente http://localhost:17777/admin con un código de 6 dígitos que introduces en Ajustes → Impresoras → Agentes → Vincular nuevo agente en tu panel FactuTPV. El agente queda vinculado a tu cuenta y listo para usar.

FactuTPV ofrece tres vías de impresión, con el Agente como opción recomendada y dos alternativas directas-desde-navegador para escenarios específicos:

El Agente cubre el 100% de los escenarios reales de punto de venta. Las opciones directas desde navegador son útiles si quieres configurar rápido una única tablet y no tienes un PC en el local.

El proceso completo lleva menos de 5 minutos y no requiere conocimientos técnicos. Una sola vez por local:

1. Descarga el Agente para tu sistema operativo desde github.com/ulisesbaena/factutpv-agent-releases. El instalador pedirá permisos de administrador (para registrar el servicio) — acepta.
2. Tras la instalación, se abre automáticamente http://localhost:17777/admin en tu navegador con un código de 6 dígitos grande en pantalla.
3. En tu panel de FactuTPV, ve a Ajustes → Impresoras → Ver agentes → Vincular nuevo agente. Pega el código de 6 dígitos y escribe un nombre (ej. "PC cocina", "Mac oficina"). Pulsa Emparejar.
4. El agente queda listo y muestra Conectado con punto verde. Pasa al siguiente paso.
5. En Ajustes → Impresoras → Añadir impresora → tipo Agente, selecciona tu agente y pulsa Descubrir impresoras. El modal lista lo que ha encontrado (LAN, USB, Bluetooth).
6. Pulsa Usar en la impresora que quieras configurar. Se rellena el formulario automáticamente.
7. Ponle un nombre, ajusta el ancho de papel (80 mm estándar), activa corte automático si lo quieres, y marca Predeterminada si es tu impresora principal.
8. Guarda. Pulsa Probar — sale un ticket de prueba. Listo.

A partir de aquí, cualquier dispositivo de cualquier operador que abra FactuTPV en su navegador (misma cuenta/tenant) imprimirá en esa impresora sin tocar nada.

Muchas impresoras térmicas llegan pre-configuradas con una IP estática como 192.168.123.100 que no encaja con el rango de tu router (por ejemplo 192.168.0.x). Síntoma típico: la impresora imprime selftests pero el agente no la encuentra — el router la ve como Red UnKnown pero no puede enrutar tráfico a su subred.

La solución definitiva: activar DHCP en la impresora una vez. Después funcionará en cualquier red sin reconfigurar nada. Proceso aprendido en un caso real de soporte con una UNYKAch POS5:

1. Consigue un adaptador USB-C → Ethernet si tu ordenador no tiene puerto RJ-45 (funcionan los de ~10 €).
2. Desconecta el cable Ethernet de la impresora del router. Conecta ese cable directamente entre el adaptador USB-C del Mac/PC y la impresora. Punto a punto, sin router entre medio.
3. Desactiva el Wi-Fi temporalmente.
4. Configura IP manual en el Mac/PC: Ajustes del Sistema → Red → el adaptador Ethernet nuevo → Detalles → TCP/IP → Configurar IPv4 → Manualmente:
   • Dirección IP: 192.168.123.50 (una IP libre del rango de la impresora)
   • Máscara: 255.255.255.0
   • Router: déjalo vacío
5. Abre Terminal y comprueba: ping 192.168.123.100. Debe responder. Si no, revisa que el cable esté bien y los LEDs del puerto RJ-45 parpadeen.
6. Abre el navegador en http://192.168.123.100. Aparece la web UI de la impresora (la mayoría de Xprinter, HPRT, Unykach, HOIN la traen). Login típico: admin / admin o campos vacíos.
7. Ve a Configuration → Ethernet (o TCP/IP según el firmware). Busca DHCP Client o Obtain IP automatically → marca Enable. Save.
8. Apaga la impresora con el interruptor trasero. Espera 10 segundos. Enciéndela. Al arrancar imprime un selftest con la IP nueva (asignada por tu router) y DHCP: Enabled.
9. Desconecta el cable del Mac, conéctalo al router principal. Reactiva el Wi-Fi.
10. En FactuTPV → Descubrir impresoras → la impresora aparece con su IP nueva. Listo.

A partir de ahora, la impresora cogerá IP automáticamente en cualquier red donde la enchufes. Si cambias de local, la llevas y funciona sin reconfigurar. Y si el DHCP del router le da una IP distinta mañana, el Agente FactuTPV la encuentra por su MAC address automáticamente y sigue imprimiendo.

Este es el escenario que más valoran los clientes de FactuTPV con hostelería, retail con varios puntos de cobro o negocios con tablets repartidos por el local:

• Un solo PC con el Agente instalado, físicamente conectado a la impresora por USB o por red.
• Múltiples dispositivos (iPads, tablets Android, móviles de camareros, PC adicional en caja) que comparten la misma cuenta FactuTPV.
• Cualquiera de ellos abre FactuTPV en su navegador, hace una venta y el ticket sale impreso en esa misma impresora — sin instalar nada en los dispositivos.

Funciona así: el dispositivo hace la venta → el backend de FactuTPV enruta el trabajo de impresión al agente del local por una conexión WebSocket permanente → el agente dispara el ESC/POS por el transporte correspondiente. El operador del iPad solo ve "Imprimiendo..." y en un par de segundos tiene su ticket.

Este flujo no existe en ningún otro TPV cloud español. Competidores como Holded, Alegra, Glop o Hiopos o bien obligan a instalar algo en cada dispositivo, o bien venden hardware propietario, o directamente no soportan multi-dispositivo con una sola impresora.

Cada terminal de venta puede tener su propia impresora asignada — útil cuando tienes varios puntos de cobro con impresoras distintas, o cuando separas caja de cocina:

1. Para tickets de venta: Ajustes → Terminales TPV → editar terminal → desplegable Impresora de tickets.
2. Para comandas de cocina (hostelería): Ajustes → Hostelería → desplegable Impresora de cocina.

Si no asignas ninguna, el terminal usa la impresora predeterminada del negocio. Y si no hay predeterminada, usa el diálogo del navegador como último recurso.

La impresora de cocina imprime automáticamente cuando un pedido se manda a cocina: nombre de la mesa, zona, comensales, hora, platos agrupados por curso (primero, segundo, postre).

FactuTPV es compatible con cualquier impresora térmica ESC/POS del mercado. Algunos modelos que hemos validado en el piloto y tenemos tests de integración automatizados:

Si no ves tu modelo en la lista y cumple ESC/POS estándar, funciona. Al comprar, busca: compatible ESC/POS, puerto Ethernet (para uso profesional), ancho 80 mm, corte automático, conector de cajón portamonedas RJ-11 si lo necesitas.

El mercado español de TPV cloud en materia de impresión térmica es una colección de limitaciones. Compara con cabeza:

FactuTPV es el único TPV cloud español que ofrece agente propio gratuito con soporte universal (USB + red + Bluetooth + Serie) y cobertura multi-dispositivo a través de una sola instalación. Sin comisiones por impresora, sin licencias, sin hardware obligatorio.

Apple no permite que ningún navegador en iPad (ni Safari, ni Chrome, ni Firefox) acceda a dispositivos USB o Bluetooth directamente desde la web. Todos los navegadores en iOS usan WebKit por decisión de Apple.

La solución con FactuTPV: instala el Agente en el ordenador del local (Mac mini, PC Windows, NAS con Linux, lo que tengas). El iPad hace las ventas en el navegador y el backend enruta la impresión al agente del local. Ningún setup por iPad: se abre FactuTPV, se vende y sale el ticket.

Esto resuelve el problema clásico de "quiero iPads como puntos de venta pero imprimir tickets nativos" — sin hardware propietario, sin apps raras, sin Bonjour ni AirPrint (que impiden cajón portamonedas ni corte automático ESC/POS).