Custo Efetivo dos Empréstimos

O fluxo vem do FINANCEIRO, não do cabeçalho nem da grade de parcelas

Por quêO líquido do cabeçalho muda de sentido entre CHQ e DUP. Os títulos são os que EmprestimoFinanceiroService grava em financeiro_emissao.

Ligaçãofe.idfaturamento = emprestimo.id e fe.idtipo_faturamento = emprestimo.idtipo_faturamento (o idfaturamento é compartilhado entre módulos; o relatório casa os dois). Só títulos vivos, tipo_emissao IN ('R','P').

LotesA leitura é em lotes de 500 empréstimos e 500 títulos.

Captação (226): entrada líquida e saídas

EntradaΣ títulos a receber − Σ títulos a pagar com idtipo_parcela = 1 (comissão e desconto), na data de entrada (data_entrada, senão data do empréstimo).

SaídasNo vencimento de cada título a pagar: principal (idtipo_parcela = 2), juros (3) e, com “IVA dos juros como custo”, IVA/renta (4). Vencimento nulo vale a data de entrada.

FIN/TERNesses tipos o a receber já vem líquido da comissão e o título de comissão desconta de novo: o custo sai como o financeiro o registra.

FIDC (22R): tipos 11173 e 11174

EntradaO título a receber (o líquido do borderô), na data de entrada.

SaídasTodos os títulos a pagar (líquido e juros de cada duplicata), no vencimento — sem separar por idtipo_parcela.

Taxa contratadaFIDC com taxa zerada mostra “por título”.

CET (TIR) — mês de 30 dias

CálculoTaxa mensal que zera o valor presente de todos os movimentos, com t = dias desde o primeiro movimento ÷ 30. Busca por bissecção, entre 0 e 1000% a.m. (custo positivo) ou entre −99% e 0 (negativo). Anual = (1 + mensal)^12 − 1.

Sem soluçãoSem entrada ou sem saída, ou sinais que não cruzam zero: a taxa fica em branco.

Dif. a.a. (p.p.)CET a.a. − taxa contratada anualizada, em pontos percentuais.

Taxa contratada anualizada

Contatipo_taxa = 'MEN' → (1 + taxa/100)^12 − 1; qualquer outro valor (hoje ANU) é tratada como taxa anual. Taxa zerada ou nula: em branco.

TextoColuna “Taxa contratada”: ex. 23,4940% a.a. ou 1,7600% a.m..

Prazo médio, Recebido, A pagar, Custo e % pago

Recebido / A pagar / CustoEntrada líquida; Σ das saídas; A pagar − Recebido.

Prazo médio (dias)Σ(valor da saída × dias entre a entrada e o vencimento) ÷ Σ saídas.

% pagoΣ amortizado de cada saída (limitado ao valor dela) ÷ A pagar. Amortizado = a conta do 221 (valor − acréscimo − juros + desconto + devolução + retenção) das baixas vivas.

Realizado a.a. — só empréstimo quitado

QuandoTodas as saídas amortizadas (amortizado ≥ valor − 0,01).

FluxoEntrada líquida na data de entrada e, para cada baixa das saídas, a data da baixa e o valor em dinheiro (b.valor, não o amortizado). Pagar antes do vencimento aumenta a taxa (mesmo custo em menos tempo).

Em brancoSe o empréstimo tem “problema” (abaixo), o realizado também fica em branco.

Observação: por que um empréstimo fica sem taxa e fora da carteira

sem valor recebidoEntrada líquida ≤ 0.

sem pagamentosNenhum título de saída reconhecido.

vencimento antes da entradaAlgum pagamento vence antes da data de entrada (em geral ano digitado errado; no central, 22 de 914 em 28/09, títulos de FIDC com 2025-01 × 2026-01).

vencimentos na data da entradaTodos os pagamentos na própria data de entrada (prazo médio zero).

EfeitoA linha sai com a Observação, não entra na Carteira nem em Por instituição; a linha da carteira informa “N fora da carteira”.

Carteira e Por instituição

CarteiraUm bloco por moeda: os fluxos dos empréstimos calculáveis são somados num só fluxo e a TIR é recalculada (não é média das taxas).

Por instituiçãoMesmo cálculo agrupado por razão social + moeda; ordenado pelo Recebido (decrescente); sem instituição: “(sem instituição)”.

Informe a data inicial. / Informe a data final.

QuandoPeríodo em branco (chamada direta).

A data final não pode ser anterior à inicial.

QuandoPeríodo invertido.

A filial N não está entre as filiais do usuário. / O usuário não tem filial de acesso.

QuandoFilial sem acesso ou usuário sem filial.

Não foram encontrados dados nessas condições.

QuandoNenhum empréstimo (fora o 1140) com e.data no período e nos filtros.

PegadinhaUm empréstimo cuja data_entrada cai no período mas cuja data não, não aparece.

Empréstimo com Observação não está na carteira

EfeitoO total da carteira não fecha com a soma de todas as linhas da grade. Conte as linhas com Observação (a linha “Carteira” já diz quantas ficaram de fora).

Sem período máximo

EfeitoDiferente dos outros 316x, não há teto de meses; um período longo traz centenas de empréstimos (no central, ~900 em 2025-01 a 2026-09, ~12 s).

Tipos fixos no código

EfeitoFIDC = tipos de faturamento 11173 e 11174; empréstimo a cliente = 1140. São ids chumbados: tenant com outros ids classifica errado (a opção “Só FIDC” não acha nada, e FIDC cai como captação). Confira em docs/regras-chumbadas.html antes de mexer.

T1 — Conferência à mão de um empréstimo simples

ComoGere 01/09/2026 a 30/09/2026, filial do empréstimo NC.11696254 (tipo 1118, id 10011246). Veja o fluxo que o financeiro gravou (SQL abaixo).

EsperadoEntrada 24/09/2026 de 2.026.449,73; saída em 14/10/2026 de 2.026.449,73 (principal) + 26.449,73 (juros) = 2.052.899,46, em 20 dias. Recebido 2.026.449,73; A pagar 2.052.899,46; Custo 26.449,73; Prazo médio 20,0. CET a.m. = (2.052.899,46 ÷ 2.026.449,73)^(30/20) − 1 ≈ 1,96%; a.a. ≈ 26,29%. Taxa contratada 23,4940% a.a. → Dif. ≈ +2,80 p.p. % pago 0 (ainda não venceu). Realizado em branco.

SELECT fe.tipo_emissao, fe.idtipo_parcela, DATE(fe.data_vencimento) AS venc, fe.valor_parcela
  FROM financeiro_emissao fe
 WHERE fe.idfaturamento = 10011246 AND fe.idtipo_faturamento = 1118
   AND fe.excluido <> 'T' AND fe.tipo_emissao IN ('R','P')
 ORDER BY fe.data_vencimento, fe.tipo_emissao

T2 — Tipos de empréstimo no período

ComoCompare a distribuição por tipo (SQL abaixo) com as linhas da grade em “Captação e FIDC”, depois com “Só captação” e “Só FIDC”.

EsperadoCaptação = tipos fora de 11173/11174; FIDC = só esses; nenhuma linha de 1140. Referência em 04/10/2026 no central, 01/01/2025 a 27/09/2026: tipo 1118 = 87, 11173 = 553, 11174 = 280, 1143 = 8 (os números mudam com a base).

SELECT e.idtipo_faturamento, COUNT(*) AS n
  FROM emprestimo e
 WHERE e.excluido <> 'T' AND e.idtipo_faturamento <> 1140
   AND e.data >= '2025-01-01' AND e.data < DATE_ADD('2026-09-27', INTERVAL 1 DAY)
 GROUP BY e.idtipo_faturamento

T3 — IVA dos juros como custo

ComoNum empréstimo com título a pagar de idtipo_parcela = 4, gere com a caixa ligada e desligada.

EsperadoDesligada: A pagar menor, CET menor, título do relatório com “(sem o IVA dos juros)”. Em FIDC a caixa não muda nada (todas as saídas entram).

T4 — Empréstimo sem conta

ComoUse (ou monte numa base de teste) um empréstimo com vencimento anterior à entrada.

EsperadoLinha com taxas em branco e Observação “vencimento antes da entrada”; fora da Carteira; a linha da Carteira diz “1 fora da carteira” (contando os da mesma moeda).

T5 — Carteira soma só os calculáveis

ComoGere um período com vários empréstimos de uma moeda.

EsperadoRecebido e A pagar da Carteira = soma das linhas sem Observação. A taxa da Carteira não é a média das taxas: é a TIR do fluxo somado.

T6 — Realizado × CET

ComoNum empréstimo quitado com pagamento antes do vencimento, compare CET a.a. e Realizado a.a. %.

EsperadoRealizado a.a. maior que o CET a.a. (mesmo custo em menos dias). Empréstimo não quitado: Realizado em branco.

T7 — Período pela data do empréstimo

ComoEscolha um empréstimo e gere um período que contenha data_entrada mas não data.

EsperadoNão aparece. Com um período que contenha data, aparece.

T8 — Recusas

ComoPeríodo invertido; datas em branco; período sem empréstimos; filial sem acesso.

EsperadoAs mensagens da seção D.