Recuperar o PDV quando algo trava#

APDV travado (não responde ao teclado nem ao toque)#

1. Espere 30 segundos. Um ciclo de sincronização ou uma cobrança TEF em andamento podem segurar a interface.
2. Olhe a barra de mensagens do caixa: se houver um aviso fixo (por exemplo, dívida de conciliação de TEF ou carga pendente), ele é a pista.
3. Feche o aplicativo pela janela e abra de novo por INICIAR_PDV_WINDOWS.bat (Windows) ou pelo ícone (Android). No Windows, não abra o pdv_flutter.exe direto.
4. Ao reabrir, confira o estado:
   • a venda em edição não volta (só o que foi segurado ou finalizado sobrevive);
   • o caixa e o turno voltam como estavam;
   • a fila de sincronização continua no banco local.
5. Abra Status do PDV e confira Carga do servidor, o indicador fiscal e o estado do operador.

BQueda de energia durante a venda#

1. Religue o terminal e abra o PDV pelo caminho normal.
2. Faça duas verificações separadas — elas respondem a perguntas diferentes, e nenhuma substitui a outra:

a) A venda existe? Procure a venda em Comprovantes e no Histórico local. b) O pagamento daquela operação foi confirmado? No Status do PDV, veja se há pendência de TEF e o desfecho dela.

1. Decida pelo cruzamento das duas:

1. Se houver pendência de TEF, reconecte a maquineta e deixe o PDV conciliar. Ao conseguir, ele avisa N pendência(s) TEF recuperada(s) com segurança. Enquanto houver pendência, nova cobrança fica bloqueada com O desfazimento do TEF ficou pendente. Reconecte a maquineta; uma nova cobrança ficará bloqueada até a conciliação.
2. Se a venda existir, não refaça nada — nem a venda, nem a cobrança. Se existir e o pagamento não estiver confirmado, siga a seção I.

CQueda de energia durante a apuração do turno (F9)#

1. Religue e autentique com o mesmo operador do turno.
2. O PDV reabre a apuração com o que já estava digitado — declaração, fundo e lacre foram salvos como rascunho no banco local.
3. Confira cada campo antes de concluir: Dinheiro, Fundo deixado para o próximo operador e Número do lacre do malote.
4. Conclua a saída normalmente.

DTela Modo seguro do caixa#

Se, ao abrir, o PDV mostrar a tela Modo seguro do caixa, isso não é travamento: é a proteção dos dados locais agindo. O caixa fica bloqueado para venda de propósito.

1. Leia a mensagem central. Ela diz qual é a situação:

1. Se aparecer o botão Tentar novamente, use-o. Ele refaz a verificação sem perder nada.
2. Se aparecer Ver diagnóstico, clique e anote os três valores: Estado, Código e Protocolo.
3. Se aparecer Chamar suporte, clique e aguarde. O protocolo é o que o suporte usa para localizar o caso.
4. Se aparecer Não foi possível registrar o diagnóstico agora. O caixa continua bloqueado., tente de novo — o caixa não libera venda enquanto isso.

EFalha do banco local#

O PDV trabalha com dois bancos locais separados: um de catálogo e um de movimento. Eles falham de forma independente, e o PDV diz qual dos dois está protegido.

FLer o Código do diagnóstico#

O campo Código usa um vocabulário fixo e seguro — ele identifica a situação sem expor dado sensível. Alguns exemplos do que você pode ver:

Se o campo mostrar não disponível, o código não pôde ser reportado — o Protocolo continua valendo.

GPDV lento ou "travando" em toda venda#

1. Abra Status do PDV e olhe Carga do servidor: Aguardando ou Parcial significa que faltam tabelas e cada venda tenta resolver o que não está local.
2. Confira a quantidade de pendências no rodapé (N eventos pendentes).
3. Verifique o disco: disco cheio é uma das classes de falha do banco local e degrada tudo.
4. Verifique o Histórico local e o Status operacional — eles mostram a origem do que o terminal está usando.
5. Não resolva lentidão desligando recursos de proteção. Chame a retaguarda com os dados acima.

HUm periférico parou de responder#

Siga Hardware e periféricos. O caminho é o diálogo Periféricos do PDV, com Testar por card e Testar todos.

Se o periférico que travou for a impressora e houver comprovante de turno pendente, use a 2ª via do último malote depois de resolver a impressora.

IPagamento com cartão sem desfecho#

1. Não repita a cobrança. O PDV bloqueia a próxima enquanto houver pendência.
2. Reconecte/religue a maquineta e aguarde a conciliação automática.
3. Se não resolver, chame a retaguarda com a mensagem exata exibida e o horário. Uma autorização sem venda gravada é desfeita; uma autorização com venda gravada é confirmada — quem decide é o diário, não a memória de quem atendeu.

JReinstalar ou reparear NÃO é o primeiro passo#

Reparear o terminal troca a credencial dele. Isso não conserta banco corrompido, não limpa fila e não libera modo seguro. Reinstalar pode apagar dados que ainda poderiam ser recuperados.

Existe um caso em que reparear é a resposta certa: quando o próprio PDV diz Credencial deste caixa foi revogada. Refaça o pareamento na retaguarda. Fora desse caso, escale.