Skip to main content

🛑 Cancelamento e Estorno de Pedidos

Cancelar uma venda em uma escola de esportes náuticos não é apenas "apagar um registro". Um pedido cancelado pode afetar o estoque da loja, retirar créditos de um aluno, cancelar aulas na agenda e até mesmo reverter comissões já calculadas para os instrutores.

Por isso, a Pororoca possui um Motor de Cancelamento Avançado que garante a segurança financeira e operacional da sua escola, agindo em cascata para desfazer todas as ações atreladas a uma fatura.

🔒 Quem pode cancelar um pedido?​

Para evitar fraudes e erros de operação no caixa, o sistema possui regras de acesso (RBAC) rígidas:

  • Recepção (RECEPTIONIST): Só tem permissão para cancelar pedidos com status PENDENTE (ou seja, vendas que foram lançadas no sistema, mas nenhum valor foi recebido ainda). Muito útil para corrigir erros de digitação antes do pagamento.
  • Administrador (ADMIN / SUPER_ADMIN): Tem permissão total para estornar transações PAGAS (PAID) ou PARCIALMENTE PAGAS (PARTIAL), ativando o motor de reversão de fundos e de serviços.

⚙️ Como o Cancelamento Funciona na Prática?​

Quando um gestor clica em "Cancelar Pedido" no módulo Financeiro / Pedidos, o sistema não exclui a fatura (pois o histórico é sagrado). Em vez disso, ele abre um modal com opções estratégicas.

1. A Justificativa (Motivo)​

O sistema exige que o operador digite um motivo obrigatório (Ex: "Cliente desistiu por conta da chuva"). Esse motivo, junto com o nome de quem cancelou e o horário da ação, fica salvo para sempre no registro do pedido (Log de Auditoria).

2. Retorno ao Estoque​

O operador deve escolher se os itens físicos daquele pedido devem voltar para a prateleira:

  • Devolver ao inventário: O sistema incrementa a quantidade de volta no estoque (Ex: A camisa UV não foi usada e voltou para o cabide).
  • Não devolver: Útil se o cliente cancelou um pacote de aulas, mas consumiu uma garrafa de água que estava no mesmo pedido.

3. O Método de Reembolso (Para pedidos pagos)​

Se a escola já recebeu o dinheiro, o gestor define como o estorno será tratado:

  • Crédito na Carteira (Wallet Credit): O dinheiro não sai do caixa da escola. O valor pago vira um "saldo positivo" no perfil do aluno, que ele poderá usar na próxima compra.
  • Reembolso Manual (Manual Refund): O pedido muda para o status de Aviso de Reembolso, alertando o gestor de que ele precisa realizar um PIX ou estorno no cartão de crédito do cliente para zerar a pendência.

PDV

🔄 A Cascata de Cancelamento Automático​

Ao confirmar o cancelamento, a Pororoca executa uma reversão inteligente (Rollback) em todo o sistema:

🏄‍♂️ Aulas e Agendamentos​

  • Se o pedido incluía a matrícula de uma aula futura, os pagamentos lançados na mesma voltam para o status "pendente", porém o cancelamento não é realizado automaticamente, possibilitando possíveis ajustes e cancelamento manual.
Cuidado

Trava de Segurança

Se o aluno já participou da aula (Status: Concluída), o sistema bloqueia o cancelamento total da fatura. O serviço já foi prestado e o professor já trabalhou. Nesses casos, apenas estornos parciais ou negociações manuais são permitidos.

💳 Créditos e Pacotes​

Se o pedido era a compra de um Pacote de Aulas (Ex: Pacote de 10 Aulas):

  • O sistema retira instantaneamente os 10 créditos do saldo do aluno.
  • O histórico financeiro do aluno (Ledger) registra um "Débito por estorno de cancelamento".
  • Se o aluno já agendou e usou algumas dessas aulas antes do cancelamento, o saldo de créditos dele poderá ficar negativo, alertando a recepção de que ele "deve" aulas à escola.

🏆 Comissões da Equipe​

  • As comissões (de vendas ou de instrutores) que estavam provisionadas (PENDING ou APPROVED) para este pedido são automaticamente marcadas como Canceladas. A escola não paga comissão por venda estornada!
  • Alerta: Se o gestor da escola já tiver transferido o dinheiro da comissão para o instrutor (Status: Pago), o sistema emitirá um alerta severo exigindo atenção manual para aquele acerto de contas.