UC00127 - Movimento bancário

Objetivo

• Manter movimentos bancários.

Atores

• Usuário

Pré-requisitos

• Considerar documento Padrões de desenvolvimento.
• No projeto da rotina, em confsrc > META-INF > messages > view.properties definir o nome como Movimento bancário. Este nome será utilizado para criar a página no Wiki.

Resultado esperado

• Realizar movimentos bancários

Diagrama de classes

Fluxo de eventos

Fluxos principais

Fluxo 1:

Fluxos alternativos

Fluxo 1:

Fluxos de exceção

Fluxo 1: Usuário possui uma conta contábil informada no tipo de lançamento bancário, mas no banco utilizado no movimento bancário não.

• Ao salvar o movimento bancário o sistema não gera movimento contábil e emite ao usuário a seguinte mensagem de alerta: O tipo de lançamento bancário utilizado possui uma conta contábil informada em seu cadastro, mas não será possível gerar contabilidade para este movimento bancário uma vez que no cadastro do banco utilizado não ha conta contábil informada.

Fluxo 2: Usuário possui uma conta contábil informada no cadastro do banco, mas no cadastro do tipo de lançamento bancário utilizado não.

• Ao salvar o movimento bancário o sistema não gera movimento contábil e emite ao usuário a seguinte mensagem de alerta: O banco utilizado possui uma conta contábil informada em seu cadastro, mas não será possível gerar contabilidade para este movimento bancário uma vez que no cadastro do tipo de lançamento bancário utilizado não ha conta contábil informada.

Fluxo 3: Usuário possui conta contábil informada nos cadastros do banco e do tipo de lançamento bancário utilizados, mas tenta salvar a movimentação sem selecionar um histórico contábil.

• Sistema aborta a movimentação (bancária e contábil) e emite ao usuário a seguinte mensagem de alerta: O banco e tipo de lançamento bancário utilizados possuem em seu cadastro uma conta contábil informada, portanto será necessário selecionar um histórico contábil para concluir esta operação.

Fluxo 4: Usuário utiliza um tipo de lançamento bancário que possui uma conta contábil informada em seu cadastro, mas que não exige a informação do Nº Documento. Tendo também um banco que também possui conta contábil informada em seu cadastro e um histórico contábil que utiliza o coringa $DOC informados, o usuário tenta salvar a movimentação bancária sem informar o Nº Documento.

• Sistema aborta a operação e emite ao usuário a seguinte mensagem de alerta: O histórico contábil selecionado utiliza o coringa $DOC e portanto a informação do campo "Nº Documento" é obrigatória independente do tipo de lançamento bancário selecionado exigi-la ou não.

Regras de negócio

RN01 - Tela de pesquisa

Exibirá os movimentos bancários já realizados em um grid com as seguintes colunas:

1. FILIAL
2. DATA DE MOVIMENTO
3. TIPO DE LANÇAMENTO: Tipo de lançamento bancário utilizado.
4. BANCO
5. AGENCIA
6. CONTA
7. Nº DOCUMENTO
8. VALOR
9. HISTÓRICO BANCÁRIO

No canto superior esquerdo da tela estará disponível o botão [Adicionar movimento bancário] que quando acionado direcionará o usuário para tela de manutenção em modo de inclusão.

No canto superior direito estará disponível a aba de consulta, que permitirá ao usuário filtrar as movimentações já realizadas com os seguintes filtros:

1. Período de movimento: Campo onde o usuário poderá informar uma data inicial e final para filtrar movimentações cuja data de movimento está compreendida no período informado.
2. Banco: Lista todos os bancos cadastrados para que o usuário selecione um banco para filtrar movimentações realizadas com o mesmo.
3. Agência: Lista todas as agencias cadastradas e vinculadas ao banco selecionado para filtrar movimentações realizadas com a mesma.
4. Conta: Lista todas as contas cadastradas e vinculadas a agência selecionada para filtrar movimentações realizadas com a mesma.

RN02 - Tela de manutenção

1. Filial: Campo onde são listadas todas as filiais cadastradas, ativas e que são acessíveis pelo usuário logado. Será permitido selecionar apenas uma filial.
2. Data de movimento: Campo onde o usuário deverá informar uma data para a movimentação.
3. Tipo de lançamento bancário: Campo onde serão listados todos os tipos de lançamentos bancários cadastrados para que o usuário selecione um único tipo a ser utilizado no movimento bancário.
4. Banco: Campo onde serão listados todos bancos cadastrados no sistema para que o usuário selecione um banco a ser utilizado na movimentação.
5. Agência: Campo onde serão listadas todas as agências cadastradas e vinculadas ao banco selecionado. Será permitido selecionar apenas uma agência para a movimentação.
6. Conta: Campo onde serão listadas todas as contas cadastradas e vinculadas a agência selecionada. Será permitido selecionar apenas uma conta.
7. Nº Documento: Campo onde poderá ser informado um número de documento para a movimentação bancária. Esta informação poderá ser obrigatória ou não ou poderá ser repetida em diferentes movimentações de acordo com a configuração do tipo de lançamento bancário selecionado.
8. Valor: Campo onde o usuário deverá informar o valor da movimentação bancária.
9. Histórico bancário: Campo onde o usuário poderá informar um histórico para a movimentação bancária.
10. Conta caixa: Visível somente quando o tipo de lançamento bancário utilizado esta configurado para informar a conta caixa opcional ou obrigatoriamente, neste campo o usuário poderá/deverá informar uma conta caixa a ser vinculada à movimentação bancária.
    • Caso o tipo de lançamento bancário esteja configurado para gerar caixa, na conta informada será gerado um movimento de caixa no valor do movimento bancário.
    • Se o tipo de lançamento bancário possuir uma conta caixa padrão esta será automaticamente preenchida no campo em questão, permitindo que o usuário a altere se desejar.
11. Centro de custo: Visível somente quando o tipo de lançamento bancário utilizado está configurado para informar centro de custo opcional ou obrigatoriamente, neste campo o usuário poderá/deverá informar um centro de custo a ser vinculado à movimentação bancária.
    • Se o tipo de lançamento bancário possuir um centro de custo padrão este será automaticamente preenchido no campo em questão, permitindo ao usuário altera-lo se desejar.
    • Logo à direita do campo Centro de custo, enquanto o mesmo não estiver preenchido será exibido o botão [Rateio] que quando acionado exibirá a tela Rateio do centro de custo, onde o usuário poderá ratear o valor do movimento bancário entre diferentes centros de custo.
12. Histórico contábil: Visível somente quando houver informada nos cadastros do tipo de lançamento bancário e banco uma conta contábil, neste campo o usuário deverá selecionar, obrigatoriamente, um histórico contábil a ser utilizado para gerar o movimento contábil. Serão listados todos os históricos contábeis cadastrados e ativos no sistema.

Movimentações

Bancária

O sistema gerará um movimento de débito ou crédito (depende do tipo de lançamento bancário) não conciliado no banco/agência/conta informados. Este movimento poderá ser visualizado posteriormente na rotina de consulta de extrato bancário.

Caixa

Se o tipo de lançamento bancário utilizado possuir marcado em seu cadastro o parâmetro Gerar movimento de caixa setá gerado na conta caixa informada na movimentação bancária um movimento de caixa com o valor da movimentação bancária. Para o movimento de caixa gerado automaticamente devem ser observados:

• O histórico do movimento de caixa será o mesmo histórico informado para movimentação bancária.
• A natureza do movimento de caixa será inversa à natureza do movimento bancário. Se o tipo de lançamento bancário é de débito (saiu dinheiro do banco) será gerado um movimento de crédito no caixa. Se o tipo de lançamento bancário é de crédito (entrou dinheiro no banco) será gerado um movimento de débito no caixa.

Contábil

Se no tipo de lançamento bancário utilizado o parâmetro Gerar movimento contábil estiver marcado como Sim, o sistema deverá proceder conforme segue abaixo.

NAT. TIPO LANC. BANCÁRIO	MOVIMENTO CONTÁBIL
Débito	Crédito na conta do banco -> Débito na conta do tipo de lançamento bancário
Crédito	Débito na conta do banco -> Crédito na conta do tipo de lançamento bancário

Ao gerar o movimento contábil os coringas do histórico selecionado deverão ser considerados da seguinte maneira:

1. $N: Caso o histórico contábil selecionado utilize este coringa será exibido logo abaixo do histórico o campo Nº Doc. Contábil onde o usuário deverá, obrigatoriamente, informar um número equivalente ao documento contábil antes de salvar a movimentação.
2. $OBS: Caso histórico contábil selecionado utilize este coringa será exibido logo abaixo do campo do histórico o campo Obs. Contábil onde o usuário deverá, obrigatoriamente, informar uma observação.
3. $DMA: Caso histórico contábil selecionado utilize este coringa, quando o mesmo for gravado no movimento contábil ele será substituído pelo dia, mês e ano corrente.
4. $DOC:Caso histórico contábil selecionado utilize este coringa, quando o mesmo for gravado no movimento contábil ele será substituído pelo Nº Documento informado para a movimentação bancária.

    
    Um determinado histórico contábil poderá utilizar simultaneamente mais de um coringa, sendo assim, os campos respectivos a cada um devem ser renderizados abaixo do histórico 
    na ordem em que são informados no próprio histórico.

Quadro de dados

NOME	OBRIGATÓRIO	TIPO DE ENTRADA	VALORES POSSÍVEIS	TAMANHO	VALOR PADRÃO	OBSERVAÇÃO
Filial	Sim	Combobox	Filiais cadastradas cujo usuário logado possui acesso		Filial logada
Data do movimento	Sim	Input	Datas		Data de login
Tipo de lançamento bancário	Sim	Combobox	Tipos de lançamentos bancários cadastradas		Vazio
Banco	Sim	Input+Combobox	Bancos cadastrados no sistema		Vazio
Agência	Sim	Input+Combobox	Agências cadastradas no sistema e vinculadas ao banco informado		Vazio
Conta	Sim	Input+Combobox	Contas cadastradas no sistema e vinculadas a agência informada		Vazio
Nº Documento	De acordo com o tipo de lançamento bancário	Input	Alfanuméricos	15	Vazio
Valor	Sim	Input	Numéricos		Vazio
Histórico bancário	Sim	Input	Alfanuméricos	120	Vazio
Conta caixa	De acordo com o tipo de lançamento bancário	Input	Contas caixa cadastradas no sistema		Vazio ou conta padrão do tipo de lançamento	A natureza da conta (débito ou crédito) dependerá da natureza do tipo de lançamento bancário.
Centro de custo	De acordo com o tipo de lançamento bancário	Combobox	Centros de custos cadastrados no sistema		Vazio ou centro de custo padrão do tipo de lançamento