Modo offline do POS | Docs contable.io

O POS do contable.io é uma PWA (Progressive Web App) desenhada para continuar funcionando mesmo sem conexão à internet. As vendas são salvas localmente no navegador e sincronizadas automaticamente quando a rede volta.

Isto é crítico para negócios em zonas com conectividade instável: você nunca para de vender.

O que funciona offline

✅ Buscar produtos do catálogo (cache local).
✅ Adicionar ao carrinho e editar quantidades.
✅ Atribuir clientes já conhecidos pelo dispositivo.
✅ Cobrar em qualquer meio de pagamento.
✅ Imprimir bobina na térmica.
✅ Fechar a venda e atender o próximo.

O que NÃO funciona offline

❌ Criar clientes novos (fica em fila).
❌ Validar estoque contra outros depósitos.
❌ Aplicar listas de preços atualizadas nas últimas horas.
❌ Enviar o documento equivalente à DIAN em tempo real.

Como sincronizam as vendas

Cada venda offline é salva no IndexedDB, a base local do navegador. A fila é persistente: mesmo fechando o POS, as vendas continuam lá.

Quando o POS recupera conexão:

Detecta automaticamente que há rede.
Envia as vendas pendentes ao backend, uma por uma e em ordem.
Cada venda recebe seu número de documento equivalente e é reportada à DIAN.
O indicador muda para verde mostrando quantas sincronizaram.

Numeração durante o modo offline

Vendas offline recebem um número temporário local (ex. LOCAL-20260406-001) impresso na bobina. Ao sincronizar, o sistema atribui o número definitivo da resolução DIAN e reemite o documento equivalente.

Avisos e limites

Não faça fechamento de turno offline. Espere conexão.
O catálogo offline tem a última versão sincronizada.
Estoque offline é estimado. Se exceder, ficará negativo ao sincronizar.
Mudanças de preço não se refletem.

Boas práticas

Mantenha o POS aberto no navegador o dia todo.
Configure conexões de backup: WiFi + hotspot do celular.
Revise a fila no fim do dia antes de fechar turno.