Quando um cliente deixa de pagar uma fatura pode ser necessário realizar um acréscimo de encargos financeiros (correção monetário, multa, juros e honorários) decorrentes deste atraso de pagamento. 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.
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 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”.
1.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. |
...
2. Cálculos realizados
...
2.3 Configuração da regra de mora
3. Cálculos realizados
3.1 Dias de atraso
Os Cálculo dos dias em atraso são calculados a partir da diferença entre “hoje” e os campos “Data prevista para pagamento” ou “Data de vencimento”.
Se a situação da fatura esteja como “vencida”, isto é, ainda não tenha passado pelo processo de atualização de encargos, a data que será utilizada será “Data de vencimento”, caso a situação da fatura esteja como “atualizada” o processo de atualização de encargos já ocorreu e a “data prevista para pagamento” já foi atualizada, dessa forma, será esse o campo que o sistema utilizará para realizar a comparação.
Se o resultado dessa diferença for maior que 1
Info |
---|
O cálculo de dias em atraso leva em consideração 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). |
2.2 Correção monetária
...
Exemplo:
...
2.3 Juros
...
Exemplo:
...
2.4 Multa de mora
...
Exemplo:
...
2.5 Honorários advocatícios
...
Exemplo:
...
...
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, realize as seguintes atividades:
Entre na guia de “Faturas”;
Clique na fatura que se deseja atualizar (com situação diferente de “cancelada” ou “recebida”);
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 e do título a receber.
...
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íquida | é composto pela diferença entre os campos “valor da correção calculada” e o “desconto correção”. |
Valor multa | é o valor da Multa calculada na atualização de fatura. |
Desconto multa | é o valor da Multa informada pelo usuário na atualização de fatura. |
Multa lí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í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í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:
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” proveniente da fatura. |
Valor da multa | é composto pelo campo “Multa líquida” proveniente da fatura. |
Valor de honorários | é composto pelo campo “Honorário líquido” proveniente da fatura. |
Valor do juros de mora calculado | é composto pelo campo “Juro 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 |