WRBNC003 – Fluxo de Caixa Analítico por Conta de Resultado
WRBNC003 — Fluxo de Caixa Analítico por Conta de Resultado
O relatório WRBNC003 — Fluxo de Caixa Analítico por Conta de Resultado mostra o fluxo de caixa detalhado — saldo bancário, saldo de títulos vencidos anteriores ao período (a receber e a pagar) e o detalhamento título a título dos valores do período — organizado com foco na conta de resultado (contábil) associada a cada título.
1. Visão Geral da Rotina
O relatório WRBNC003 — Fluxo de Caixa Analítico por Conta de Resultado mostra o fluxo de caixa detalhado — saldo bancário, saldo de títulos vencidos anteriores ao período (a receber e a pagar) e o detalhamento título a título dos valores do período — organizado com foco na conta de resultado (contábil) associada a cada título. Internamente instancia o “WRBNC001 – Fluxo de Caixa Analítico” e reaproveita, sem alteração, todos os dados que ele calcula; a diferença está no layout, que agrupa/realça a leitura por conta de resultado.
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 “WRBnc003” (ID 50907), 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, “WRBNC003 – Fluxo de caixa analítico por conta de resultado”. O sistema abre a tela de parâmetros.
Passo 2: Informar a filial (opcional) “prmFilial” — sem seleção, considera todas.
Passo 3: Informar o período “prmDataEmissao” e “prmDataVencimento” — o início do período de vencimento define o corte do saldo anterior.
Passo 4: Filtrar tipo de documento, forma de cobrança e de pagamento (opcional) “prmTipoDocumentoAReceber”/”prmTipoDocumentoAPagar” e “prmFormaDeCobranca”/”prmFormaDePagamento”.
Passo 5: Definir a natureza dos títulos (opcional) “prmNaturezaAReceber”/”prmNaturezaAPagar” — “T” mantém todas.
Passo 6: Definir a exibição dos blocos de saldo “prmImprimeSaldoBanco”, “prmImprimeSaldoAReceber” e “prmImprimeSaldoAPagar”.
Passo 7: Definir se detalha os títulos do período “prmImprimeDetalheDeTitulos” (padrão “Sim”).
Passo 8: Definir se considera dia útil “prmConsideraDiaUtil”.
Passo 9: Incluir parcelas previstas de pedidos ainda não faturados (opcional) “prmTipoDeMovimento”.
Passo 10: Informar se imprime títulos em atraso (sem efeito no resultado) “prmImprimeTitulosEmAtraso” — campo exclusivo deste relatório, aparece na tela, mas o valor é descartado antes de chegar à consulta (ver Regra 8).
Passo 11: Gerar o relatório O sistema processa e apresenta o fluxo de caixa analítico, organizado por conta de resultado.
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. 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ão afeta o saldo anterior nem o saldo bancário. Impacto: Restringe os títulos detalhados pela data de emissão.
—
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 separa o “saldo anterior” dos títulos detalhados; a final delimita o fim do detalhamento. Impacto: Define 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 entram; aplicado tanto ao saldo anterior quanto aos títulos do período. Impacto: Restringe o relatório a determinadas naturezas de documento.
—
Parâmetro: prmFormaDeCobranca / prmFormaDePagamento Tipo: lista de seleção (múltiplos) Obrigatoriedade: opcional Descrição: Forma(s) de cobrança (a receber) e de pagamento (a pagar) a considerar. Comportamento: Cada uma se aplica somente ao lado correspondente. Impacto: Permite isolar o fluxo de caixa por forma específica.
—
Parâmetro: prmNaturezaAReceber / prmNaturezaAPagar Tipo: lista de seleção Obrigatoriedade: opcional (valor “T” = todas) Descrição: Natureza do título a receber e a pagar. Comportamento: Só é aplicado como filtro quando diferente de “T”. Impacto: Permite separar valores já 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 aparece: não considerar, forma detalhada ou apenas o total. Comportamento: Mesmo “não detalhado”, o total continua entrando no acumulado (exceto “não considerar”). Impacto: Define o nível de detalhe impresso e se cada bloco entra 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 informado, o sistema assume “Sim”. Impacto: Reduz o volume de linhas do relatório quando desligado.
—
Parâmetro: prmConsideraDiaUtil Tipo: Sim/Não Obrigatoriedade: opcional Descrição: Define se as datas de vencimento usadas são as ajustadas para dia útil ou as corridas. Comportamento: Afeta o corte do saldo anterior, o filtro do período e a data exibida em cada título. Impacto: Pode mudar a data em que um título aparece no fluxo.
—
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. Comportamento: Substitui, pelo valor previsto, qualquer título já existente originado do mesmo documento. Impacto: Antecipa no fluxo de caixa valores de pedidos ainda não faturados.
—
Parâmetro: prmImprimeTitulosEmAtraso Tipo: lista de seleção Obrigatoriedade: opcional Descrição: Aparenta controlar se o relatório imprime títulos em atraso. Comportamento: Sem efeito. O valor informado é lido pela tela de parâmetros, mas descartado antes de chegar à consulta de dados — não influencia o resultado gerado. Impacto: Nenhum sobre o relatório atual. Recomenda-se validar com o time técnico se é uma funcionalidade pendente de implementação.
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.
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. Qualquer correção deve ser feita na rotina de origem do título ou do saldo.
8. Estrutura Técnica e Comportamento do Sistema
Gerado pelo Crystal Reports a partir de “~/Relatorios/WRBnc/WRBnc003.rpt”. A classe “WRBNC003” (em “ATAK.Relatorios.Implementacao.Financeiro”) instancia “new WRBNC001(…)” dentro de “ObterRelatorioPrincipal” e repassa a ele todos os parâmetros exceto “imprimeTitulosEmAtraso” (recebido, mas descartado); devolve o resultado exatamente como veio do WRBNC001, sem reordenação adicional. 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”.
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 e ainda em aberto.
Regra 3 — Documentos de adiantamento contam ao contrário Documentos “AD” 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 Entram apenas como um valor somado ao final do fluxo, sem aparecer detalhados.
Regra 6 — Parcelas previstas de pedidos ainda não faturados Documentos do tipo de movimento informado entram como previsão, substituindo qualquer título já existente originado do mesmo documento.
Regra 7 — Saldo acumulado O relatório soma progressivamente, na ordem de exibição, o saldo inicial com cada título a receber (soma) e a pagar (subtrai) do período.
Regra 8 — Parâmetro sem efeito O campo “Imprime Títulos em Atraso” aparece na tela de filtros, mas o valor informado é lido e depois descartado antes de chegar à consulta — não influencia o resultado gerado. Recomenda-se validar com o time técnico se essa é uma funcionalidade pendente de implementação.
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.
—
WRBNC003 — Fluxo de Caixa Analítico por Conta de Resultado
1. Visão Geral
Mostra o mesmo fluxo de caixa detalhado do “WRBNC001 – Fluxo de Caixa Analítico” (saldo bancário, saldo anterior a receber/pagar e títulos do período, título a título), mas organizado com foco na conta de resultado (contábil) associada a cada título — útil para uma leitura gerencial do fluxo de caixa por classificação contábil. Este relatório não tem lógica própria de consulta: reaproveita exatamente os mesmos dados calculados pelo WRBNC001.
2. Como Acessar
Menu Financeiro > Relatórios (rotina “WRBnc003”).
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 | Filiais a considerar. |
| prmDataEmissao | Não | Intervalo de datas | Entre | Data de emissão dos títulos. |
| prmDataVencimento | Não | Intervalo de datas | Entre | Data de vencimento dos títulos — corte do saldo anterior. |
| prmTipoDocumentoAReceber | Não | Lista de seleção (múltipla) | Contido em | Tipo(s) de documento a receber. |
| prmTipoDocumentoAPagar | Não | Lista de seleção (múltipla) | Contido em | Tipo(s) de documento a pagar. |
| prmFormaDeCobranca | Não | Lista de seleção (múltipla) | Contido em | Forma(s) de cobrança. |
| prmFormaDePagamento | Não | Lista de seleção (múltipla) | Contido em | Forma(s) de pagamento. |
| prmNaturezaAReceber | Não | Lista de seleção | Igual | Natureza do título a receber; “T” = todas. |
| prmNaturezaAPagar | Não | Lista de seleção | Igual | Natureza do título a pagar; “T” = todas. |
| prmImprimeSaldoBanco | Não | Lista de seleção | Igual | Exibição do saldo bancário. |
| prmImprimeSaldoAReceber | Não | Lista de seleção | Igual | Exibição do saldo anterior a receber. |
| prmImprimeSaldoAPagar | Não | Lista de seleção | Igual | Exibição do saldo anterior a pagar. |
| prmImprimeDetalheDeTitulos | Não (padrão “Sim”) | Lista de seleção | Igual | Detalha título a título ou só totais. |
| prmConsideraDiaUtil | Não | Lista de seleção | Igual | Usa data de vencimento ajustada para dia útil. |
| prmTipoDeMovimento | Não | Texto livre | Igual | Tipos de movimento para prever parcelas futuras. |
| prmImprimeTitulosEmAtraso | Não | Lista de seleção | Igual | Sem efeito sobre o resultado — ver “Regras de Negócio”, Regra 8. |
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 |
| ViewDeTitulosAPagar | VWATAK4NET_TITULOS_A_PAGAR | Títulos a pagar |
| SaldoBanco | TBSALDOBCO | Saldo diário 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”, instanciada e chamada internamente pela classe “WRBNC003”.
5. Regras de Negócio e Cálculos
- Saldo bancário do último fechamento: soma o saldo de cada banco/caixa na data mais recente registrada, só carteiras marcadas para o fluxo de caixa.
- Saldo anterior a receber e a pagar: soma separadamente títulos já vencidos e em aberto.
- Documentos “AD” entram com valor invertido.
- Títulos do período ajustados pelo prazo de liberação de cobrança antes de exibidos.
- Títulos a receber com vencimento além do período entram apenas no total acumulado.
- Parcelas previstas de pedidos ainda não faturados substituem títulos equivalentes já existentes.
- Saldo acumulado calculado progressivamente ao longo das linhas.
- Parâmetro sem efeito. “Imprime Títulos em Atraso” é lido, mas descartado antes de chegar à consulta.
6. Colunas Principais do Resultado
| Campo | Descrição de negócio |
|---|---|
| NomeDoBancoCaixa / ValorDoSaldo | Nome do banco/caixa e saldo atual registrado |
| 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 |
| Titulo / IdDoParticipante / NomeDoParticipante | Identificação do título e do cliente/fornecedor |
| IdDaCarteira / NomeDaCarteira | Carteira vinculada ao título |
| IdDoGrupoCliente / NomeDoGrupoCliente | Grupo econômico do cliente/fornecedor |
| DataDeVencimento / DataDeEmissao | Datas do título |
| ValorDoTituloaReceber / ValorDoTituloaPagar | Valor do título no período |
| IdDaContaResultado | Código da conta de resultado (contábil) associada ao título — campo de destaque neste layout |
| NomeDaContaResultado | Descrição da conta de resultado — campo de destaque neste layout |
| Natureza | Natureza do título |
| TotalDeSaldoAcumulado | Saldo de caixa acumulado até aquela linha |