Checkout: Recuperação de Vendas após Encerramento Inesperado | 129742 | Checkout
1. CONTEXTO
Para proporcionar maior continuidade às operações de venda no Resulth Checkout, o sistema passa a contar com um mecanismo automático para gravação e recuperação de vendas em andamento.
Durante a operação, os dados da venda são registrados automaticamente e, em caso de encerramento inesperado do sistema, podem ser recuperados no próximo login do operador, respeitando o terminal, a série de NFC-e e a filial da venda original.
Dessa forma, itens, cliente e formas de pagamento já informados podem ser restaurados automaticamente, permitindo que o operador retome a operação de acordo com o estado da venda e do caixa.
2. O QUE MUDOU
Gravação automática da venda: a partir da inclusão do primeiro item, o sistema registra os dados da venda em andamento em estruturas temporárias, incluindo itens, cliente, pagamentos, descontos e complementos.
Identificação de venda pendente: no login, o sistema verifica automaticamente a existência de uma venda não finalizada vinculada ao mesmo terminal, série de NFC-e e filial.
Recuperação conforme o estado do caixa: com o caixa aberto, a recuperação ocorre imediatamente. Com o caixa fechado, o processo aguarda a abertura do caixa para ser realizado.
Recuperação das formas de pagamento: informações de TEF, Smart TEF, PIX, carteira digital, cheque e contas a receber são restauradas e vinculadas novamente à venda.
Tratamento de NFC-e já emitida: quando a NFC-e já tiver sido transmitida pelo servidor, o sistema conclui automaticamente os processos locais relacionados à venda, conforme as regras da recuperação.
Registro da recuperação: cada recuperação de venda é registrada em Utilitários > Logs do Sistema, disponível exclusivamente no Checkout.
3. COMO ACESSAR
ℹ |
Esta funcionalidade é automática e não requer configuração ou ativação de parâmetro. O sistema realiza a verificação e a recuperação de vendas pendentes conforme as condições previstas nas regras da funcionalidade. |
Para acompanhar os logs de recuperação: acesse o caminho abaixo.
Caminho: Utilitários > Logs do Sistema (Apenas Checkout) |
4. COMO USAR
A seguir, o fluxo de recuperação de acordo com o estado do caixa no momento do login:
Cenário A: Login com caixa já aberto
O operador realiza o login no Resulth Checkout após um encerramento inesperado.
O sistema verifica automaticamente se há uma venda não finalizada para o terminal, série e filial configurados.
Se uma venda pendente for encontrada e o caixa estiver aberto, a mensagem abaixo é exibida:
Mensagem exibida ao operador quando o caixa está aberto no momento do login.
A recuperação é processada automaticamente logo após a exibição da mensagem.
A tela de venda é aberta com os dados recuperados. Se já existirem formas de pagamento informadas, a tela de encerramento da venda será aberta automaticamente.
Cenário B: Login com caixa fechado
O operador realiza o login no Resulth Checkout após um encerramento inesperado.
O sistema identifica a existência de uma venda pendente, mas o caixa está fechado. A mensagem abaixo será exibida:
Mensagem exibida ao operador quando o caixa está fechado no momento do login.
A recuperação da venda fica aguardando a abertura do caixa.
Ao abrir o caixa, o sistema realiza automaticamente a recuperação da venda pendente, seguindo o mesmo fluxo do Cenário A.
Resumo dos cenários
Cenário |
Condição |
Comportamento do sistema |
Resultado |
Login pós-falha — caixa já aberto |
Há venda pendente detectada + caixa está ABERTO |
Mensagem informativa é exibida e a recuperação é processada imediatamente |
Venda exibida na tela, pronta para conclusão |
Login pós-falha — caixa fechado |
Há venda pendente detectada + caixa está FECHADO |
Aviso exibido e recuperação adiada até a abertura do caixa |
Ao abrir o caixa, recuperação é disparada automaticamente |
NFC-e já emitida pelo servidor |
A API emissora confirma que a nota já foi transmitida |
Sistema finaliza processos locais: baixa de estoque, financeiro, confirmação de TEF e impressão do DANFE |
Ciclo da venda encerrado corretamente |
Venda não transmitida |
A API emissora confirma que a NFC-e não foi enviada |
Venda exibida na tela de venda com todos os dados preenchidos, disponível para edição ou finalização |
Operador decide se conclui ou cancela a venda |
Gerenciamento de formas de pagamento na recuperação
Forma de pagamento |
Comportamento na recuperação |
Se a venda for cancelada |
TEF / Smart TEF |
Transações em aberto são recuperadas e vinculadas novamente à venda |
Transações TEF são canceladas automaticamente |
PIX |
Dados do PIX são recuperados e vinculados à venda |
Dados do PIX são descartados |
Carteira digital |
Informações da carteira digital são restauradas na venda |
Registros da carteira são removidos |
Cheque |
Dados do cheque informado são recuperados |
Registros do cheque são removidos |
Contas a receber |
Vínculos de contas a receber são recuperados |
Registros de contas a receber são removidos |
5. REGRAS DE NEGÓCIO
A gravação dos dados temporários se inicia no momento em que o primeiro item é adicionado à venda.
A verificação de venda pendente é realizada por terminal, série de NFC-e e filial. Cada combinação é tratada de forma independente.
Antes de exibir a venda recuperada, o sistema consulta a API emissora (consultarNFCe) para verificar se a nota já foi ou não transmitida.
Se a NFC-e já tiver sido transmitida (com ou sem rejeição), a venda recuperada não pode ser alterada. O sistema finaliza os processos locais automaticamente.
Se a numeração da NFC-e estiver associada a uma nota substituída, o sistema avança para a próxima numeração disponível, tratando os casos de nota pendente, cancelada ou inutilizada conforme as regras aplicáveis.
Movimentos provisórios de estoque e financeiro gerados durante a venda são desfeitos durante a recuperação e refeitos apenas se a venda for efetivamente concluída pelo operador.
Após a conclusão da venda recuperada (com emissão de NFC-e), todos os dados temporários são apagados do banco de dados.
6. BOAS PRÁTICAS E OBSERVAÇÕES
⚠ |
Se o operador cancelar uma venda recuperada que contenha transações TEF em aberto, essas transações serão canceladas automaticamente. Nenhuma ação manual é necessária. |
💡 |
Para consultar o histórico completo de recuperações realizadas, acesse Utilitários > Logs do Sistema (disponível exclusivamente no Checkout). |
A recuperação é vinculada ao mesmo terminal, série e filial da venda original. Se o operador fizer login em outro terminal, a recuperação não será disparada.
O recurso protege contra falhas inesperadas, mas não substitui boas práticas operacionais, como fechar o caixa corretamente ao final do turno.
Caso a venda recuperada apresente divergências (ex.: item sem estoque), o operador pode editar ou cancelar a venda antes de finalizá-la.
A impressão do DANFE e dos comprovantes de TEF e contas a receber ocorre automaticamente quando a NFC-e já havia sido emitida e os dados são recuperados, garantindo que o ciclo documental esteja completo.