Esse artigo descreve as configurações e as operações sistêmicas para o sistema realizar o cálculo da atualização de encargos das faturas. Quando o Quando um cliente deixa de pagar uma fatura pode ser necessário recalcular o valor desta fatura, levando em consideração uma nova data de vencimento e os realizar um acréscimo de encargos financeiros (correção monetário, multa, juros e honorários) decorrentes deste atraso de pagamento. Este Esse artigo descreve as regras de negócio configurações e as operações de sistema necessárias para atualizar uma fatura vencidasistêmicas para o sistema realizar o cálculo da atualização de encargos das faturas.
Table of Contents |
---|
1. Regras de negócio
Somente será possível atualizar faturas com situação diferente de “canceladas” “cancelada” e “recebidas”“recebida”;
As taxas de honorários, juros e multa devem estar configuradas nas parametrizações do Snapproperty SnapProperty para o sistema realizar seus respectivos cálculos corretamente;
As taxas de juros, multa podem ser alteradas no contrato de locação, caso seja necessário.
Deve ser cadastrado uma tabela de índice de atualização monetária para o sistema realizar o cálculo da correção monetária;
Os encargos que serão calculados deverão estar configurados no objeto “Regras de Mora”, caso contrário, não serão calculados.
Caso o tipo de lançamento seja negativo, os valores dos encargos calculados também serão negativos. Por exemplo: se o tipo de lançamento de “desconto concedido” for configurado para calcular multa, o sistema realizará o cálculo, com o valor negativo descontando do valor total da multa que deverá ser paga.
2. Parametrização
2.1
...
Configuração das taxas
Para realizar a configuração das taxas necessárias para o cálculo dos encargos, realize o seguinte procedimento:
...
Info |
---|
As taxas de “multa de mora” e de “juros” podem ser alteradas, caso necessário, diretamente no contrato de locação, sendo deste local, o local efetivo que o sistema utilizará para calcular esses encargos. |
2.2 Cadastrar tabela de índice de reajuste
É necessário realizar o cadastro do índice de reajuste que será utilizado no cálculo da correção monetária. Para isso:
Entre na guia de “Índices”;
Clique no botão “Novo”;
Informe o campo “Índice” com o nome do índice desejado;
Informe o campo “Descrição” com a descrição resumida deste índice;
Informe o campo “Freqüência” com a frequência de atualização deste índice;
Informe o campo “Dia da publicação” com o dia de atualização desse índice;
Clique no botão “Salvar”.
O sistema abrirá uma tela para o cadastramento dos valores do índice então clique no botão “Novo”;
Informe o campo “Dia” referente ao valor do índice;
Informe o campo “Valor” com o valor do índice na data informada;
Informe o campo “Percentual de reajuste”, caso necessário;
Clique no botão “Salvar”.
2.2.a Atualizar um valor de reajuste na tabela de índice
Para atualizar a tabela de reajuste com um novo valor é necessário realizar o seguinte procedimento:
Entre na guia de “Índices”;
Clique no índice desejado;
Clique no botão “Novo”;
Informe o campo “Dia” referente ao valor do índice;
Informe o campo “Valor” com o valor do índice na data informada;
Informe o campo “Percentual de reajuste”, caso necessário;
Clique no botão “Salvar”.
3.Cadastrar as regras de mora
Este é o local onde o sistema irá verificar as regras e realizar o cálculo dos encargos. Para configurá-lo realize o seguintes procedimentos:
Entre no objeto “Regras de mora”;
Clique no botão “Novo”;
Preencha o campo “Tipo de lançamento” com o tipo de lançamento do contrato que deverá ser calculado o encargo pelo sistema;
Preencha o campo “Dias em atraso” com a quantidade de dias máxima para o enquadramento da fatura nesse cálculo;
Para calcular correção monetária:
Marcar o campo “Calcular correção monetária”;
Preencher o campo “Índice para correção monetária” com a tabela de reajuste criada anteriormente;
Para calcular juros de mora:
Marcar o campo “Calcular juros de mora”;
Marcar o campo “Incluir correção na base de juros”, se o valor do cálculo da correção monetária realizado anteriormente deve ser incluído na base de cálculo do juros de mora;
Para calcular multa de mora:
Marcar o campo “Calcular multa de mora”;
Marcar o campo “Incluir correção na base de multa”, se o valor do cálculo da correção monetária realizado anteriormente deve ser incluído na base de cálculo da multa de mora;
Marcar o campo “Incluir juros na base de multa”, se o valor do cálculo do juros de mora realizado anteriormente deve ser incluído na base de cálculo da multa de mora;
Para calcular honorários advocatícios:
Marcar o campo “Calcular honorários”;
Marcar o campo “Incluir correção na base de honorários”, se o valor do cálculo da correção monetária realizado anteriormente deve ser incluído na base de cálculo dos honorários;
Marcar o campo “Incluir juros na base de honorários”, se o valor do cálculo do juros de mora realizado anteriormente deve ser incluído na base de cálculo dos honorários;
Marcar o campo “Incluir multa na base de honorários”, se o valor do cálculo da multa realizado anteriormente deve ser incluído na base de cálculo dos honorários;
Clique no botão “Salvar”.
Realizar o cadastro de todos os tipos de lançamentos da fatura necessários para que o sistema calcule os encargos corretamente de acordo com a quantidade de dias máximo e tipo de lançamento.
Info |
---|
O tipo de lançamento e a quantidade de dias em atraso são os campos chaves para o cálculo de um determinado encargo. Abaixo segue um exemplo de algumas regras cadastradas. |
...
Cálculos realizados
Dias de Atraso
Os dias em atraso são calculados a partir da diferença entre os campos “Data prevista para pagamento” e a “Data de vencimento” da fatura.
Existe também um tratamento para o cálculo de dias em atraso para dias úteis. Primeiramente o sistema calcula a data de vencimento real que leva em consideração sábados, domingos e feriados. Em seguida calcula o número de dias em atraso, considerando a data de vencimento real. Se o número de dias em atraso for maior do que 1, o sistema calcula novamente o número de dias em atraso, considerando a data de vencimento da fatura (no lugar da data de vencimento real).
Correção Monetária
O valor da correção monetária é calculado conforme parametrização no objeto “Regra de Mora”, isto é, de acordo com quantidade de dias, no item definido da fatura. O percentual da Correção Monetária é calculada de acordo com a tabela de correção informada de acordo com a quantidade de dias, por item.
Exemplo:
...
Juros
O valor do juros é calculado conforme parametrização no objeto “Regra de Mora”, isto é, de acordo com quantidade de dias, em quais itens da fatura ele vai incidir e como será composta sua base. O percentual do juros utilizado está configurado no contrato de locação, mas sua configuração padrão é realizada nas “Parametrizações do SnapProperty”.
Exemplo:
...
Multa
O valor da multa é calculada conforme parametrização no objeto “Regra de Mora”, isto é, de acordo com quantidade de dias, em quais itens da fatura ele vai incidir e como será composta sua base. O percentual da multa utilizada está configurado no contrato de locação, mas sua configuração padrão é realizada nas “Parametrizações do SnapProperty”.
Exemplo:
...
Honorários
O valor dos honorários é calculado conforme parametrização no objeto “Regra de Mora”, isto é, de acordo com quantidade de dias, em quais itens da fatura ele vai incidir e como será composta sua base. O percentual dos honorários utilizado está configurado nas “Parametrizações do SnapProperty”.
Exemplo:
...
2.3 Configuração da regra de mora
3. Cálculos realizados
3.1 Dias de atraso
3.2 Correção monetária
Cálculo do valor da correção monetária
3.3 Juros
Cálculo do valor dos juros de mora
3.4 Multa de mora
3.5 Honorários advocatícios
Cálculo do valor dos honorários advocatícios
4. Processo
Para realizar o processo de atualização de fatura entre na tela de Faturas, selecione uma fatura que estava com situação diferente de “cancelada” ou “recebida”. Entre dentro dessa fatura e clique no botão “Atualizar”.
...
Após, informe a data prevista informada pelo cliente e clique no botão “Calcular”.
...
, realize as seguintes atividades:
Entre na guia de “Faturas”;
Clique na fatura que se deseja atualizar;
Clique no botão “Atualizar”;
Informe a data prevista de pagamento informada pelo cliente no campo “Data prevista”;
Clique no botão “Calcular”;
Repita o processo acima até encontrar o melhor valor para o cliente.
Caso necessário, é possível informar um campo para o valor de ”desconto de multa”, ”desconto de juros”, ”desconto de correção” ou ”desconto de honorários”.
Após, clique no botão “Salvar”.
Info |
---|
Somente faturas com situação diferente de “cancelada”,“recebida”, “divergência” poderão ser atualizadas. |
Nesse momento o sistema realiza a atualização da Fatura fatura e do Título título a Receberreceber.
Os campos atualizados na fatura são:
Campos | Descrição |
---|---|
Valor total da fatura | composto pelo valor da fatura + multa líquida + juro líquido + correção líquida + honorários líquido. |
Dias em atraso | é composto pela diferença entre os campos “Data prevista para pagamento” e a “Data de vencimento” da faturaesse campo é zerado no momento da atualização. |
Valor correção | é o valor da correção calculada na atualização de fatura. |
Desconto correção | é o valor do desconto da correção informada pelo usuário na atualização de fatura. |
Correção Líquidalíquida | é composto pela diferença entre os campos “valor da correção calculada” e o “desconto correção”. |
Valor Multamulta | é o valor da Multa calculada na atualização de fatura. |
Desconto Multamulta | é o valor da Multa informada pelo usuário na atualização de fatura. |
Multa Líquidalíquida | é composto pela diferença entre os campos “valor da multa calculada” e “desconto multa”. |
Valor honorários | é o valor do honorários calculado na atualização de fatura. |
Desconto honorários | é o valor do desconto do honorários informado pelo usuário na atualização de fatura. |
Honorários Líquidolíquido | é composto pela diferença entre os campos “valor da honorários calculado” e “desconto honorários”. |
Valor juro | é o valor do juro calculado na atualização de fatura. |
Desconto juro | é o valor do desconto do juro informado pelo usuário na atualização de fatura. |
Juro Líquidolíquido | é composto pela diferença entre os campos “valor da juro calculado” e “desconto juro”. |
Data prevista para pagamento | é informado a data prevista de pagamento calculada na atualização de fatura. |
...
Dias em atraso inadimplente | esse campo é mantido e não alterado no momento da atualização. |
Após a atualização da fatura, o sistema irá realizar a atualização dos campos no título a receber os campos alterados foram:
Campos | Descrição |
---|---|
Valor total do título | composto pelo valor do título + juro líquido + multa líquida + correção líquida + honorários líquido. |
Dias em atraso | é composto pela diferença entre os campos “Data prevista para pagamento” e a “Data de vencimento” da fatura. |
Valor da correção | é composto pelo campo “Correção Líquida” líquida” proveniente da fatura. |
Valor da multa | é composto pelo campo “Multa Líquida” líquida” proveniente da fatura. |
Valor de honorários | é composto pelo campo “Honorário Líquido” líquido” proveniente da fatura. |
Valor do juros de mora calculado | é composto pelo campo “Juro Líquido” líquido” proveniente da fatura. |
Data prevista para pagamento | é informado a data prevista de pagamento calculada na atualização de fatura. |
Valor do desconto calculado | é informado o somatório do desconto calculado na atualização de fatura |
...
. | |
Incluir alteração data vencimento | se a atualização alterou a data de vencimento do título o campo é marcado. |
Incluir alteração valor | se a atualização alterou o valor total do título o campo é marcado. |
5. Processo diário automático
O serviço é executado diariamente uma única vez para atualizar os encargos da fatura e título das faturas com situação igual a “vencida”. O processo não altera a situação da fatura e os cálculos utilizam a data atual no campo “data prevista de pagamento” para realizar o processamento.
6. Notas para o desenvolvedor
A operação “Atualizar fatura” é implementada pelos seguintes componentes:
Componente | Tipo | Descrição |
---|---|---|
atualizarFaturaVencida | Componente lightning | Interface utilizado pelo usuário para atualizar uma fatura. |
FaturaController.atualizarVencimentoFaturaLocacao | Classe Apex | |
FaturaServico.atualizarVencimentoFatura | Classe Apex | Atualizar a data prevista para pagamento de uma fatura e os valores de encargos correspondentes. |
AtualizarFaturasBatch | Serviço que calcula o encargo diariamente | |
AtualizarFaturasScheduler | Serviço que executa o serviço AtualizarFaturasBatch |