Operações de sistema

O serviço autônomo responsável por gerar lançamento é o GeracaoLancamentosContratosBatch
 que é executado uma vez ao dia, de acordo com o agendamento da classe GeracaoLancamentosContratosScheduler.

Seleção dos contratos

Este batch seleciona todos os contratos que cumpram os seguintes critérios:

Observação: Os contratos que tiverem o campo “Situação do lançamento” igual a “Pendente” e as condições acima listadas cumpridas (com exceção do campo “Data do próximo lançamento”) também serão inclusos no processamento.

Após selecionar os contratos será executado o método gerarLancamentosContratoLocacao da classe ContratoServico.

gerarLancamentosContratoLocacao

Ao iniciar esse método, o processamento passará por uma validação de contratos que será executada pelo método validarContratoFaturamento da classe ContratoServico.

validarContratoFaturamento

Essa validação realiza a verificação dos contratos e, para cada contrato que foi selecionado, funciona da seguinte forma:

1. Se o campo “Ativo” (contrato.Ativo__c) for nulo o sistema incrementará a mensagem de erro: 'O contrato ainda não foi ativado; ';

2. Se o campo “Faturar” (contrato.Faturar__c) for nulo o sistema incrementará a mensagem de erro: 'O contrato não está habilitado para faturamento; ';

3. Se o campo “Data de início de Vigência” (contrato.Data_inicio_vigencia__c) for nulo o sistema incrementará a mensagem de erro: 'Data de início de vigência não foi definida; ';

4. Se o campo “Data da posse do locatário” (contrato.Data_posse_locatario__c) for nulo o sistema incrementará a mensagem de erro: 'O contrato ainda não foi ativado; ';

5. Se o campo “Empresa” (contrato.Empresa__c) for nulo o sistema incrementará a mensagem de erro: 'A empresa administradora do contrato não foi definida; ';

6. Se o campo “Tipo de vencimento” (contrato.Tipo_vencimento__c) for nulo o sistema incrementará a mensagem de erro: 'O tipo de vencimento do contrato não foi definido; ';

7. Se o campo “Periodicidade do reajuste” (contrato.Peridiocidade_reajuste__c) for nulo o sistema incrementará a mensagem de erro: 'A periodicidade de reajuste do valor do aluguel não foi definida; ';

8. Se o campo “Valor do aluguel original” (contrato.Valor_aluguel__c) for nulo o sistema incrementará a mensagem de erro: 'Valor do aluguel não foi definido; ';

9. Se o campo “Valor do aluguel corrigido” (contrato.Valor_aluguel_corrigido__c) for nulo o sistema incrementará a mensagem de erro: 'Valor do aluguel corrigido não foi definido; ';

10. Se o campo “Taxa de administração” (contrato.Taxa_administracao__c) for nulo o sistema incrementará a mensagem de erro: 'Taxa de administração do contrato não foi definida; ';

11. Se o campo “Taxa de intermediação para locação” (contrato.Taxa_intermediacao__c) for nulo o sistema incrementará a mensagem de erro: 'Taxa de intermediação do contrato não foi definida; ';

12. Se o campo “Data vencimento da próxima fatura” (contrato.Data_vencimento_proxima_fatura__c) for nulo o sistema incrementará a mensagem de erro: 'Data de vencimento da próxima fatura não foi preenchida; ';

13. Se o campo “Data do próximo lançamento” (contrato.Data_proximo_aluguel__c) for nulo o sistema incrementará a mensagem de erro: 'Data do próximo lançamento não foi preenchida; ';

14. Se o campo “Valor do aluguel corrigido” (contrato.Valor_aluguel_corrigido__c) for nulo o sistema incrementará a mensagem de erro: 'O valor do aluguel corrigido não foi preenchido; ';

15. Se o campo “Locatário” (contrato.snap_brok__Locatario__c ) for nulo o sistema incrementará a mensagem de erro: 'O locatário não foi preenchida; ';

16. Se o campo “Locador” (contrato.snap_brok__Locador__c) for nulo o sistema incrementará a mensagem de erro: 'O locador não foi preenchida; ';

17. Se o campo “Carteira” (contrato.Empresa__r.snap_finan__Carteira__c) for nulo o sistema incrementará a mensagem de erro: 'A carteira da empresa não foi preenchida; ';

18. Se o campo “Gerar lançamentos para IPTU” (contrato.Gerar_lancamento_iptu__c) estiver igual a “Ativo”:

    1. O sistema validará também:

       1. se o campo “Responsável pelo IPTU” (contrato.Responsavel_iptu__c) for igual a nulo será incrementado o seguinte erro: 'O responsável do IPTU não foi preenchido; ' ;

       2. se o campo “Pagante IPTU” (contrato.Pagante_iptu__c) for igual a nulo será incrementado o seguinte erro: 'O pagante do IPTU não foi preenchido; ';  

       3. se o contrato tiver algum imóvel cadastrado o sistema irá percorrer os imóveis e, para cada imóvel do contrato, validará as seguintes informações:

          1. “Valor mensal do IPTU” (imovel.Imovel__r.Valor_iptu__c), caso esse campo seja nulo será incrementado o seguinte erro: 'O valor do IPTU do imóvel ' + “Imóvel” (imovel.Imovel__r.Name) + ' não foi preenchida; ';

          2. “Rateio IPTU” (imovel.Imovel__r.Rateio_iptu__c), caso esse campo seja nulo será incrementado o seguinte erro: 'O valor do rateio do IPTU do imóvel ' + “Imóvel” (imovel.Imovel__r.Name) + ' não foi preenchida; ';

19. Se o campo “Gerar lançamentos para condomínio” (contrato.Gerar_lancamento_condominio__c) estiver igual a “Ativo”:

    1. O sistema validará também:

       1. se o campo “Responsável condomínio” (contrato.Responsavel_condominio__c) for igual a nulo será incrementado o seguinte erro: 'O responsável do condomínio não foi preenchido; ';  

       2. se o campo “Pagante condomínio” (contrato.Pagante_condominio__c) for igual a nulo será incrementado o seguinte erro: 'O pagante do condomínio não foi preenchido; ';   

       3. se o contrato tiver algum imóvel cadastrado o sistema irá percorrer os imóveis e, para cada imóvel do contrato, validará as seguintes informações:

          1. se o campo “Valor do condomínio” (imovel.Valor_condominio__c), caso esse campo seja nulo será incrementado o seguinte erro: 'O valor do condomínio do imóvel ' + “Imóvel” (imovel.Imovel__r.Name) + ' não foi preenchida; ';

20. Se o campo “Gerar lançamentos para condomínio” (contrato.Gerar_lancamentos_coleta_lixo__c) estiver igual a “Ativo”:

    1. O sistema validará também:

       1. se o campo “Responsável coleta de lixo” (contrato.Responsavel_coleta_lixo__c) for igual a nulo será incrementado o seguinte erro: 'O responsável da coleta do lixo não foi preenchido; '; 

       2. se o campo “Pagante coleta de lixo” (contrato.Pagante_coleta_lixo__c) for igual a nulo será incrementado o seguinte erro: 'O pagante da coleta do lixo não foi preenchido; '; 

       3. se o contrato tiver algum imóvel cadastrado o sistema irá percorrer os imóveis e, para cada imóvel do contrato, validará as seguintes informações:

          1. se o campo “Valor mensal de coleta de lixo” (imovel.Imovel__r.Valor_mensal_Coleta_lixo__c), caso esse campo seja nulo será incrementado o seguinte erro: 'O valor da coleta do lixo do imóvel ' + “Imóvel”  (imovel.Imovel__r.Name) + ' não foi preenchida; ';

21. Se o campo “Gerar lançamentos para condomínio” (contrato.Gerar_lancamentos_taxa_marinha__c) estiver igual a “Ativo”:

    1. O sistema validará também:

       1. se o campo “Responsável taxa marinha” (contrato.Responsavel_taxa_marinha__c) for igual a nulo será incrementado o seguinte erro: 'O responsável da taxa marinha não foi preenchido; ';

       2. se o campo “Pagante taxa marinha” (contrato.Pagante_taxa_marinha__c) for igual a nulo será incrementado o seguinte erro: 'O pagante da taxa marinha não foi preenchido; '; 

       3. se o contrato tiver algum imóvel cadastrado o sistema irá percorrer os imóveis e, para cada imóvel do contrato, validará as seguintes informações:

          1. se o campo “Valor mensal de taxa marinha” (imovel.Imovel__r.Valor_mensal_Taxa_Marinha__c), caso esse campo seja nulo será incrementado o seguinte erro: 'O valor da taxa marinha do imóvel ' + “Imóvel”  (imovel.Imovel__r.Name)  + ' não foi preenchida; ';

O sistema irá percorrer os participantes do contrato e validar as seguintes informações para cada participante encontrado:

i. Se o papel do participante (part.snap_brok__Papel__c) se for igual “Locatário”

a. Se o tipo de pessoa (part.snap_brok__Participante__r.snap_finan__tipo_pessoa__c) for igual “Física”

1. Se o campo CPF xxxx estiver nulo (part.snap_brok__Participante__r.snap_finan__Cpf_2__pc) o sistema incrementará a mensagem de erro: 'O CPF do locatário ' + part.snap_brok__Participante__r.Name + ' não foi preenchido; ';

2. Se o CPF ERP xxxx estiver nulo (part.snap_brok__Participante__r.snap_finan__CPFF__c) o sistema incrementará a mensagem de erro: 'O CPF (ERP) do locatário ' + part.snap_brok__Participante__r.Name + ' não foi preenchido; ';

b. Se o tipo de pessoa (part.snap_brok__Participante__r.snap_finan__tipo_pessoa__c) for diferente de “Física”

1. Se o CNPJ xxxx estiver nulo (part.snap_brok__Participante__r.snap_finan__CNPJ__c ) o sistema incrementará a mensagem de erro: 'O CNPJ do locatário ' + part.snap_brok__Participante__r.Name + ' não foi preenchido;'

2. Se a Razão social xxxx estiver nula (part.snap_brok__Participante__r.snap_finan__razao_social__c) o sistema incrementará a mensagem de erro: 'A razão social do locatário ' + part.snap_brok__Participante__r.Name + ' não foi preenchida; '

ii. Se o endereço de cobrança do participante (part.snap_brok__Participante__r.snap_finan__Logradouro_cobranca__c ) for nulo o sistema incrementará a mensagem de erro: 'O logradouro do endereço de cobrança do locatário ' + part.snap_brok__Participante__r.Name + ' não foi preenchido; ';

iii. Se o bairro de cobrança do participante (part.snap_brok__Participante__r.snap_finan__Bairro_cobranca__c ) for nulo o sistema incrementará a mensagem de erro: 'O bairro do endereço de cobrança do locatário ' + part.snap_brok__Participante__r.Name + ' não foi preenchido; ';
                           
                   

iv.
                           
                            if (part.snap_brok__Participante__r.snap_finan__Cep_cobranca__c == null){
                                erros+= 'O cep do endereço de cobrança do locatário ' + part.snap_brok__Participante__r.Name + ' não foi preenchido; ';
                            }
                           
                            if (part.snap_brok__Participante__r.snap_finan__Cidade_para_cobranca_texto__c == null){
                                erros+= 'A cidade do endereço de cobrança do locatário ' + part.snap_brok__Participante__r.Name + ' não foi preenchida; ';
                            }
                           
                            if (part.snap_brok__Participante__r.snap_finan__UF_para_cobranca__c == null){
                                erros+= 'O estado (UF) do endereço de cobrança do locatário ' + part.snap_brok__Participante__r.Name + ' não foi preenchida; ';
                            }

Se o sistema incrementou uma mensagem de erro em alguma das validações,o sistema atualizará:

a. o valor do campo “validado para faturamento” colocará como falso

b. preencherá o campo erros do faturamento com os erros incrementados

Como consequência de algum erro encontrado o contrato não seguirá no processamento para a geração de lançamentos.

Gerar lançamentos dos contratos (serviço autônomo)

O sistema executa automaticamente o serviço para geração de lançamentos todos os dias durante a madrugada de acordo com uma seleção de contratos.

Os contratos selecionados para a execução do serviço devem atender às seguintes regras:

Campos obrigatórios necessários para a geração dos lançamentos são:

Na geração de lançamentos do contrato de locação do serviço autônomo, o sistema realiza as seguintes operações:

1. Cria um registro no objeto "Lançamento do contrato" dentro do contrato de locação.

2. Preenche o campo “Lançamento” com um número sequencial do lançamento.

3. Preenche o campo "Data do lançamento" com a data de vencimento do lançamento.

4. Preenche o campo "Valor do lançamento" de acordo com os critérios descritos na seção pré requisitos para lançamento.

5. Preenche o campo "Situação" com o valor “Aprovado”.

6. O campo “Imóvel” é preenchido com o Imóvel que originou o lançamento. 

7. O “Tipo de registro” varia entre 3 tipos dependendo do destinatário do lançamento: 

   1. Administradora 

   2. Locador 

   3. Locatário

8. O campo “Contrato de locação” recebe o número do contrato que originou o lançamento.

9. O campo “Contrato de administração” recebe o número do contrato de onde esse lançamento é originário.

10. O campo “Ciclo da Locação” recebe o número do ciclo que esse lançamento foi gerado.

11. O campo “Tipo de lançamento” recebe o tipo de lançamento dependendo da sua finalidade.

12. O campo “Histórico” é um campo do tipo texto que descreve informações do lançamento. 

13. O campo "Fatura" é preenchido no momento em que este lançamento é adicionado a uma fatura. 

14. O campo “Manutenção” é preenchido com o serviço de manutenção que originou esse lançamento. 

15. O campo “Reembolso” é preenchido no momento em que este lançamento é proveniente de um reembolso. 

16. O campo “Locador” é preenchido quando o lançamento for exclusivo para um único locador.

Lançamentos gerados para um contrato pelo serviço autônomo

Lançamento de aluguel

São criados dois lançamentos, para creditar locador e debitar locatário, de acordo com a tabela abaixo.

Observação: Quando estiver no mês e ano do reajuste do aluguel que está no campo "data do próximo reajuste" no contrato de locação, o sistema realiza a correção do aluguel de acordo com o índice cadastrado para esse contrato, informando o novo valor do aluguel corrigido. 

Lançamento de taxa de administração

São criados dois lançamentos, para creditar administradora e debitar locador, de acordo com a tabela abaixo.

Lançamento de IPTU

Condições:

a. O valor do IPTU do imóvel pode ser cobrado mensalmente do locador ou do locatário.

b. O lançamento de IPTU só é gerado quando o campo "Gerar lançamentos para IPTU" do contrato de locação estiver selecionado.

c. Quando o contrato de locação possuir mais de um imóvel, o sistema gera um lançamento de IPTU para cada imóvel do contrato.

d. O valor do lançamento do IPTU, para cada imóvel, é calculado pela fórmula: "Valor do IPTU" * "Rateio do IPTU".

• Quando o "Rateio do IPTU" não for informado, o sistema considera o valor do rateio como 100%.

• Quando o "Valor do IPTU" não for informado, o sistema considera o valor como zero.

e. O lançamento de débito do IPTU é feito de acordo com a definição do campo "Responsável pelo IPTU" do contrato de locação, que pode "Locador" ou "Locatário".

f. O lançamento de crédito do IPTU é feito de acordo com a definição do campo "Pagante do IPTU" do contrato de locação, que pode ser "Administradora", "Locador" ou "Locatário".

Lançamento de condomínio

São criados dois lançamentos, para creditar locador e debitar locatário, de acordo com a tabela abaixo.

Lançamento de Taxa de intermediação

São criados dois lançamentos, para creditar administradora e debitar locador, de acordo com a tabela abaixo.

Lançamento de retenção de IR

Lançamento de seguro incêndio

São criados dois lançamentos, para creditar administradora e debitar locatário, de acordo com a tabela abaixo.

Condições:

a. O campo “Tipo de contrato do seguro” e “Número parcelas seguro incêndio” devem estar preenchidos.

b. O campo “Finalidade” do contrato de locação deve estar informado.

c. A tabela de seguro incêndio deve estar cadastrada na tela “Tabelas de Seguro” com o mesmo tipo de finalidade utilizado no contrato.

d. A tabela de seguro deve comportar todas as faixas para o pagamento dos prêmios.

Lançamento de lixo

pelo que verifiquei esse lct não gera no serviço autônomo ou não gerou nenhuma lct até agora

Lançamento de taxa marinha

pelo que verifiquei esse lct não gera no serviço autônomo ou não gerou nenhuma lct até agora

Lançamento taxa de novembro

pelo que verifiquei esse lct não gera no serviço autônomo ou não gerou nenhuma lct até agora

validarcontratodefaturmamento

determinar inicio e términio de apuração

data de vencimento

Gerar lançamentos para um contrato

Para gerar os lançamento de um contrato, o sistema realiza os seguintes passos:

1. Validar contrato para geração de lançamento.

2. Calcular período de apuração.

3. Gerar lançamentos de aluguel.

4. Gerar lançamentos da taxa de administração.

5. Gerar lançamentos de taxa de intermediação.

6. Gerar lançamentos do IPTU.

7. Gerar lançamentos do condomínio.

8. Gerar lançamentos da lixo.

9. Gerar lançamentos da taxa marinha.

10. Gerar lançamentos para retenção do IR.

11. Gerar lançamentos de seguro incêndio.

12. Gerar lançamentos de taxa de novembro.

13. Registrar evento "Lançamentos" no contrato.

14. Atualizar "Data do próximo lançamento".