Pular para o conteúdo principal

Valores e vencimento

Cada cobrança carrega um conjunto de valores que contam a história da dívida — do que foi emitido ao que é devido hoje. Todos aparecem no card Valores do detalhe da cobrança.

Os cinco valores​

  • Valor Original (originalAmount) — o valor de emissão do título. Obrigatório e sempre positivo. Nunca muda.
  • Juros (interestAmount) — encargos acumulados pelo atraso.
  • Multa (fineAmount) — penalidade pelo não pagamento no prazo.
  • Desconto (discountAmount) — abatimentos concedidos.
  • Valor Atual (currentAmount) — o que é devido hoje:
Valor Atual = Valor Original + Juros + Multa − Desconto

Quando a cobrança é paga, o Valor Pago (paidAmount) registra quanto efetivamente entrou — que pode diferir do valor atual (pagamento parcial, acordo com desconto).

Nas mensagens da régua, é o Valor Atual que o devedor vê (variável {{charge.currentAmount}} nos templates), nunca um valor congelado no passado.

No pagamento parcial, o paidAmount fecha o título original como Paga (baixa parcial) e o saldo passa a ser uma cobrança-filha independente, com novo originalAmount (o próprio saldo, base imutável) e novo vencimento — em vez de o valor da mesma cobrança ser recalculado. Veja Pagamento e baixa.

Datas​

  • Data de Emissão (issueDate) — quando o título foi emitido. Obrigatória ao criar; nas importações, o padrão é a data do processamento.
  • Data de Vencimento (dueDate) — o marco central do ciclo de vida: define quando a cobrança vira Vencida e ancora os gatilhos da régua ("3 dias antes do vencimento", "7 dias depois").
  • Data de Pagamento (paidAt) — preenchida na baixa.

Dias em atraso (daysOverdue)​

O contador de dias corridos desde o vencimento de uma cobrança não paga. Ele aparece na lista de cobranças (coluna Dias Atraso), no detalhe, no aging do dashboard e nas condições da régua.

Como funciona:

  • É recalculado diariamente por um processo automático, junto com a atualização de juros, multa e status.
  • Cobrança em dia ou paga tem daysOverdue = 0.
  • Nas métricas de recuperação, o atraso no momento do pagamento é calculado direto das datas (pagamento − vencimento), para não subcontar pagamentos feitos no próprio dia.

Editando valores​

O formulário de edição da cobrança permite ajustar juros, multa, desconto e o valor pago manualmente — útil para refletir negociações feitas por fora ou políticas próprias de encargos. O Valor Total exibido no formulário recalcula na hora.

:::warning Valor errado segundo o devedor? Se o devedor contesta o valor, o caminho certo não é editar a cobrança: é registrar uma disputa do tipo "Valor errado". A disputa pausa a régua imediatamente, preserva a trilha de auditoria e, se procedente, ajusta o valor com decisão fundamentada. :::

Dados de pagamento​

Além dos valores, a cobrança pode carregar os meios de pagamento que tornam as mensagens "pagáveis": Método de Pagamento (Boleto, PIX, Cartão de Crédito, Transferência), Código de Barras, PIX Copia e Cola e Link de Pagamento. Preencha-os sempre que existirem — cobrança boa é a que o devedor consegue pagar no mesmo minuto em que lê a mensagem.