Se a internet cair ou a nuvem ficar indisponível

A conexão cai: provedor, roteador, tempestade, falha na operadora. O estabelecimento não fecha por isso — os clientes estão no caixa. Abaixo, o que exatamente continua funcionando, o que não funciona e o que a equipe deve fazer.

Distinga duas falhas, porque elas se comportam de forma diferente:

O que aconteceu	Caixa no estabelecimento	Cliente na rua
A internet caiu no estabelecimento	Funciona offline: registra, imprime, acumula fila	A vitrine abre (ela é distribuída pelo CDN), o pedido vai para a nuvem — mas no estabelecimento só será visto após a conexão voltar
A nuvem está indisponível	O mesmo: o caixa não distingue uma coisa da outra — para ele, é "o registro não foi enviado"	A vitrine pode abrir do cache, a finalização do pedido e o pagamento não passam

O caixa deliberadamente não tenta adivinhar a causa: qualquer erro de rede significa "trabalhamos localmente, registro na fila".

O que continua funcionando#

Caixa (POS web). Não é apenas uma página em cache, mas uma verdadeira fila de registros no dispositivo:

o pedido é registrado e vai para a fila de pedidos (vive no caixa por 24 horas);
recibo e turno de caixa — fila própria de operações (abertura de turno, suprimento e sangria, recibo, devolução, fechamento de turno). Cada operação tem uma chave de idempotência do cliente, por isso o reenvio não duplica nada;
turno aberto offline recebe um número temporário e continua funcionando: a trava "pagamento proibido sem turno aberto" também vale offline, ela calcula pelo cache local;
menu, preços, mesas, cadastros são lidos do cache local do navegador — eles foram para lá enquanto havia conexão;
recarregar a página não joga para a tela de login: o caixa abre em "sessão degradada" a partir do instantâneo local e se reconecta sozinho quando a rede voltar.

Impressão. O recibo, o ticket de cozinha e a etiqueta são impressos pela ponte que está no mesmo computador: o caixa a acessa pelo endereço local da máquina — não é preciso internet para isso.

Recibo fiscal. Se o registrador fiscal estiver conectado ao mesmo computador, o recibo é emitido pela ponte pelo mesmo canal local: a memória fiscal acumula documentos, e o operador fiscal os recupera quando a conexão aparecer. Para a 54-ФЗ, este é um modo normal, não uma infração.

Tela de login. Enquanto houver uma sessão recente no navegador (janela de 7 dias), o operador de caixa entra e trabalha; o envio do que foi acumulado ainda exigirá autenticação real quando a conexão voltar.

O que não funciona sem conexão#

Tela de cozinha (KDS). Os tickets chegam até ela pela nuvem; sem internet, novos pedidos não chegarão à cozinha — eles irão para lá quando a conexão voltar. Nesse meio-tempo, a cozinha trabalha com tickets impressos, se você tiver configurado a impressão na cozinha, ou com a passagem verbal.
Terminal bancário. O pagamento com cartão exige autorização no banco — offline ele não passa. Aceite dinheiro.
Pagamento online pelo cliente (cartão na vitrine, pagamento da conta do cliente pela mesa, pagamento no totem) — é preciso acesso ao provedor de pagamento.
Segundo caixa e tablet do garçom. Os dispositivos não se sincronizam entre si na rede local: cada um mantém sua própria fila e a reenvia sozinho. O contorno local compartilhado ("modo LAN") nós deliberadamente não fazemos — decisão do dono do produto: priorizamos a autonomia de um único caixa com impressão.
Relatório X. O corte intermediário é calculado no servidor com base nas vendas — offline o caixa recusa, honestamente. O turno pode ser fechado, o relatório Z será gerado quando a conexão voltar.
Seções do painel administrativo que calculam no servidor — "Pedidos", "Finanças", "Estatísticas", "Estoque", "Equipe". Elas leem a nuvem e, offline, mostram no melhor caso a última coisa que conseguiram ler.
Tela de entrega, painel de chamada, totem — também são superfícies na nuvem.

O que a equipe deve fazer#

Continue registrando. Assim que a conexão cai, aparece no caixa um banner âmbar "offline" e o chip "N não enviados". Este é o modo normal: o pedido foi aceito, o recibo foi impresso, o dinheiro foi recebido.
Imprima o recibo para o cliente como de costume. A impressão é local — o papel sai.
Trabalhe no mesmo dispositivo e no mesmo navegador. A fila fica neste computador: não dá para mudar para o segundo tablet e "enviar de lá".
Não limpe o cache do navegador, não saia da conta, não abra o caixa no modo anônimo — assim você apagará pedidos e recibos não enviados.
Recarregar a página pode. A fila sobrevive a recarregamento e reinício do navegador.
Não registre o mesmo pedido duas vezes "por precaução": o sistema é protegido contra duplicatas no reenvio, mas dois pedidos diferentes ele contará, honestamente, como dois.
Não aceite cartão — o terminal não autoriza offline. Dinheiro, e se o cliente quiser, uma fatura para pagamento posterior.
O banner vermelho "N não entregues" significa que parte dos registros não foi enviada mesmo após a conexão voltar (prazo expirado ou o servidor recusou). Isso é motivo para chamar o gerente, não para esconder o banner.

O que acontecerá quando a conexão voltar#

O reenvio começa sozinho — pelo evento "a rede apareceu", ao voltar para a aba e por temporizador.

O chip "N não enviados" diminui e desaparece. Os pedidos aparecem na seção "Pedidos" e na tela de cozinha, os recibos recebem números, o estoque é baixado pelas fichas técnicas.
Não haverá duplicatas. Cada pedido tem um identificador do cliente, cada operação de caixa tem uma chave de idempotência; o servidor reconhece a repetição e não a aplica uma segunda vez.
O turno offline é substituído pelo real. O número temporário do turno é reescrito pelo real em todos os recibos e movimentos ainda na fila.
O relatório Z é gerado para o turno fechado offline.
Nada é excluído em silêncio. Os registros que não puderam ser entregues (expiraram as 24 horas ou o servidor retornou um erro irrecuperável) vão para uma lista separada de "não entregues" (armazenada por 7 dias, até 100 registros) e são mostrados em um banner vermelho com a possibilidade de ocultá-lo manualmente.

A ordem é preservada: a fila é reenviada sequencialmente e, em erros temporários do servidor, repete a tentativa com pausa crescente.

Limitações#

O modo offline está fechado para o Caixa e para a impressão — e só. A tela de cozinha, o Terminal bancário e a sincronização entre Dispositivos na rede local não funcionam sem internet; um contorno completo de LAN conscientemente não é feito.
A fila está vinculada ao Dispositivo e ao navegador. Ela fica no armazenamento de um navegador específico: outro computador, outro navegador ou o modo anônimo não a veem.
O prazo de vida da fila é de 24 horas para Pedidos e operações de Caixa. Mais de um dia sem conexão — os Registros vão para a lista "não enviado", e não desaparecem silenciosamente.
A sessão offline dura 7 dias. Depois disso, o Caixa exigirá o login normal, e ele é impossível sem rede.
O relatório X offline não está disponível — ele é calculado no servidor.
As superfícies do cliente (vitrine, totem) mantêm a fila por apenas uma hora — elas são projetadas para uma falha breve da rede móvel do cliente, e não para operar sem internet.
Caixa Android. O recebimento de Pedido e o Recibo fiscal local offline funcionam, mas o Registro no registro de Recibos e o Turno de caixa offline ainda não (está planejado). A fonte da verdade offline ali é o armazenamento fiscal.
O teste ponta a ponta de "puxar o cabo" em um Registrador fiscal real ainda não foi feito. O modo offline do Caixa é coberto por código e testes automatizados (incluindo o e2e "offline dentro da sessão"), e a verificação em hardware real pelo proprietário está no plano — nós dizemos isso claramente, em vez de apresentá-la como concluída.

Solução de problemas#

O Caixa pede para entrar, embora funcionasse antes. A sessão tem mais de sete dias ou o navegador foi limpo. Sem rede não é possível entrar — restabeleça a conexão.

O chip "N não enviados" não diminui. Verifique se a conexão realmente voltou (abra qualquer site) e deixe a aba do Caixa ativa: o reenvio ocorre por evento de rede, retorno à aba e temporizador. Se o chip permanecer com o mesmo número — veja o banner vermelho: parte dos Registros pode ter ido para "não enviado".

Apareceu o banner vermelho "N não enviados". Os Registros não foram aceitos pelo servidor: o prazo de um dia expirou ou a resposta foi irrecuperável (por exemplo, o acesso foi revogado). Os Pedidos e Recibos dessa lista precisam ser lançados manualmente — confira com os Recibos em papel do Turno de caixa.

O Pedido foi lançado offline, mas não está na cozinha. É assim mesmo: o ticket irá para a tela de cozinha quando a conexão for restabelecida. Enquanto não há rede, a cozinha é alimentada pelos tickets impressos.

O Recibo não imprime offline. Então o problema não é a internet: verifique se a Ponte neste computador está em execução e se a Impressora está conectada — Cenaly Hardware Bridge. A Ponte e o Caixa se comunicam dentro da mesma máquina.

Depois de restabelecer a conexão, apareceram Pedidos duplicados. Não pode haver duplicatas por reenvio — verifique se o mesmo Pedido não foi lançado duas vezes à mão e cancele o excedente na seção "Pedidos".

Perguntas frequentes#

O Caixa funciona sem internet?#

Sim: lança Pedidos, imprime Recibos e os fiscaliza através da Ponte no mesmo computador. Tudo o que deve ir para a Nuvem se acumula na fila no Dispositivo e é reenviado automaticamente.

Os dados serão perdidos?#

Não. A fila sobrevive à recarga da página e à reinicialização do navegador, e o que não pôde ser enviado entra na lista visível "não enviado", em vez de desaparecer. Só é possível perdê-la manualmente — limpando os dados do navegador.

É possível lançar Recibos conforme a 54-ФЗ offline?#

Sim, se o Registrador fiscal estiver conectado ao mesmo computador que a Ponte: o armazenamento fiscal acumula documentos e os transmite ao operador de dados fiscais quando a conexão aparecer. Este é um regime previsto em lei.

Por que a tela de cozinha não funciona?#

Os tickets passam pela Nuvem. Não temos rede local entre o Caixa e a tela de cozinha — esta é uma decisão consciente: cobrimos a autonomia do Caixa com impressão, e não o salão inteiro. Enquanto não há rede, a cozinha se mantém com os tickets impressos.

Sim — a vitrine é distribuída via CDN e não depende da sua internet. O Pedido feito pelo cliente chegará à Nuvem, mas no estabelecimento você só o verá depois de restabelecer a conexão.

O que fazer com o pagamento por cartão?#

Aceitar dinheiro: o Terminal bancário precisa de autorização no banco.

Quanto tempo o Caixa aguenta sem conexão?#

Um dia para a fila de Pedidos e operações de Caixa, sete dias — para a sessão. Na prática, isso significa: você trabalhará um Turno tranquilo.

Seções relacionadas#

Caixa (POS) — Pedido, pagamento, modos de atendimento e a seção "Trabalho offline"
Turno de caixa e relatório Z — abertura, movimentações, relatórios X e Z
Cenaly Hardware Bridge — Ponte no computador do POS, Impressoras e Registradores fiscais
Impressão para a cozinha — tickets por estação, quando a tela de cozinha não está disponível
Tela de cozinha (KDS) — como os tickets chegam à cozinha
Primeiro dia: café, restaurante, refeitório — o que ativar logo de início