Cenaly Hardware Bridge — Hardware del establecimiento

El navegador por sí solo no sabe imprimir recibos en una impresora POS, abrir el cajón de dinero ni leer el peso de una balanza. Esa tarea la resuelve Cenaly Hardware Bridge — una pequeña aplicación gratuita que se instala en el ordenador de la caja, funciona en segundo plano y conecta la página del panel de administración/caja con el Hardware local del establecimiento.

Abrir: Panel de administración → Hardware (admin.cenaly.com).

Qué se conecta#

Cola de impresión#

La impresión a través del Puente no es «envié y confíe». El Puente tiene su propia cola de tareas con reintentos, que sobrevive al reinicio: si se apagó la Impresora o se acabó el papel, la tarea no se pierde y se imprimirá cuando el Dispositivo vuelva a la vida.

Por eso la impresión tiene cinco resultados distintos, y no «salió/no salió»: impreso, aceptado en cola (¡todavía no hay papel!), impreso por el navegador, lo imprime la Caja fiscal (véase más abajo) y no impreso. En la cabecera de la Caja se ve un indicador de la cola con el número de tareas en espera.

Las tareas son idempotentes: el reenvío del mismo documento no produce un segundo papel.

La Caja fiscal no es una Impresora de recibos de reserva. Si en el Local no hay una Impresora de recibos aparte, el Puente NO imprimirá nuestro recibo a través de la Caja fiscal: el recibo fiscal lo imprime ella misma, y nuestro documento es otro papel. La Caja en tal situación lo dice así: «el recibo lo imprime la propia Caja fiscal». A través de la Caja fiscal solo están permitidos la impresión de prueba y el pre-recibo — y en ellos se imprime una marca de que no es un documento fiscal.

Detalles, vinculación de Impresoras a estaciones y páginas de códigos para cirílico y georgiano — Impresión en cocina y sala.

Instalación del Puente#

Si el Puente no se encuentra en este PC, la página ofrecerá instalarlo:

1. Descargue la versión para su sistema operativo — Windows, Linux (x64) o Linux (ARM64) (macOS — en planes). Para la verificación se indica el SHA-256.
2. Ejecute la aplicación. Windows — doble clic: el Puente pasa a segundo plano (icono en la bandeja) y abre la página de estado. Linux — es más fiable instalarlo directamente como servicio en segundo plano con el comando de una línea desde la página «Hardware» (curl … | sudo … bash): se inicia al arrancar el PC y se reinicia solo. Ejecutar el archivo descargado manualmente (chmod +x y ejecutar) también funciona, pero el Puente solo vive mientras el terminal esté abierto y tras reiniciar no vuelve; la página de estado en Linux ábrala usted mismo — http://127.0.0.1:9100.
3. Compruebe en la página de estado que el Puente está en marcha. Abra el panel de administración en este mismo PC, seleccione el Local necesario y la sección «Hardware»: el navegador se conecta automáticamente.
4. Vuelva al panel de administración y pulse «Buscar de nuevo» — la Caja encontrará sola el Puente en este PC y se conectará.

Si Windows muestra una advertencia al descargar/ejecutar — es lo esperado: elija «Guardar», y al ejecutar «Más información» → «Ejecutar de todos modos». Para Linux hay una instalación de una línea como servicio en segundo plano.

Cómo quitar el Puente del ordenador (Linux). Con el mismo comando de una línea de la página «Hardware», solo que con una suborden — en la página está oculto bajo «Linux — detener o eliminar el Puente»:

• … | sudo bash -s -- stop — detener el servicio y quitarlo del inicio automático; los archivos y la configuración quedan en su sitio, para volver a activarlo — start;
• … | sudo bash -s -- uninstall — quitar el servicio y eliminar el propio programa. La configuración y la vinculación de la Caja permanecen, y el script indica dónde están;
• … | sudo bash -s -- uninstall --purge — lo mismo más la configuración: la lista de Hardware y la vinculación al Local. Después de esto habrá que vincular la Caja de nuevo;
• … | sudo bash -s -- status — si el Puente funciona y en qué dirección (si 9100 está ocupado, el Puente toma el siguiente libre, hasta 9109).

En Windows para esto existe el habitual «Instalar y desinstalar programas» (Registro «Cenaly Bridge») — el desinstalador también quita el inicio automático.

Puente en un ordenador donde no se abre el panel de administración (servidor en el cuarto de atrás, PC aparte junto a las Impresoras), no se puede vincular con la búsqueda automática — la vinculación automática funciona solo entre el Puente y la página de la Caja en el mismo ordenador. Para ese caso el propietario genera en el panel de administración un código de vinculación de un solo uso (vive 15 minutos) y lo introduce en la página de estado del Puente.

El Puente está vinculado a su marca: descargado desde un dominio de marca ajena no atenderá su panel de administración, y si el Puente ya está vinculado a otro Local del mismo propietario, la página lo mostrará y ofrecerá revincularlo aquí con un solo botón.

Tres formas de conexión#

El código de acceso del empleado de la sección «Dispositivos» es un mecanismo aparte. Si el PIN o el código han caducado, cree uno nuevo con el botón correspondiente.

Gestión y comprobaciones#

Cuando el Puente está conectado, en la página se ve:

• Dispositivos — lista con el estado de cada uno (conectado / atención / error / no encontrado);
• Comprobación de Hardware — prueba rápida de impresión, escaneo, peso;
• Ajustes de Hardware;
• Actividad — flujo de eventos (escaneo, peso, impresión) en tiempo real;
• Actualización — si ha salido una nueva versión del Puente, se puede instalar directamente desde aquí.

Al añadir una Impresora, elija su destino: de recibos, de cocina o para etiquetas. El rol se ve en la ficha del Dispositivo. Define el destino dentro del Puente; la distribución del Hardware entre puestos de trabajo individuales es otro nivel de configuración. Si la lectura de los ajustes no ha funcionado, el asistente ofrecerá repetir y conservará la lista existente.

El Hardware encontrado se puede desconectar o eliminar. «Desconectar» deja el Dispositivo en la lista con todos los ajustes, pero el controlador no se levanta: el puerto COM queda libre, no hay sondeo, el rol pasa a otro Dispositivo — se vuelve a activar con un solo botón. «Eliminar» (bajo confirmación) quita el Dispositivo definitivamente, y la detección automática de Hardware conocido ya no lo devolverá en el siguiente arranque del Puente. El Hardware que se configuró antes y que ahora la búsqueda no ve, se muestra en un grupo aparte — de lo contrario no habría con qué gestionarlo.

Puede haber varios Puentes por Cuenta, y a cada uno se le asigna un rol: universal, Hardware, cámaras o telefonía. Los Puentes del Local se listan aparte — se pueden renombrar y asignar el Puente por defecto.

Hardware de toda la cuenta y trabajo desde la nube#

Además del puente «de este equipo», en la página hay un registro de Hardware de la cuenta: una tabla transversal de todos los puentes, Dispositivos y cámaras de todos los Locales de la red: se ve qué hay en cada sitio, si el puente está en línea y a qué Locales da servicio de Hardware. Un Dispositivo se puede trasladar a otro Local si el puente está en línea en ese momento; con un puente sin conexión, el registro solo muestra, pero no modifica.

En cada máquina del registro se despliega una ficha «Detalles del PC»: nombre del equipo, IP y MAC, sistema, modelo, procesador, memoria por ranuras, unidades de almacenamiento con espacio libre y estado, todo el Hardware conectado y todos los puertos COM, con la indicación de qué puerto está ocupado y por quién, y cuál está libre. Es lo primero que conviene mirar cuando «la Impresora estaba y ahora no se ve» o cuando al PC de Caja se le acaba el espacio. Los datos los recopila el propio puente; en una versión antigua del puente la lista de Hardware puede estar vacía: en ese caso basta con actualizar el puente.

Además del canal local (navegador ↔ puente en este PC) existe el canal de Nube: la orden llega al puente a través del servidor, por lo que se puede imprimir un Recibo o comprobar la Impresora desde otro Dispositivo; por ejemplo, un camarero imprime desde su teléfono en la Impresora de Caja de la barra. En la página esto se ve como «vinculación de Nube» en el puente y un botón aparte de impresión de prueba desde la Nube.

Impresión en la Impresora de otro equipo. Si la Impresora está conectada físicamente a otro PC, no hace falta «compartirla» por red ni tirar un cable. La acción «Imprimir desde otro PC» en el registro crea en esta máquina un enlace a la Impresora ajena: se eligen el equipo propietario, el Local y el nombre; después la fila queda marcada como «a través de la Nube → PC propietario», y los trabajos se imprimen con la cola de ese equipo. No hacen falta una carpeta compartida, VPN ni visibilidad directa entre las máquinas: basta con que ambos puentes den servicio a un mismo Local.

Pantalla remota de la Caja. Desde esa misma página (y por invitación desde el chat de trabajo) se puede ver la pantalla del PC de Caja; por ejemplo, para ver con los propios ojos qué muestra la Caja. Siempre decide la otra parte: mientras su titular no active el acceso remoto en su equipo, no hay botón de conexión, y cada sesión requiere su consentimiento por separado; «no volver a preguntar» no existe a propósito. Ver y controlar son dos permisos distintos, y cerrar la ventana finaliza la sesión de forma garantizada.

Secciones relacionadas#

• Caja (POS) — dónde se usan la impresión de Recibos y el cajón de dinero
• Recibos y devoluciones — impresión y reimpresión de Recibos
• Fiscalización — Impresoras fiscales y Cajas fiscales en línea
• Impresión en cocina y en sala — estaciones, etiquetas, cola y páginas de códigos
• Producto a peso y etiquetas — trabajo con básculas, unidades de medida y etiquetas para estantería
• Hardware: qué se conecta — panorama de clases de hierro y equipos mínimos por formato
• Telefonía: centralita propia — teléfonos y pasarelas no requieren el puente de Hardware y viven en su propio circuito
• Control de pérdidas — videoclips de operaciones peligrosas desde la cámara del puente

Preguntas frecuentes#

¿Hay que introducir un código para la vinculación?#

Normalmente no: el puente se inicia en el mismo PC donde se abre la Caja, y esta lo encuentra sola con el botón «Buscar de nuevo». El código solo hace falta para el puente en un equipo donde no se abre el panel de administración; en ese caso, el titular genera un código de un solo uso y lo introduce en la página del puente.

¿En qué sistemas operativos funciona el puente?#

Windows y Linux (x64 y ARM64). La versión para macOS está en planes.

No se ve el Hardware: ¿qué comprobar?#

Compruebe que el puente está iniciado (página de estado) y pulse «Buscar de nuevo». El estado de cada Dispositivo y las comprobaciones rápidas están disponibles en la página «Hardware». Si el Dispositivo no aparece, abra en el registro de Hardware la ficha «Detalles del PC» de esa máquina: ahí se ve todo el hierro que ve el propio equipo y todos los puertos COM con la indicación de quién ocupa el puerto; normalmente basta para entender si el problema está en el cable, en el puerto o en otro programa que retiene el puerto.