WRBNC002 – Fluxo de Caixa Sintético
WRBNC002 — Fluxo de Caixa Sintético
O relatório WRBNC002 — Fluxo de Caixa Sintético mostra uma visão consolidada (resumida) do fluxo de caixa: saldo bancário, saldo de títulos vencidos anteriores ao período (a receber e a pagar) e a movimentação de títulos a receber/pagar dentro do período informado, com o saldo acumulado projetado.
1. Visão Geral da Rotina
O relatório WRBNC002 — Fluxo de Caixa Sintético mostra uma visão consolidada (resumida) do fluxo de caixa: saldo bancário, saldo de títulos vencidos anteriores ao período (a receber e a pagar) e a movimentação de títulos a receber/pagar dentro do período informado, com o saldo acumulado projetado. Internamente, o relatório instancia o “WRBNC001 – Fluxo de Caixa Analítico” e reaproveita, sem alteração, todos os dados que ele calcula — a diferença entre os dois está apenas no layout de impressão: enquanto o WRBNC001 detalha título a título, este exibe de forma consolidada por grupo, mostrando os totais em vez do detalhe linha a linha.
Geração: disponível no módulo Financeiro do ERP Atak, gerado via Crystal Reports a partir da tela de parâmetros padrão do sistema.
2. Vídeo Tutorial
▶ Tutorial em vídeo: ainda não disponível para esta rotina.
3. Pré-requisitos e Contexto de Acesso
O acesso é controlado pelo recurso “WRBnc002” (ID 50906), 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.
4. Processo de Geração — Passo a Passo
Passo 1: Acessar o relatório O usuário acessa, no menu do módulo Financeiro, a opção “WRBNC002 – Fluxo de caixa sintético”. O sistema abre a tela de parâmetros do relatório.
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 dia útil em vez da data de vencimento original, para 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 fluxo de caixa consolidado por grupo (bancos, saldo anterior a receber/pagar e movimentação do período).
5. Descrição de Cada Campo da Tela
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.
6. Utilização e Consulta de Registros
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, o usuário usa a busca do próprio visualizador, ou restringe melhor os parâmetros antes de gerar novamente.
7. Processo de Edição
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 deve ser feita na rotina de origem do título ou do saldo, não no relatório.
8. Estrutura Técnica e Comportamento do Sistema
Gerado pelo Crystal Reports a partir de “~/Relatorios/WRBnc/WRBnc002.rpt”. A classe “WRBNC002” (em “ATAK.Relatorios.Implementacao.Financeiro”) não consulta o banco diretamente: no método “ObterRelatorioPrincipal”, ela instancia “new WRBNC001(…)” e delega a ele toda a obtenção de dados, apenas reordenando o resultado por “NivelDoRelatorio” antes de devolvê-lo ao layout — reordenação que, na prática, é redundante, pois o WRBNC001 já entrega o resultado ordenado. As consultas efetivamente executadas (dentro do WRBNC001) usam 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.
9. Regras de Negócio e Restrições
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.
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.
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, antes de ser exibida.
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.
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.
Regra 8 — Apresentação consolidada, não recálculo A única diferença deste relatório para o WRBNC001 está no layout de impressão: os mesmos dados são apresentados agrupados por total, em vez de detalhados título a título. Nenhuma das Regras 1 a 7 é recalculada — todas vêm prontas do WRBNC001.
Regra 9 — 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.
—
WRBNC002 — Fluxo de Caixa Sintético
1. Visão Geral
Mostra uma visão consolidada (resumida) do fluxo de caixa: saldo bancário, saldo de títulos vencidos anteriores ao período (a receber e a pagar) e a movimentação de títulos a receber/pagar dentro do período informado, com o saldo acumulado projetado. Este relatório não tem lógica própria de consulta — ele reaproveita exatamente os mesmos dados calculados pelo relatório “WRBNC001 – Fluxo de Caixa Analítico” (mesmos parâmetros, mesmas regras de negócio, mesmas tabelas). A diferença entre os dois é apenas o layout de impressão: enquanto o WRBNC001 detalha título a título, este exibe de forma consolidada (por grupo), mostrando os totais em vez do detalhe linha a linha.
2. Como Acessar
Menu Financeiro > Relatórios (rotina “WRBnc002”).
3. Parâmetros de Filtro
| Parâmetro | Obrigatório | Tipo de controle | Operador | O que filtra |
|---|---|---|---|---|
| prmFilial | Não | Lista de seleção (múltipla) | Contido em (In) | Uma ou mais filiais a considerar. Sem seleção, considera todas. |
| prmDataEmissao | Não | Intervalo de datas | Entre (Between) | Data de emissão dos títulos a receber/pagar (de/até). |
| prmDataVencimento | Não | Intervalo de datas | Entre (Between) | Data de vencimento dos títulos a receber/pagar (de/até) — também usada como referência para separar “saldo anterior” dos títulos do período. |
| prmTipoDocumentoAReceber | Não | Lista de seleção (múltipla) | Contido em (In) | Tipo(s) de documento a receber a incluir. |
| prmTipoDocumentoAPagar | Não | Lista de seleção (múltipla) | Contido em (In) | Tipo(s) de documento a pagar a incluir. |
| prmFormaDeCobranca | Não | Lista de seleção (múltipla) | Contido em (In) | Forma(s) de cobrança dos títulos a receber. |
| prmFormaDePagamento | Não | Lista de seleção (múltipla) | Contido em (In) | Forma(s) de pagamento dos títulos a pagar. |
| prmNaturezaAReceber | Não | Lista de seleção | Igual | Natureza do título a receber; valor “T” = todas. |
| prmNaturezaAPagar | Não | Lista de seleção | Igual | Natureza do título a pagar; valor “T” = todas. |
| prmImprimeSaldoBanco | Não | Lista de seleção | Igual | Se e como o saldo bancário é exibido: não considerar, forma simples ou forma detalhada. |
| prmImprimeSaldoAReceber | Não | Lista de seleção | Igual | Mesma lógica, aplicada ao saldo anterior de títulos a receber. |
| prmImprimeSaldoAPagar | Não | Lista de seleção | Igual | Mesma lógica, aplicada ao saldo anterior de títulos a pagar. |
| prmImprimeDetalheDeTitulos | Não (padrão “Sim”) | Lista de seleção | Igual | Se “Sim”, lista cada título individualmente; se “Não”, só os totais entram no cálculo. |
| prmConsideraDiaUtil | Não | Lista de seleção | Igual | Se “Sim”, usa a data de vencimento ajustada para dia útil. |
| prmTipoDeMovimento | Não | Texto livre | Igual | Tipo(s) de movimento de estoque cujos documentos devem ser incluídos como previsão de parcelas futuras. |
4. Tabelas e Views Utilizadas
| Entidade/Classe C# | Tabela/View real no banco | O que representa |
|---|---|---|
| ViewDeTitulosAReceber | VWATAK4NET_TITULOS_A_RECEBER | Títulos a receber, já com saldo, status e datas de vencimento calculadas |
| ViewDeTitulosAPagar | VWATAK4NET_TITULOS_A_PAGAR | Títulos a pagar, no mesmo padrão |
| SaldoBanco | TBSALDOBCO | Saldo diário registrado de cada banco/caixa |
| Documento (parcelas) — via IConsultaDeDocumento.ObterPorListaDeTipoDeMovimento | (consulta especializada de pedidos ainda não faturados) | Usada apenas quando “prmTipoDeMovimento” é informado |
Estas consultas são executadas dentro da classe “WRBNC001”, que é instanciada e chamada internamente pela classe “WRBNC002” — este relatório não faz nenhuma consulta adicional própria.
5. Regras de Negócio e Cálculos
- Saldo bancário. O sistema localiza a data do último fechamento de saldo registrado e soma o saldo de cada banco/caixa nessa data, considerando apenas carteiras com “status de fluxo” ativo; saldos zerados são descartados.
- Saldo anterior a receber e a pagar. O relatório soma, separadamente, todo o saldo de títulos a receber e a pagar já vencidos e ainda em aberto. Documentos “AD” (adiantamentos) entram com valor invertido.
- Títulos do período. 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 “Imprime Detalhe de Títulos” esteja em “Sim”. A data de vencimento é ajustada pelo prazo de liberação de cobrança.
- Títulos a receber com vencimento posterior ao período. Entram apenas como um valor somado ao final do fluxo, sem detalhamento.
- Parcelas previstas de documentos ainda não faturados. Documentos do tipo de movimento informado são incluídos como previsão, substituindo qualquer título já existente originado do mesmo documento.
- Saldo acumulado. O relatório soma progressivamente o saldo inicial com cada título a receber (soma) e a pagar (subtrai) do período, produzindo o saldo acumulado.
- Apresentação consolidada. A única diferença deste relatório para o WRBNC001 é o reagrupamento por totais no layout de impressão — nenhuma das regras acima é recalculada de forma diferente.
6. Colunas Principais do Resultado
| Campo (projeção) | Descrição de negócio |
|---|---|
| NomeDoBancoCaixa / ValorDoSaldo | Nome do banco/caixa e o saldo atual registrado nele |
| SaldoTotalBanco | Soma do saldo de todos os bancos/caixas |
| IdDoDocumento / SaldoDoDocumentoaReceber / SaldoDoDocumentoaPagar | Saldo vencido anterior ao período, por tipo de documento |
| SaldoTotalaReceber / SaldoTotalaPagar | Total do saldo anterior a receber / a pagar |
| TotalDeSaldoAnteriorAcumulado | Ponto de partida do acumulado (bancos + saldo vencido a receber − saldo vencido a pagar) |
| Titulo / IdDoParticipante / NomeDoParticipante | Identificação do título e do cliente/fornecedor envolvido |
| IdDaCarteira / NomeDaCarteira | Carteira (banco/caixa) vinculada ao título |
| IdDoGrupoCliente / NomeDoGrupoCliente | Grupo econômico do cliente/fornecedor, quando existir |
| DataDeVencimento / DataDeEmissao | Datas do título |
| ValorDoTituloaReceber / ValorDoTituloaPagar | Valor do título no período |
| IdDaContaResultado / NomeDaContaResultado | Conta de resultado (contábil) vinculada ao título |
| Natureza | Natureza do título (realizado/previsto) |
| TotalDeSaldoAcumulado | Saldo de caixa acumulado até aquela linha do relatório |