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

¿Por qué solo Epson y Star en la web?

Los navegadores web no pueden abrir conexiones TCP sin procesar. 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 funcionan únicamente a través de la red.

Agregar una impresora

1

Abrir la configuración de impresora

Ir a Configuración > Impresora en el POS. Si aún no se ha configurado ninguna impresora, 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 texto que facilite distinguir las impresoras.

2

Elegir cómo se conecta la impresora

Este es el paso que cambia según la plataforma:

• Web app — pick the Vendor: Epson or Star. This is the first choice on the web, because browsers can only reach these two brands' built-in web servers.
• Desktop app — printers connect over the network; there's nothing extra to pick here.
• Mobile apps — pick a Connection Type: Network, Bluetooth, or USB (USB is Android only). The fields below change to match your choice.

3

Identificar la impresora

Impresoras de red — 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 "Detected: Epson" o "Detected: Star" una vez que la detección se complete. En la aplicación web, también se muestra la URL exacta del endpoint al que se conectará.

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 configura todo correctamente, es posible realizar ajustes en Configuración avanzada.

4

Guardar y probar

Hacer clic en Guardar. WCPOS envía primero una impresión de prueba y solo guarda la impresora si la prueba se completa 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 de 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 maneras. Seleccionar el Tipo de conexión en la parte superior del formulario de agregar impresora; los campos de conexión se actualizarán de acuerdo con la opción elegida.

Red

La impresora se encuentra en la misma red Wi-Fi que el dispositivo. Introducir su dirección IP — consultar 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. Pulsar Buscar impresoras y seleccionar la impresora 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 se conecta mediante un cable USB. Pulse Actualizar y selecciónela en 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 en general, por lo que esta opción solo aparece en Android.

nota

El ajuste Puerto solo se aplica a impresoras de red — permanece oculto en conexiones Bluetooth y USB.

Ajustes avanzados

Expanda Ajustes avanzados para ajustar con precisión la configuración de la impresora. La mayoría de estos campos se completan automáticamente una vez que se identifica el fabricante.

Ajuste	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 un ajuste avanzado. 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 en conexiones 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	58 mm (32 caracteres), 80 mm estándar (42 caracteres), 80 mm 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 80 mm admiten 42 caracteres por línea, aunque algunas admiten 48.
Ráster del recibo completo	Desactivado / Activado	Imprimir el recibo completo como imagen en lugar de texto — consulte Ráster del recibo completo a continuación.

Opciones de impresora

Estos interruptores se encuentran en la parte inferior del formulario Agregar impresora:

Opción	Descripción
Corte automático de papel	Cortar el papel automáticamente después de cada recibo
Apertura automática del cajón de efectivo	Enviar un comando de apertura a un cajón de efectivo conectado después de imprimir
Establecer como predeterminada	Establecer esta como la impresora predeterminada — se utiliza para cualquier recibo que no esté asignado a una impresora específica

¿Busca "impresión automática después del cobro"?

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. Qué impresora se utiliza se determina según la impresora predeterminada y cualquier asignación de impresora por plantilla.

Ráster del recibo completo

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 tiene fuente — muchos alfabetos no latinos, texto de derecha a izquierda, algunos símbolos — pueden aparecer como cuadros en blanco o caracteres ilegibles.

Rasterización completa del recibo soluciona esto. Cuando está activada, WCPOS renderiza todo el recibo como una imagen y envía esa imagen a la impresora, de modo que la impresión coincide exactamente con lo que aparece 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.
• Utilizar solo cuando sea necesario. Si los recibos se imprimen correctamente como texto, es preferible dejarlo desactivado.
• Se aplica a impresoras térmicas en cualquier tipo de conexión (red, Bluetooth, USB). No se aplica al cuadro de diálogo de impresión del sistema, que ya imprime a partir de una renderización a 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) — se debe seleccionar Buscar impresoras o Actualizar y elegir la impresora de la lista. El nombre y el fabricante se completan automáticamente.

Para impresoras de red en cualquier plataforma, se debe introducir 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

Como alternativa, es posible consultar la lista de dispositivos conectados del 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 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 (asignar una IP reservada a la dirección MAC de la impresora)

Impresoras Epson

Las impresoras Epson compatibles con 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) o 8043 (HTTPS)
• Endpoint: /cgi-bin/epos/service.cgi

Modelos confirmados en funcionamiento:

• Epson TM-T70-i 2 (red)
• Epson TM-m30iii (con middleware Printus)

consejo

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 mediante Bluetooth o USB a través del SDK nativo de Epson — no se requiere dirección IP ni servidor web ePOS.

Impresoras Star

Las impresoras Star compatibles con WebPRNT se comunican mediante 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 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 a través de Bluetooth o USB (estos 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:

1. Habilite Apertura automática del cajón de efectivo en las opciones de la impresora
2. El POS envía un comando de apertura ESC/POS después de la impresión

nota

El control del cajón de efectivo requiere un perfil de impresora térmica — el diálogo de impresión del navegador no puede activar cajones de efectivo.

Troubleshooting

Printer not detected during setup

• Confirm the printer is powered on and connected to the same network as your device
• For network printers: check the IP address is correct (print a self-test page)
• For the web app: confirm the printer is an Epson or Star model with ePOS/WebPRNT support
• For the desktop app: try the Generic vendor option with port 9100
• For Bluetooth: pair the printer in your device's Bluetooth settings first, then tap Scan for printers
• For USB (Android): check the cable and approve the USB permission prompt if one appears
• Check that no firewall is blocking the connection

Printer detected but nothing prints

• Check the paper roll — it may be empty or jammed
• Verify the Printer text width setting matches your paper (58mm or 80mm)
• Try printing a self-test from the printer itself to confirm it works
• Check the command language matches your printer (ESC/POS for Epson, StarPRNT or Star Line Mode for Star)

Receipt is garbled or has wrong characters

• 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 del 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 muestre correctamente

Cash drawer doesn't open

• Es necesario confirmar que 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

Cannot connect from the web app

• 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 móvil en su lugar
• Si el sitio utiliza HTTPS pero la impresora solo se comunica por HTTP, el navegador puede bloquear la conexión por tratarse de contenido mixto

Bluetooth printer won't connect (mobile)

• Es necesario emparejar la impresora en la configuración de Bluetooth del sistema del dispositivo antes de agregarla en WCPOS
• La impresión por Bluetooth solo es compatible con impresoras Epson y Star — las impresoras Bluetooth genéricas no son compatibles
• Si la impresora no aparece en la lista, se debe presionar Buscar impresoras nuevamente y verificar que esté encendida y dentro del alcance