UC00105 - Consulta de movimentação de cheques

Objetivo

• Consultar histórico de movimentações de cheques.

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 Movimentação de cheques. Este nome será utilizado para criar a página no Wiki.
• Garantir que todas rotinas que movimentam cheque no sistema estejam atualizando corretamente a situação e gerando o respectivo movimento (OcorrenciaCheque) para o cheque.

Resultado esperado

• Listar para cada cheque, todas as movimentações realizadas desde sua criação até seu status atual.

Diagrama de classes

Fluxo de eventos

Fluxos principais

Fluxo 1: Usuário acessa a rotina Menu > Consultas > Tesouraria > Movimentação de cheques.

• Sistema exibe a tela principal da rotina, com a aba de filtragem aberta contendo os campos citados na RN01.

Fluxo 2: Usuário informa os filtros desejados e aciona o botão <Filtrar>.

• Sistema lista no grid citado na RN02 os resultados encontrados com base nos filtros informados.

Fluxos alternativos

Fluxo 1: Após filtrar e listar os resultados no grid, usuário clica sobre o [+] na primeira coluna de um determinado cheque.

• Sistema expande os dados do cheque exibindo detalhes de suas movimentações conforme RN02.
• Caso usuário clique sobre o [+] na primeira linha do grid, onde ficam os nomes das colunas, todos os cheques terão seus detalhes expandidos ou recolhidos.

Fluxo 2: Uma vez que os resultados foram filtrados e listados no grid, usuário posiciona o mouse sobre o botão <Imprimir> no canto superior direito logo acima do grid.

• Sistema exibe ao usuário as opções de impressão para consulta (Word, PDF e Excel).
• Caso usuário clique sobre uma das opções exibidas, sistema gera impressão da consulta no formado escolhido.
• A impressão deverá listar os dados conforme estão listados no grid, ou seja, os que estão detalhados serão detalhados também na impressão e os que não estão detalhados também não serão detalhados na impressão.

Fluxo 3: Na aba de filtragem, usuário clica sobre o botão <Limpar>.

• Sistema limpa todos os filtros informados voltando-os para seu estado inicial.

Fluxos de exceção

Fluxo 1: Usuário informa filtros para os quais o sistema não possui nenhum resultado a exibir e aciona o botão <Filtrar>.

• Sistema emite ao usuário uma mensagem de alerta informando que não foram encontradas movimentações de cheque com base nos filtros informados.

Regras de negócio

RN01 - Tela de filtragem

Assim que o usuário acessar a rotina em questão será exibida uma aba com os seguintes filtros:

1. Filial: Campo (checkListBox) onde o usuário poderá selecionar uma ou mais filiais para filtragem.
2. Valor: Campos (inicial e final) onde o usuário poderá informar uma faixa de valores para listar cheques cujo valor está dentro da mesma.
3. Data de emissão: Campo onde o usuário poderá informar um período para listar cheques cuja data de emissão está dentro do mesmo.
4. Data de baixa: Campo onde o usuário poderá informar um período para listar cuja baixa foi realizada dentro do mesmo.
5. Tipo de cheque: Campo onde o usuário poderá selecionar o tipo de cheque que deseja visualizar na consulta. Os tipos serão:
   • À vista: Cheques cuja data de entrada é igual a data de emissão.
   • Pré-datado: Cheques cuja data de entrada é maior que a data de emissão.
   • Ambos: Considera ambos os tipos.
6. Situação: Campo onde o usuário poderá selecionar uma ou mais situações de cheques para filtragem. Por padrão todas as situações ficarão selecionadas. As situações do cheque serão as seguintes:
   • ABERTO
   • QUITADO (BAIXADO)
   • CUSTODIADO
   • DESCONTADO
   • DEVOLUÇÃO TEMPORÁRIA
   • DEVOLUÇÃO DEFINITIVA
7. Emitido/Recebido: Campo onde o usuário deverá, obrigatoriamente, informar se deseja filtrar cheques recebidos ou emitidos. Por padrão o valor deste campo será Recebido.

    
    Os únicos filtros obrigatórios serão a filial e se o cheque é emitido ou recebido.

Caso usuário acesse a rotina e acione o botão <Filtrar> sem informar nenhum filtro, o sistema terá como padrão os seguintes dados:

• Filial: Filial logada.
• Valor: Não será considerado na filtragem.
• Data de emissão e data de baixa: Será considerado o mês corrente.
• Tipo de cheque: Ambos.
• Situação: Todas.

RN02 - Listagem do resultado da consulta

Os resultados serão listados em um grid que possuirá mestre e detalhe (tabelaDetalhavel), onde no mestre serão exibidos os dados de um determinado cheque e no detalhe serão exibidas suas movimentações. O grid terá as seguintes colunas:

Mestre

1. FILIAL: Filial a qual o cheque pertence.
2. Nº CHEQUE: Número do cheque.
3. BANCO: Banco a qual o cheque pertence (número + nome).
4. AGÊNCIA: Código da agência do banco a qual o cheque pertence.
5. CONTA: Número da conta na agência a qual o cheque pertence.
6. EMISSÃO: Data de emissão do cheque.
7. ENTRADA: Data de entrada do cheque.
8. VALOR: Valor do cheque.
9. SACADO: Nome do sacado do cheque.
10. CPF/CNPJ: CPF ou CNPJ do sacado.
11. CLIENTE/FORNECEDOR: Cliente ou fornecedor do cheque, dependendo se o mesmo é recebido ou emitido.

Detalhe

1. SITUAÇÃO: Situação atual do cheque.
2. TIPO MOVIMENTO: Tipo de movimento que ocasionou a situação atual do cheque (ex: Depósito, Venda no PDV, Liquidação e etc).
3. DATA: Data em que o tipo movimento citado na coluna anterior ocorreu.
4. HISTÓRICO MOVIMENTO: Histórico gerado na movimentação do cheque.
5. DEVOLVIDO: Coluna que mostra se o cheque foi devolvido (Sim ou Não).
6. MOTIVO DEVOLUÇÃO: Caso cheque esteja devolvido, esta coluna mostrará o motivo da devolução (classe MotivoDevolucao).

Layouts sugeridos