🔌 Agente de hardware y failover en la nube¶
En el funcionamiento en la nube, la caja se ejecuta en {name}.next.dikas.de — pero el hardware
real (terminal EC, impresora de tickets) está en el local. El agente de hardware tiende este
puente: un programa ligero en la red del local que ejecuta pagos e impresiones de forma local y que
se controla mediante una conexión saliente hacia la nube. Así, el hardware funciona también
cuando la caja ya no se ejecuta localmente, sino en la nube.
¿Quién necesita esto?
Locales que operan su caja (de forma temporal o permanente) en la nube, pero utilizan dispositivos locales. Las cajas de funcionamiento puramente local hablan directamente con su hardware y no necesitan el agente. Véase también Nube y máquina local.
¿Quién puede ser el agente?¶
El agente de hardware ya está integrado en las apps de dispositivos DiKAS — no hace falta instalar nada adicional:
| Host | Plataforma | Rol |
|---|---|---|
| Appliance DikasArch | Mini-PC (Arch Linux, kiosco Electron) | Caja y agente de hardware en uno |
| DiKAS Mobile | Android (app MAUI) | Caja móvil con función de agente |
| Agente de dispositivo DiKAS | Tableta Android | agente de hardware puro (sin interfaz de caja) |
Cualquier dispositivo de la red del local puede ser el agente. Si hay varios conectados, uno de ellos asume la tarea; si uno falla, los demás siguen prestando servicio.
¿Qué pasa por el agente?¶
| Función | A través del agente |
|---|---|
| Pago con tarjeta/EC (ZVT) | ✓ Pago, anulación, abono, corte de caja — en el terminal de red |
| Impresión de tickets/recibos (ESC/POS) | ✓ en impresoras de tickets de red o impresoras USB/serie conectadas localmente |
| Búsqueda de dispositivos en la red | ✓ Encontrar terminales e impresoras en la red del local |
| Impresión de documentos A4 (CUPS) | ✓ a través del puente de impresión local de la appliance |
| Firma TSE | ✗ — la TSE sigue vinculada a la caja local (o funciona como Cloud-TSE), véase TSE |
Directo frente a agente — automático
Si el servidor alcanza el dispositivo directamente en la red (funcionamiento local), DiKAS lo aborda directamente. Si la caja está en la nube y hay un agente conectado, todo pasa automáticamente por el agente — sin necesidad de cambiar nada en el manejo.
Emparejamiento (Pairing)¶
El agente se conecta por sí mismo a la nube (conexión saliente, compatible con NAT — no hace falta abrir puertos). La autenticación se realiza por inquilino mediante un secreto derivado de la licencia.
- Appliance DikasArch: se empareja automáticamente — conoce su inquilino a partir de la licencia
y deriva por sí misma la dirección de la nube (
{name}.next.dikas.de) y el secreto de emparejamiento. - Tableta/Móvil: emparejamiento mediante código QR desde el área de administración (dirección de la nube + secreto).
El área de administración muestra el estado de la conexión (dispositivos conectados) en Configuración → Hardware → Agente de hardware.
Failover en la nube: el servidor local falla¶
Si el servidor de caja local se desconecta (corte de luz, red, avería), el negocio debe poder seguir funcionando. DiKAS detecta el fallo y ofrece el cambio a la nube:
- La caja comprueba periódicamente si el servidor local está accesible.
- Si falla y la nube está accesible, aparece abajo un aviso: «Servidor local no accesible — ¿cambiar a la nube?»
- Tras confirmar, la caja carga la dirección de la nube
{name}.next.dikas.de. Se conservan los ajustes locales (puesto de trabajo, asignación de impresora/terminal) y el nombre de usuario aparece precargado — solo hay que volver a iniciar sesión. - El hardware sigue funcionando: el pago con tarjeta y la impresión de tickets pasan ahora por el agente de hardware, que sigue funcionando con independencia del servidor de caja. Las impresiones A4 pasan por el puente de impresión local.
- En cuanto el servidor local vuelve a estar disponible, la caja ofrece el cambio de vuelta.
Por qué el agente sobrevive al fallo
En la appliance DikasArch, el agente de hardware se ejecuta como un servicio propio, separado del servidor de caja. Si el servidor de caja se cae, el agente sigue conectado — los dispositivos siguen siendo utilizables en modo nube.
Reenvío inmediato (Relay) en el failover
El reenvío inmediato (Relay) presupone que el servidor local esté en funcionamiento, por lo que no está disponible durante el failover. La impresión local y el pago con tarjeta en modo nube pasan por el agente de hardware (o por el puente de impresión para A4).
Cambiar manualmente a la nube¶
También es posible cambiar del funcionamiento local a la nube sin que haya un fallo — p. ej. para seguir trabajando desde fuera. Para ello, en el menú principal de la caja aparece (en la appliance y en móvil, en cuanto se conoce una dirección de nube) la entrada «Cambiar a online». Ejecuta el mismo cambio que en el failover.
Preguntas frecuentes¶
¿Tengo que instalar algo en la appliance? No. El agente forma parte del software DikasArch y se empareja automáticamente mediante la licencia.
¿Funcionan realmente el pago con tarjeta y la impresión cuando el servidor local está apagado? Sí — a través del agente de hardware, siempre que haya un dispositivo conectado en la red del local. La nube debe conocer los dispositivos (direcciones de terminal/impresora); estos se encuentran y se guardan mediante la búsqueda de dispositivos.
¿Qué pasa si no hay ningún agente conectado? En modo nube, la caja muestra entonces un mensaje de error claro («no hay ningún agente de hardware conectado») — el pago con tarjeta y la impresión no vuelven a estar disponibles hasta que se conecte un dispositivo.
¿Se cobran los recibos por duplicado durante el failover? No. Si se pierde el resultado de un pago, la caja notifica un error en lugar de repetirlo automáticamente — así se evita un cobro duplicado.