Histórico da Página

Informações Gerais

   Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos). 

Objetivo

Adicionar tratamento de cálculo de juros e multas variáveis na rotina de liquidação e recebimentos de títulos, permitir a simulação de valores negociados e converter a rotina para MVC.

Definição da Regra de Negócio

Liquidação de títulos a receber

No processo de liquidação de títulos, quando o usuário selecionar títulos em atraso, será aplicado um percentual fixo de multa e calculado os juros sobre o período em atraso, conforme percentual listado na inclusão do título (padrão existente no sistema).

Configuração para cálculo de multa:

MV_JURTIPO = L (SIGALOJA)

MV_LJMULTA = Percentual de multa

MV_LJINTFS = .T. (Usa cálculo do SIGALOJA)

MV_TXPER = Percentual de Juros

MV_LJJUROS = Percentual de Juros

Será possível informar uma outra taxa de multa e/ou juros, que serão aplicadas no momento da simulação da liquidação, caso uma outra taxa seja negociada com o cliente.

Após a marcação dos títulos e seleção da condição de pagamento, quando necessário, haverá novo cálculo de juros sobre o valor negociado e este será corrigido. Abaixo um exemplo desta negociação.

Exemplo:

No dia 20/08/15, cliente entra em contato com a cobrança e solicita renegociação dos valores em aberto:

Cliente solicita um parcelamento dos valores em aberto em duas parcelas, a primeira a vista e a segunda para 30 dias.

No momento do parcelamento, os valores serão sugeridos pelo sistema, mas o usuário de cobrança poderá alterar o valor de juros, conforme a negociação com o cliente.

A alteração dos valores poderá ocorrer parcela a parcela da renegociação ou sobre o total renegociado, sendo este último aplicado à todos os títulos pertencentes à uma negociação.

Os títulos gerados de uma liquidação serão corrigidos quando baixados em uma data posterior ao vencimento negociados.

Após a negociação com o cliente o usuário poderá:

Liquidação

Gravar todos os passos da liquidação, baixar os títulos selecionados e gerar novos títulos com os valores acordados.

Os valores gravados ficarão disponível no relatório Acordos de Liquidação.

Simulação

Gravar todos os passos da liquidação com uma data de validade. Sendo assim, enquanto a simulação estiver vigente (dentro do prazo de validade), o usuário poderá alterar a simulação, alterar e efetivar a simulação.

Os valores gravados ficarão disponíveis no relatório Acordos de Liquidação.

Detalhamento técnico.

FINA460 - Liquidação a Receber

Reescrever a rotina FINA460 para MVC, mantendo suas funcionalidades, validações e pontos de entrada.

Função genérica para montagem de tela.

A funcionalidade da liquidação será disponibilizada para o módulo de Telecobrança, onde serão selecionados os títulos para um atendimento/cobrança e utilizaram a rotina de liquidação na tela do protótipos 02.

Para isso, reestruturar a função A460Liquid, dividindo-a em:

1. Seleção de dados (tela inicial);
2. Montagem do arquivo temporário, com dados coletados da seleção de títulos;
3. Montagem da tela de liquidação.

Importante: Manter todas as validações e gravações existentes.

Após a reestruturação, o módulo de telecobrança deverá chamar a função de montagem da tela de seleção de títulos.

Tela de Liquidação

Conforme protótipo de tela 02, para adicionar as informações:

FO0 - Cabeçalho da Liquidação

No cabeçalho da tela:

• Adicionar o campo Tx. Multa, iniciando com o percentual do parâmetro MV_LJMULTA;
• Adicionar o campo Tx Juros , iniciando com o percentual do parâmetro MV_TXPER/MV_LJJUROS.
• Adicionar o campo Tx Jur Ger, iniciando com o percentual do parâmetro MV_TXPER/MV_LJJUROS.
• Adicionar o 

Validações:

Os campos serão editáveis e quando manipulados serão replicados para os seus respectivos campos no grid da tela.

Retirar botão EDITAR localizado em ações relacionadas adicionar sua funcionalidade na grid da tela.

FO1 - Títulos Selecionados

No grid da seleção de títulos:

• Adicionar o campo %Multa, iniciando com o percentual do campo FO0_TXMUL;
• Adicionar o campo % Juros, iniciando com o percentual do campo FO0_TXJUR;
• Adicionar o campo Acréscimo, iniciando com o valor do campo E1_SDACRES e retirar a soma do seu conteúdo ao campo VALOR JUROS;
• Adicionar o campo Decréscimo, iniciando com o valor do campo E1_SDDECRE e retirar a soma do seu conteúdo ao campo VALOR DESCONTO;
• Adicionar os campos E1_EMISSAO e E1_BAIXA.

Ordenação da tela: similar a grid de geração título descrita abaixo.

Validações:

• Os campos da grid serão editáveis, sempre que alterados deverão recalcular os campos de juros/multa do título.
• Os campos de juros/multa deverão iniciar com o cálculo de juros/multa, com os percentuais de seus respectivos parâmetros.
• Os campos Juros/Multa serão somados ao campo Valor a liquidar.
• Caso os títulos selecionados sejam de uma moeda diferente da liquidação (FO0_MOEDA), deverá converter os dados para moeda da liquidação.

Regra de Cálculo:

• Multa - Chamar a função LojxRMul() para calcular a multa conforme percentual informado pelo usuário.
• Juros - Chamar a função LojxRJur() ou faJuros() para calcular os juros com percentual informado pelo usuário.
• Valor a Liquidar - Saldo do título + Multa + Juros + Acréscimo - Decréscimo - Desconto - Abatimento

FO2 - Títulos Gerados

Validações:

Quando o parâmetro MV_GRSEFLQ = .T.:

• Só irá gerar cheques a receber caso o tipo de título for igual a CH, caso o usuário informe outro tipo de título, deverá apresentar uma mensagem informando que não será gerado o cheque, para essa liquidação;
• Os campos Banco cheque, Agencia cheque, Conta cheque e Número cheque, serão obrigatórios quando o tipo de título for CH.

Ao alterar o campo Per. Juros deverá recalcular os campos de Juros e Valor da Parcela.

Ao alterar os campos acréscimos, decréscimos deverá recalcular o campo valor da parcela.

Ao alterar a data de vencimento do título deverá recalcular os campos de Juros e Valor da Parcela.

Serão permitidas alterações nas parcelas:

• Será permitida a inclusão de novas linhas ou a deleção de linhas existentes, ainda que o campo de Condição de Pagamento esteja preenchido.
• Será permitida a alteração dos valores das parcelas no decorrer da negociação.
  
  

Será validado o total negociado da seguinte forma:

• Obtém-se o total dos valores corrigidos (somatório da coluna 'Total Neg.') dos títulos selecionados na Grid  "Títulos Selecionados";
• Obtém-se o total dos valores das parcelas (somatório da coluna 'Val. Parcela') das parcelas informadas na Grid "Títulos Gerados";
• Caso o total das parcelas seja menor que o total dos valores dos títulos negociados, será apresentada mensagem ao usuário informando desta situação.
• Caso o total das parcelas seja maior que o total dos valores dos títulos negociados, não será apresentada qualquer mensagem ao usuário.
  

Regra de Cálculo

Juros - Chamar a função LojxRJur()/faJuros() para calcular os juros com percentual informado pelo usuário.

Será calculado o juros desde a data de negociação (data base), até a data de vencimento da nova parcela.

Função FA460Can

Ao cancelar a liquidação que possua simulação, apresentar a pergunta:

Cancela a simulação:

Se sim, deverá limpar o campo FO0_NUMLIQ e alterar o campo FO0_STATUS = 3 cancelado, para todas as versões vinculadas a simulação liquidada.

Se não, deverá limpar o campo FO0_NUMLIQ e restaurar o status anterior da simulação (FO0_STATUS=FO0_BKPSTT).

Conversão para MVC

Como a rotina será reescrita utilizando a tecnologia MVC, suas funções e pontos de entrada sofrerão algumas alterações.

Lista de Funções

Lista de Parâmetros

Lista de Pontos de entrada

FINA460B - Liquidação a receber

Irá conter a View para executar a leitura de cheques antes da abertura da tela de liquidação, ou seja, quando o parâmetro MV_CMC7FIN = S estiver ativo e a leitora de cheques configurada, quando o usuário clicar no botão liquidar irá apresentar a pergunta:

Deseja utilizar leitora cheque, caso o usuário informe SIM, será executada a função para leitora de cheques antes de abrir a VIEW com os campos de cheques preenchidos, caso contrário a rotina continuará conforme descrito no item FINA460.

Ações:

Os campos abaixo serão preenchidos pela função de leitora de cheques:

Os demais serão solicitados ao usuário.

FINA460A - Simulação de liquidação a receber

Criar uma rotina com browse baseada na tabela FO0, conforme o protótipo de dela 01, com as propriedades abaixo: 

Legenda

Cor	Descrição	Condição
	Simulação Bloqueada	FO0_STATUS = 2 - Bloqueada
	Simulação Vigente	FO0_STATUS = 1 - Ativo e o campo FO0_DTVALID >= database
	Simulação Cancelada	FO0_STATUS = 3 - Cancelada
	Simulação Vencida	FO0_STATUS = 1 - Ativo e o campo FO0_DTVALID < database
	Simulação Gerada	FO0_STATUS = 4
	Simulação Encerrada	FO0_STATUS = 5

Botão Incluir

Incluir uma simulação, irá apresentar os parâmetros iniciais da rotina FINA460, para seleção dos títulos, após preenchimentos dos parâmetros será apresentada o protótipo de tela 02.

Na tela de seleção de título será alterado apenas o título para SIMULAÇÃO DE LIQUIDAÇÃO, deverá usar a mesma função do fonte FINA460, apenas com essa alteração.

Na tela de geração de títulos adicionar o campo DATA VALIDADE, que será replicado para o campo FO0_DTVALID  e o botão EFETIVAR SIMULAÇÃO que irá efetuar liquidação dos títulos selecionados e gerar os novos conforme a simulação.

Ações:

Botão Salvar Simulação irá gravar somente a simulação.

Botão Efetivar Simulação, irá gravar a simulação e gerar a liquidação.

Validações 

A data de validade não poderá ultrapassar o limite definido no parâmetro MV_LMVLDLQ, ou seja, a data de validade não pode ser maior que a data da negociação somados o limite definido no parâmetro.

Botão Alterar 

Irá abrir os protótipos de tela 02, com os dados gravados das tabelas FO0, FO1, FO2, caso o usuário altere as informações será criada uma nova versão nas tabelas envolvidas.

Validações

Não poderão sofrer alteração as simulações: 

Ações:

Ao alterar uma simulação sistema deverá efetuar uma varredura nos títulos selecionados e verificar se houve alteração de saldo, caso ocorra deverá notificar o usuário, informando que houve movimentação dos títulos negociados, se deseja recalcular ou encerrar a simulação.

Se a somatória do saldos dos títulos envolvidos na liquidação for igual a zero, notificar o usuário que não pendencias de recebimentos para essa simulação.

Caso não haja alterações de saldos nos títulos envolvidos ou solicitado recalculo, deverá carregar os dados das telas da liquidação conforme o protótipo 02, para conferencia e/ou manipulação do usuário:

• Caso o usuário altere e clique novamente em Salvar Simulação, sistema irá gravar uma nova versão.
• Caso o usuário altere e clique novamente em Efetivar Simulação, sistema irá gravar uma nova versão e efetuar a liquidação normalmente.

Regra Recalculo:

Recalcular os valores de juros e multas, título a título, caso o título esteja com o saldo zero, será retirado do processo de negociação, para gravar o processo o usuário deverá selecionar a opção SALVAR SIMULAÇÃO ou EFETIVAR SIMULAÇÃO.

Botão Efetivar

Irá abrir o protótipo de tela 02, com os dados gravados das tabelas FO0, FO1, FO2, ao confirmar será gravada a liquidação dos títulos selecionados e gerar os novos conforme dados da simulação.

Os campos FO0_STATUS = 4 (gerada) e o campo FO0_NUMLIQ, com número da liquidação gerada.

Caso exista mais de uma versão para o mesmo processo de simulação, as demais simulações terão o campo FO0_STATUS alterado para liquidação 5 - Encerrada.

Antes da alteração de STATUS deverá gravar o conteúdo do campo FO0_STATUS no campo FO0_BKPSTT.

Validações

Todos os campos estarão disponíveis apenas para visualização.

Ações:

Ao alterar uma simulação sistema deverá efetuar uma varredura nos títulos selecionados e verificar se houve alteração de saldo, caso ocorra deverá notificar o usuário, informando que houve movimentação dos títulos negociados, se deseja recalcular ou encerrar a simulação.

Se a somatória do saldos dos títulos envolvidos na liquidação for igual a zero, notificar o usuário que não pendencias de recebimentos para essa simulação.

Caso não haja alterações de saldos nos títulos envolvidos ou solicitado recalculo, deverá carregar os dados das telas da liquidação conforme o protótipo 02, para conferencia e/ou manipulação do usuário.

Recalculo:

Recalcular os valores de juros e multas, título a título, caso o título esteja com o saldo zero, será retirado do processo de negociação, para gravar o processo o usuário deverá selecionar a opção SALVAR.

Botão Visualizar 

Irá apresentar o protótipo de tela 02, para conferência.

Validações

Todos os campos estarão disponíveis apenas para visualização.

Botão Bloquear

Irá apresentar o protótipo de tela 02, para conferência, se o usuário clicar na opção SALVAR, deverá alterar o campo FO0_STATUS para 2 (bloqueado).

Validações

Todos os campos estarão disponíveis apenas para visualização.

Botão Relatório

Irá chamar o relatório FINR460A.

Funções Genéricas.

Função de Gravação.

Ao confirmar uma liquidação serão gravadas as tabelas:

FO0 - Cabeçalho da Liquidação

FO1 - Títulos Selecionados

FO2 - Títulos Gerados

Gravação de Simulação.

Serão gravados as tabelas FO0, FO1, FO2 com os campos FO0_STATUS= 1 e FO0_NUMLIQ em branco.

Gravação do Versão.

Será gravado uma nova versão da simulação com dados da tela, mantendo o mesmo número de processo (FO0_PROCES) e incrementando apenas o campo FO0_VERSAO, ou seja, será realizada a gravação das tabelas FO0, FO1, FO2 com os dados em tela com o mesmo número do processo alterado, com uma versão diferente.

FINA460LOAD - Funções Genéricas

Na inclusão de uma liquidação ou simulação, alguns campos da tela deverão ser preenchidos conforme os parâmetros preenchidos pelo usuário para seleção dos títulos a serem liquidados, para tal deverá criar funções genéricas de montagem de tela, para fazer o carregamento dos dados das tabelas FO0 e FO1 dos campos reais e virtuais:

FO0 - Cabeçalho da liquidação / Simulação

FO1 - Títulos Selecionados

FINR460A - Relatório de simulação

Emitir o relatório baseado nas tabelas FO0, FO1, FO2, conforme protótipo de tela 04, com a estrutura abaixo em formato de paisagem.

FO0 X SA1 - Cabeçalho do processo

FO0, FO1, FK7, SE1 - Títulos selecionados

FO0, FO2 - Títulos Gerados

Relacionamento entre as Tabelas

O relatório será quebrado por processo de negociação, divididos em três sessões (FO0, FO1, FO2), irá buscar dados conforme grupo de perguntas FINR460A, demonstrado no protótipo de tela 03.

FINA740 - Funções de Contas a Receber

Adicionar chamada da rotina de Simulação - FINA460A

FINXBX - Funções genéricas 

Ajustar a função faJuros para efetuar o calculo de juros conforme vencimento passado do título.

Impostos na Liquidação

Para a seleção de títulos, optaremos pela regra da natureza mais completa, ou seja, os impostos da natureza do título origem devem estar contidos na da natureza da liquidação para serem elegíveis à seleção de uma liquidação. Desta forma a seleção ficará mais flexível e garantimos as questões fiscais.

Além disso, será equalizado o uso do parâmetro MV_RTIPFIN, utilizado no faturamento, para retenção dos impostos na primeira parcela de títulos provenientes de notas (Como o IR, por exemplo).

Exemplo

Considerando os títulos e os impostos calculados pela natureza financeira abaixo (seja pela emissão ou pela baixa):

Situação 1

Caso na negociação seja informada uma natureza para a liquidação que tenha a configuração de PIS, COFINS, CSLL, IR e ISS, somente o título A será liquidado.

(Este exemplo contempla a correção do titulo pela liquidação)

Situação 2

Caso na negociação seja informada uma natureza para a liquidação que tenha a configuração de PIS, COFINS, CSLL, IR, INSS e ISS, ambos os títulos serão oferecidos para a liquidação. As bases acompanharão os impostos calculados:

Exemplo 2

Temos

• Uma nota parcelada em 3 vezes (O IR foi totalmente retido na primeira parcela).
• Uma segunda nota parcelada em duas vezes (O IR foi totalmente retido na primeira parcela).

Não haverá retenção do IR pois a retenção existiu nas primeiras parcelas de ambas as notas. Portanto, só carregaremos, para as novas parcelas, os impostos que estiverem contidos nas notas que forem liquidadas.

Teríamos as seguintes parcelas:

Tabelas Utilizadas

• FK1 - Baixas a Receber
• SE1 - Contas a Receber
• SED - Naturezas
• SA1 - Clientes
• FK6 - Valores acessórios
• FO0 - Cabeçalho da Simulação
  
• FO1 - Títulos Negociados
• FO2 - Títulos gerados

Opcional

Protótipo de Tela

Protótipo de tela 01

 Protótipo de tela 02

Protótipo de Tela 03

Protótipo de Tela 04