WRBNC006 – Movimentação Financeira por Carteira
WRBNC006 — Movimentação Financeira por Carteira
O relatório WRBNC006 — Movimentação Financeira por Carteira mostra o extrato analítico de movimentação financeira de cada carteira (banco/caixa) em um período: saldo inicial (real e/ou conciliado), cada lançamento bancário do período (data, documento, participante e valor), lançamentos anteriores que foram conciliados dentro do período, lançamentos ainda não conciliados, cheques emitidos ainda não compensados no contas a pagar, e o saldo final resultante por carteira.
1. Visão Geral da Rotina
O relatório WRBNC006 — Movimentação Financeira por Carteira mostra o extrato analítico de movimentação financeira de cada carteira (banco/caixa) em um período: saldo inicial (real e/ou conciliado), cada lançamento bancário do período (data, documento, participante e valor), lançamentos anteriores que foram conciliados dentro do período, lançamentos ainda não conciliados, cheques emitidos ainda não compensados no contas a pagar, e o saldo final resultante por carteira. É usado tanto para conferência de extrato bancário quanto como base para o “WRBNC007 – Movimentação Financeira por Carteira (sintética)” e o “WRBNC009 – Movimentação Financeira por Carteira – Conciliado”, duas variações deste mesmo relatório.
Geração: disponível no módulo Financeiro, 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 “WRBnc006” (ID 50910), vinculado ao menu do módulo Financeiro. Requer que exista saldo bancário e/ou movimentação financeira registrada na(s) carteira(s) e período informados.
4. Processo de Geração — Passo a Passo
Passo 1: Acessar o relatório No menu do módulo Financeiro, o usuário acessa “WRBNC006 – Movimentação financeira por carteira”.
Passo 2: Informar a filial (opcional) “prmFilial” — uma ou mais filiais.
Passo 3: Informar o período “prmDataLancamento” — intervalo de data de lançamento (ou de conciliação, conforme opção do passo 6).
Passo 4: Selecionar a(s) carteira(s) “prmCarteiraWRBNC006” — uma ou mais carteiras (bancos/caixas).
Passo 5: Definir o tratamento do saldo conciliado “prmConsideraSaldoConciliado” — se o saldo anterior conciliado entra no cálculo.
Passo 6: Definir se exibe lançamentos não conciliados “prmEmiteLancamentoNaoConciliado”.
Passo 7: Definir a moeda de exibição “prmCodigoMoeda” — moeda corrente, estrangeira, ou ambas lado a lado.
Passo 8: Definir o critério de filtro por data “prmConsultarPorDataDeConciliacao” — filtra pela data de conciliação em vez da data de lançamento.
Passo 9: Definir o tratamento de lançamentos anteriores conciliados “prmReparteLancamentoAnterioresConciliados”.
Passo 10: Gerar o relatório O sistema processa e apresenta o extrato analítico por carteira.
5. Descrição de Cada Campo da Tela
Parâmetro: prmFilial Tipo: lista de seleção (múltiplos) Obrigatoriedade: opcional Descrição: Filiais incluídas. Comportamento: Sem seleção, considera todas. Impacto: Determina o universo de carteiras/lançamentos considerados.
—
Parâmetro: prmDataLancamento Tipo: intervalo de datas Obrigatoriedade: opcional Descrição: Período de lançamento/conciliação analisado. Comportamento: A interpretação da data (lançamento ou conciliação) depende de “prmConsultarPorDataDeConciliacao”. Impacto: Delimita o extrato apresentado.
—
Parâmetro: prmCarteiraWRBNC006 Tipo: lista de seleção (múltiplos) Obrigatoriedade: opcional Descrição: Carteiras (bancos/caixas) a incluir. Comportamento: Sem seleção, considera todas as carteiras da filial. Impacto: Restringe o extrato a determinadas contas bancárias.
—
Parâmetro: prmConsideraSaldoConciliado Tipo: lista de seleção Obrigatoriedade: opcional Descrição: Se o saldo anterior conciliado deve ser considerado no cálculo. Comportamento: Quando ativado, o relatório também calcula o “Saldo Anterior Conciliado” separadamente do saldo real. Impacto: Habilita a coluna de saldo conciliado no relatório.
—
Parâmetro: prmEmiteLancamentoNaoConciliado Tipo: lista de seleção Obrigatoriedade: opcional Descrição: Se lançamentos ainda não conciliados devem aparecer no relatório. Comportamento: Controla se a seção de “Lançamentos Não Conciliados” é calculada e impressa. Impacto: Afeta tanto o detalhamento quanto o saldo final calculado (real vs. conciliado).
—
Parâmetro: prmCodigoMoeda Tipo: lista de seleção Obrigatoriedade: opcional Descrição: Moeda dos valores exibidos. Comportamento: A opção “Ambas” faz o sistema calcular os mesmos valores em moeda corrente e em moeda estrangeira, lado a lado. Impacto: Define se o extrato mostra apenas uma moeda ou as duas simultaneamente.
—
Parâmetro: prmConsultarPorDataDeConciliacao Tipo: lista de seleção Obrigatoriedade: opcional Descrição: Se o período filtra pela data de conciliação em vez da data de lançamento. Comportamento: Muda o critério de corte de todos os blocos de lançamento do relatório. Impacto: Pode alterar significativamente quais lançamentos aparecem no período consultado.
—
Parâmetro: prmReparteLancamentoAnterioresConciliados Tipo: lista de seleção Obrigatoriedade: opcional Descrição: Se lançamentos anteriores conciliados dentro do período aparecem destacados separadamente. Comportamento: Quando ativado (ou quando a consulta é por data de conciliação), a seção “Lançamentos Anteriores Conciliados” não é calculada separadamente. Impacto: Muda a forma como lançamentos “atrasados” na conciliação são apresentados.
6. Utilização e Consulta de Registros
O relatório não tem tela de busca própria; os parâmetros de geração definem inteiramente o conteúdo apresentado. O mesmo levantamento também alimenta uma consulta de extrato bancário (usada internamente por outras telas) que pode ser filtrada por tipo: Conciliado, Real, ou apenas Tarifas (juros, acréscimo, desconto, multa, tarifa bancária).
7. Processo de Edição
O relatório não é editável — é saída de leitura/impressão gerada a partir de lançamentos já registrados em outras rotinas do sistema.
8. Estrutura Técnica e Comportamento do Sistema
Gerado pelo Crystal Reports a partir de “~/Relatorios/WRBnc/WRBnc006.rpt”. A classe “WRBNC006” (em “ATAK.Relatorios.Implementacao.Financeiro”) consulta diretamente “SaldoBanco” (“TBSALDOBCO”), “ViewDeMovimentacaoFinanceiraBancaria” (“vwAtak4Net_movtofin_banco”, usada em três contextos: lançamentos do período, anteriores conciliados e não conciliados), “MovimentacaoFinanceira” (“TBMOVTOFIN”), “TituloPagar” (“TBTITULOPAG”) e “Cheque” (“TBCHEQUE”). É reaproveitada pelos relatórios “WRBNC007” (versão sintética) e “WRBNC009” (versão sempre conciliada), que a instanciam internamente.
9. Regras de Negócio e Restrições
Regra 1 — Saldo de banco Soma o saldo gravado na data anterior ao início do período, por carteira; se não houver saldo gravado para alguma carteira filtrada, o sistema busca a última conciliação existente para ela.
Regra 2 — Cheques a compensar Lista, em seção separada, os cheques emitidos para pagamento que ainda não foram conciliados, vinculados ao respectivo título a pagar em aberto — permitindo enxergar cheques que já saíram da empresa mas ainda não desceram do banco.
Regra 3 — Lançamentos do período Movimentações bancárias filtradas por data de lançamento ou de conciliação (conforme o parâmetro escolhido), classificadas em débito ou crédito.
Regra 4 — Lançamentos anteriores conciliados no período Lançamentos que foram lançados antes do início do período, mas cuja conciliação ocorreu dentro dele — só é calculado quando a consulta não é feita por data de conciliação nem com o reparte de lançamentos anteriores ativado.
Regra 5 — Lançamentos não conciliados Combina os lançamentos com conciliação prevista após o fim do período com os que simplesmente ainda não foram conciliados, eliminando duplicidade; só aparece se o parâmetro correspondente estiver marcado.
Regra 6 — Saldo final por carteira Cruza saldo do banco, movimentações do período, lançamentos não conciliados, lançamentos anteriores conciliados e cheques ainda não conciliados, calculando o saldo final real (posição de caixa efetiva) e o saldo final conciliado (posição já confirmada com o banco) por carteira — esta é a linha-resumo usada pelo relatório WRBNC007.
Regra 7 — Moeda “Ambas” Quando solicitado, o relatório calcula os mesmos valores tanto em moeda corrente quanto em moeda estrangeira, exibindo-os lado a lado.
—
WRBNC006 — Movimentação Financeira por Carteira
1. Visão Geral
Mostra o extrato analítico de movimentação financeira de cada carteira (banco/caixa) em um período: saldo inicial (real e/ou conciliado), cada lançamento bancário do período (data, documento, participante e valor), lançamentos anteriores que foram conciliados dentro do período, lançamentos ainda não conciliados, cheques emitidos ainda não compensados no contas a pagar, e o saldo final resultante por carteira. É usado tanto para conferência de extrato bancário quanto como base para o “WRBNC007 – Movimentação Financeira por Carteira (sintética)”, versão resumida deste mesmo relatório.
2. Como Acessar
Menu Financeiro > Relatórios (rotina “WRBnc006”).
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 incluídas |
| prmDataLancamento | Não | Intervalo de datas | Entre | Período de lançamento/conciliação analisado |
| prmCarteiraWRBNC006 | Não | Lista de seleção (múltipla) | Contido em | Carteiras (bancos/caixas) a incluir |
| prmConsideraSaldoConciliado | Não | Lista de seleção | Igual | Se o saldo anterior conciliado deve ser considerado no cálculo |
| prmEmiteLancamentoNaoConciliado | Não | Lista de seleção | Igual | Se lançamentos ainda não conciliados devem aparecer no relatório |
| prmCodigoMoeda | Não | Lista de seleção | Igual | Moeda dos valores exibidos; a opção “Ambas” mostra moeda corrente e estrangeira lado a lado |
| prmConsultarPorDataDeConciliacao | Não | Lista de seleção | Igual | Se o período filtra pela data de conciliação em vez da data de lançamento |
| prmReparteLancamentoAnterioresConciliados | Não | Lista de seleção | Igual | Se lançamentos anteriores conciliados dentro do período aparecem destacados separadamente |
4. Tabelas e Views Utilizadas
| Entidade/Classe C# | Tabela/View real no banco | O que representa |
|---|---|---|
| SaldoBanco | TBSALDOBCO | Saldo bancário registrado por data, usado como ponto de partida do período |
| ViewDeMovimentacaoFinanceiraBancaria (consultada em três contextos: lançamentos do período, anteriores conciliados, e não conciliados) | vwAtak4Net_movtofin_banco | Movimentações financeiras bancárias |
| MovimentacaoFinanceira | TBMOVTOFIN | Lançamentos financeiros — usada para localizar cheques emitidos ainda não compensados |
| TituloPagar | TBTITULOPAG | Título a pagar vinculado ao cheque emitido |
| Cheque | TBCHEQUE | Cadastro dos cheques emitidos, usado para obter o número físico do cheque |
5. Regras de Negócio e Cálculos
- Saldo de banco. Soma o saldo gravado na data anterior ao início do período, por carteira; se não houver saldo gravado para alguma carteira filtrada, o sistema busca a última conciliação existente para ela.
- Cheques a compensar. Lista, em seção separada, os cheques emitidos para pagamento que ainda não foram conciliados, vinculados ao respectivo título a pagar em aberto — permitindo enxergar cheques que já saíram da empresa mas ainda não desceram do banco.
- Lançamentos do período. Movimentações bancárias filtradas por data de lançamento ou de conciliação (conforme o parâmetro escolhido), classificadas em débito ou crédito.
- Lançamentos anteriores conciliados no período. Lançamentos que foram lançados antes do início do período, mas cuja conciliação ocorreu dentro dele — só é calculado quando a consulta não é feita por data de conciliação nem com o reparte de lançamentos anteriores ativado.
- Lançamentos não conciliados. Combina os lançamentos com conciliação prevista após o fim do período com os que simplesmente ainda não foram conciliados, eliminando duplicidade; só aparece se o parâmetro correspondente estiver marcado.
- Saldo final por carteira. Cruza saldo do banco, movimentações do período, lançamentos não conciliados, lançamentos anteriores conciliados e cheques ainda não conciliados, calculando o saldo final real (posição de caixa efetiva) e o saldo final conciliado (posição já confirmada com o banco) por carteira — esta é a linha-resumo usada pelo relatório WRBNC007.
- Moeda “Ambas”. Quando solicitado, o relatório calcula os mesmos valores tanto em moeda corrente quanto em moeda estrangeira, exibindo-os lado a lado.
- Extrato bancário por tipo. O mesmo levantamento também alimenta uma consulta de extrato bancário que pode ser filtrada por tipo: Conciliado, Real, ou apenas Tarifas (juros, acréscimo, desconto, multa, tarifa bancária).
6. Colunas Principais do Resultado
| Campo | Descrição de negócio |
|---|---|
| IdDaCarteira / NomeDaCarteira | Banco/caixa da linha |
| NivelDoRelatorio | Seção do extrato (saldo, lançamentos, anteriores conciliados, não conciliados, cheques, totalizador) |
| DataDoLancamento / DataDaConciliacao | Datas do lançamento e da conciliação bancária |
| IdDoDocumento / NumeroDoDocumento / SerieDoDocumento / NumeroDaParcela | Identificação do documento de origem |
| NomeDeCadastroNoTitulo | Nome do cliente/fornecedor envolvido no lançamento |
| Complemento | Histórico/observação do lançamento |
| ValorDebito / ValorCredito | Valor lançado a débito ou a crédito |
| StatusConciliado | Se o lançamento já foi conciliado com o extrato bancário |
| SaldoAnteriorReal / SaldoAnteriorConciliado | Saldo inicial da carteira (real e conciliado) |
| SaldoFinalReal / SaldoFinalConciliado | Saldo final calculado da carteira (real e conciliado) |
| TotalValorDebito / TotalValorCredito | Totais de débito/crédito por carteira no período |