Histórico da Página

Informações Gerais

IMPORTANTE: Esta é a fase 1 da estrutura de Valores Acessórios no Financeiro (SIGAFIN).

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

Objetivo

Desenvolver uma rotina que permita aos usuários criar valores adicionais aos títulos, para somar ou subtrair do valor pago, por exemplo: 

• Juros adicionais;
• Mais de um tipo desconto;
• Outros valores para tributos;
•  Entre outros.

Definição da Regra de Negócio

Atualmente o sistema permite a inclusão de valores adicionais de pagamento como acréscimo, decréscimos, juros calculados, abatimentos vinculados ao título.
Para ter múltiplas regras de descontos, juros, multas e outros valores, será desenvolvido um cadastro de tipos de valores acessórios, conforme protótipo de tela 01.
Cadastro dos tipos de valores que poderão ser somados ou subtraídos dos valores pagos, que permitirá o usuário definir regras:

• Código;
• Descrição;
• Ação: Soma ou Subtrai;
• Tipo de Valor: Percentual ou Valor;
• Periodicidade: Sempre, Diário, Mensal, Anual;
• Aplicação: Até a data de vencimento, Depois da data de vencimento ou fixa;
• Regra de aplicação: regra definida pelo usuário em ADVPL para regras especificas.

 Regra de Cálculo

 A regra de cálculo abaixo deverá vir pré-definida, pois nesta etapa da implementação dos Valores Acessórios o cadastro de valores acessórios será restringido.

Observação: Nesta etapa da implementação, haverá somente uma regra de cálculo pré-definida e que será aplicada apenas aos títulos que possuem INSS. O cadastro de Valores Acessórios será restringido nessa etapa.

Exemplo:

Através do cadastramento dos tipos de valores acessórios, o usuário poderá vincular o valor acessório aos títulos a pagar.
Para adicionar um valor acessório a um título, usuário deverá alterá-lo vinculando o tipo de valor acessório e seu valor.
Um título poderá ter vários valores acessórios vinculado ao mesmo pagamento.

Baixa Total:

Gravação nas Tabelas:

Caso o valor informado na baixa seja menor do que o valor acessório:

Detalhamento Técnico

FINA035 - Tipo de Valores Acessórios

Desenvolver uma tela em MVC conforme protótipo de tela 01, para gravação dos tipos de valores acessórios, baseado na tabela FKC.

Gravação da tabela FKC - Tipos de Valores Acessórios

Validações

Registros com os campos FKC_FILIAL+FKC_CODIGO, não poderá repetir.
Caso um tipo de valor acessório estiver amarrado a um título não poderá ser excluído, quando o usuário tentar excluir deverá apresentar uma mensagem informando que deverá desativar o tipo de valor.
Se um tipo de valor acessório estiver amarrado a um título, e o usuário solicitar a alteração, deverá ser apresentada uma mensagem informando ao usuário que o mesmo possui amarração, portanto se alterar seu conteúdo, todos os títulos passaram a seguir as regras atualizadas.

FINA050 - Títulos a Pagar

Adicionar um botão no browse das contas a pagar, “Valores Acessórios” que irá abrir o protótipo de tela 02, para vincular valores acessórios ao título posicionado.

FINA870C - Entrada de Valores Acessórios

Desenvolver uma tela em MVC, conforme protótipo de tela 02, para amarração do título aos valores acessórios, baseado nas tabelas SE2 e FKD. Essa tela será acionada pelo botão "Valores Acessórios", no browse das contas a pagar.

Campos da tabela SE2 – Títulos a pagar

Chamar a função FINGRVFK7 para gravar a chave da tabela SE2 x FK7 x FKD.

Tabela FKD - Valores Acessórios

Validações:

O usuário só poderá vincular valores acessórios nos títulos com saldo maior que zero.
Não poderá ter dois valores acessórios com o mesmo código (FKC_CODIGO), ou seja, os campos FKD_FILIAL + FKD_CODIGO + FKD_IDDOC não poderá repetir.
O valor acessório fixo (FKD_PERIOD=FIXO e FKD_TPVAL= VALOR), no caso de subtração (FKD_ACAO=SUBTRAÇÃO) não poderá ser maior que o saldo do título.
O usuário poderá informar vários valores acessórios por título (Exceto nesta primeira etapa da implementação de valores acessórios no financeiro).
Os valores acessórios só poderão ser deletados, caso o campo FKC_DTBAIX estiver em branco.
Os títulos do tipo listados nas variáveis MVPROVIS (PR), MVTXA (TXA), MVABATIM (AB-), MVPAGANT (PA) e MV_CPNEG (NDF), não poderão ter valores acessórios.

Funções genéricas

Criar funções genéricas para retornar o valor acessório para ser somado ou subtraído ao valor pago, conforme tipo de valor acessório (FKC) e valor atribuído (FKD), para atender a regra de cálculo definida acima.

Sugestão de desenvolvimento

Buscar informação

Se o campo FKC_APLIC for igual até a data de vencimento, será executado o cálculo se a data base for menor ou igual ao vencimento do título.
Se o campo FKC_APLIC for igual após a data de vencimento, será executado o cálculo se a data base for maior ou igual ao vencimento do título.
Se o campo FKC_APLIC for igual sempre, será executado o cálculo independente da data base e o vencimento do título.
Ou o campo FKC_SALDO > 0.

Calcular

Verificar o período de cálculo:

Se o campo FKC_DTBAIX estiver vazio:

• Se o campo FKC_APLIC for igual até a data de vencimento, verificar o período entre a data de emissão do título e a data de baixa, retornando em dias.
• Se o campo FKC_APLIC for igual após a data de vencimento, verificar o período entre a data de vencimento do título e a data de baixa, retornando em dias.
• Se o campo FKC_APLIC for igual sempre, retornará sempre 1.

Caso contrário:

• Se o campo FKC_APLIC for igual até a data de vencimento, verificar o período entre a FKC_DTBAIX e a data de baixa, retornando em dias.
• Se o campo FKC_APLIC for igual após a data de vencimento, verificar o período entre a FKC_DTBAIX e a data de baixa, retornando em dias.
• Se o campo FKC_APLIC for igual sempre, retornará sempre 1.

Com o retorno do período de cálculo agrupar eles conforme o campo FKC_PERIOD.

Se o campo FKC_PERIOD for diário, não haverá alteração no período,
Se o campo FKC_PERIOD for mensal, serão agrupados em períodos de 30 dias.
Se o campo FKC_PERIOD for anual, serão agrupados em períodos de 360 dias.
Se o campo FKC_PERIOD for sempre, retornará 1.

Após a definição dos períodos de cálculo, definir o fator de calculo

Se o campo FKC_TPVAL for igual valor, deverá retornar o valor informado no campo FKC_VALOR.
Se o campo FKC_TPVAL for igual percentual, deverá o percentual informado no campo FKC_VALOR, ao saldo do título.

Após localizar o fator de cálculo, deverá multiplica-lo pelos períodos e somar o resultado ao campo FKC_SALDO.

Retorno

Se o campo FKC_ACAO for soma, o retorno da função poderá ser positivo, caso contrário negativo.
FKC_REGRA – Será aplicado antes do retorno
Se o valor retornado for negativo, não poderá ultrapassar o saldo do título, caso ocorrera deverá retornar exatamente o saldo do título, para que o pagamento seja igual a zero, por exemplo:
E2_SALDO+E2_SDACRES-E2_SDDECRE-Juros-desconto+Multa-Abatimentos>=Valor acessório, deverá retornar como negativo a somatória: E2_SALDO+E2_SDACRES-E2_SDDECRE-Juros-desconto+Multa-Abatimentos.

Gravação:

Ao baixar um título deverão gravar os campos:

<Atualmente o sistema permite a inclusão de valores adicionais de pagamento como acréscimo, decréscimos, juros calculados, abatimentos vinculados ao título.>

<Para ter múltiplas regras de descontos, juros, multas e outros valores, será desenvolvido um cadastro de tipos de valores acessórios, conforme protótipo de tela 01.>

<Cadastro dos tipos de valores que poderão ser somados ou subtraídos dos valores pagos, que permitirá o usuário definir regras:>

<Regra de negócio é o que define a forma de fazer o negócio, o processo definido e/ou as regras que devem ser contempladas. Devem ser descritas restrições, validações, condições e exceções do processo. Caso necessário, incluir neste capítulo também regras de integridade que devem ser observadas no momento do desenvolvimento>.

<Na tabela abaixo informe quais são as rotinas envolvidas, o tipo de operação, a opção de menu e se necessário uma breve descrição das regras de negócio relacionadas a rotina>.

Definição da Regra de Negócio

<Regra de negócio é o que define a forma de fazer o negócio, o processo definido e/ou as regras que devem ser contempladas. Devem ser descritas restrições, validações, condições e exceções do processo. Caso necessário, incluir neste capítulo também regras de integridade que devem ser observadas no momento do desenvolvimento>.

<Na tabela abaixo informe quais são as rotinas envolvidas, o tipo de operação, a opção de menu e se necessário uma breve descrição das regras de negócio relacionadas a rotina>.

Opcional

Protótipo de Tela

<Caso necessário inclua protótipos de telas com o objetivo de facilitar o entendimento do requisito, apresentar conceitos e funcionalidades do software>.

Protótipo 01

Opcional

Fluxo do Processo

<Nesta etapa incluir representações gráficas que descrevam o problema a ser resolvido e o sistema a ser desenvolvido. Exemplo: Diagrama - Caso de Uso, Diagrama de Atividades, Diagrama de Classes, Diagrama de Entidade e Relacionamento e Diagrama de Sequência>. 

Opcional

Dicionário de Dados

Arquivo ou Código do Script: AAA – Negociação Financeira / *Versao=CP.2014.12_03*/

(Opcional)

Grupo de Perguntas

<Informações utilizadas na linha Protheus>.

Nome: FINSRF2

(Opcional)

Consulta Padrão

<Informações utilizadas na linha Protheus>

Consulta: AMB