Visão geral

Crédito Excedente é um saldo financeiro que fica registrado para o cliente (titular) quando existe um valor excedente que não foi aplicado integralmente em débitos no momento do processamento.

Em termos práticos, é o que o sistema trata como Saldo da conta.

Onde o crédito excedente pode aparecer

Hoje o Crédito Excedente aparece principalmente em:

1. Terminal de Caixa

• A forma de pagamento Saldo da conta usa o saldo disponível do Crédito Excedente.

2. Contas a Receber

• Baixa do título (detalhe): no modal de pagamento existe a opção Usar saldo excedente neste pagamento.
• Busca/lista (inclui lote): é possível selecionar débitos e fazer Receber em lote (com suporte a saldo excedente quando o lote é do mesmo titular).
• Aba Baixas: passou a refletir melhor o status real de estorno e a bloquear exclusão direta quando a baixa ou o documento usam crédito excedente.

3. Sócio

• Aba Débitos: permite iniciar a baixa de um débito e usar saldo excedente no modal de pagamento.
• Aba Saldo Excedente: mostra um extrato administrativo do saldo (geração, uso e estornos), com filtros e links para as movimentações relacionadas.

4. Cálculo de Mensalidades

• Na prévia do cálculo, pode existir abatimento previsto por crédito excedente (quando a empresa está habilitada para isso).

Como habilitar na empresa (pré-requisito)

Para o recurso funcionar nas telas de baixa (Terminal de Caixa / Contas a Receber / Sócio) e (opcionalmente) impactar o Cálculo de Mensalidades, a empresa precisa estar parametrizada em:

Cadastros > Empresa > Empresa > (Alterar) > Preferências Financeiras > Crédito excedente

Marque:

• Habilitar crédito excedente
• Habilitar crédito excedente no cálculo (se quiser considerar no cálculo)

Depois clique em Salvar.

Como ele é gerado (origens mais comuns)

O Crédito Excedente pode ser gerado quando o sistema identifica uma sobra após processar pagamentos e abatimentos.

Exemplos comuns:

• Retorno bancário (boleto): quando o retorno traz duplicidade de baixa para o mesmo débito/pagamento (ex.: duas confirmações para o mesmo lançamento). O sistema mantém a baixa válida e transforma o excedente em Crédito Excedente para não perder o valor.
• Retorno bancário (débito em conta): cenário equivalente ao boleto, quando ocorre duplicidade de baixas no processamento do retorno.
• Conciliação de PIX: se houver duplicidade de baixas/confirmações (mais de uma baixa para o mesmo débito), a sobra é convertida em Crédito Excedente.

Em todos os casos acima, a lógica é a mesma: quando há uma sobra real de valor após as baixas válidas serem aplicadas, o sistema registra essa sobra como saldo do cliente (Crédito Excedente).

Observação

O Crédito Excedente é do cliente. Ele não "pertence" ao processo que o gerou.

Como ele é consumido

O consumo acontece sempre como pagamento de débito (abatimento em contas a receber), respeitando:

• saldo disponível;
• regras de elegibilidade da empresa;
• limites do débito (principal remanescente).

Como funciona o estorno

Se um pagamento que utilizou Saldo da conta for estornado/cancelado, o sistema recompõe o saldo historicamente (quando existir trilha de utilização).

Pontos práticos:

• a aba Baixas prioriza o status final calculado pelo backend;
• exclusão direta não é o caminho correto quando houver uso de crédito excedente na baixa ou no documento;
• quando necessário, a operação deve ser feita por Estornar.