UC00085 - Estorno de liquidação pagar/receber

Objetivo

• Manter estorno de liquidação de documentos a pagar/receber.

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 Estorno de liquidação. Este nome será utilizado para criar a página no Wiki.

Resultado esperado

• Estornar o movimento de liquidação de documentos a pagar/receber voltando cada documento para seu estado/situação anterior à liquidação estornada.

Diagrama de classes

Fluxo de eventos

Fluxos principais

Fluxo 1: Usuário acessa a rotina Menu -> Movimentos -> Pagar/Receber -> Estorno de liquidação.

• Sistema exibe a tela inicial (de manutenção) da rotina em questão conforme regra de negócio RN01.

Fluxo 2: Usuário informa dados para filtrar liquidações simples/em lote já realizadas e aciona o botão <Filtrar>.

• Sistema apresenta os registros encontrados no grid conforme regra de negócio RN02.

Fluxo 3: Usuário seleciona registros de liquidação que deseja estornar e em seguida aciona o botão <Estornar>.

• Sistema procede conforme regras de negócio RN04 e RN03.

Regras de negócio

RN01 - Tela inicial/manutenção

A tela inicial da rotina deverá apresentar um grid (vazio) onde serão listadas as liquidações filtradas e também uma aba de consulta para o usuário buscar as liquidações que deseja estornar.

A aba de consulta deverá apresentar os seguintes filtros:

1. Cliente/Fornecedor: Campo onde deverá ser informado o cliente (para receber) ou fornecedor (para pagar) para qual existem movimentos de liquidação a estornar.
2. Período de liquidação: Campo onde deverá ser informado um período inicial e final onde o sistema deverá buscar por movimentos de liquidações.
3. Tipo de documento: Campo onde deverá ser informado um tipo de documento específico utilizado no(s) documento(s) contidos na liquidação a ser estornada.
4. Valor: Campo onde deverá ser informada uma faixa de valor de liquidação para buscar movimentos de liquidação cujo total está compreendido na faixa informada.
5. Código do documento: Campo onde deverá ser informado o código do documento a pagar/receber cuja liquidação será estornada. Através do código do documento o sistema irá buscar pelo movimento de liquidação do mesmo.
6. Nº liquidação: Campo onde deverá ser informado o número da liquidação (simples ou em lote) a ser estornada.
7. Botão <Limpar>: Quando acionado, limpa todos os filtros informados voltando-os a seu estado inicial.
8. Filtrar: Quando acionado, com base nos filtros informados, busca por movimentos de liquidação e exibe o resultado no grid.

O grid onde serão listadas as liquidações filtradas apresentará os seguintes dados:

1. SEL.: Coluna onde será apresentado, para cada liquidação, um checkbox que permitirá selecionar uma ou mais liquidações a serem estornadas.
2. VLR. LIQUIDAÇÂO: Coluna que exibe o valor total da liquidação.
3. TIPO LIQ.: Coluna que informa se a liquidação foi TOTAL ou PARCIAL. No caso de liquidação em lote, esta informação só será exibida na tela pop-up exibida quando for acionado o botão <Exibir> da coluna DOCUMENTOS.
4. Nº LIQ: Número da liquidação, seja ela simples ou em lote. Quando exibindo liquidações em lote, todos os documentos pertencentes a uma determinada liquidação terão o mesmo Nº LIQ.
5. DATA: Coluna que exibe a data da liquidação.
6. LIQUIDAÇÃO: Coluna que informa se a liquidação foi SIMPLES ou EM LOTE.
7. DOCUMENTO: Coluna onde será exibido o número do documento liquidado. No caso de liquidação em lote, para cada liquidação, no lugar do número do documento será exibido o botão <Exibir>. Quando acionado este botão exibirá em um pop-up, para cada documento do lote, os seguintes dados:
   • TIPO LIQ: Se o documento foi total ou parcialmente liquidado.
   • DOCUMENTO: Coluna onde será exibido o número do documento liquidado.
   • TD: Tipo de documento.
   • VLR. DOC: Valor do documento.
   • JUROS: Valor de juros do documento no dia da liquidação.
   • MULTA: Valor de multa do documento no dia da liquidação.
   • ACRÉSCIMO: Valor de acréscimo do documento no dia da liquidação.
   • DESCONTO: Valor de desconto do documento no dia da liquidação.
   • VLR. PAGO: Valor pago para cada documento na liquidação.
8. TD: Tipo do documento liquidado (somente para liquidação simples).
9. VLR. DOC: Valor do documento liquidado (somente para liquidação simples).
10. JUROS: Valor de juros do documento no dia da liquidação (somente para liquidação simples).
11. MULTA: Valor de multa do documento no dia da liquidação (somente para liquidação simples).
12. ACRÉSCIMO: Valor de acréscimo do documento no dia da liquidação (somente para liquidação simples).
13. DESCONTO: Valor de desconto do documento no dia da liquidação (somente para liquidação simples).
14. VLR. PAGO: Valor pago para o documento na liquidação (somente para liquidação simples).
15. FORMAS DE PAGAMENTO: Nesta coluna será exibido um botão que quando acionado, exibirá em uma tela pop-up as formas de pagamento utilizadas em uma determinada liquidação.

Na parte inferior da tela inicial serão exibidos os seguintes botões:

1. Estornar: Quando acionado, realiza o movimento de estorno de liquidação em todas as liquidações selecionadas no grid diante uma mensagem de confirmação.
2. Cancelar: Aborta qualquer operação e fecha a rotina de estorno de liquidação.

RN02 - Filtragem/exibição de liquidações

1. Todos os registros de liquidação de um determinado documento serão exibidos no grid se estiverem compreendidos nos filtros informados. Exemplo: Se um documento teve uma liquidação parcial e depois uma liquidação total, e estas estiverem compreendidas na filtragem, ambas serão exibidas no grid.
2. Registros de liquidação em lote serão exibidos em uma única linha, cada uma referente a uma liquidação em lote diferente. Nesta linha haverá botões que permitirão ao usuário visualizar os documentos liquidados e também as formas de pagamento utilizadas.
3. Para liquidações simples, também será possível visualizar a forma de pagamento utilizada clicando no botão <Exibir> da coluna FORMA DE PAGAMENTO.

RN03 - Estorno de liquidação

Ao estornar um movimento de liquidação o sistema deverá marcar como "estornado" o(s) movimento de liquidação selecionado(s) e voltar cada documento para a situação em que estava antes do movimento de liquidação atualizando todos os seus valores. Além disto, o sistema deverá gerar um movimento de "estorno de liquidação".

RN04 - Seleção de liquidações para estorno

Caso um determinado documento possua mais de uma liquidação/agrupamento e estas estejam listadas no grid, o sistema só permitirá que o usuário selecione a última liquidação/agrupamento. Após a última liquidação ser selecionada, o sistema habilitará a liquidação/agrupamento anterior para que o usuário a selecione, habilitando assim a liquidação anterior e assim por diante. Caso usuário tente selecionar uma liquidação/agrupamento que possui um liquidação/agrupamento posterior não selecionada, o sistema deverá abortar a seleção e emitir ao usuário a seguinte mensagem de alerta: Não é permitido selecionar para estorno uma liquidação/agrupamento que possua uma ou mais liquidações/agrupamentos posteriores não selecionadas. Sugestão: Selecione primeiro as liquidações mais recentes para depois selecionar as liquidações mais antigas..

DOCUMENTO	VENCIMENTO	Nº LIQ
AG0000012701-A	01/01/2014	121

Em outras palavras, uma liquidação não poderá ser selecionada para estorno enquanto houver uma liquidação posterior não selecionada para estorno.

Caso um determinado documento possua mais de uma liquidação e a ultima ou as últimas liquidações não estejam listadas no grid, quando usuário tentar selecionar uma liquidação que esteja listada no grid o sistema não permitirá a seleção e emitirá a seguinte mensagem de alerta: Este documento possui movimentos de liquidação posteriores a este e portando esta liquidação não poderá ser selecionada para estorno. Sugestão: Faça a filtragem de forma que todas as liquidações deste documento sejam exibidas no grid..