Documentación técnica · Bouzon TPV
Si se cae internet a las 22:30 de un sábado, el restaurante sigue cobrando
Esta es la lista completa y honesta de qué hace y qué no hace Bouzon TPV sin conexión. Está publicada porque un TPV cloud se juega la credibilidad justo aquí, y porque preferimos que lo compruebes antes de contratarlo que descubrirlo con el comedor lleno.
Resumen en una línea: se sigue abriendo mesas, mandando comandas a cocina, cobrando y cerrando la caja. Lo único que no puede existir sin red es lo que necesita al servidor o a un tercero para nacer: el papel fiscal con QR Verifactu, los pagos con Stripe y los informes agregados.
Cómo funciona
- Con red, el TPV no cambia nada. La capa offline solo gobierna cuando el dispositivo se queda sin conexión; el servidor sigue siendo la única fuente de verdad el resto del tiempo.
- Detección automática. Un ping al API cada 20 segundos; dos fallos seguidos y el TPV entra en modo offline y lo avisa en pantalla. Cualquier respuesta del servidor lo devuelve a modo online al instante.
- Cola append-only. Sin red, cada acción escribe en la base de datos local del dispositivo y encola una mutación. Al reconectar se reproducen en orden.
- Idempotente por diseño. Cada acción lleva un identificador único de dispositivo: reproducir la cola dos veces no duplica ni una venta ni un cobro.
- Fiscal diferido. Un cierre sin conexión numera y encadena su registro Verifactu al sincronizar, en orden y sin huecos.
- Impresión sin router. La comanda de cocina se arma en el propio dispositivo y sale por red local o por Bluetooth SPP — no depende del WiFi del local ni de internet.
✅ Funciona sin conexión
| Abrir mesa y comanda | Igual que con red. |
| Añadir, editar y anular productos | Cantidad, precio, notas, pase y modificadores. |
| Mover la comanda de mesa | Al reconectar, el servidor revalida «una comanda por mesa»; si choca, se resuelve a mano. |
| Aplicar y quitar descuentos | Igual que con red. |
| Enviar la comanda a cocina | El navegador arma los bytes ESC/POS e imprime directo contra el agente local. No pasa por internet. |
| Cobrar | Efectivo, tarjeta por datáfono externo, Bizum, transferencia y vale. |
| Cobro parcial | Por importe y por ítems. |
| Cerrar la comanda | El registro fiscal se emite al reconectar, numerado y encadenado en orden. |
| Anular la comanda | El modal avisa antes y acusa recibo después: «anulada aquí, pendiente de sincronizar». |
| Devolver una venta cerrada | Total o parcial. Sale el ticket negativo con su cobro negativo y baja el esperado del cajón. Excepción: un ticket con descuento necesita red. |
| Abrir la caja y registrar movimientos | Ingresos y gastos con su método real; solo el efectivo mueve el esperado del cajón. |
| Corregir el método de un cobro | Sin red solo se ofrecen métodos manuales. |
| Cerrar caja y arqueo parcial | Contado, datáfono y notas. Las cifras se marcan como estimación: el esperado y el descuadre definitivos los recalcula el servidor al sincronizar, con la misma fórmula del cierre online. |
| Imprimir la cuenta y el cierre | Sale un documento PROVISIONAL marcado «sin validez fiscal». La copia fiscal con QR se reimprime al reconectar. |
| Ver los tickets de este dispositivo | Los que este TPV abrió, cobró o anuló desde la última sincronización — no el histórico del negocio, y la pantalla lo dice. |
❌ No funciona sin conexión — y por qué
Ninguna de estas es una funcionalidad pendiente: son cosas que necesitan al servidor o a un tercero para existir. Cualquier TPV cloud que diga lo contrario conviene mirarlo dos veces.
| Ticket fiscal con QR Verifactu | El QR y el CSV nacen cuando el ticket sincroniza: la emisión es diferida por diseño. Offline sale el provisional; la copia fiscal, al volver la red. Es un límite real, no una funcionalidad que falte. |
| Cobro con Stripe (datáfono Stripe o QR Pay del cliente) | Autorizar un pago con Stripe necesita red. Imposible sin conexión, en cualquier sistema. |
| Informe Z y cierres históricos | Son agregados de toda la sesión que solo tiene el servidor. Sin red sale el cierre provisional del cajón; el Z se imprime desde Informes al reconectar. |
| Devolución de un ticket con descuento | El reparto del descuento entre las unidades devueltas lo calcula el servidor. Sin él, el dinero que sale del cajón no coincidiría con el registrado — y eso es peor que esperar. |
| Factura completa, ticket regalo y eliminar ticket | Escriben en el servidor (numeración fiscal, borrado auditado). El panel los desactiva con su aviso en vez de fallar al pulsarlos. |
| Auto-pedido por QR del cliente | Llega desde fuera de la red local: sin servidor no hay a quién servir. |
| Chatbot, analíticas, buscador de clientes y reseñas | Son lecturas y servicios online. |
Preguntas frecuentes
¿Qué pasa exactamente si se cae internet a media faena?
Nada visible para el cliente. El TPV detecta la caída (un ping al API cada 20 segundos; dos fallos seguidos y pasa a modo offline), avisa con una banda en pantalla y sigue funcionando contra una base de datos local en el propio dispositivo. Los camareros siguen abriendo mesas, mandando comandas a cocina por Bluetooth o red local, cobrando en efectivo o con datáfono externo y cerrando la caja. Cada acción se apunta en una cola. Cuando vuelve internet, la cola se reproduce en orden contra el servidor.
¿Se puede duplicar una venta al sincronizar?
No. Cada acción viaja con un identificador único generado en el dispositivo, y el servidor reconoce el que ya ha procesado. Reproducir la misma cola dos veces no crea dos tickets ni cobra dos veces: la segunda pasada se marca como duplicada y se descarta. Está cubierto por tests automáticos que reproducen la cola dos veces a propósito.
¿Y el cuadre de caja? ¿No descuadra si cobro sin conexión?
El cierre sin red se calcula como «última foto del servidor + lo que este dispositivo ha cobrado desde entonces». La pantalla lo rotula como estimación, porque el número contable definitivo —esperado, descuadre y propinas de tarjeta— lo recalcula el servidor cuando la cola sincroniza, con la fórmula literal del cierre online. Es decir: puedes cerrar y arquear sin internet, y el número que queda en los libros lo firma el servidor.
¿Y Verifactu? Si cierro un ticket sin conexión, ¿se pierde el registro?
No. El ticket se cierra con estado «fiscal diferido». Al reconectar, el servidor numera y encadena su registro AEAT en orden y sin huecos, dentro de un bloqueo por restaurante para que la cadena no se rompa aunque sincronicen varios dispositivos a la vez. Lo que no puede salir sin red es el papel fiscal con QR, porque el QR y el CSV nacen en ese momento: offline se imprime el ticket provisional y la copia fiscal se reimprime al volver la conexión.
¿Puedo usar el TPV en modo avión para siempre y no pagar?
No. El dispositivo guarda una licencia con 72 horas de gracia que se renueva cada vez que hay conexión. Si la cuenta se desactiva, el token deja de renovarse y el TPV se bloquea solo al cabo de esas 72 horas. Es un candado pensado para la dejadez, no para un atacante, y no afecta jamás a un cliente al día: basta con que el dispositivo se conecte de vez en cuando.
¿Necesito comprar un router 4G o hardware especial?
No. Todo esto corre en el dispositivo que ya tienes —el portátil de la barra, una tablet, un móvil Android— y la impresión a cocina va por red local o por Bluetooth SPP directamente desde el dispositivo del camarero, sin pasar por el router. No vendemos conectividad ni terminales propietarios, y no hay licencia por terminal ni permanencia.
¿Esto está probado o es una promesa?
Está desplegado en producción desde junio de 2026 y probado en local real. El motor de sincronización tiene tests automáticos que incluyen el doble replay idempotente y la numeración fiscal monótona; el cuadre offline tiene tests de paridad contra la fórmula del cierre online. Esta página se mantiene en paralelo con el documento interno que define el comportamiento, para que lo que lees aquí sea lo que hace el sistema y no lo que nos gustaría que hiciera.
Bouzon TPV — 29,99 €/mes
Certificado Verifactu, sin hardware propietario, sin licencia por terminal y sin permanencia. Puesta en marcha y formación incluidas —por videollamada para toda España, en persona en Benalmádena y la Costa del Sol—, y soporte 24/7 todos los días del año.
Ver el TPV