WRBNC001 — Fluxo de Caixa Analítico

O relatório WRBNC001 — Fluxo de Caixa Analítico mostra, de forma detalhada, a movimentação financeira prevista da empresa: o saldo atual nos bancos e caixas, o saldo de títulos vencidos e ainda em aberto até a data inicial do período consultado, e o detalhamento de cada título a receber e a pagar dentro do período informado.

O relatório WRBNC001 — Fluxo de Caixa Analítico mostra, de forma detalhada, a movimentação financeira prevista da empresa: o saldo atual nos bancos e caixas, o saldo de títulos vencidos e ainda em aberto até a data inicial do período consultado, e o detalhamento de cada título a receber e a pagar dentro do período informado. Cada linha traz um saldo acumulado, permitindo enxergar como o caixa da empresa evolui dia a dia conforme os títulos vencem.

É a versão “analítica” de uma família de cinco relatórios de fluxo de caixa do módulo Financeiro (WRBNC001 a WRBNC004 e WRBNC010): mostra cada título individualmente, não apenas os totais. Os relatórios WRBNC002 (Sintético), WRBNC003 e WRBNC004 (por Conta de Resultado) reaproveitam integralmente os dados calculados por este relatório, mudando apenas o layout de impressão — nenhum deles tem regra de cálculo própria.

Geração: o relatório fica disponível dentro do módulo Financeiro do ERP Atak e é gerado via Crystal Reports, a partir de uma tela de parâmetros que antecede a impressão (a mesma tela “Ferramenta → Relatórios” comum a todos os relatórios do sistema).

▶ Tutorial em vídeo: ainda não disponível para esta rotina.

O acesso ao relatório WRBNC001 é controlado pelo recurso “WRBnc001” (ID 50905), vinculado ao menu do módulo Financeiro. Não há dependência de cadastro prévio específico — porém, para o relatório retornar dados relevantes, é necessário que já existam títulos a receber/a pagar lançados e, se o bloco de saldo bancário for solicitado, que exista ao menos um fechamento de saldo registrado em alguma carteira (rotina de Saldo de Banco). Contratos, carteiras e cadastros de participantes usados como filtro precisam já estar cadastrados nas respectivas rotinas do sistema.

Passo 1: Acessar o relatório O usuário acessa, no menu do módulo Financeiro, a opção “WRBNC001 – Fluxo de caixa analítico”. O sistema abre a tela de parâmetros do relatório (relatorios.aspx).

Passo 2: Informar a filial (opcional) Uma ou mais filiais cujos títulos e saldo bancário serão considerados (“prmFilial”); sem seleção, considera todas.

Passo 3: Informar o período Intervalo de data de emissão (“prmDataEmissao”) e de data de vencimento (“prmDataVencimento”) dos títulos a considerar — o início do período de vencimento também define o corte do “saldo anterior” (títulos já vencidos antes dele).

Passo 4: Filtrar tipo de documento, forma de cobrança e de pagamento (opcional) “prmTipoDocumentoAReceber”/”prmTipoDocumentoAPagar” restringem por tipo de título; “prmFormaDeCobranca”/”prmFormaDePagamento” restringem pela forma usada.

Passo 5: Definir a natureza dos títulos (opcional) “prmNaturezaAReceber”/”prmNaturezaAPagar” — restringe pela natureza do título (ex: Realizado/Previsto); “T” mantém todas.

Passo 6: Definir a exibição dos blocos de saldo “prmImprimeSaldoBanco”, “prmImprimeSaldoAReceber” e “prmImprimeSaldoAPagar” — cada um define se o respectivo saldo aparece de forma detalhada, apenas como total, ou não é considerado.

Passo 7: Definir se detalha os títulos do período “prmImprimeDetalheDeTitulos” (padrão “Sim”) — se “Não”, apenas os totais entram no cálculo do saldo acumulado, sem listar cada título.

Passo 8: Definir se considera dia útil “prmConsideraDiaUtil” — se “Sim”, usa a data de vencimento já ajustada para o dia útil seguinte/anterior em todos os filtros e ordenações por data.

Passo 9: Incluir parcelas previstas de pedidos ainda não faturados (opcional) “prmTipoDeMovimento” — informando um ou mais tipos de movimento de estoque, o relatório inclui a previsão de parcelas de pedidos daquele tipo que ainda não geraram título financeiro.

Passo 10: Gerar o relatório O sistema processa e apresenta o PDF (ou Excel/Word, conforme a opção escolhida na barra de ferramentas) do fluxo de caixa analítico.

Parâmetro: prmFilial Tipo: lista de seleção (múltiplos) Obrigatoriedade: opcional Descrição: Filial(is) cujos títulos e saldo bancário serão considerados. Comportamento: Sem seleção, considera todas as filiais; com uma única filial selecionada, o filtro de saldo bancário usa comparação direta, com mais de uma usa “contido em”. Impacto: Determina o universo de títulos e de carteiras bancárias que compõem o relatório.

—

Parâmetro: prmDataEmissao Tipo: intervalo de datas (de/até) Obrigatoriedade: opcional Descrição: Data de emissão dos títulos a receber/pagar a incluir. Comportamento: Filtra apenas os títulos do bloco “período” (nível 4); não afeta o saldo anterior nem o saldo bancário. Impacto: Restringe os títulos detalhados pela data em que foram emitidos.

—

Parâmetro: prmDataVencimento Tipo: intervalo de datas (de/até) Obrigatoriedade: opcional Descrição: Data de vencimento dos títulos a considerar. Comportamento: A data inicial também é o corte usado para separar o “saldo anterior” (títulos vencidos antes dela) dos títulos detalhados do período; a data final delimita o fim do detalhamento — títulos com vencimento posterior a ela entram apenas no total acumulado (nível 5), sem detalhamento. Impacto: É o parâmetro que define, sozinho, a “janela” temporal de todo o fluxo de caixa exibido.

—

Parâmetro: prmTipoDocumentoAReceber / prmTipoDocumentoAPagar Tipo: lista de seleção (múltiplos) Obrigatoriedade: opcional Descrição: Tipo(s) de documento dos títulos a receber e a pagar a incluir. Comportamento: Sem seleção, todos os tipos entram; aplicado tanto ao saldo anterior quanto aos títulos do período de cada lado (a receber/a pagar). Impacto: Restringe o relatório a determinadas naturezas de documento (ex: apenas duplicatas, apenas notas de débito etc.).

—

Parâmetro: prmFormaDeCobranca / prmFormaDePagamento Tipo: lista de seleção (múltiplos) Obrigatoriedade: opcional Descrição: Forma(s) de cobrança (para títulos a receber) e forma(s) de pagamento (para títulos a pagar) a considerar. Comportamento: Cada uma se aplica somente ao lado correspondente (cobrança → a receber; pagamento → a pagar). Impacto: Permite isolar, por exemplo, apenas o fluxo de caixa esperado via boleto, ou apenas pagamentos programados via PIX.

—

Parâmetro: prmNaturezaAReceber / prmNaturezaAPagar Tipo: lista de seleção Obrigatoriedade: opcional (valor “T” = todas) Descrição: Natureza do título (ex: Realizado/Previsto) a receber e a pagar. Comportamento: Só é aplicado como filtro quando o valor for diferente de “T”; aplicado tanto ao saldo anterior quanto aos títulos do período. Impacto: Permite separar, por exemplo, apenas os valores já efetivamente realizados dos ainda previstos.

—

Parâmetro: prmImprimeSaldoBanco / prmImprimeSaldoAReceber / prmImprimeSaldoAPagar Tipo: lista de seleção Obrigatoriedade: opcional Descrição: Controla se e como cada bloco de saldo (bancário, títulos vencidos a receber, títulos vencidos a pagar) aparece no relatório: não considerar, forma detalhada (linha a linha) ou apenas o total. Comportamento: Mesmo quando configurado para “não detalhar”, o total de cada bloco continua entrando no cálculo do saldo acumulado — a opção só controla o que é impresso, não o que é somado (exceto quando “não considerar” é escolhido, que exclui o bloco do cálculo). Impacto: Define o nível de detalhe do relatório impresso e se cada bloco entra ou não no saldo projetado.

—

Parâmetro: prmImprimeDetalheDeTitulos Tipo: Sim/Não Obrigatoriedade: opcional (padrão “Sim”) Descrição: Define se os títulos do período aparecem detalhados, título a título. Comportamento: Se não for informado, o sistema assume “Sim” automaticamente. Impacto: Reduz drasticamente o volume de linhas do relatório quando desligado — útil para uma leitura rápida do total projetado.

—

Parâmetro: prmConsideraDiaUtil Tipo: Sim/Não Obrigatoriedade: opcional Descrição: Define se as datas de vencimento usadas nos filtros e na ordenação são as datas já ajustadas para dia útil, ou as datas de vencimento originais (corridas). Comportamento: Afeta simultaneamente o corte do saldo anterior, o filtro do período e a data exibida em cada título. Impacto: Pode mudar a data (e, por consequência, o mês/semana) em que um título aparece no fluxo, quando o vencimento cai em fim de semana ou feriado.

—

Parâmetro: prmTipoDeMovimento Tipo: texto (múltiplos separados por vírgula) Obrigatoriedade: opcional Descrição: Tipo(s) de movimento de estoque cujos pedidos/documentos ainda não faturados devem ser incluídos como previsão de parcela futura. Comportamento: Quando informado, o relatório busca esses documentos e substitui, pelo valor previsto neles, qualquer título já existente que tenha se originado do mesmo documento — evitando contar o mesmo valor duas vezes. Impacto: Antecipa no fluxo de caixa valores de pedidos que ainda não viraram título financeiro formal.

O relatório não tem uma tela de busca própria — os dados exibidos são inteiramente definidos pelos parâmetros preenchidos na tela de geração. Para localizar uma informação específica dentro do PDF/Excel gerado (um título, um banco, um participante), o usuário usa a busca do próprio visualizador de PDF/Excel, ou restringe melhor os parâmetros (filial, período, tipo de documento, forma de cobrança/pagamento) antes de gerar novamente.

O relatório não é editável. É um relatório de saída (leitura/impressão) gerado a partir de dados já registrados em outras rotinas do sistema — títulos a receber/a pagar, saldo bancário, pedidos de venda. Qualquer correção de valor, data ou situação deve ser feita na rotina de origem do título ou do saldo, não no relatório.

Gerado pelo Crystal Reports a partir de “~/Relatorios/WRBnc/WRBnc001.rpt”. Diferente de relatórios de outros módulos que delegam a busca de dados a uma classe de consulta própria, aqui toda a lógica está na própria classe do relatório (“WRBNC001”, em “ATAK.Relatorios.Implementacao.Financeiro”), que consulta diretamente as views “ViewDeTitulosAReceber” (tabela real “VWATAK4NET_TITULOS_A_RECEBER”), “ViewDeTitulosAPagar” (“VWATAK4NET_TITULOS_A_PAGAR”) e a entidade “SaldoBanco” (“TBSALDOBCO”); quando o filtro de tipo de movimento é usado, também consulta o serviço “IConsultaDeDocumento” para obter pedidos/documentos ainda não faturados.

Regra 1 — Saldo bancário do último fechamento O sistema localiza a data do fechamento de saldo mais recente registrado e soma o saldo de cada banco/caixa nessa data, considerando apenas carteiras marcadas para entrar no fluxo de caixa; saldos zerados são descartados.

Regra 2 — Saldo anterior a receber e a pagar Antes de detalhar o período, o relatório soma separadamente todo o saldo de títulos a receber e a pagar já vencidos (vencimento anterior à data inicial informada) e ainda em aberto — a base de onde o fluxo de caixa “começa a contar”.

Regra 3 — Documentos de adiantamento contam ao contrário Documentos cujo código começa com “AD” (adiantamentos) entram com o valor invertido (negativo) tanto no saldo anterior quanto nos títulos do período — representam uma antecipação já recebida/paga, não uma expectativa futura de caixa.

Regra 4 — Títulos do período ajustados pelo prazo de liberação de cobrança A data de vencimento de cada título do período é somada ao “Prazo de Liberação de Cobrança” cadastrado (dias adicionais até o valor ficar efetivamente disponível), antes de ser exibida — o fluxo de caixa reflete quando o dinheiro realmente fica disponível, não apenas a data contratual do título.

Regra 5 — Títulos a receber com vencimento além do período Títulos a receber cujo vencimento é posterior ao fim do período informado entram apenas como um valor somado ao final do fluxo, sem aparecer detalhados — representam a “cauda” do fluxo de caixa fora da janela consultada.

Regra 6 — Parcelas previstas de pedidos ainda não faturados Quando o filtro de tipo de movimento é usado, pedidos daquele tipo que ainda não geraram título financeiro entram como previsão de parcela — e, para não contar o mesmo valor duas vezes, o relatório remove qualquer título já existente que tenha se originado desse mesmo pedido.

Regra 7 — Saldo acumulado O relatório soma progressivamente, na ordem de exibição, o saldo inicial (bancos + títulos vencidos) com cada título a receber (soma) e a pagar (subtrai) do período, produzindo a coluna de saldo acumulado — a “curva” de caixa prevista, linha a linha.

Regra 8 — Sem mensagens de bloqueio específicas Não há validação de negócio que impeça a geração do relatório. Sem títulos, saldo bancário ou parâmetros informados, o relatório é gerado apenas com o que existir — inclusive vazio, se nada corresponder aos filtros escolhidos.

—

WRBNC001 — Fluxo de Caixa Analítico

O relatório “Fluxo de Caixa Analítico” mostra, de forma detalhada, a movimentação financeira prevista da empresa: o saldo atual nos bancos e caixas, o saldo de títulos vencidos e ainda em aberto até a data inicial do período consultado, e o detalhamento de cada título a receber e a pagar dentro do período informado. Ao final, cada linha traz um saldo acumulado, permitindo enxergar como o caixa da empresa evolui dia a dia conforme os títulos vencem. É a versão “analítica” da família de relatórios de fluxo de caixa — mostra cada título individualmente, não apenas os totais.

Menu Financeiro > Relatórios (rotina “WRBnc001”, listada em “/MenuRelatorio/Listar/Financeiro”).

1. Saldo bancário (nível 1). O sistema localiza a data do último fechamento de saldo registrado (a mais recente em TBSALDOBCO) e soma o saldo de cada banco/caixa nessa data, considerando apenas carteiras com “status de fluxo” ativo. Saldos zerados são descartados. Se o parâmetro pedir a forma detalhada, cada banco aparece individualmente; o total sempre entra no acumulado inicial do relatório.
2. Saldo anterior a receber e a pagar (níveis 2 e 3). Antes de detalhar o período, o relatório soma, separadamente, todo o saldo de títulos a receber e a pagar que já estavam vencidos (ou com vencimento anterior à data inicial informada) e ainda em aberto. Documentos cujo código começa com “AD” (adiantamentos) entram com valor invertido (negativo), pois representam uma antecipação já recebida/paga, não uma expectativa futura.
3. Títulos do período (nível 4). Para o intervalo de datas informado, o relatório lista cada título a receber e a pagar individualmente — filtrando por filial, forma de cobrança/pagamento, tipo de documento, natureza e status “Aberto” — desde que o parâmetro “Imprime Detalhe de Títulos” esteja marcado como “Sim”. A data de vencimento usada é ajustada pelo prazo de liberação de cobrança do título (dias adicionais até o valor ficar efetivamente disponível).
4. Títulos a receber com vencimento posterior ao período (nível 5). Títulos a receber cujo vencimento é posterior ao fim do período informado entram apenas como um valor somado ao final do fluxo, sem detalhamento — representam a “cauda” do fluxo de caixa que está fora da janela consultada.
5. Parcelas previstas de documentos ainda não faturados. Quando o parâmetro “Tipo de Movimento” é informado, o sistema busca pedidos/documentos daquele tipo que ainda não geraram título financeiro e os inclui como previsão de parcela futura — e, para não contar duas vezes o mesmo valor, remove do resultado qualquer título já existente que tenha se originado desse mesmo documento.
6. Saldo acumulado. Por fim, o relatório soma progressivamente (linha a linha, na ordem do relatório) o saldo inicial (bancos + títulos vencidos) com cada título a receber (soma) e a pagar (subtrai) do período, produzindo a coluna de saldo acumulado — a “curva” de caixa prevista.