Este artigo descreve o comportamento do módulo responsável pela geração das faturas utilizadas para cobrar valores de aluguel e encargos dos locatários.

Visão geral

O faturamento representa a segunda etapa do ciclo financeiro do contrato de locação, que é responsável pela apuração e discriminação do valor a ser pago pelo locatário, onde o valor da fatura é o resultado da soma dos lançamentos atribuídos ao locatário até a data de término da apuração da fatura.

O faturamento é executado automaticamente pelo sistema, sem a necessidade de um usuário criar faturas manualmente. O serviço de faturamento é acionado através da "Data da próximo faturamento" do contrato de locação. Este serviço filtra os contratos com a "Data do próximo faturamento" igual à data do sistema e encaminha os contratos encontrados para a fila do próximo faturamento. Depois que o faturamento é executado, o sistema atualiza a "Data do próximo faturamento" para que o contrato seja faturado novamente no próximo mês.

Quando uma nova fatura é gerada, o sistema também cria um novo título a receber que representa o boleto, utilizado para realizar a cobrança da fatura.

Regras de negócio

Geração da fatura

A fatura pode ser gerada de forma automatizada ou manual.

Datas para faturamento

Hipótese 1 

Período de apuração: Mês fechado 

Tipo de vencimento: Antecipado

Descrição:

1. Inicio de apuração = Dia 1 + ( Mês da Data de vencimento da próxima fatura + 1 mês) + Ano da Data de vencimento da próxima fatura
2. Término de apuração = Último dia do mês da Data de vencimento da próxima fatura + ( Mês da Data de vencimento da próxima fatura + 1 mês) + Ano da Data de vencimento da próxima fatura

Hipótese 2

Período de apuração: Mês fechado 

Tipo de vencimento: Vencido

Descrição:

1. Inicio de apuração = Dia 1 + ( Mês da Data de vencimento da próxima fatura - 1 mês) + Ano da Data de vencimento da próxima fatura
2. Término de apuração = Último dia do mês da Data de vencimento da próxima fatura + ( Mês da Data de vencimento da próxima fatura - 1 mês) + Ano da Data de vencimento da próxima fatura

Fatura automatizada

A fatura automatizada é gerada diariamente pelo sistema através de um serviço autônomo e não requer uma operação do usuário.

A geração da fatura automatizada ocorre no dia definido pelo campo "Data do próximo faturamento" do contrato de locação.

O serviço verifica todos o contratos que estão com a (flag ativo marcada, todos que possuem o campo faturar ativo, todos que possuem data do próximo faturamento igual a hoje) ou situação do faturamento igual a pendente.

Fatura manual

A fatura manual é utilizada quando existe a necessidade de gerar uma fatura em alguma data diferente da que foi prevista em contrato.

Período de apuração da fatura

A data de término para apuração da fatura é utilizada para filtrar os lançamentos do contrato de locação que são incluídos na fatura. Ao gerar uma nova fatura, o sistema seleciona os lançamentos do contrato atribuídos ao locatário com data igual ou anterior à data de término para apuração.

O cálculo da data de término pode ser feito de duas formas, dependendo da parametrização "Período de apuração da fatura".

Lançamentos do contrato

Para gerar uma nova fatura, o sistema seleciona os lançamentos do contrato que atendem os seguintes critérios:

A "Situação" do lançamento de contrato selecionado para a fatura é alterada para "Faturado".

Apuração do valor da fatura

O valor da fatura será calculado pela soma dos lançamentos do contrato de locação, atribuídos ao locatário, aprovados e com data igual ou anterior à data de término para apuração da fatura.

Se o valor apurado para a fatura for menor ou igual a zero, o sistema não gera uma nova fatura. Neste caso, o campo "Situação do faturamento" do contrato de locação é alterado para "Erro" e o campo "Mensagem para faturamento" é atualizado para "O valor da fatura foi menor ou igual a zero".

Número da fatura

O sistema gera um número sequencial para a nova fatura, levando em consideração o número da última fatura gerada para o contrato de locação.

Itens da fatura

Quando uma nova fatura é gerada, o sistema cria um registro no objeto "Item da fatura" para cada lançamento do contrato selecionado para a fatura.

Situação da fatura

O campo "Situação" da fatura controla o estado do registro e indica a etapa em que se encontra uma fatura.

Repasse garantido

Quando o contrato de locação que originou a fatura é garantido, o sistema atualiza o campo "Data do próximo repasse", de acordo com a parametrização "Tipo de apuração do repasse", como mostra a tabela abaixo.

Situação do faturamento

Depois que ocorre a geração da fatura, o sistema atualiza os campos "Situação do faturamento" (contrato) e "Mensagem do faturamento" (contrato), de acordo com a tabela abaixo.

Cancelamento da fatura

Uma fatura de locação pode ser cancelada apenas quando a situação do registro for igual a: Nova, Emitida, Gerada, Enviada ou Vencida.

Ao cancelar uma fatura, o sistema realiza as seguintes ações:

Fatura

1. Atualiza o campo "Situação" da fatura para "Cancelada".
2. Atualiza o campo "Data do cancelamento" para a data e hora do sistema no momento do cancelamento.
3. Atualiza o campo "Usuário do cancelamento" para o usuário que realizou a operação de cancelamento.
4. Atualiza o campo "Motivo do cancelamento" com a descrição digitada pelo usuário.

Lançamentos do contrato

1. Atualiza o campo "Situação" para "Aprovado".

Títulos a receber

1. Atualiza o campo "Situação" para "Cancelado".
2. Atualiza o campo "Data do cancelamento" para a data no momento do cancelamento.
3. Atualiza o campo "Situação do boleto" para "Baixado".
4. Desmarca os campos "Incluir alteração data vencimento” e “Incluir alteração valor” se estiverem marcados.

Notificações

1. Sistema envia e-mail "Cancelamento de fatura" para o contato do locatário cadastrado no contrato de locação.

Processo de Cobrança

  Caso a fatura cancelada esteja em processo de cobrança, o sistema realiza o seguinte procedimento:

1. Se existir apenas uma fatura nesse processo de cobrança:

   1. O sistema apaga o campo de cobrança da fatura para retirá-la do processo de cobrança;

   2. Encerra o processo de cobrança colocando a situação da cobrança para “Cancelada”;

2. Se existir mais de uma fatura com no mesmo processo da cobrança:

   1. O sistema apaga o campo de cobrança da fatura para retirá-la do processo de cobrança;

   2. Atualiza campo “valor da cobrança” no processo de cobrança deduzindo o campo “Valor total da fatura”;

   3. Remove o nome da fatura no campo “Faturas da cobrança”;

   4. Atualiza o campo “dias em atraso da fatura mais antiga” com o a quantidade de dias em atraso da(s) fatura(s), que está(ão) dentro do processo de cobrança, que possuir a maior quantidade de dias em atraso, após ter removido a fatura desejada.

Serviços autônomos

Os serviços autônomos são tarefas executadas pelo sistema sem a necessidade da intervenção de um usuário.

Geração de faturas

Este serviço gera as faturas dos contratos de locação com a "Data do próximo faturamento" igual à data do sistema.

As atividades executadas para a geração de faturas são:

1. Calcular as datas de início e término para apuração da fatura.
2. Calcular o valor da fatura.
   1. Se o valor da fatura for menor ou igual a zero, o sistema não gera a fatura. 
3. Criar um registro do evento "Faturamento" no contrato de locação.

Operações de sistema

Faturar contrato de locação

Para faturar um contrato de locação, siga os passos abaixo.

1. Selecione a guia "Contratos".
2. Utilize os filtros da pesquisa para encontrar os contratos que deseja faturar.
3. Selecione os contratos desejados.
4. Clique no botão "Faturar" para iniciar o faturamento.

Sistema executa as ações:

1. Validar contrato para faturamento, caso a validação seja com sucesso segue o fluxo, caso contrário, é informado a situação de erro no faturamento e o sistema não atualiza a data do próximo faturamento.
2. Sistema gera os lançamentos do contrato:
   1. Gera os lançamentos de aluguel.
   2. Gera lançamentos da taxa de administração.
   3. Gera lançamentos do IPTU.
   4. Gera lançamentos do condomínio.
   5. Gera lançamentos da taxa de lixo.
   6. Gera lançamentos da taxa de marinha.
   7. Gera lançamentos da taxa de comissão do 13o.
   8. Registra evento no contrato para o tipo "Lançamentos".
3. Sistema gera a fatura do locatário:
   1. Define o período de apuração.
   2. Seleciona os lançamentos aprovados do para o locatário.
   3. Cria os itens da fatura.
   4. Calcula o valor da fatura.
   5. Atualiza os lançamentos do contrato.
   6. Gera o título a receber.
   7. Calcula a data de vencimento da próxima fatura.
   8. Calcula a data do próximo faturamento. 
   9. Registra evento no contrato para o tipo "Faturamento".
4. Sistema exibe mensagem com os dados da fatura criada.

Cancelar fatura

Para cancelar uma fatura, siga os passos abaixo.

1. Selecione a fatura que deseja cancelar desde que ela não tenha sido recebida.
2. Clique no botão "Cancelar".
3. Sistema executa o cancelamento da fatura.
4. Sistema exibe a mensagem "Fatura cancelada com sucesso".
5. Nesse processo o sistema também realiza o cancelamento do título dessa fatura,
   1. altera a situação do lançamento do contrato de locação que deu origem para a fatura para "Aprovado".
   2. altera a situação do boleto para "baixada" caso ele já tenha sido emitido.

Gerar Arquivo da fatura

Para gerar o arquivo de extrato de uma fatura, siga os passos abaixo.

1. Selecione as faturas que deseja gerar o arquivo de extrato.
2. Clique no botão "Gerar Arquivo".
3. O sistema executa a geração dos arquivos das faturas selecionadas conforme os lançamentos existentes dentro da mesma.
4. O sistema exibe a mensagem "Arquivos gerados com sucesso".
5. Para acessar o arquivo gerado, entre na fatura e clique na Guia "Arquivo".

Enviar e-mail com o arquivo da fatura

Para enviar e-mail para o locatário com o arquivo de extrato de uma fatura, siga os passos abaixo.

1. Selecione as faturas que deseja enviar o e-mail.
2. Clique no botão "Enviar Email".
3. O sistema verifica se a fatura possui arquivo gerado e, se tiver, seleciona o arquivo mais recente para ser enviado. Caso contrário, o sistema apresenta um erro de falta de arquivo de extrato.
4. Após o sistema verifica se o locatário possui e-mail de cobrança, se tiver esse é o endereço de e-mail que será utilizado, caso contrário, o sistema apresenta um erro de falta de e-mail de cobrança do locatário.
5. Estando tudo correto o sistema exibe a mensagem "Faturas enviadas com sucesso", caso contrário o sistema apresenta os erros correspondestes a falta de e-mail ou a falta de arquivo.

Observação:   o e-mail do remetente do envio da fatura/repasse pode ser configurado de duas formas:

Forma Padrão:  o e-mail que será utilizado é o e-mail da pessoa que clicou no botão "Enviar Email".

Forma Personalizada: o e-mail do remetente que será utilizado é um e-mail único e fixo e configurado na Organização do cliente e será utilizado tanto para o envio de faturas quanto para o envio de repasses.

Para isso é necessário entrar em:  Configurações > Endereço de toda organização > Adicionar.

         No nome "Exibir nome" informar obrigatoriamente: Financeiro

         No campo "Endereço de email" informar o email desejado. Exemplo: financeiro@xxx.com.br.

         Selecionar a opção de "Permitir a todos os perfis utilizar esse Endereço de remetente".

         Clicar em "Salvar".

Modelo de dados da fatura

A representação da fatura é feita através de dois objetos: Fatura e Item da fatura.

Fatura

Item da fatura

Parametrização

Na tabela abaixo são descritos os campos da parametrização do SnapProperty que afetam o faturamento.

Contrato de locação

Na tabela abaixo são descritos os campos do contrato de locação que afetam o faturamento.