# 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. ¿Imprimir en una impresora que no está en este dispositivo? 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](/es/receipts/cloud-printing.md). 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[​](#supported-printers-by-platform "Enlace directo a 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 | ¿Por qué solo Epson y Star por red en la web? 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[​](#adding-a-printer "Enlace directo a Agregar una impresora") 1 #### 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. 2 #### 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). 3 #### 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**. 4 #### 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. ¿La prueba falla? Aún es posible guardar 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[​](#connection-types-mobile-apps "Enlace directo a 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[​](#network "Enlace directo a 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](#finding-your-printers-ip-address). 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[​](#bluetooth "Enlace directo a 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[​](#usb-android-only "Enlace directo a 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**. nota La configuración de **Puerto** solo se aplica a impresoras de red — está oculta para las conexiones Bluetooth y USB. ## Configuración avanzada[​](#advanced-settings "Enlace directo a 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](#full-receipt-raster) 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[​](#printer-options "Enlace directo a 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 | ¿Busca la opción de "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 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[​](#print-routing "Enlace directo a 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: 1. **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**. 2. **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**. 3. **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. nota 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[​](#full-receipt-raster "Enlace directo a 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[​](#discovering-printers "Enlace directo a 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](#finding-your-printers-ip-address) 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[​](#finding-your-printers-ip-address "Enlace directo a 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[​](#static-ip-recommended "Enlace directo a 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://`) * En la configuración DHCP del router (asignando una IP reservada a la dirección MAC de la impresora) ## Impresoras Epson[​](#epson-printers "Enlace directo a 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) o `8043` (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) 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://` 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[​](#star-printers "Enlace directo a 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) o `443` (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[​](#generic-printers "Enlace directo a 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[​](#cash-drawers "Enlace directo a Cajones de dinero") Los cajones de dinero conectados a una impresora de recibos pueden activarse automáticamente después de cada venta: 1. Habilitar **Apertura automática del cajón de dinero** en las opciones de la impresora 2. El POS envía un comando de apertura ESC/POS después de imprimir nota 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[​](#troubleshooting "Enlace directo a 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](/es/receipts/cloud-printing.md) * 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