Configuración de impresora
La configuración de la 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.
Impresoras compatibles por plataforma
El formulario Agregar impresora se adapta a la aplicación en uso — cada plataforma muestra únicamente 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 por 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 solo funcionan 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 se han configurado impresoras, se mostrará un estado vacío con un botón Agregar impresora. Cada impresora recibe un Nombre de impresora — simplemente una etiqueta, completada automáticamente como "Impresora de recibos" (luego "Impresora de recibos 2", y así sucesivamente) — que se puede cambiar a cualquier nombre que ayude a distinguir entre las impresoras.
Elegir el método de conexión de la impresora
Este es el paso que varía según la plataforma:
- Aplicación web — elegir el Fabricante: Epson o Star. Es la primera opción en la web, porque los navegadores solo pueden acceder a los servidores web integrados de estas dos marcas.
- Aplicación de escritorio — las impresoras se conectan por la red; aquí no hay nada adicional que elegir.
- Aplicaciones móviles — elegir un Tipo de conexión: Red, Bluetooth o USB (USB solo está disponible en Android). Los campos siguientes cambian según la elección.
Identificar la impresora
Impresoras de red — introducir la Dirección IP (por ejemplo, 192.168.1.100). WCPOS analiza 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 la detección se complete. En la aplicación web, también se muestra la URL exacta del endpoint de conexión.
Impresoras Bluetooth o USB (móvil) — seleccionar la impresora de la lista de dispositivos detectados. Al seleccionar un dispositivo, se completan automáticamente su nombre y fabricante. 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 ajustar todos los valores en Configuración avanzada.
Guardar y probar
Haga clic en Guardar. WCPOS envía primero una impresión de prueba y solo guarda la impresora si tiene éxito.
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 de 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. Seleccione 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á emparejada con el 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 ofrece compatibilidad general con periféricos USB, por lo que esta opción solo aparece en Android.
La configuración de Puerto solo se aplica a impresoras de red — permanece oculta para 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 conoce el fabricante.
| Configuración | Opciones | Descripción |
|---|---|---|
| Fabricante | Epson, Star, Genérico | Fabricante de la impresora. En la aplicación web, Fabricante es la opción principal en la parte superior del formulario (solo Epson o Star) en lugar de una configuración avanzada. Genérico 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 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. |
| Ráster de recibo completo | Desactivado / Activado | Imprime el recibo completo como imagen en lugar de texto — consulte Ráster de recibo completo 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 para abrir un cajón de efectivo conectado después de imprimir |
| Establecer como predeterminada | Convierte esta en la impresora predeterminada, utilizada para cualquier recibo que no esté dirigido a una impresora específica |
La impresión automática de un recibo al completar una venta es una configuración del carrito, no una configuración de 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 enrutamiento de impresora por plantilla.
Enrutamiento de impresión
Si se utilizan varias plantillas —por ejemplo, un recibo térmico y una factura A4— el enrutamiento de impresión determina a qué impresora se envía cada plantilla. El enrutamiento tiene tres niveles, que se verifican en este orden:
- Anulación por trabajo. En la pantalla de recibo, un menú desplegable de impresora se encuentra junto al selector de plantillas. Al seleccionar una impresora aquí se anulan todas las demás configuraciones para ese trabajo de impresión. Al cambiar de plantilla, se restablece a Automático.
- Anulación en configuración. Vaya a Configuración → Enrutamiento de impresión para asignar una impresora específica a cada plantilla. Por ejemplo, se puede dirigir el recibo térmico a la impresora de red Epson y la factura HTML al diálogo de impresión del sistema. Establezca una plantilla de nuevo en Automático para eliminar la anulación.
- Asignación automática. Cuando no se ha establecido una asignación manual, WCPOS realiza la asignación de forma automática:
- Las plantillas térmicas se dirigen a impresoras térmicas cuyo ancho de caracteres coincide. Una plantilla térmica de 58mm prefiere impresoras de 32 columnas; una plantilla de 80mm prefiere impresoras de 42 o 48 columnas.
- Las plantillas HTML se dirigen 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 color ámbar en la pantalla del recibo. La impresión continúa, pero es posible que el resultado no se muestre correctamente.
Las asignaciones de enrutamiento se almacenan por dispositivo. Cada iPad, teléfono u ordenador gestiona su propia configuración de 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.
Rasterización completa 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. La limitación: las fuentes de las impresoras térmicas solo cubren un conjunto limitado de caracteres. Los sistemas de escritura para los que la impresora no dispone de fuente — muchos alfabetos no latinos, texto de derecha a izquierda, algunos símbolos — pueden aparecer como cuadros en blanco o caracteres ilegibles.
La rasterización completa del recibo soluciona este problema. Cuando está activada, 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.
- Se recomienda usar solo cuando sea necesario. Si los recibos se imprimen correctamente como texto, es mejor dejarlo 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 una representación de página completa.
Descubrimiento de impresoras
En las aplicaciones móviles, el formulario Agregar impresora muestra las impresoras cercanas para conexiones Bluetooth (iOS y Android) y USB (solo Android). Basta con pulsar Buscar impresoras o Actualizar y seleccionar la impresora de la lista. El nombre y el fabricante se completan automáticamente.
Para impresoras de red en cualquier plataforma, se introduce 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 requiere la introducción manual de la 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 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 reinicia. 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 como compatibles:
- Epson TM-T70-i 2 (red)
- Epson TM-m30iii (con middleware Printus)
Es necesario asegurarse de 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. Es necesario introducir la dirección IP y el puerto de la impresora (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 mediante Bluetooth o USB (para esos casos se requiere una impresora Epson o Star). La aplicación web no es compatible con impresoras genéricas.
Cajones de dinero
Los cajones de dinero conectados a una impresora de recibos pueden activarse automáticamente después de cada venta:
- Activar Apertura automática del cajón de dinero 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 compatibilidad ePOS/WebPRNT
- Para la aplicación de escritorio: probar la opción de fabricante Generic con el puerto 9100
- Para Bluetooth: emparejar la impresora en los ajustes de Bluetooth del dispositivo primero y luego pulsar Buscar impresoras
- Para USB (Android): verificar el cable y aprobar el mensaje de permiso USB si aparece
- Verificar que ningún firewall esté bloqueando la conexión
La impresora se detecta pero no imprime nada
- 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 (58 mm u 80 mm)
- Intentar imprimir una página de autodiagnóstico desde la propia 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 sale con caracteres incorrectos o ilegibles
- Es posible que la configuración del lenguaje de comandos sea incorrecta — se recomienda alternar entre ESC/POS, StarPRNT y Star Line Mode
- Es necesario verificar que la configuración de Ancho de texto de la impresora sea correcta
- Si el recibo está en un alfabeto no latino o en un idioma de escritura de derecha a izquierda, se debe activar Rasterización completa del recibo en Configuración avanzada — esto imprime el recibo como imagen para que cualquier idioma se represente correctamente
El cajón de dinero no se abre
- Es necesario confirmar que la opción Apertura automática del cajón de dinero esté habilitada en las opciones de la impresora
- Se debe 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 son compatibles con el comando de apertura del cajón — se recomienda consultar la documentación de la impresora
No es posible conectar desde la aplicación web
- La aplicación web solo puede conectarse a impresoras Epson y Star que cuenten con servidores web integrados
- Las impresoras genéricas y USB no son compatibles con la versión web — se debe utilizar la aplicación de escritorio o la aplicación móvil en su lugar
- Si el sitio utiliza HTTPS pero la impresora solo admite HTTP, el navegador puede bloquear la conexión por tratarse de contenido mixto
La impresora Bluetooth no se conecta (móvil)
- Es necesario emparejar la impresora en los ajustes de Bluetooth del sistema del dispositivo antes de añadirla en WCPOS
- La impresión por Bluetooth es compatible únicamente 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