Checkout: Recuperação de Vendas após Encerramento Inesperado

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

  1. O operador realiza o login no Resulth Checkout após um encerramento inesperado.

  2. O sistema verifica automaticamente se há uma venda não finalizada para o terminal, série e filial configurados.

  3. Se uma venda pendente for encontrada e o caixa estiver aberto, a mensagem abaixo é exibida:


img

Mensagem exibida ao operador quando o caixa está aberto no momento do login.


  1. A recuperação é processada automaticamente logo após a exibição da mensagem.

  2. 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

  1. O operador realiza o login no Resulth Checkout após um encerramento inesperado.

  2. O sistema identifica a existência de uma venda pendente, mas o caixa está fechado. A mensagem abaixo será exibida: 


img

Mensagem exibida ao operador quando o caixa está fechado no momento do login.


  1. A recuperação da venda fica aguardando a abertura do caixa. 

  2. 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.


API do Resulth Windows: Novo endpoint de Contas a Pagar
Lançamento de Notas Fiscais Emitidas: Consulta de IBS e CBS