Si se pierde la conexión a internet o la Nube no está disponible

La conexión se corta: el proveedor, el router, una tormenta, una avería del operador. El establecimiento no cierra por eso: los clientes siguen en la Caja. A continuación, qué sigue funcionando exactamente, qué no y qué debe hacer el Turno.

Distinga dos fallos, porque se comportan de forma diferente:

La Caja deliberadamente no intenta adivinar la causa: cualquier error de red significa «trabajamos en local, el Registro va a la cola».

Qué sigue funcionando#

Caja (POS web). No es una página en caché sin más, sino una auténtica cola de Registro en el Dispositivo:

• el Pedido se cobra y va a la cola de Pedidos (vive en la Caja 24 horas);
• el Recibo y el Turno de caja tienen su propia cola de operaciones (apertura de Turno, ingreso y retirada, Recibo, devolución, cierre de Turno). Cada operación tiene una clave idempotente de cliente, por lo que el reenvío no duplica nada;
• el Turno abierto sin conexión recibe un Número temporal y sigue funcionando: la restricción «sin Turno abierto no se puede cobrar» también se aplica sin conexión, y calcula con la caché local;
• el menú, los precios, las Mesas y los catálogos se leen de la caché local del navegador: llegaron allí mientras había conexión;
• recargar la página no expulsa a la pantalla de inicio de sesión: la Caja se abre en una «sesión degradada» con la instantánea local y se reconecta sola cuando vuelva la red.

Impresión. El Recibo, el tique de cocina y la etiqueta se imprimen mediante el Puente instalado en el mismo ordenador: la Caja se comunica con él por la dirección local de la máquina; para ello no hace falta internet.

Recibo fiscal. Si la Caja fiscal está conectada al mismo ordenador, el Recibo se emite a través del Puente por el mismo canal local: el almacenamiento fiscal acumula documentos y el operador de datos fiscales los pone al día cuando aparezca la conexión. Para la 54-ФЗ este es el modo habitual, no una infracción.

Pantalla de inicio de sesión. Mientras el navegador tenga una sesión reciente (ventana de 7 días), el cajero entra y trabaja; el envío de lo acumulado requerirá de todos modos una autorización real al restablecerse la conexión.

Qué no funciona sin conexión#

• Pantalla de cocina (KDS). Los tiques llegan a ella a través de la Nube; sin internet, los nuevos Pedidos no llegarán a la cocina: se enviarán allí cuando se restablezca la conexión. Mientras tanto, la cocina trabaja con tiques impresos, si tiene configurada la impresión en cocina, o con el pase oral.
• Terminal bancario. El pago con tarjeta requiere autorización del banco: sin conexión no se completará. Acepte efectivo.
• Pago en línea por el cliente (tarjeta en el escaparate, pago de la cuenta del huésped desde la Mesa, pago en el kiosco): se necesita acceso al proveedor de pagos.
• Segunda Caja y tableta del camarero. Los Dispositivos no se sincronizan entre sí en la red local: cada uno lleva su propia cola y la reenvía por su cuenta. El contorno local compartido («modo LAN») no lo hacemos a propósito: decisión del propietario del producto: apostamos por la autonomía de una sola Caja con impresión.
• Informe X. El corte intermedio se calcula en el servidor a partir de las ventas: sin conexión, la Caja lo rechazará honestamente. El Turno se puede cerrar; el informe Z se generará cuando vuelva la conexión.
• Secciones del panel de administración que calculan en el servidor: «Pedidos», «Finanzas», «Estadísticas», «Almacén», «Personal». Leen de la Nube y, sin conexión, muestran como mucho lo último que lograron leer.
• Pantalla de entrega, panel de turnos, kiosco: también son superficies en la Nube.

Qué debe hacer el personal#

1. Siga cobrando. En cuanto se pierde la conexión, aparece en la Caja un banner ámbar de «sin conexión» y el chip «N sin enviar». Es el modo normal: el Pedido se ha aceptado, el Recibo se ha impreso, el dinero se ha cobrado.
2. Imprima el Recibo al cliente como de costumbre. La impresión es local: el papel sale.
3. Trabaje en el mismo Dispositivo y en el mismo navegador. La cola está en este ordenador: no se puede pasar a una segunda tableta y «reenviar desde allí».
4. No borre la caché del navegador, no cierre la sesión de la Cuenta ni abra la Caja en modo incógnito: así borrará los Pedidos y Recibos no enviados.
5. Se puede recargar la página. La cola sobrevive a la recarga y al reinicio del navegador.
6. No cobre un mismo Pedido dos veces «por si acaso»: el sistema está protegido contra duplicados al reenviar, pero dos Pedidos distintos los contará honestamente como dos.
7. No acepte tarjeta: el Terminal no autoriza sin conexión. Efectivo y, si el cliente lo desea, una Factura para pagar más tarde.
8. El banner rojo «N sin entregar» significa que parte de los Registros no se enviaron ni siquiera tras restablecerse la conexión (se agotó el plazo o el servidor los rechazó). Es motivo para llamar al gerente, no para ocultar el banner.

Qué ocurrirá cuando vuelva la conexión#

El reenvío comienza solo: por el evento «ha aparecido la red», al volver a la pestaña y por temporizador.

• El chip «N sin enviar» disminuye y desaparece. Los Pedidos aparecen en la sección «Pedidos» y en la pantalla de cocina, los Recibos reciben Números, el almacén se descuenta según las fichas técnicas.
• No habrá duplicados. Cada Pedido tiene un identificador de cliente y cada operación de Caja, una clave de idempotencia; el servidor reconoce la repetición y no la aplica por segunda vez.
• El Turno sin conexión se sustituye por el real. El Número temporal del Turno se reescribe por el real en todos los Recibos y movimientos que aún estén en la cola.
• Se genera el informe Z para el Turno cerrado sin conexión.
• Nada se elimina en silencio. Los Registros que no se pudieron entregar (se agotaron las 24 horas o el servidor devolvió un error irrecuperable) pasan a una lista aparte de «sin entregar» (se conserva 7 días, hasta 100 Registros) y se muestran con un banner rojo que se puede ocultar manualmente.

El orden se mantiene: la cola se reenvía de forma secuencial y, ante errores temporales del servidor, reintenta con una pausa creciente.

Limitaciones#

• El modo sin conexión está cerrado para la Caja y la impresión, y solo para eso. La pantalla de cocina, el Terminal bancario y la sincronización entre Dispositivos en la red local no funcionan sin internet; el circuito LAN completo no se hace de forma deliberada.
• La cola está vinculada al Dispositivo y al navegador. Se guarda en el almacenamiento de un navegador concreto: otro equipo, otro navegador o el modo incógnito no la ven.
• La vida útil de la cola es de 24 horas para Pedidos y operaciones de Caja. Más de un día sin conexión: los Registros pasan a la lista «no entregado», no desaparecen en silencio.
• La sesión sin conexión dura 7 días. Después, la Caja pedirá el inicio de sesión habitual, y sin red no es posible.
• El informe X no está disponible sin conexión: se calcula en el servidor.
• Las superficies para el cliente (escaparate, kiosco) mantienen la cola solo una hora: están pensadas para un fallo breve de la red móvil del cliente, no para funcionar sin internet.
• Caja Android. La recepción de Pedidos y el Recibo fiscal local sin conexión funcionan, pero el Registro en el registro de Recibos y el Turno de caja sin conexión aún no (está planificado). La fuente de verdad sin conexión allí es el almacenamiento fiscal.
• La prueba integral de «desconectar el cable» en un registro fiscal real aún no se ha hecho. El modo sin conexión de la Caja está cubierto por código y pruebas automatizadas (incluida la e2e «sin conexión dentro de la sesión»), y la verificación en hardware real por parte del propietario está en el plan: lo decimos con claridad, no lo hacemos pasar por hecho.

Solución de problemas#

La Caja pide iniciar sesión, aunque antes funcionaba. La sesión tiene más de siete días o se han limpiado los datos del navegador. Sin red no se puede iniciar sesión: restablezca la conexión.

El chip «N sin enviar» no disminuye. Compruebe que la conexión ha vuelto realmente (abra cualquier sitio web) y deje la pestaña de la Caja activa: el reenvío se produce por el evento de red, al volver a la pestaña y por temporizador. Si el chip se mantiene con el mismo número, mire el banner rojo: parte de los Registros puede haber pasado a «no entregado».

Ha aparecido un banner rojo «N no entregado». El servidor no ha aceptado los Registros: ha vencido el plazo de un día o la respuesta era irrecuperable (por ejemplo, acceso revocado). Los Pedidos y Recibos de esta lista hay que registrarlos manualmente: compárelos con los Recibos en papel del Turno de caja.

Se registró un Pedido sin conexión y en la cocina no aparece. Es lo esperado: el ticket llegará a la pantalla de cocina cuando se restablezca la conexión. Mientras no haya red, la cocina se apoya en los tickets impresos.

El Recibo no se imprime sin conexión. Entonces no es cosa de internet: compruebe que el Puente está iniciado en este equipo y que la Impresora está conectada: Cenaly Hardware Bridge. El Puente y la Caja se comunican dentro de la misma máquina.

Tras restablecerse la conexión han aparecido Pedidos duplicados. No puede haber duplicados por el reenvío: compruebe si se ha registrado el mismo Pedido dos veces a mano y cancele el sobrante en la sección «Pedidos».

Preguntas frecuentes#

¿La Caja funciona sin internet?#

Sí: registra Pedidos, imprime Recibos y los fiscaliza a través del Puente en el mismo equipo. Todo lo que debe ir a la Nube se acumula en la cola del Dispositivo y se reenvía automáticamente.

¿Se perderán los datos?#

No. La cola sobrevive a la recarga de la página y al reinicio del navegador, y lo que no se ha podido entregar pasa a la lista visible «no entregado», no desaparece. Solo se puede perder manualmente, al limpiar los datos del navegador.

¿Se pueden registrar Recibos conforme a la 54-ФЗ sin conexión?#

Sí, si el registro fiscal está conectado al mismo equipo que el Puente: el almacenamiento fiscal acumula documentos y los transmite al operador de datos fiscales cuando vuelva la conexión. Es un modo previsto por la ley.

¿Por qué no funciona la pantalla de cocina?#

Los tickets van a través de la Nube. No tenemos red local entre la Caja y la pantalla de cocina: es una decisión deliberada: cubrimos la autonomía de la Caja con impresión, no todo el local. Mientras no haya red, la cocina se apoya en los tickets impresos.

¿El cliente podrá abrir el menú mientras no tenemos internet?#

Sí: el escaparate se sirve desde el CDN y no depende de su internet. El Pedido realizado por el cliente llegará a la Nube, pero en el establecimiento lo verá solo cuando se restablezca la conexión.

¿Qué hacer con el pago con tarjeta?#

Aceptar efectivo: el Terminal bancario necesita autorización en el banco.

¿Cuánto tiempo aguanta la Caja sin conexión?#

Un día para la cola de Pedidos y operaciones de Caja, siete días para la sesión. En la práctica, esto significa que podrá trabajar un Turno con tranquilidad.

Secciones relacionadas#

• Caja (POS): Pedido, pago, modos de servicio y la sección «Trabajo sin conexión»
• Turno de caja e informe Z: apertura, movimientos, informes X y Z
• Cenaly Hardware Bridge: Puente en el equipo POS, Impresoras y registros fiscales
• Impresión en cocina: tickets por estaciones cuando la pantalla de cocina no está disponible
• Pantalla de cocina (KDS): cómo llegan los tickets a la cocina
• Primer día: cafetería, restaurante, comedor: qué activar de inmediato