Configuración de impresora
La configuración de impresora se encuentra en POS > Ajustes > Impresión. 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 a la caja por USB, Bluetooth o la red local. Para una impresora en otra sala o ubicación — o una que se desee compartir con todos los dispositivos — consultar Impresión en la nube. Las impresoras en la nube configuradas para la tienda aparecen automáticamente en la lista de impresoras de cada dispositivo — no es necesario agregarlas aquí.
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 realmente puede utilizar.
| Plataforma | Impresoras compatibles | Conexiones |
|---|---|---|
| Aplicación web | Impresoras Epson y Star con servidor web integrado (red); impresoras Epson y Star vía WebUSB/Web Bluetooth (USB/Bluetooth, solo Chrome/Edge) | Red (HTTP), USB, Bluetooth |
| Aplicación de escritorio | Cualquier impresora de recibos en red | Red (raw TCP), USB, Bluetooth |
| App iOS | Epson y Star | Red, Bluetooth |
| App 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 a una impresora de red desde un navegador. La aplicación de escritorio no tiene esta limitación porque puede conectarse directamente a través de TCP.
La impresión por USB y Bluetooth en el navegador también funciona, pero solo en Chrome o Microsoft Edge (utilizan las API WebUSB y Web Bluetooth) — Safari y Firefox no las admiten.
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 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 POS > Ajustes > Impresión. Si aún no se han configurado impresoras, se mostrará un estado vacío con un botón Agregar impresora. Cada impresora tiene un Nombre de impresora — solo una etiqueta, completada 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
Todas las plataformas comienzan con la misma pregunta — Tipo de conexión — y muestran solo las opciones que esa plataforma admite. Los campos siguientes se actualizan según la selección realizada.
- Aplicación web — Red, USB o Bluetooth (USB y Bluetooth requieren Chrome o Edge). Para una impresora de Red, se selecciona el Fabricante — Epson o Star — porque el navegador se comunica con una impresora de red a través del servidor web integrado de esa marca.
- Aplicación de escritorio — Red, USB o Bluetooth.
- Aplicaciones móviles — Red o Bluetooth, además de USB en Android (iOS no es compatible con USB).
Identificar la impresora
Impresoras de red — se introduce 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. Una vez finalizada la detección, aparecerá una etiqueta "Detectado: Epson" o "Detectado: Star". 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 selecciona la impresora de la lista de dispositivos detectados. Al seleccionar un dispositivo, se completan automáticamente su nombre y fabricante. Pulse Buscar impresoras (Bluetooth) o Actualizar (USB) si la impresora aún no aparece en la lista.
Si la detección automática no obtiene todos los datos correctamente, es posible ajustarlos 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 esta 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 con 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 la opción Guardar sin probar para guardar el perfil de todos modos.
Tipos de conexión
Se comienza seleccionando el Tipo de conexión en la parte superior del formulario Agregar impresora, y los campos de conexión se actualizan de acuerdo con la selección. Los tipos disponibles dependen de la plataforma (consultar la tabla anterior).
Red
La impresora se encuentra en la misma red Wi-Fi que el dispositivo. En las aplicaciones de escritorio y móvil, se puede pulsar Escanear red para descubrir impresoras automáticamente, o introducir la dirección IP manualmente — consultar Cómo encontrar la dirección IP de la impresora. La aplicación web solo permite la entrada manual de IP. En las aplicaciones de escritorio y móvil, una impresora de red puede ser Epson, Star o genérica; en la web debe ser Epson o Star, y se selecciona cuál dentro de la conexión de red.
Bluetooth
La impresora está emparejada con el dispositivo a través de Bluetooth. Se selecciona de la lista — el nombre y el fabricante se completan automáticamente. En móvil, 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; en la web, Bluetooth funciona en Chrome o Edge a través de la API Web Bluetooth.
USB
La impresora está conectada mediante un cable USB. Se selecciona de la lista de dispositivos conectados. USB está disponible en la web (Chrome o Edge, a través de WebUSB), la aplicación de escritorio y Android — pero no en iOS, que no tiene soporte general para periféricos USB. En móvil, la impresión por USB requiere una impresora Epson o Star.
La configuración de Puerto solo se aplica a 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.
Estas configuraciones se aplican en todas las plataformas:
| Configuración | Opciones | Descripción |
|---|---|---|
| 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. Este valor debe coincidir con 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 todo el recibo como una imagen en lugar de texto — consulte Recibo completo como imagen a continuación. |
Estas dos configuraciones se comportan de manera diferente según la plataforma y el tipo de conexión:
| Configuración | Opciones | Dónde se aplica |
|---|---|---|
| Fabricante | Epson, Star, Genérico | Fabricante de la impresora. En la aplicación web se selecciona el fabricante directamente en la conexión de Red (solo Epson o Star), no como configuración avanzada. Genérico está disponible para impresoras de red en las aplicaciones de escritorio y móviles, pero no para conexiones Bluetooth o USB. |
| Puerto | Completado automáticamente | Puerto de red de la impresora, que se muestra junto a la dirección IP. Solo para red — oculto para Bluetooth y USB. Se completa automáticamente en función del fabricante (y, en la web, de si el POS se sirve a través de HTTP o HTTPS); modifíquelo solo si la red lo reasigna. |
Opciones de impresora
Estas opciones se encuentran en la parte inferior del formulario Añadir 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 | Convierte esta en la impresora predeterminada — se utiliza para cualquier recibo que no esté asignado 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 los ajustes del carrito del POS. Qué impresora se utiliza depende de la impresora predeterminada y de cualquier enrutamiento 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 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 plantilla. 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 ajustes. Vaya a POS > Ajustes > 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 Epson de red y la factura HTML al diálogo de impresión del sistema. Para eliminar la anulación, establezca la plantilla de nuevo en Automático.
- Coincidencia automática. Cuando no se establece ninguna anulació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 58mm prefiere impresoras de 32 columnas; una plantilla de 80mm 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 color ámbar en la pantalla del recibo. La impresión continúa, pero es posible que el resultado no se visualice correctamente.
Las anulaciones 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 implícitamente el diálogo de impresión del sistema. Las impresoras en la nube configuradas para la tienda también cuentan aquí — aparecen como destinos de enrutamiento automáticamente, sin necesidad de añadirlas en el dispositivo.
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. El inconveniente: las fuentes de las impresoras térmicas solo cubren un conjunto limitado de caracteres. Los sistemas de escritura para los que la impresora no tiene 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 tipo de 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
La forma de encontrar una impresora depende del tipo de conexión:
- Bluetooth y USB — en las aplicaciones móviles, se debe pulsar Buscar impresoras (Bluetooth) o Actualizar (USB) y seleccionar la impresora de la lista; el nombre y el fabricante se completan automáticamente. En la web (Chrome o Edge), se debe hacer clic en Conectar y elegir la impresora en el selector de dispositivos del navegador.
- Red — en las aplicaciones de escritorio y móvil, se debe pulsar Escanear red para encontrar impresoras en la red local de forma automática (la aplicación de escritorio las descubre mediante mDNS/Bonjour; la móvil utiliza los SDK de Epson y Star), y luego seleccionar la impresora de la lista. También es posible introducir la dirección IP directamente — consulte Cómo encontrar la dirección IP de la impresora más abajo. Los navegadores no pueden escanear redes, por lo que la aplicación web 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 de papel mientras se enciende la impresora
- Star: Mantener presionado el botón de avance de papel durante 5 segundos con la impresora encendida
Alternativamente, consulte la lista de dispositivos conectados de su router o la utilidad de configuración de su impresora.
Se recomienda IP estática
Las impresoras de recibos deben usar 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) — se completa automáticamente según si el POS se sirve a través de HTTP o 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 por Bluetooth o USB a través del 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:
- Puerto
80(HTTP) o443(HTTPS) — se completa automáticamente según si el POS se sirve a través de HTTP o HTTPS - Endpoint:
/StarWebPRNT/SendMessage
En las aplicaciones móviles, las impresoras Star también pueden conectarse por Bluetooth o USB a través del 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. Se debe introducir la dirección IP de la impresora y el puerto (generalmente 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 por Bluetooth ni USB (para esos tipos de conexión 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:
- Habilitar 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: en la aplicación de escritorio o móvil, se puede utilizar Escanear red para encontrarla automáticamente; de lo contrario, verificar que la dirección IP sea correcta (imprimir una página de autotest)
- 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 proveedor Genérico con el puerto 9100
- Para Bluetooth: emparejar la impresora primero en la configuración de Bluetooth del dispositivo y luego pulsar 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
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 utilizado (58mm o 80mm)
- Intentar imprimir un autotest desde la propia impresora para confirmar que funciona correctamente
- 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 — probar alternando entre ESC/POS, StarPRNT y Star Line Mode
- Asegurarse de que la configuración de Ancho de texto de impresora sea correcta
- Si el recibo está en un alfabeto no latino o en un idioma de escritura de derecha a izquierda, activar Rasterizado completo del recibo en Configuración avanzada — esto imprime el recibo como una imagen para que cualquier idioma se muestre correctamente
El cajón de dinero no se abre
- Confirmar que Apertura automática del cajón de dinero 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 del cajón — consultar la documentación de la impresora
No es posible conectar desde la aplicación web
- A través de la red, la aplicación web solo puede comunicarse con impresoras Epson y Star (mediante sus servidores web integrados) — las impresoras genéricas de red raw no son compatibles en un navegador; utilizar la aplicación de escritorio o móvil, o una impresora en la nube
- Las impresoras USB y Bluetooth sí funcionan en la web, pero solo en Chrome o Microsoft Edge (Safari y Firefox no son compatibles con las API WebUSB / Web Bluetooth)
- Si el sitio utiliza HTTPS pero la impresora solo admite HTTP, el navegador puede bloquear la conexión como contenido mixto — la impresora debe utilizar el mismo protocolo HTTP/HTTPS que el POS
La impresora Bluetooth no se conecta (móvil)
- Es necesario emparejar la impresora en los ajustes de Bluetooth del dispositivo antes de agregarla 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, se debe pulsar Buscar impresoras de nuevo y asegurarse de que esté encendida y dentro del alcance