Modo offline del POS | Docs contable.io

El POS de contable.io es una PWA (Progressive Web App) diseñada para seguir funcionando aunque se pierda la conexión a internet. Las ventas se guardan localmente en el navegador y se sincronizan automáticamente cuando vuelve la red.

Esto es crítico para negocios en zonas con conectividad inestable o durante caídas del proveedor de internet: nunca dejas de vender.

Qué se puede hacer offline

Cuando el POS detecta que está sin conexión, muestra un indicador en la parte superior y permite:

✅ Buscar productos del catálogo (cargado en caché local).
✅ Agregar al carrito y editar cantidades.
✅ Asignar clientes ya conocidos por el dispositivo.
✅ Cobrar en cualquier medio de pago.
✅ Imprimir tirilla en la térmica.
✅ Cerrar la venta y atender al siguiente cliente.

Qué NO se puede hacer offline

❌ Crear clientes nuevos (queda en cola hasta volver online).
❌ Validar stock contra otras bodegas o sucursales.
❌ Aplicar listas de precios actualizadas en las últimas horas.
❌ Enviar el documento equivalente a la DIAN en tiempo real.

Cómo se sincronizan las ventas

Cada venta hecha offline se guarda en IndexedDB, la base de datos local del navegador. La cola es persistente: aunque cierres el POS o reinicies el computador, las ventas siguen ahí.

Cuando el POS recupera conexión:

Detecta automáticamente que hay red.
Envía las ventas pendientes al backend, una por una y en orden.
Cada venta recibe su número de documento equivalente y se reporta a la DIAN.
El indicador cambia a verde y muestra cuántas ventas se sincronizaron.

Mientras la cola se vacía, puedes seguir vendiendo. Las ventas nuevas se agregan al final de la fila.

Numeración durante el modo offline

Las ventas hechas offline reciben un número temporal local (ej: LOCAL-20260406-001) que se imprime en la tirilla del cliente. Cuando se sincronizan, el sistema les asigna el número definitivo de la resolución DIAN y reemite el documento equivalente.

Si el cliente necesita el comprobante con el número final, puede consultarlo días después en Ventas → Recibos POS buscando por la fecha o el monto.

Advertencias y límites

No hagas cierre de turno offline. El cierre necesita validar contra el servidor el efectivo declarado vs el esperado. Espera a tener conexión.
El catálogo offline tiene la última versión sincronizada. Si subiste productos nuevos durante la caída, no aparecerán hasta que vuelvas a estar online.
Stock offline es estimado. Si dos cajas venden el mismo producto sin conexión y exceden el stock real, el sistema lo permitirá y quedará en negativo al sincronizar. Revisa el reporte de inventario al recuperar conexión.
Cambios de precio no se reflejan. Si actualizaste precios durante la caída, las ventas offline usan los precios viejos.

Buenas prácticas

Mantén el POS abierto en el navegador todo el día, incluso entre clientes. Esto asegura que la PWA esté actualizada y la cola de sincronización corra en background.
Configura múltiples conexiones de respaldo: WiFi principal + datos móviles del celular como hotspot. La PWA cambia de red sin intervención.
Revisa la cola al final del día desde el menú de la caja. Si hay ventas sin sincronizar, no cierres turno hasta recuperar conexión.