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:

Baixa total:

O campo FKD_SALDO será sempre zero e no campo FKD_DTBAIX ficará com a data de baixa do título.

Baixa parcial:

Na baixa parcial a preferência de recebimento será sempre dos valores acessórios, assim como ocorre hoje com os juros, multas acréscimos e decréscimos, portanto:
Se o valor acessório calculado for maior que o valor de baixa informado pelo usuário, a baixa ocorrerá normalmente, mas a diferença de valores será gravada no campo FKD_SALDO.
No campo FKD_DTBAIX ficará com a data de baixa do título.
Quando ocorrer nova baixa desse título, o valor do saldo deverá ser somado ao calculado nos valores acessórios e data de referência para cálculo mudará para o campo FKC_DTBAIX.

Gravação da tabela FK6 - Valores Acessórios:

Criar uma função centralizadora, para gravação da FK6:

Consulta da tabela FK6

Criar uma função genérica que retorne um array com todos os registros da FK6, referente aos valores acessórios de títulos baixados.

Estorno de baixa

Desenvolver uma função genérica para buscar os valores acessórios gravados na tabela FK6, para restauração do saldo do valor acessório em caso de baixa parcial e gravar o campo FKD_SALDO, caso o estorno seja total deverá limpar os campos FKD_SALDO e FKD_DTBAIX.

Ajustes em funções:

Ajustar as funções abaixo, para somar o retorno da função genérica de cálculo dos valores acessórios, para compor o total a pagar.

Ajustar as funções abaixo, para chamar a função genérica de gravação os valores acessórios.

Ajustar as funções abaixo, para somar o retorno da função genérica de gravação de estorno dos valores acessórios.

Ajustar as funções abaixo, chamar a função genérica para gravação da FK6, com os valores de dados acessórios.

FINA080 - Baixa Pagar Manual

Adicionar na tela de baixa uma variável para apresentação dos valores acessórios, todos os valores serão somados e apresentados em uma única variável.
Para obter o detalhamento/edição dos valores acessórios será desenvolvida uma tela que ficará disponível no botão OUTRAS AÇÕES, como valores acessórios, chamado o fonte FINA080A.
Adicionar a soma da base de retenção os Valores Acessórios, quando o parâmetro MV_IMPBAIX=1.
Funções: fA080Tit, fA080TitW, Fa080But, fa080ValVR, fA080Val, F080TotMes.

FINA080A - Detalhamento de Valores Acessórios

Esse botão abrirá o protótipo de tela 03, com o valor calculado por valor acessório vinculado ao título.
Caso o usuário altere o valor calculado pelo sistema, será preciso reservar o valor cálculo para posterior gravação do campo FK6_VALCAL e novo valor informado pelo usuário será usado para compor o total pago e será gravado no campo FK6_VALMOV.

Validações:

O valor calculado poderá ser alterado pelo usuário.
O valor acessório não poderá ser excluído.

FINXSE5 - Funções Genéricas

Alterar a função FINVARCTB para declarar as variáveis de contabilização listada no cadastro FKC_VARCTB, de todos os valores acessórios ativos.
Alterar função FINCARVAR para carregar o conteúdo nas variáveis de contabilização, conforme o tipo de valor acessório associado a FK6 (FK6_CODVAL).

FINR871 - Emissão de Guia GPS

Os valores acessórios vinculados aos títulos deverão ser listados na coluna de Outros Valores.

Tabelas Utilizadas

• FKC - Tipos de Valores Acessórios;
• FKD - Títulos x Valores Acessórios;
• FKB - Tipos de Movimentos;
• FK6 - Valores Acessórios;
• FK7 - Tabela Auxiliar;
• SE2 - Títulos a Pagar.

Opcional

Protótipo de Tela

Atenção: as imagens abaixo são meramente ilustrativas. 

Protótipo 01

Protótipo 02 

Protótipo 03 

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  FKC – Tipo de Valores acessórios / *Versao=CP.2014.12_03*/

(Opcional)

Grupo de Perguntas

<Informações utilizadas na linha Protheus>.

Nome: FINSRF2

Arquivo ou Código do Script: FKD – Títulos x Valores acessórios / *Versao=CP.2014.12_03*/

Arquivo ou Código do Script: FK6 – Valores acessórios / *Versao=CP.2014.12_03*/

Consulta Padrão

Consulta: FKC

(Opcional)

Consulta Padrão

<Informações utilizadas na linha Protheus>

Consulta: AMB