Pular para o conteúdo principal

Regras e comportamentos

Esta seção consolida as regras operacionais do Crédito Excedente.

1) O saldo sempre pertence ao cliente​

  • O saldo é do cliente (titular) e é reutilizável em outras operações.
  • O sistema não "amarra" o saldo ao módulo que originou o crédito.

2) Habilitação do recurso por empresa​

Para existir consumo do saldo, a empresa precisa estar habilitada para Crédito Excedente.

Quando o cliente reclamar que "o saldo não aparece", o primeiro diagnóstico é validar se a empresa está habilitada para o recurso.

3) Política de elegibilidade​

Existe uma política de elegibilidade para o consumo.

Estado atual:

  • Política 0: consumo restrito ao próprio cliente (self-only).
  • Política 1: reservada para titular + dependentes, ainda não suportada.

4) Consumo respeita limite do débito (principal)​

O Crédito Excedente pode pagar um débito com:

  • principal;
  • juros;
  • multa;
  • correção monetária (quando existir).

Trava importante:

  • o principal consumido não pode ultrapassar o principal remanescente do débito.

5) Consumo é FIFO (ordem de uso do saldo)​

Quando existe mais de um crédito disponível, o sistema usa o saldo em ordem FIFO (o mais antigo primeiro).

6) Guardrails por tela​

6.1) Terminal de Caixa (Saldo da conta)​

  • Exige estação PDV válida.
  • A forma Saldo da conta precisa estar habilitada na estação.
  • Bloqueia quando o valor digitado é maior que o saldo disponível.
  • Exige que os débitos selecionados sejam do mesmo cliente.

6.2) Contas a Receber (título e lote)​

  • A aplicação do saldo excedente acontece ao marcar Usar saldo excedente neste pagamento.
  • Ao marcar, o modal passa a exibir: valor em aberto, saldo utilizado e valor restante.
  • Quando houver "valor restante", é necessário completar com pagamento convencional (conta/forma).

Em lote

  • O uso de saldo excedente em lote exige que todos os débitos sejam do mesmo titular.

7) Baixa ou documento que usa crédito excedente: como cancelar​

  • Baixas que usam crédito excedente não devem ser excluídas diretamente.
  • O bloqueio pode acontecer pelo pagamento em si ou pelo documento de recebimento ao qual aquela baixa pertence.
  • Em termos práticos: se existir trilha oficial de uso do saldo excedente naquela baixa ou naquele documento, o caminho correto é Estornar.
  • A exclusão direta só deve ser usada quando a operação não tem participação de crédito excedente.

8) Estorno histórico​

Quando uma utilização é estornada, o saldo é recomposto com base no histórico real da utilização, e não apenas na configuração atual da empresa.

9) Como a aba Baixas interpreta estorno​

  • A aba Baixas confia no status final calculado pelo backend.
  • Isso evita falso estorno visual em baixas com crédito excedente.
  • Em suporte, não use apenas cancelamento bruto ou leitura manual da linha como prova de estorno; considere o status devolvido pela tela.

10) Monitoramento no detalhe do sócio (Saldo Excedente)​

No detalhe do sócio, a aba Saldo Excedente serve como leitura administrativa do extrato do saldo, incluindo:

  • geração de crédito;
  • utilização (pagamentos usando saldo);
  • estornos;
  • cancelamentos.

Regras de uso na tela:

  • os filtros só são aplicados após clicar em Buscar;
  • Carregar mais expande a lista de registros carregados;
  • os botões de Ações abrem as movimentações relacionadas em outra aba.