Configuración de impresora
La configuración de impresora se encuentra en el POS en Ajustes > Impresora. Cada dispositivo gestiona su propia configuración de impresora — las impresoras se almacenan localmente y no se sincronizan entre dispositivos.
Esta página cubre las impresoras conectadas al terminal por USB, Bluetooth o la red local. Para una impresora en otra sala o ubicación — o una que se desee compartir entre todos los dispositivos — consultar Impresión en la nube.
Impresoras compatibles por plataforma
El formulario Agregar impresora se adapta a la aplicación en uso — cada plataforma muestra solo las conexiones y opciones que puede utilizar.
| Plataforma | Impresoras compatibles | Conexiones |
|---|---|---|
| Aplicación web | Impresoras Epson y Star con servidor web integrado | Red (HTTP) |
| Aplicación de escritorio | Cualquier impresora de recibos en red | Red (TCP directo) |
| Aplicación iOS | Epson y Star | Red, Bluetooth |
| Aplicación Android | Epson y Star | Red, Bluetooth, USB |
Los navegadores web no pueden abrir conexiones TCP directas. Las impresoras de recibos Epson y Star incluyen un servidor web integrado que acepta trabajos de impresión a través de HTTP — esta es la única forma de enviar comandos ESC/POS desde un navegador. La aplicación de escritorio no tiene esta limitación porque puede conectarse directamente a través de TCP.
En las aplicaciones móviles, la impresión por Bluetooth y USB se realiza a través de los SDK oficiales de Epson y Star, por lo que esas conexiones también requieren una impresora Epson o Star. Las impresoras genéricas funcionan únicamente a través de la red.
Agregar una impresora
Abrir la configuración de impresora
Ir a Configuración > Impresora en el POS. Si aún no hay impresoras configuradas, se mostrará un estado vacío con un botón Agregar impresora. Cada impresora tiene un Nombre de impresora — solo una etiqueta, que se completa automáticamente como "Receipt Printer" (luego "Receipt Printer 2", y así sucesivamente) — que se puede cambiar a cualquier nombre que facilite distinguir las impresoras.
Elegir cómo se conecta la impresora
Este es el paso que varía según la plataforma:
- Aplicación web — seleccionar el Fabricante: Epson o Star. Esta es la primera opción en la web, ya que los navegadores solo pueden acceder a los servidores web integrados de estas dos marcas.
- Aplicación de escritorio — las impresoras se conectan a través de la red; no es necesario seleccionar nada adicional aquí.
- Aplicaciones móviles — seleccionar un Tipo de conexión: Red, Bluetooth, o USB (USB es solo para Android). Los campos a continuación cambian según la opción seleccionada.
Identificar la impresora
Impresoras de red — se debe introducir la Dirección IP (por ejemplo, 192.168.1.100). WCPOS sondea la dirección para detectar si se trata de un dispositivo Epson o Star, y completa automáticamente el puerto, el lenguaje de comandos y el fabricante. Se mostrará una etiqueta "Detectado: Epson" o "Detectado: Star" una vez que finalice la detección. En la aplicación web, también se muestra la URL exacta del endpoint al que se conectará.
Impresoras Bluetooth o USB (móvil) — se debe seleccionar la impresora de la lista de dispositivos descubiertos. Al seleccionar un dispositivo, se completan automáticamente el nombre y el fabricante. Se puede pulsar Buscar impresoras (Bluetooth) o Actualizar (USB) si la impresora aún no aparece en la lista.
Si la detección automática no identifica todo correctamente, es posible ajustarlo en Configuración avanzada.
Guardar y probar
Se debe hacer clic en Guardar. WCPOS envía primero una impresión de prueba y solo guarda la impresora si se realiza correctamente.
La impresión de prueba es un diagnóstico breve: una regla de columnas numeradas, texto centrado en tamaño normal y doble, una fila de alineación izquierda/derecha y un corte de papel. Está diseñada para confirmar que el ancho del papel, la alineación, el tamaño y el corte están configurados correctamente, no solo que la impresora es accesible.
Si la prueba falla, se mostrará el error junto con una opción Guardar sin probar para guardar el perfil de todos modos.
Tipos de conexión (aplicaciones móviles)
En las aplicaciones de iOS y Android, una impresora puede conectarse de tres formas. Se debe seleccionar el Tipo de conexión en la parte superior del formulario Agregar impresora, y los campos de conexión se actualizarán en consecuencia.
Red
La impresora está en la misma red Wi-Fi que el dispositivo. Introduzca su dirección IP — consulte Cómo encontrar la dirección IP de la impresora. Las impresoras de red pueden ser Epson, Star o genéricas.
Bluetooth
La impresora está vinculada al dispositivo a través de Bluetooth. Pulse Buscar impresoras y seleccione la suya de la lista — el nombre y el fabricante se completan automáticamente. La impresión por Bluetooth utiliza los SDK nativos de Epson y Star, por lo que la impresora debe ser un modelo Epson o Star.
USB (solo Android)
La impresora está conectada mediante un cable USB. Pulse Actualizar y selecciónela de la lista de dispositivos conectados. Al igual que con Bluetooth, la impresión por USB requiere una impresora Epson o Star. iOS no admite periféricos USB de uso general, por lo que esta opción solo aparece en Android.
La configuración de Puerto solo se aplica a las impresoras de red — está oculta para las conexiones Bluetooth y USB.
Configuración avanzada
Expanda Configuración avanzada para ajustar la configuración de la impresora. La mayoría de estos campos se completan automáticamente una vez que se identifica el fabricante.
| Configuración | Opciones | Descripción |
|---|---|---|
| Fabricante | Epson, Star, Genérico | Fabricante de la impresora. En la aplicación web, el fabricante es la opción principal en la parte superior del formulario (solo Epson o Star) en lugar de una configuración avanzada. La opción genérica está disponible para impresoras de red en las aplicaciones de escritorio y móvil, pero no para conexiones Bluetooth o USB. |
| Puerto | Autocompletado | Puerto de red de la impresora. Solo para conexión de red — oculto para Bluetooth y USB. |
| Lenguaje | ESC/POS, StarPRNT, Star Line Mode | El protocolo de comandos que utiliza la impresora. Se completa automáticamente a partir del fabricante detectado. |
| Ancho de texto de la impresora | 58mm (32 caracteres), 80mm estándar (42 caracteres), 80mm ancho (48 caracteres) | Cantidad de caracteres que caben en una línea. Se debe ajustar según el papel y la impresora — la mayoría de las impresoras de 80mm admiten 42 caracteres por línea, algunas admiten 48. |
| Recibo completo como imagen | Desactivado / Activado | Imprime el recibo completo como imagen en lugar de texto — consulte Recibo completo como imagen a continuación. |
Opciones de impresora
Estas opciones se encuentran en la parte inferior del formulario Agregar impresora:
| Opción | Descripción |
|---|---|
| Corte automático de papel | Corta el papel automáticamente después de cada recibo |
| Apertura automática del cajón de efectivo | Envía un comando de apertura al cajón de efectivo conectado después de imprimir |
| Establecer como predeterminada | Establece esta como la impresora predeterminada — se utiliza para cualquier recibo que no esté asignado a una impresora específica |
La impresión automática del recibo al completar una venta es una configuración del carrito, no de la impresora — active Impresión automática de recibo en la configuración del carrito del POS. La impresora que se utiliza depende de la impresora predeterminada y de cualquier asignación de impresora por plantilla.
Enrutamiento de impresión
Si se utiliza más de una plantilla — por ejemplo, un recibo térmico y una factura A4 — el enrutamiento de impresión decide a qué impresora se envía cada plantilla. El enrutamiento tiene tres capas, evaluadas en este orden:
- Sustitución por trabajo. En la pantalla de recibo, un menú desplegable de impresora se encuentra junto al selector de plantillas. Seleccionar una impresora aquí sustituye todo lo demás para ese trabajo de impresión. Cambiar de plantilla restablece la selección a Automático.
- Sustitución en ajustes. Ir a Ajustes → Enrutamiento de impresión para asignar una impresora específica a cada plantilla. Por ejemplo, enrutar el recibo térmico a la impresora de red Epson y la factura HTML al diálogo de impresión del sistema. Establecer una plantilla de nuevo en Automático para eliminar la sustitución.
- Coincidencia automática. Cuando no se establece ninguna sustitución, WCPOS realiza la coincidencia automáticamente:
- Las plantillas térmicas se enrutan a impresoras térmicas cuyo ancho de caracteres coincida. Una plantilla térmica de 58 mm prefiere impresoras de 32 columnas; una plantilla de 80 mm prefiere impresoras de 42 o 48 columnas.
- Las plantillas HTML se enrutan al diálogo de impresión del sistema.
- Si varias impresoras coinciden, la impresora predeterminada tiene prioridad.
Si se envía manualmente una plantilla a una impresora incompatible — por ejemplo, una plantilla térmica al diálogo del sistema — aparece una advertencia de incompatibilidad en ámbar en la pantalla de recibo. La impresión se ejecuta de todos modos, pero la salida puede no renderizarse correctamente.
Las sustituciones de enrutamiento se almacenan por dispositivo. Cada iPad, teléfono u ordenador gestiona su propio enrutamiento — no existe sincronización del lado del servidor.
La página de configuración de enrutamiento de impresión solo aparece una vez que se ha añadido al menos una impresora. Sin impresoras configuradas, todas las plantillas utilizan el diálogo de impresión del sistema de forma implícita.
Rasterizado completo del recibo
De forma predeterminada, WCPOS envía los recibos a las impresoras térmicas como texto — rápido, compacto y nítido, utilizando las fuentes integradas de la impresora. El inconveniente: las fuentes de las impresoras térmicas solo cubren un conjunto limitado de caracteres. Los scripts para los que la impresora no tiene fuente — muchos alfabetos no latinos, texto de derecha a izquierda, algunos símbolos — pueden aparecer como cuadros vacíos o caracteres ilegibles.
El rasterizado completo del recibo soluciona esto. Cuando está activado, WCPOS renderiza el recibo completo como una imagen y envía esa imagen a la impresora, de modo que la impresión coincide exactamente con lo que se muestra en pantalla — en cualquier idioma o sistema de escritura.
Se activa por impresora en Configuración avanzada. Aspectos a tener en cuenta:
- Es más lento. Una imagen es mucho más grande que una línea de texto, por lo que el recibo tarda más en enviarse e imprimirse.
- Utilícelo solo cuando sea necesario. Si los recibos se imprimen correctamente como texto, déjelo desactivado.
- Se aplica a impresoras térmicas en cualquier conexión (red, Bluetooth, USB). No se aplica al diálogo de impresión del sistema, que ya imprime a partir de un renderizado de página completa.
Descubrimiento de impresoras
En las aplicaciones móviles, el formulario de añadir impresora muestra las impresoras cercanas para conexiones Bluetooth (iOS y Android) y USB (solo Android) — pulse Buscar impresoras o Actualizar y seleccione la suya de la lista. El nombre y el fabricante se completan automáticamente.
Para impresoras de red en cualquier plataforma, introduzca la dirección IP directamente — consulte Cómo encontrar la dirección IP de la impresora a continuación. La aplicación web no dispone de descubrimiento de red (los navegadores no pueden escanear redes), por lo que siempre utiliza la entrada manual de IP.
Cómo encontrar la dirección IP de la impresora
La mayoría de las impresoras de recibos pueden imprimir una página de autodiagnóstico que incluye la dirección IP:
- Epson: Mantener presionado el botón de avance mientras se enciende la impresora
- Star: Mantener presionado el botón de avance durante 5 segundos con la impresora encendida
Alternativamente, es posible consultar la lista de dispositivos conectados en el router o la utilidad de configuración de la impresora.
Se recomienda una IP estática
Las impresoras de recibos deben utilizar una dirección IP estática para evitar que la dirección cambie cuando la impresora se reinicie. Esto se puede configurar de dos formas:
- En la interfaz web integrada de la impresora (generalmente accesible en
http://<printer-ip>) - En la configuración DHCP del router (asignando una IP reservada a la dirección MAC de la impresora)
Impresoras Epson
Las impresoras Epson con soporte ePOS se comunican a través de HTTP. WCPOS envía solicitudes SOAP/XML al servidor web integrado de la impresora.
Detalles de conexión:
- Puerto
8008(HTTP) o8043(HTTPS) - Endpoint:
/cgi-bin/epos/service.cgi
Modelos confirmados en funcionamiento:
- Epson TM-T70-i 2 (red)
- Epson TM-m30iii (con middleware Printus)
Es necesario que la impresora Epson tenga ePOS habilitado en su configuración. Se puede acceder a la interfaz web de la impresora en http://<printer-ip> para verificar y habilitar la configuración de ePOS.
En las aplicaciones móviles, las impresoras Epson también pueden conectarse a través de Bluetooth o USB mediante el SDK nativo de Epson, sin necesidad de dirección IP ni servidor web ePOS.
Impresoras Star
Las impresoras Star con soporte WebPRNT se comunican a través de HTTP. WCPOS envía comandos al endpoint WebPRNT de Star.
Detalles de conexión:
- HTTPS o HTTP
- Endpoint:
/StarWebPRNT/SendMessage
En las aplicaciones móviles, las impresoras Star también pueden conectarse a través de Bluetooth o USB mediante el SDK nativo de Star.
Impresoras genéricas
La aplicación de escritorio es compatible con cualquier impresora de recibos en red mediante TCP sin procesar. Introduzca la dirección IP de la impresora y el puerto (normalmente 9100). Esto funciona con la mayoría de las impresoras térmicas independientemente del fabricante, siempre que acepten comandos ESC/POS.
En las aplicaciones móviles, las impresoras genéricas también son compatibles, pero solo para conexiones de red, no a través de Bluetooth o USB (esos requieren una impresora Epson o Star). La aplicación web no es compatible con impresoras genéricas.
Cajones de efectivo
Los cajones de efectivo conectados a una impresora de recibos pueden activarse automáticamente después de cada venta:
- Habilite Apertura automática del cajón de efectivo en las opciones de la impresora
- El POS envía un comando de apertura ESC/POS después de imprimir
El control del cajón de dinero requiere un perfil de impresora térmica — el diálogo de impresión del navegador no puede activar cajones de dinero.
Solución de problemas
La impresora no se detecta durante la configuración
- Confirmar que la impresora está encendida y conectada a la misma red que el dispositivo
- Para impresoras de red: verificar que la dirección IP sea correcta (imprimir una página de autodiagnóstico)
- Para la aplicación web: confirmar que la impresora es un modelo Epson o Star con soporte ePOS/WebPRNT
- Para la aplicación de escritorio: probar la opción de fabricante Genérico con el puerto 9100
- Para Bluetooth: emparejar primero la impresora en los ajustes de Bluetooth del dispositivo y luego tocar Buscar impresoras
- Para USB (Android): verificar el cable y aprobar el aviso de permiso USB si aparece
- Verificar que ningún firewall esté bloqueando la conexión
Impresora detectada pero no imprime
- Verificar el rollo de papel — puede estar vacío o atascado
- Verificar que el ajuste Ancho de texto de la impresora coincida con el papel (58mm o 80mm)
- Intentar imprimir una prueba automática desde la impresora para confirmar que funciona
- Verificar que el lenguaje de comandos coincida con la impresora (ESC/POS para Epson, StarPRNT o Star Line Mode para Star)
El recibo aparece ilegible o con caracteres incorrectos
- El ajuste de lenguaje de comandos puede ser incorrecto — intentar cambiar entre ESC/POS, StarPRNT y Star Line Mode
- Asegurarse de que el ajuste Ancho de texto de la impresora sea correcto
- Si el recibo está en un alfabeto no latino o en un idioma de derecha a izquierda, activar Rasterización completa del recibo en Ajustes avanzados — imprime el recibo como imagen para que cualquier idioma se muestre correctamente
El cajón de efectivo no se abre
- Confirmar que Apertura automática del cajón de efectivo esté habilitada en las opciones de la impresora
- Verificar que el cajón esté conectado al puerto DK de la impresora (no a una fuente de alimentación independiente)
- No todas las impresoras admiten el comando de apertura de cajón — consulte la documentación de su impresora
No es posible conectar desde la aplicación web
- La aplicación web solo puede conectarse a impresoras Epson y Star con servidores web integrados
- Las impresoras genéricas y USB no son compatibles con la versión web — utilice la aplicación de escritorio o móvil en su lugar
- Si su sitio utiliza HTTPS pero la impresora solo admite HTTP, el navegador puede bloquear la conexión por contenido mixto
La impresora Bluetooth no se conecta (móvil)
- Empareje la impresora en los ajustes de Bluetooth del sistema de su dispositivo antes de agregarla en WCPOS
- La impresión por Bluetooth es compatible solo con impresoras Epson y Star — las impresoras Bluetooth genéricas no son compatibles
- Si la impresora no aparece en la lista, pulse Buscar impresoras de nuevo y asegúrese de que esté encendida y dentro del alcance