Aging de Títulos

Saldo do título = a conta do 221, até a data de referência

Contafe.valor_parcela − Σ(b.valor − b.valor_acrescimo − b.valor_juros + b.valor_desconto + b.valor_devolucao + b.valor_retencao) sobre as baixas vivas (b.excluido <> 'T') com b.data_baixa < referência + 1 dia.

Não usafinanceiro_emissao.valor_pendente — está zerada no central.

Só entrasaldo > 0,005. Título quitado, ou com baixa maior que a parcela, some.

Quais títulos entram

Filtros fixosfe.excluido <> 'T', fe.tipo_emissao = R|P, fe.data_emissao < referência + 1 dia (faixa meio-aberta: o título emitido no próprio dia entra), fe.idfilial IN (filiais do usuário ou a escolhida).

A receber descontadoIFNULL(fe.descontado,'') = 'T' fica fora no tipo R (o risco foi para o banco). No tipo P não há esse corte.

Não filtraidtipo_faturamento: entram títulos de qualquer origem (venda, compra, empréstimo, avulso, adiantamento). O relatório não olha idfaturamento, então a regra de “idfaturamento junto com tipo” não se aplica aqui.

Faixas de atraso

Diasdias = referência − DATE(fe.data_vencimento). Título sem vencimento conta 0 dia (a vencer).

Limitesdias ≤ 0 → A vencer (inclui o que vence na própria data) · 1–30 · 31–60 · 61–90 · > 90.

% vencido(Total − A vencer) ÷ Total, 2 casas. Maior atraso = maior número de dias entre os títulos do grupo (nunca negativo).

Vendedor e região do grupo

VendedorCOALESCE(NULLIF(fe.idvendedor,0), e.idvendedor, 0) — o do título; sem ele o do cadastro do cliente; sem os dois: “(sem vendedor)”.

Regiãocidade.idregiao da cidade do cliente (emitente.idcidade); sem cidade ou região: “(sem região)”.

Sem nomeCliente sem razão social aparece como “(sem emitente)”.

Sintético: uma linha por grupo e por moeda

Chaveid do grupo + moeda: o mesmo cliente com títulos em duas moedas aparece em duas linhas.

Total geralSai por moeda (QuebrasDaGrade.totalGeral(...).separandoMoedaPela). Moedas diferentes nunca são somadas.

OrdemAlfabética pelo nome do grupo (sem opção de ordenar no painel).

Analítico: um título por linha

ColunasGrupo, Cliente/Fornecedor, Documento, Parc., Vencimento, Dias, Moeda (só no XLS), uma coluna por faixa (o valor cai só na faixa do título), Total, Id.

OrdemNome do grupo, emitente, vencimento, id. Subtotal por grupo, por moeda.

Curva ABC e concentração

ValorSaldo × IF(fe.valor_cambio > 0, fe.valor_cambio, 1) do título — moeda local pelo câmbio gravado no título, não pela cotação do dia.

ClasseA enquanto o acumulado antes do grupo é < 80%; B até 95%; C o resto (quem cruza a fronteira fica na classe de baixo do corte). Grupos com saldo ≤ 0 saem.

Folha ConcentraçãoQuantidade e valor por classe, participação do maior, dos 5, 10 e 20 maiores (só se houver grupos suficientes), Total, Vencido e o HHI (Σ participação² em %; > 2.500 concentrada, 1.500–2.500 moderada, < 1.500 pulverizada).

ScoreTambém sai na curva quando é Cliente + A receber.

Score de crédito (coluna Score)

Escala0 a 100, faixas A 80+, B 60–79, C 40–59, D < 40. Cinco componentes com os pesos de system_config.SCORE_CREDITO_PESOS (padrão 35,25,15,10,15): atraso, uso do limite, pontualidade dos últimos 12 meses, relacionamento (24 meses = 100) e parecer B2E de 12 meses.

Quando faltaCliente sem score calculado sai com a célula em branco.

Documentação própriaDetalhe do cálculo em docs/historico/292-… e na janela Score do 2332/15.

Informe a data de referência.

QuandoPosição em branco (chamada direta; a tela já nasce com hoje).

Data de referência inválida: 2026-13-01 (confira o ano).

QuandoData fora do padrão yyyy-MM-dd ou inexistente.

A filial N não está entre as filiais do usuário.

QuandoFilial escolhida sem acesso em usuario_filial.

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

QuandoNenhum título com saldo na data e nos filtros — e também na Curva ABC quando todos os grupos ficam com saldo ≤ 0.

PegadinhaPosição em data anterior à emissão dos títulos devolve vazio; confira a data antes de suspeitar do filtro.

Formato desconhecido gera planilha

O que aconteceQualquer formato diferente de pdf vira XLS — não há mensagem de “formato inválido” nestes relatórios (o padrão do corpo é xls).

Cliente em duas moedas, duas linhas; sem conversão

EfeitoQuem esperava um total único em moeda local não o encontra no sintético. Use Moeda filtro ou a Curva ABC (que converte pelo câmbio do título).

Câmbio do título, não cotação do dia (só na Curva ABC)

EfeitoTítulo em moeda estrangeira com valor_cambio zerado vale câmbio 1 e subestima a curva. Não há aviso de “cotação faltando” neste relatório.

Tempo de geração

MedidoNo central, ~31 mil títulos a receber em aberto no tenant inteiro: ~12 s; Curva ABC com score da filial 3 (191 clientes): ~35 s. A tela mostra Gerando… (Ns).

T1 — O total bate com uma SQL independente

ComoGere o sintético A receber, Cliente, filial 3, posição em 31/08/2026, sem Moeda filtro. Compare com a SQL abaixo.

EsperadoIgualdade ao centavo, por moeda. Referência medida em 04/10/2026 no central: moeda 111 — 2.827 títulos, total 165.422.416,44, A vencer 3.535.277,55, 1 a 30 680.559,78, mais de 90 147.971.304,91. Os números mudam se alguém lançar ou baixar com data retroativa.

SELECT t.idmoeda, COUNT(*) AS n, ROUND(SUM(t.pend),2) AS total,
       ROUND(SUM(IF(t.dias<=0,t.pend,0)),2) AS a_vencer,
       ROUND(SUM(IF(t.dias BETWEEN 1 AND 30,t.pend,0)),2) AS f_1_30,
       ROUND(SUM(IF(t.dias>90,t.pend,0)),2) AS mais_90
FROM (SELECT fe.idmoeda, DATEDIFF('2026-08-31', DATE(fe.data_vencimento)) AS dias,
             fe.valor_parcela - IFNULL((SELECT SUM(b.valor)-SUM(b.valor_acrescimo)-SUM(b.valor_juros)
                                              +SUM(b.valor_desconto)+SUM(b.valor_devolucao)+SUM(b.valor_retencao)
                                         FROM financeiro_baixas b
                                        WHERE b.idfinanceiro_emissao = fe.id AND b.excluido <> 'T'
                                          AND b.data_baixa < DATE_ADD('2026-08-31', INTERVAL 1 DAY)), 0) AS pend
        FROM financeiro_emissao fe
       WHERE fe.excluido <> 'T' AND fe.tipo_emissao = 'R' AND IFNULL(fe.descontado,'') <> 'T'
         AND fe.idfilial = 3 AND fe.data_emissao < DATE_ADD('2026-08-31', INTERVAL 1 DAY)) t
WHERE t.pend > 0.005
GROUP BY t.idmoeda

T2 — Posição passada não enxerga baixa futura

ComoAche um título com baixa depois da data (SQL abaixo). Gere com a referência anterior à baixa e depois com hoje.

EsperadoNa data anterior o saldo é a parcela inteira (ou menos as baixas anteriores); em hoje o saldo cai pelo valor amortizado. O título some quando quita.

SELECT fe.id, fe.documento, fe.parcela, fe.valor_parcela, b.data_baixa, b.valor
  FROM financeiro_baixas b JOIN financeiro_emissao fe ON fe.id = b.idfinanceiro_emissao
 WHERE b.excluido <> 'T' AND fe.excluido <> 'T' AND fe.tipo_emissao = 'R'
   AND b.data_baixa >= '2026-09-01' AND fe.data_emissao < '2026-08-01' AND fe.idfilial = 3
 LIMIT 5

T3 — Limites das faixas

ComoEscolha (ou crie) títulos vencidos 0, 1, 30, 31, 60, 61, 90 e 91 dias antes da referência.

Esperado0 → A vencer; 1 e 30 → “1 a 30”; 31 e 60 → “31 a 60”; 61 e 90 → “61 a 90”; 91 → “Mais de 90”. No analítico a coluna Dias mostra o número e o valor cai numa só coluna de faixa.

T4 — Descontado e tipo

ComoMarque um título a receber com descontado='T' (ou use um existente) e gere A receber; depois gere A pagar.

EsperadoO descontado não aparece no A receber. No A pagar o relatório usa tipo_emissao = 'P', rótulo “Fornecedor”, e não mostra a coluna Score.

T5 — Moeda

ComoCliente com títulos em duas moedas. Gere sem filtro e depois com Moeda filtro.

EsperadoSem filtro: duas linhas do cliente e total geral por moeda. Com filtro: só a moeda escolhida.

T6 — Vendedor e região

ComoAgrupe por Vendedor com um título sem idvendedor de cliente com vendedor no cadastro, e outro de cliente sem vendedor.

EsperadoO primeiro entra no vendedor do cadastro; o segundo em “(sem vendedor)”. Em Região, cidade sem região → “(sem região)”. O filtro Vendedor usa a mesma regra (título, senão cadastro).

T7 — Curva ABC

ComoMarque Curva ABC (sem Analítico) numa filial de uma moeda só.

EsperadoA soma de Saldo igual ao total do sintético (câmbio 1); % acumulado da última linha = 100; classe A termina quando o acumulado anterior chega a 80%; a folha Concentração fecha Total = soma das classes e traz o HHI. Referência de 27/09 no central, filial 3, 31/08: 191 clientes, A = 13 (82,2%), 5 maiores = 51,9%, HHI 839.

T8 — Recusas

ComoLimpe a data; escolha uma filial sem acesso (chamada direta); gere numa data anterior a todos os títulos.

EsperadoAs mensagens da seção D, sem arquivo gerado.

T9 — Score só no cliente a receber

ComoGere Cliente + A receber; depois Vendedor, Região e A pagar.

EsperadoColuna Score só no primeiro caso, no formato “número faixa” (ex.: 47 C).