Fluxo de Caixa Projetado

Faixas do horizonte

Primeira faixaComeça hoje e o horizonte termina em hoje + dias − 1 (30 dias = 30 dias contando hoje).

Semana / MêsSemana de segunda a domingo (a primeira pode ter menos de 7 dias); Mês de calendário (o último termina no último dia do horizonte). O título vence na faixa em que cai.

Pedido sem faixaParcela após o horizonte é ignorada.

Saldo inicial = contas marcadas, convertido

ContaSoma do movimento até hoje, só na moeda da própria conta (desde 04/10/2026): lançamentos financeiro_lancamento_banco (operacao='E' soma, o resto subtrai) mais baixas financeiro_baixas (R soma, P subtrai), vivos, com data < amanhã. É a conta do Boletim 3172.

QuaisContas com data_desativacao nula ou > hoje; tipo tipo_conta 1 = Caixa, qualquer outro = Banco; sugerida = último movimento nos últimos 60 dias.

ConversãoO saldo (na moeda da conta) é convertido para a moeda de apresentação pela cotação mais recente. O filtro Moeda filtro também restringe a lista de contas — e o saldo inicial.

CacheA lista de contas fica 5 minutos em memória por banco e dia (a primeira leitura custa ~10–20 s no central); a projeção soma dela em ~0,3 s.

Títulos: a conta do 221, pelo vencimento

Saldofe.valor_parcela − Σ(b.valor − b.valor_acrescimo − b.valor_juros + b.valor_desconto + b.valor_devolucao + b.valor_retencao) das baixas vivas (todas, sem corte de data: é projeção a partir de hoje). Só saldo > 0,004.

Recortefe.excluido <> 'T', tipo_emissao IN ('P','R'), NOT (tipo_emissao='R' AND descontado='T'), data_vencimento >= hoje AND < fim + 1 dia (com FORCE INDEX (data_vencimento): sem ele o MySQL varre 2 milhões de títulos, 9 s contra 0,6 s).

Não usafinanceiro_emissao.valor_pendente (zerada no central).

A pagar na RJrecuperacao_judicial = 1 em título a pagar vai para a coluna A pagar na RJ, fora do saldo (não é pago no vencimento). Título a receber com RJ é contado como a receber na projeção.

Conversão para uma moeda só

Cadeiaorigem → moeda local → moeda de apresentação, pela cotação mais recente até hoje (moeda_valores.valor > 0) de cada moeda. O legado usa a cotação da emissão; aqui é projeção.

ExceçõesDocumento na própria moeda de apresentação (ou sem moeda) não converte. Documento com cambio_fechado = 'T' usa valor_cambio. Moeda sem cotação usa valor_cambio do documento e gera aviso.

Avisos“Moeda X sem cotação até hoje: usado o câmbio gravado no documento.” e “A cotação de X usada na conversão é de dd/mm/aaaa (a última lançada).” quando passa de 7 dias (no central a do U$ é de 31/03/2022). A linha “Cotações usadas” da tela lista moeda, valor e data.

Pedidos de venda e ordens de compra em aberto

Pedidofaturamento_venda_ordem_venda sem venda viva (faturamento_venda.idpedido = pedido.id com excluido <> 'T'); ordem: faturamento_compra_ordem sem compra viva (faturamento_compra_carne.idordem_compra).

ValorΣ produtos (valor_total) + valor_outros_acrescimos − valor_outros_descontos; sem ST e frete. Total ≤ 0 não entra.

ParcelasRepartido pelo campo prazo (faturamento.Prazos) em parcelas iguais, com a sobra na última; sem prazo, uma parcela no dia da base.

Data-basePedido: data_entrega; ordem: data_emissao. Se já passou, vale hoje.

Quais entramEmitidos nos últimos N dias (padrão 30), autorizado = 'T' se “Só autorizados”, e só os tipos de faturamento que geraram título a receber (pedido) ou a pagar (ordem) no último ano (uma consulta por tipo, cache por banco e dia) — transferência para produção, remessa e retorno não mexem no caixa.

FiltrosPedido e ordem não têm centro de custo: com filtro de centro/grupo ficam de fora (aviso). A ordem não tem vendedor: com filtro de vendedor fica de fora (aviso); o pedido filtra por idvendedor dele. País e filial valem para os dois.

Totais do período e do horizonte

Saldo do períodoA receber + Pedidos − A pagar − Ordens (a RJ não entra).

Saldo acumuladoSaldo inicial + Σ dos saldos dos períodos até aquele. Menor saldo e a data (último dia da faixa em que ocorreu).

ArredondamentoCada valor é arredondado às casas da moeda de apresentação antes de somar: o total pode divergir em centavos de uma soma sem arredondar.

Vencidos em aberto

Janeladata_vencimento >= hoje − N dias AND < hoje (N = 365 por padrão). Título vencido há mais que N dias não aparece.

DivisãoA receber, A pagar e A pagar na RJ (com quantidade de títulos), convertidos como a projeção; ficam fora do saldo projetado.

Composição (painel)

ConsultaUma consulta agrupada por filial + centro de custo + emitente + tipo + moeda + câmbio fechado, convertida como a projeção, do período clicado (limitado ao horizonte; antes de hoje vira hoje).

RJA composição exclui os títulos com recuperacao_judicial = 1 dos dois lados (a projeção os trata à parte e só no a pagar).

Pedidos e ordensEntram pela filial e pelo emitente deles e em “Sem centro de custo”.

EmitentesSó os 15 maiores de entrada e os 15 maiores de saída; o resto não aparece no gráfico (a soma dos emitentes é menor que a das filiais).

Horizonte de 30, 60 ou 90 dias.

QuandoQualquer outro valor de dias (projeção e composição).

Vencidos de 1 a 3650 dias para trás.

QuandoDias fora de 1–3650 no vencidos.

Pedidos e ordens emitidos de 1 a 365 dias para trás.

Quando“Emitidos nos últimos N dias” fora de 1–365.

A moeda X não tem cotação até hoje: não há como converter para ela.

QuandoMoeda de apresentação sem nenhuma cotação (e diferente da local).

Moeda N não encontrada. / Escolha a moeda (a filial está sem moeda local).

QuandoId de moeda inexistente, ou filial da sessão sem idmoeda_local e nenhuma moeda escolhida.

Mais de 3000 títulos neste período; escolha um período menor.

QuandoAbrir a lista de títulos de um período com mais de 3.000 títulos (a lista de pedidos/ordens não tem esse limite).

Informe o tipo e o período. / Período fora do horizonte. / Data inválida: texto

QuandoChamada direta da lista ou da composição com dados faltando, período invertido ou fora do horizonte.

Com filtro de centro de custo, pedidos e ordens de compra ficam de fora (não têm centro de custo).

EfeitoAviso na tela; as caixas continuam marcadas mas os valores de pedidos/ordens somem. Com filtro de vendedor, só as ordens saem (“Com filtro de vendedor, as ordens de compra ficam de fora (não têm vendedor).”).

Saldo de conta em moeda estrangeira — corrigido em 04/10/2026

O que aconteciaA leitura das contas do fluxo somava o movimento de qualquer moeda na conta. No fjfrigo_concepcion a conta 1001913 dava −30.690.651.975,19 U$ (contra 21.480.007,18 só com o movimento em U$).

HojeFluxoCaixaService.lerContas agrupa o movimento por idconta_bancaria, idmoeda e junta com s.idmoeda = cb.idmoeda: só o movimento na moeda da própria conta entra, como no Boletim 3172 e na Exposição Cambial (3176). A mesma conta passa a dar U$ 21.480.007,18.

Moeda filtro também filtra as contas

EfeitoA ajuda diz que as contas do saldo inicial “continuam as marcadas”, mas o filtro de moeda de origem esconde as contas de outras moedas e as tira do saldo inicial.

Composição não bate com a projeção quando há título a receber na RJ

EfeitoA projeção conta o título a receber com RJ como a receber; a composição o descarta. No central há 3 títulos a receber com RJ entre os vencidos (6.415,32); nenhum no horizonte de 30 dias em 04/10/2026, então hoje a divergência é só latente.

Câmbio gravado zerado

RegraCâmbio gravado zerado ou nulo vale 1, como nos 316x (IF(valor_cambio > 0, valor_cambio, 1)), nos títulos e nos pedidos/ordens. Até 04/10/2026 o zero passava e o título em moeda estrangeira sem cotação (ou com câmbio fechado) convertia para zero. Só pesa quando a moeda do título não é a local nem a de apresentação; no central os títulos com câmbio zero do horizonte estão todos na moeda local, e o total não muda.

Pedido de valor gigante domina as entradas

Caso conhecidoO painel deixou à vista um pedido de 72 milhões (ATAGO NEW YORK, filial 11) que dominava as entradas previstas; confira antes de culpar o cálculo. O pedido some do fluxo quando ganha uma venda viva.

T1 — Os próximos 30 dias batem com SQL

ComoAbra o 382 (moeda local, 30 dias, agrupamento Dia, sem pedidos/ordens, sem filtros). Some A receber, A pagar e A pagar na RJ da grade e compare com a SQL.

EsperadoIgualdade por tipo (a soma das faixas = o horizonte). Referência medida em 04/10/2026 no central (30 dias, 04/10 a 02/11): A pagar 2.002 títulos / 27.715.641,71; A pagar na RJ 502 / 23.006.053,96; A receber 853 / 26.469.560,97. Mudam com baixas e lançamentos do dia. Conferência do histórico: os títulos de um período somam o valor do período (261 = 7.390.089,42 em 27/09).

SELECT t.tipo_emissao, t.rj, t.idmoeda, COUNT(*) n, ROUND(SUM(t.pend),2) pendente FROM (
SELECT fe.tipo_emissao, IF(fe.recuperacao_judicial=1,1,0) rj, IFNULL(fe.idmoeda,0) idmoeda,
 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'),0) pend
FROM financeiro_emissao fe
WHERE fe.excluido<>'T' AND fe.tipo_emissao IN ('P','R') AND NOT (fe.tipo_emissao='R' AND fe.descontado='T')
 AND fe.data_vencimento >= CURDATE() AND fe.data_vencimento < CURDATE() + INTERVAL 30 DAY) t
WHERE t.pend>0.004 GROUP BY 1,2,3 ORDER BY 1,2,3

T2 — Saldo acumulado e menor saldo

ComoMarque as contas e anote o saldo inicial. Percorra a grade.

EsperadoCada Saldo acumulado = anterior + A receber + Pedidos − A pagar − Ordens; o primeiro parte do saldo inicial. “Menor saldo” é o menor acumulado (ou o saldo inicial) e a data é a do fim da faixa. A RJ nunca entra.

T3 — A pagar na RJ não abate o saldo

ComoCompare o Saldo final com a conta do T2.

EsperadoA coluna RJ é informativa: o saldo final não muda se a RJ for zerada.

T4 — Vencidos

ComoClique no indicador Vencidos (365 dias) e compare com a SQL.

EsperadoA receber, A pagar e RJ iguais ao SQL. Referência 04/10/2026 no central: A pagar 3.586 / 82.356.359,84; A pagar RJ 33.840 / 1.339.424.687,92; A receber 19.678 / 782.097.005,40 (+3 títulos a receber com RJ, 6.415,32, que a tela soma no A receber). Trocar os dias para 30 reduz o recorte.

SELECT t.tipo_emissao, t.rj, COUNT(*) AS n, ROUND(SUM(t.pend),2) AS vencidos
FROM (SELECT fe.tipo_emissao, IF(fe.recuperacao_judicial=1,1,0) AS rj,
             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'),0) AS pend
        FROM financeiro_emissao fe
       WHERE fe.excluido<>'T' AND fe.tipo_emissao IN ('P','R') AND NOT (fe.tipo_emissao='R' AND fe.descontado='T')
         AND fe.data_vencimento >= CURDATE() - INTERVAL 365 DAY AND fe.data_vencimento < CURDATE()) t
WHERE t.pend > 0.004 GROUP BY 1,2

T5 — Conversão para outra moeda

ComoNum banco com dólar (fjfrigo_concepcion), converta de G$ para U$ e volte.

EsperadoDocumento em U$ não converte; em G$ divide pela cotação mais recente do U$ (aparece em “Cotações usadas”, com aviso se tiver mais de 7 dias); documento com câmbio fechado usa o câmbio dele; moeda sem cotação usa o câmbio gravado e gera aviso.

T6 — Pedidos e ordens

ComoMarque “Incluir pedidos”. Escolha um pedido sem venda (faturamento_venda.idpedido) com prazo 30/60/90.

EsperadoTrês parcelas iguais (sobra do arredondamento na última) a partir de data_entrega (ou hoje, se já passou), as que passam do horizonte ficam de fora. Emitido há mais de N dias não entra; “Só autorizados” tira os não autorizados. Na lista do período o pedido aparece com o número e o valor da parcela prevista.

T7 — Filtro de centro de custo

ComoCom pedidos e ordens ligados, filtre por um centro de custo.

EsperadoAviso “Com filtro de centro de custo, pedidos e ordens de compra ficam de fora…” e as colunas Pedidos/Ordens zeradas. Com filtro de vendedor, só as ordens saem.

T8 — Composição fecha com a projeção

ComoSome Filial e Centro de custo da composição do horizonte inteiro; compare com A receber + Pedidos e A pagar + Ordens da projeção (sem RJ).

EsperadoAs somas por filial e por centro batem com o total (pedidos podem diferir 1 centavo por arredondamento de item). Clicar num período troca a composição para ele; o período 05/10–11/10 bate com a linha da grade. Emitentes mostram só os 15 maiores de cada lado.

T9 — Excel

ComoGere o Excel com Agrupamento Dia, 30 dias.

EsperadoUma coluna por dia; o Caixa final do último dia = Saldo final da tela; os totais por centro de custo = as linhas de entrada/saída. Conferido no central em 27/09: caixa final 67.493.772,02 e ~1,7 s.

T10 — Saldo da conta em moeda estrangeira (corrigido em 04/10/2026)

ComoNo fjfrigo_concepcion, abra Contas do saldo inicial e veja a conta 1001913 (ADTO ALL PAR CASINGS U$).

EsperadoSaldo em U$ de 21.480.007,18 (só o movimento na moeda da conta, regra do 3172). Corrigido em 04/10/2026: antes o saldo somava os movimentos de qualquer moeda. O SQL abaixo mostra os dois números: saldo_so_na_moeda_da_conta deve ser igual ao saldo da tela; saldo_como_o_fluxo_calcula (todas as moedas) é o número antigo, que não deve mais aparecer.

SELECT x.idconta_bancaria,
       ROUND(SUM(x.valor),2) AS saldo_como_o_fluxo_calcula,
       ROUND(SUM(IF(x.mesma_moeda=1, x.valor, 0)),2) AS saldo_so_na_moeda_da_conta
FROM (SELECT flb.idconta_bancaria, IF(tlb.operacao='E', flb.valor, -flb.valor) AS valor, (flb.idmoeda = cb.idmoeda) AS mesma_moeda
        FROM financeiro_lancamento_banco flb
        JOIN conta_bancaria cb ON cb.id = flb.idconta_bancaria
        LEFT JOIN tipo_lancamento_bancario tlb ON tlb.id = flb.idtipo_lancamento_bancario
       WHERE flb.excluido <> 'T' AND flb.idconta_bancaria = 1001913
      UNION ALL
      SELECT fb.idconta_bancaria, IF(fe.tipo_emissao='R', fb.valor, -fb.valor), (fe.idmoeda = cb.idmoeda)
        FROM financeiro_baixas fb
        JOIN conta_bancaria cb ON cb.id = fb.idconta_bancaria
        LEFT JOIN financeiro_emissao fe ON fe.id = fb.idfinanceiro_emissao
       WHERE fb.excluido <> 'T' AND fb.idconta_bancaria = 1001913) x
GROUP BY x.idconta_bancaria

T11 — Recusas

ComoChamadas diretas: dias = 45; vencidos = 0; diasPedidos = 400; moeda de apresentação sem cotação.

EsperadoAs mensagens da seção D.