# Impresión en la Nube La impresión en la nube permite a WCPOS enviar recibos a una impresora que no está conectada directamente al dispositivo que ejecuta la caja. Configúrala una vez en WP Admin y tus pedidos se imprimirán en una impresora de cocina, una impresora de oficina interna o una impresora en otra sala, sin que cada dispositivo tenga que descubrir y emparejarse con el hardware por sí mismo. ## ¿Qué es la impresión en la nube?[​](#what-is-cloud-printing "Enlace directo a ¿Qué es la impresión en la nube?") Con la **impresión local**, el dispositivo que ejecuta el POS se comunica directamente con la impresora a través de USB, Bluetooth o la red local. Esa es la opción correcta cuando la impresora está junto a la caja — consulta [Configuración de Impresoras](/es/hardware/printers.md) para conectar impresoras USB, Bluetooth y de red en el mismo dispositivo. La **impresión en la nube** es para todo lo demás: una impresora en una ubicación diferente, en una red diferente, o una que quieras que todos los dispositivos compartan sin configurarla en cada uno. Hay dos modelos de entrega: * **Impresoras por sondeo (polling).** La impresora se conecta a WCPOS por internet según una programación, pregunta "¿tienes algo para mí?" y descarga cualquier trabajo en espera. WCPOS nunca se conecta a la impresora — la impresora siempre inicia la conversación. Así es como funcionan **Star CloudPRNT** y **Epson Server Direct Print**. * **Proveedores de retransmisión alojados.** WCPOS envía el trabajo de impresión a un servicio alojado, y ese servicio lo entrega a la impresora. Así es como funcionan **Star Online** y **PrintNode**. Star Online entrega a las impresoras Star CloudPRNT registradas en tu cuenta de stario.online; PrintNode entrega a través de su cliente de escritorio a casi cualquier impresora a la que ese equipo ya pueda imprimir. ¿Por qué una impresora que sondea? Una impresora por sondeo no necesita un puerto abierto, una IP estática ni ningún cambio en el firewall — solo realiza solicitudes salientes. Eso la hace ideal para una impresora en un sitio remoto o detrás de un router que no controlas. La contrapartida es un breve retraso: la impresora solo imprime cuando llega su siguiente sondeo. ## Elegir un proveedor[​](#providers "Enlace directo a Elegir un proveedor") Elige el proveedor que coincida con tu hardware. #### Star CloudPRNT Para impresoras térmicas Star que ejecutan el firmware **CloudPRNT**. La impresora sondea a WCPOS y descarga los trabajos. Los recibos se renderizan a los comandos nativos de la impresora. Necesita una plantilla térmica. #### Star Online Para impresoras Star registradas en una cuenta de **stario.online**. WCPOS envía Star Document Markup al servicio alojado de Star, y la impresora lo recoge de Star Online. Necesita una plantilla térmica. #### Epson Server Direct Print Para impresoras Epson ePOS que admiten **Server Direct Print**. La impresora sondea a WCPOS y descarga los trabajos como ePOS-Print XML. Necesita una plantilla térmica. #### PrintNode Funciona con prácticamente cualquier impresora a la que tu equipo pueda imprimir, en cualquier sistema operativo, a través del **cliente de escritorio PrintNode**. WCPOS envía un PDF, por lo que puedes usar cualquier plantilla, incluidas facturas HTML de página completa. | Proveedor | Hardware | Cómo fluyen los trabajos | Plantillas | | ----------------------------- | ---------------------------------------------------------------------- | ---------------------------------------------- | ------------------- | | **Star CloudPRNT** | Impresora térmica Star con firmware CloudPRNT | La impresora sondea a WCPOS | Solo térmica | | **Star Online** | Impresora Star registrada en stario.online | WCPOS envía Star Document Markup a Star Online | Solo térmica | | **Epson Server Direct Print** | Impresora Epson ePOS con Server Direct Print | La impresora sondea a WCPOS | Solo térmica | | **PrintNode** | Cualquier impresora conectada al sistema operativo + cliente PrintNode | WCPOS envía un PDF a PrintNode | Cualquier plantilla | ## Configurar una impresora en la nube[​](#setup "Enlace directo a Configurar una impresora en la nube") Las impresoras en la nube se configuran una vez en WP Admin y se comparten entre todos los dispositivos, a diferencia de las impresoras locales, que se almacenan por dispositivo. Ve a **WP Admin > POS > Settings > Cloud Print** y haz clic en **Add printer**. Dale un **nombre** (por ejemplo, "Cocina" u "Oficina interna"). WCPOS deriva automáticamente un **ID de impresora** estable a partir de la impresora — nunca cambia, por lo que es seguro referenciarlo desde la configuración del firmware de una impresora. Una vez que la impresora existe, configura el extremo del proveedor. ### Star o Epson (impresoras por sondeo)[​](#setup-polling "Enlace directo a Star o Epson (impresoras por sondeo)") 1 #### Agrega la impresora en WCPOS En **WP Admin > POS > Settings > Cloud Print**, agrega una impresora y elige **Star CloudPRNT** o **Epson Server Direct Print** como proveedor. WCPOS genera una **URL de sondeo** y un **token de un solo uso** para esa impresora. 2 #### Copia la URL de sondeo y el token Copia la URL de sondeo y el token generados. El **token se muestra solo una vez** — si lo pierdes, genera uno nuevo desde la tarjeta de la impresora y actualiza la impresora con el nuevo valor. 3 #### Ingrésalos en la configuración de la impresora Abre la página de configuración de la impresora — los ajustes de **CloudPRNT** para Star, o los ajustes de **Server Direct Print** para Epson — y pega la URL de sondeo y el token. Establece el intervalo de sondeo si la impresora lo solicita (unos pocos segundos es lo habitual). Guarda y reinicia la impresora si es necesario. Dentro de un ciclo de sondeo la impresora se registra, y su estado en WCPOS cambia de **En espera** a **Conectada**. ### PrintNode[​](#setup-printnode "Enlace directo a PrintNode") 1 #### Instala el cliente de escritorio PrintNode En un equipo que ya pueda imprimir en tu impresora de destino, instala el **cliente PrintNode** e inicia sesión. El cliente debe permanecer en ejecución y en línea para que los trabajos se impriman. 2 #### Obtén una clave API de PrintNode En tu cuenta de PrintNode, crea una **clave API**. Esto es lo que permite a WCPOS enviar trabajos a tu cuenta de PrintNode. 3 #### Ingresa la clave API en WCPOS Agrega una impresora en **WP Admin > POS > Settings > Cloud Print**, elige **PrintNode** como proveedor y pega la clave API. WCPOS la utiliza para obtener la lista de impresoras registradas en tu cuenta de PrintNode. 4 #### Selecciona la impresora Elige la impresora de destino de la lista de impresoras reportadas por el cliente de PrintNode y luego guarda. WCPOS enviará los trabajos de esta impresora a PrintNode, y el cliente los imprimirá. ### Star Online[​](#setup-star-online "Enlace directo a Star Online") Usa Star Online cuando tu impresora Star ya esté registrada en una cuenta de **stario.online** y quieras que el servicio alojado de Star se encargue de la entrega. 1 #### Obtén la URL de CloudPRNT En stario.online, abre **Device Groups** y copia la **URL de CloudPRNT** del grupo. Debería verse como `https://device.stario.online/cloudprnt/...` o `https://eu-device.stario.online/cloudprnt/...`. 2 #### Crea una clave API con permisos En stario.online, crea una clave API para WCPOS. La clave debe tener permiso para listar dispositivos e imprimir en ellos. Como mínimo, habilita: * **EnumDevices** — necesario cuando WCPOS obtiene la lista de dispositivos * **ViewDevice** — utilizado para las comprobaciones de estado del dispositivo * **PrintToDevice** — necesario para enviar trabajos de impresión * **ViewDeviceGroups** — recomendado para la búsqueda de grupos y diagnósticos Una clave API puede existir y aun así fallar si estos permisos no están habilitados. 3 #### Ingresa la URL y la clave API en WCPOS Agrega una impresora en **WP Admin > POS > Settings > Cloud Print**, elige **Star Online** como proveedor, luego pega la URL de CloudPRNT y la clave API. Haz clic en **Fetch my devices**. 4 #### Selecciona el dispositivo Star Elige la impresora de la lista de dispositivos y guarda. WCPOS almacena la clave API en el lado del servidor y utiliza el identificador de acceso del dispositivo seleccionado al enviar trabajos a Star Online. ## Reglas de impresión automática[​](#auto-print "Enlace directo a Reglas de impresión automática") Las reglas de impresión automática deciden qué se imprime y dónde, de forma automática — escritas como frases sencillas. Una regla es **alcance × impresora × plantilla**, por ejemplo: > Imprimir **cada pedido** en **Cocina** usando **Ticket de Cocina**. Cuando se completa un pedido coincidente, WCPOS renderiza la **plantilla** elegida en el lado del servidor al formato que necesita la impresora y lo pone en cola — no hay nada que el cajero deba hacer. La compatibilidad de plantillas importa Las impresoras Star y Epson solo pueden usar plantillas **térmicas**, porque el trabajo debe renderizarse al lenguaje de comandos nativo de la impresora (Star Document Markup o ESC/POS para Star, ePOS-Print para Epson). PrintNode puede usar **cualquier** plantilla — térmica o HTML de página completa — porque el trabajo se renderiza a un **PDF**. Si una plantilla no aparece como opción para una impresora, es porque la impresora no puede renderizar ese formato. Consulta [Plantillas Térmicas](/es/receipts/thermal-templates.md) para crear diseños térmicos. ## Impresoras por tienda (Pro)[​](#per-store-printers "Enlace directo a Impresoras por tienda (Pro)") Función Pro El enrutamiento de impresión por tienda requiere [WCPOS Pro](/es/getting-started/pro-license.md) y una configuración de [multitienda](/es/stores/.md). Por defecto, las reglas de impresión automática son globales — todas las tiendas las comparten. Con Pro, puedes dar a una tienda individual sus **propias** reglas de impresión en la nube para que sus pedidos se impriman en sus propias impresoras (un ticket de cocina en una ubicación no debería imprimirse en otra). Edita una tienda en **POS → Stores**, abre su sección de **Cloud Printing** y haz clic en **Add rule**. Cada regla es: * **ID de impresora** — el ID estable de la impresora en la nube a la que enviar * **Alcance** — **Solo pedidos del POS** (predeterminado), **Solo pedidos en línea** o **Cada pedido** * **Formato** — **StarPRNT** (predeterminado), **ESC/POS**, **Epson ePOS-Print** o **HTML** Cuando un pedido pertenece a una tienda que tiene sus propias reglas, WCPOS lo enruta a las impresoras de esa tienda. Si una tienda **no** tiene reglas propias, **recurre a las reglas globales** de impresión automática — así solo necesitas configurar las tiendas que difieren. ## Impresión manual[​](#manual "Enlace directo a Impresión manual") No tienes que esperar a una regla de impresión automática. Desde la **pantalla de pago / recibo**, un cajero puede enviar un recibo a una impresora en la nube bajo demanda — útil para reimpresiones o para enrutar un ticket puntual a una impresora específica. Cómo se produce el recibo depende de la impresora: * **Star CloudPRNT** — el recibo se renderiza **en el dispositivo** y se entrega a la impresora a través de CloudPRNT. * **Star Online, Epson y PrintNode** — el recibo se renderiza **en el servidor** a partir del pedido y la plantilla seleccionados, luego se entrega a la impresora o al servicio de retransmisión alojado. ## Impresión de prueba y estado de conexión[​](#status "Enlace directo a Impresión de prueba y estado de conexión") Cada tarjeta de impresora tiene un botón de **Impresión de prueba** que envía un breve diagnóstico para que puedas confirmar que la impresora es alcanzable y que el formato es correcto antes de depender de ella para pedidos reales. La tarjeta también muestra un estado en vivo: | Proveedor | Estado | Significado | | -------------------------- | ------------------ | ------------------------------------------------------------------------------ | | **Star CloudPRNT / Epson** | **En espera** | La impresora aún no se ha registrado — WCPOS está esperando su primer sondeo. | | **Star CloudPRNT / Epson** | **Conectada** | La impresora sondeó a WCPOS recientemente y está recogiendo trabajos. | | **Star Online** | **En línea** | Star Online informa que el dispositivo seleccionado está disponible. | | **Star Online** | **Fuera de línea** | Star Online informa que el dispositivo seleccionado no está disponible. | | **Star Online** | **Desconocido** | WCPOS no pudo confirmar el estado del dispositivo desde Star Online. | | **PrintNode** | **En línea** | El servicio PrintNode informa que el cliente y la impresora están disponibles. | | **PrintNode** | **Fuera de línea** | PrintNode informa que el cliente o la impresora no están disponibles. | ## Solución de Problemas[​](#troubleshooting "Enlace directo a Solución de Problemas") La impresora se queda en En espera Una impresora por sondeo que nunca sale de **En espera** nunca ha llegado correctamente a WCPOS. Verifica: * La **URL de sondeo y el token** en el firmware de la impresora coinciden exactamente con lo que WCPOS generó. Un solo carácter incorrecto significa que cada sondeo es rechazado — regenera el token en WCPOS y vuelve a ingresarlo si no estás seguro. * La impresora puede realmente **alcanzar tu sitio** por internet (DNS correcto, sin firewall que bloquee HTTPS saliente, certificado SSL válido en tu tienda). * El **sondeo está habilitado** en la configuración de CloudPRNT / Server Direct Print de la impresora, con un intervalo razonable. Reinicia la impresora después de cambiar sus ajustes. Star Online dice que la clave API no está autorizada o está prohibida Star Online separa la **autenticación** de los **permisos**: * **401 / autenticación fallida** significa que la clave API en sí no fue aceptada. Verifica que la clave se haya copiado correctamente, que no haya sido revocada y que pertenezca a la cuenta/región esperada de Star Online. * **403 / prohibido** significa que la clave API fue aceptada pero no está autorizada para la acción solicitada. Edita la clave en stario.online y habilita los permisos requeridos, especialmente **EnumDevices** para **Fetch my devices** y **PrintToDevice** para imprimir. Si **Fetch my devices** tiene éxito pero no aparecen impresoras, revisa la página de **Device Groups** de stario.online. El grupo debe contener al menos un dispositivo conectado, y la URL de CloudPRNT en WCPOS debe apuntar a ese mismo grupo. El trabajo de PrintNode nunca se imprime El trabajo llegó a PrintNode pero no salió de la impresora. Verifica: * El **cliente de escritorio PrintNode está en ejecución y en línea** en el equipo conectado a la impresora. Si el equipo está en suspensión o el cliente está cerrado, no se imprime nada. * Seleccionaste la **impresora correcta** en WCPOS — el nombre debe coincidir con la impresora que reporta el cliente. * La **clave API es válida** y no ha sido revocada. Vuelve a ingresarla si PrintNode muestra la impresora como Fuera de línea. Mi plantilla no se puede seleccionar para una impresora Star o Epson Solo las plantillas **térmicas** funcionan en las impresoras en la nube Star y Epson, porque el recibo debe renderizarse a comandos ESC/POS o ePOS-Print. Las plantillas HTML y de página completa no se pueden expresar en esos formatos, por lo que están ocultas para estas impresoras. Elige una [plantilla térmica](/es/receipts/thermal-templates.md), o usa una impresora **PrintNode** — PrintNode renderiza a PDF, por lo que puede imprimir cualquier plantilla. ## Documentación relacionada[​](#related-documentation "Enlace directo a Documentación relacionada") [Configuración de ImpresorasConecta una impresora en el mismo dispositivo o red](/es/hardware/printers.md) [PlantillasEl sistema de plantillas de recibos](/es/receipts/.md) [Plantillas TérmicasCrea diseños ESC/POS para impresoras Star y Epson](/es/receipts/thermal-templates.md)