Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

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:

...

#

...

Campo

...

Descrição

...

1

...

Tipo de registro

...

O campo "Tipo de registro" do contrato deve ser igual a "Locação".

...

2

...

Contrato ativo

...

O campo "Ativo" deve ser igual a "Verdadeiro".

...

3

...

Contrato para faturar

...

O campo "Faturar" deve ser igual a "Verdadeiro".

...

4

...

Data do próximo lançamento

...

O campo "Data do próximo lançamento" deve ser igual à data da execução do serviço.

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:

...

Table of Contents

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:

#

Campo

Descrição

1

Tipo de registro

O campo "Tipo de registro" do contrato deve ser igual a "Locação".

2

Contrato ativo

O campo "Ativo" deve ser igual a "Verdadeiro".

3

Contrato para faturar

O campo "Faturar" deve ser igual a "Verdadeiro".

4

Data do próximo lançamento

O campo "Data do próximo lançamento" deve ser igual à data da execução do serviço.

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 ainda não foi ativadodefinido; ';

  7. Se o campo “Faturar” “Periodicidade do reajuste” (contrato.FaturarPeridiocidade_reajuste__c) for nulo o sistema incrementará a mensagem de erro: 'O contrato não está habilitado para faturamentoA periodicidade de reajuste do valor do aluguel não foi definida; ';

  8. Se o campo “Data de início de Vigência” “Valor do aluguel original” (contrato.DataValor_inicio_vigenciaaluguel__c) for nulo o sistema incrementará a mensagem de erro: 'Data de início de vigência Valor do aluguel não foi definidadefinido; ';

  9. Se o campo “Data da posse do locatário” “Valor do aluguel corrigido” (contrato.DataValor_possealuguel_locatariocorrigido__c) for nulo o sistema incrementará a mensagem de erro: 'O contrato ainda Valor do aluguel corrigido não foi ativadodefinido; ';

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

  11. Se o campo “Tipo “Taxa de vencimento”intermediação para locação” (contrato.TipoTaxa_vencimentointermediacao__c) for nulo o sistema incrementará a mensagem de erro: 'O tipo Taxa de vencimento intermediação do contrato não foi definidodefinida; ';

  12. Se o campo “Periodicidade do reajuste” “Data vencimento da próxima fatura” (contrato.Peridiocidade_reajusteData_vencimento_proxima_fatura__c) for nulo o sistema incrementará a mensagem de erro: 'A periodicidade de reajuste do valor do aluguel Data de vencimento da próxima fatura não foi definidapreenchida; ';

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

  14. Se o campo “Valor do aluguel corrigido” “Locatário” (contrato.Valorsnap_brok_aluguel_corrigidoLocatario__c) for nulo o sistema incrementará a mensagem de erro: 'Valor do aluguel corrigido O locatário não foi definidopreenchida; ';

  15. Se o campo “Taxa de administração” “Locador” (contrato.Taxa_administracaosnap_brok__Locador__c) for nulo o sistema incrementará a mensagem de erro: 'Taxa de administração do contrato O locador não foi definidapreenchida; ';

  16. Se o campo “Taxa de intermediação para locação” “Carteira” (contrato.Taxa_intermediacao.Empresa__r.snap_finan__Carteira__c) for nulo o sistema incrementará a mensagem de erro: 'Taxa de intermediação do contrato A carteira da empresa não foi definidapreenchida; ';

  17. Se o campo “Data vencimento da próxima fatura” “Gerar lançamentos para IPTU” (contrato.DataGerar_lancamento_iptu_vencimento_proxima_fatura_c) estiver igual a “Ativo”:

    1. O sistema validará também:

      1. se o campo “Responsável pelo IPTU” (contrato.Responsavel_iptu__c) for

    nulo o sistema incrementará a mensagem de
      1. igual a nulo será incrementado o seguinte erro: '

    Data de vencimento da próxima fatura
      1. O responsável do IPTU não foi

    preenchida
      1. preenchido; ';

    Se
      1. se o campo

    “Data do próximo lançamento”
      1. “Pagante IPTU” (contrato.

    Data
      1. Pagante_

    proximo
      1. iptu_

    aluguel
      1. _

    _
      1. c) for igual a nulo

    o sistema incrementará a mensagem de
      1. será incrementado o seguinte erro: '

    Data
      1. O pagante do

    próximo lançamento
      1. IPTU não foi

    preenchida; ';
  18. 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; ';

  19. Se o campo “Locador” (contrato.snap_brok__Locador__c) for nulo o sistema incrementará a mensagem de erro: 'O locador
      1. preenchido; ';  

      2. 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; ';

    Se o campo “Carteira” (contrato.Empresa
        1. “Rateio IPTU” (imovel.Imovel__r.

    snap
        1. Rateio_

    finan
        1. iptu__

    Carteira__
        1. c)

    for nulo o sistema incrementará a mensagem de erro: 'A carteira da empresa
        1. , 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; ';

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

    1. O sistema validará também:

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

      2. se o campo “Pagante IPTU”condomínio” (contrato.Pagante_iptucondominio__c) for igual a nulo será incrementado o seguinte erro: 'O pagante do IPTU 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 mensal do IPTU” condomínio” (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; ';“Rateio IPTU” (imovel.Imovel__r.Rateio_iptucondominio__c), caso esse campo seja nulo será incrementado o seguinte erro: 'O valor do rateio condomínio do IPTU do imóvel ' + “Imóvel” “Imóvel” (imovel.Imovel__r.Name) + ' não foi preenchida; ';

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

    1. O sistema validará também:

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

      2. se o campo “Pagante condomínio” coleta de lixo” (contrato.Pagante_condominiocoleta_lixo__c) for igual a nulo será incrementado o seguinte erro: 'O pagante da coleta do condomínio 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 do condomínio” mensal de coleta de lixo” (imovel.Imovel__r.Valor_condominiomensal_Coleta_lixo__c), caso esse campo seja nulo será incrementado o seguinte erro: 'O valor da coleta do condomínio lixo do imóvel ' + “Imóvel”  (imovel.Imovel__r.Name) + ' não foi preenchida; ';

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

    1. O sistema validará também:

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

      2. se o campo “Pagante coleta de lixo” taxa marinha” (contrato.Pagante_coletataxa_lixomarinha__c) for igual a nulo será incrementado o seguinte erro: 'O pagante da coleta do lixo 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:

      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
        1. se o campo “Valor mensal de coleta de lixo”taxa marinha” (imovel.Imovel__r.Valor_mensal_ColetaTaxa_lixoMarinha__c), caso esse campo seja nulo será incrementado o seguinte erro: 'O valor da coleta taxa marinha do lixo do imóvel ' +  “Imóvel”  (imovel.Imovel__r.Name) + ' não foi preenchida; ';

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

        1. “Imóvel”  (imovel.Imovel__r.Name)  + ' não foi preenchida; ';

Após, o sistema irá percorrer os participantes do contrato e validar as seguintes informações para cada participante encontrado:

  1. Se o campo “Papel” do participante (part.snap_brok__Papel__c) se for igual “Locatário”

    Se o campo “Papel” do participante
    1. Se o campo “Tipo de Pessoa” (part.snap_brok__Participante__r.snap_finan__tipo_pessoa__c) da conta do participante for igual “Física”

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

        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:

        se o campo “Valor mensal de taxa marinha” (imovel.Imovel

      2. Se o campo “CPF - ERP” (part.snap_brok__Participante__r.

        Valor

        snap_

        mensal

        finan_

        Taxa

        _

        Marinha

        CPFF__c)

        , caso esse campo seja nulo será incrementado o seguinte

        da conta do participante estiver nulo o sistema incrementará a mensagem de erro: 'O

        valor da taxa marinha do imóvel ' + “Imóvel”  (imovel.Imovel__r.Name)  + ' não foi preenchida; ';

Após, o sistema irá percorrer os participantes do contrato e validar as seguintes informações para cada participante encontrado:

      1. CPF (ERP) do locatário ' + “Nome da conta” (part.snap_brok__Participante__r.Name) + ' não foi preenchido; ';

    1. Se o “Tipo de pessoa” (part.snap_brok__Participante__r.snap_finan__tipo_pessoa__c) da conta do participante for diferente de “Física”

      1. Se o campo “CNPJ” da conta do participante estiver nulo (part.snap_brok__Participante__

    Papel
      1. r.snap_finan__CNPJ__c)

    se for igual “Locatário”
    1. Se o campo “Tipo de Pessoa”
      1. o sistema incrementará a mensagem de erro: 'O CNPJ do locatário ' + “Nome da conta” (part.snap_brok__Participante__r.

      snap_finan__tipo_pessoa__c) da conta do participante for igual “Física”
      1. Se o campo “CPF” Name) + ' não foi preenchido;';

      2. Se a campo “Razão social” (part.snap_brok__Participante__r.snap_finan__Cpfrazao_2social__pcc) da conta do participante estiver nulo, o sistema incrementará a mensagem de erro: 'O CPF A razão social do locatário ' + “Nome da conta” (part.snap_brok__Participante__r.Name) + ' não foi preenchidopreenchida; ';

  1. Se o campo

    “CPF - ERP”

    “Endereço para cobrança” (part.snap_brok__Participante__r.snap_finan__Logradouro_

    CPFF

    cobranca__c) da conta do participante

    estiver

    for nulo o sistema incrementará a mensagem de erro: 'O

    CPF (ERP)

    logradouro do endereço de cobrança do locatário ' + “Nome da conta” (part.snap_brok__Participante__r.Name)

     

    + ' não foi preenchido; ';

  2. Se o

    “Tipo de pessoa”

    campo “Bairro para cobrança” (part.snap_brok__Participante__r.snap_finan__

    tipo

    Bairro_

    pessoa

    cobranca__c) da conta do participante for

    diferente de “Física”Se o campo “CNPJ” da conta do participante estiver

    nulo

    (part.snap_brok__Participante__r.snap_finan__CNPJ__c)

    o sistema incrementará a mensagem de erro: 'O

    CNPJ

    bairro do endereço de cobrança do locatário ' + “Nome da conta” (part.snap_brok__Participante__r.Name) + ' não foi preenchido; ';

  3. Se

    a campo “Razão social”

    o campo “CEP para cobrança” (part.snap_brok__Participante__r.snap_finan__

    razao

    Cep_

    social

    cobranca__c) da conta do participante

    estiver

    for nulo

    ,

    o sistema incrementará a mensagem de erro: '

    A razão social

    O cep do endereço de cobrança do locatário ' + “Nome da conta” (part.snap_brok__Participante__r.Name) + ' não foi

    preenchida

    preenchido; ';

  4. Se o campo “Endereço “Cidade para cobrança” (part.snap_brok__Participante__r.snap_finan__Cidade_Logradouropara_cobranca_texto__c) da conta do participante for nulo o sistema incrementará a mensagem de erro: 'O logradouro A cidade do endereço de cobrança do locatário ' + “Nome da conta” (part.snap_brok__Participante__r.Name) + ' não foi preenchidopreenchida; ';

  5. Se o campo “Bairro “UF para cobrança” (part.snap_brok__Participante__r.snap_finan__BairroUF_para_cobranca__c) da conta do participante for nulo o sistema incrementará a mensagem de erro: 'O bairro estado (UF) do endereço de cobrança do locatário ' + “Nome da conta” (part.snap_brok__Participante__r.Name) + ' não foi preenchidopreenchida; ';

Se o

...

sistema incrementou uma ou mais mensagens de erro em alguma das validações acima, ele atualizará:

  1. O valor do campo “Validado para faturamento” (contrato.snap_brok__Validado_faturamento__c) será colocado com “Falso”.

  2. O campo “Erros para faturamento” (contrato.snap_brok__Participante__r.snap_finan__Cep_cobranca__c) da conta do participante for nulo o sistema incrementará a mensagem de erro: 'O cep do endereço de cobrança do locatário ' + “Nome da conta” (partErros_faturamento__c) será preenchido com os erros incrementados durante a validação.

  3. o campo “Situação do lançamento” (contrato.snap_brok__Situacao_Participantefaturamento__r.Name) + ' não foi preenchido; ';Se o campo “Cidade para cobrança” (partc) será preenchido com“Erro”.

Note

O sistema valida o campo “Quantidade de dias para lançamentos” (parametrizacao.snap_brok__

...

Quantidades_

...

dias_para_

...

lancamentos_

...

_

...

c)

...

Se o campo “UF para cobrança” (part.snap_brok__Participante__r.snap_finan__UF_para_cobranca__c) da conta do participante for nulo o sistema incrementará a mensagem de erro: 'O estado (UF) do endereço de cobrança do locatário ' + “Nome da conta” (part.snap_brok__Participante__r.Name) + ' não foi preenchida; ';

Se o sistema incrementou uma ou mais mensagens de erro em alguma das validações acima, ele atualizará:

...

O valor do campo “Validado para faturamento” (contrato.snap_brok__Validado_faturamento__c) será colocado com “Falso”.

...

O campo “Erros para faturamento” (contrato.snap_brok__Erros_faturamento__c) será preenchido com os erros incrementados durante a validação.

...

Note

O sistema valida o campo “Quantidade de dias para lançamentos” (parametrizacao.snap_brok__Quantidades_dias_para_lancamentos__c) do registro “Padrão” do parametrizações do SnapProperty, se o campo estiver nulo o sistema dará o seguinte erro: 'O parâmetro com a quantidade de dias para lançamentos não foi definido', abortando a geração de lançamento.

Se o sistema encontrar algum erro na validação acima descrita, incluirá os contratos com erro em uma lista para notificação por e-mail. Os contratos que foram validados com sucesso seguirão para geração de lançamento.

Período de Apuração

Existem duas modalidades de período de apuração para a geração de lançamentos “Mês aberto” e “Mês fechado” para definir qual será o tipo de apuração da org será verificado o campo “Período de apuração do faturamento” (parametrizacao.snap_brok__Periodo_apuracao_faturamento__c) do objeto de parametrizações do SnapProperty.

Glossário

Término de apuração: Término de apuração será a data limite final que o sistema se utilizará para apurar os lançamentos, por exemplo, um aluguel tem sua data de término de apuração definindo até quando será pago aquele aluguel.

Início de apuração: Início de apuração será a data inicial que o sistema se utilizará para apurar os lançamentos, por exemplo, um aluguel tem sua data de início de apuração definindo desde quando será pago aquele aluguel.

Mês Aberto

...

do registro “Padrão” do parametrizações do SnapProperty, se o campo estiver nulo o sistema dará o seguinte erro: 'O parâmetro com a quantidade de dias para lançamentos não foi definido', abortando a geração de lançamento.

Se o sistema encontrar algum erro na validação acima descrita, incluirá os contratos com erro em uma lista para notificação por e-mail. Os contratos que foram validados com sucesso seguirão para geração de lançamento.

Período de Apuração

Existem duas modalidades de período de apuração para a geração de lançamentos “Mês aberto” e “Mês fechado” para definir qual será o tipo de apuração da org será verificado o campo “Período de apuração do faturamento” (parametrizacao.snap_brok__Periodo_apuracao_faturamento__c) do objeto de parametrizações do SnapProperty.

Glossário

Término de apuração: Término de apuração será a data limite final que o sistema se utilizará para apurar os lançamentos, por exemplo, um aluguel tem sua data de término de apuração definindo até quando será pago aquele aluguel.

Início de apuração: Início de apuração será a data inicial que o sistema se utilizará para apurar os lançamentos, por exemplo, um aluguel tem sua data de início de apuração definindo desde quando será pago aquele aluguel.

Mês Aberto

  • Término de apuração = data do “Data do próximo lançamento” (contrato.Data_proximo_aluguel__c) do contrato+ “Dias do lançamento” (parametrizacao.snap_brok__Quantidades_dias_para_lancamentos__c) do objeto parametrizações do SnapProperty.

  • Se o mês da “Data do próximo lançamento” (contrato.Data_proximo_aluguel__c) do contrato for igual a 2 e “Tipo de vencimento” (contrato.tipo_vencimento__c) do contrato for igual “Vencido” e “Dia do vencimento” (contrato.Dia_vencimento__c) for maior que 28:

    • Término de apuração = dia igual 28, mês igual a mês da data de término da apuração - 1 mês, ano igual ao ano da data de término da apuração.

    • Início de apuração = data do término de apuração - 1 mês.

    • O sistema define qual é o último dia do mês do início de apuração calculado na etapa anterior.

    • Início de apuração = ano do início de apuração, mês do início de apuração e último dia encontrado na etapa anterior.

Se o sistema entrou nessa condicional, quer dizer que o dia de vencimento do contrato não está aderente com o mês de fevereiro que o lançamento compete, pois o mês de fevereiro, com exceção de anos bissextos, não possui mais que 28 dias e, portanto, a data de apuração deverá respeitar o último dia do mês de fevereiro e não o dia de vencimento estipulado no contrato no campo “Dias de vencimento” (contrato.Dia_vencimento__c).

  • Senão se o mês da “Data do próximo lançamento” (contrato.Data_proximo_aluguel__c) do contrato for igual a 2 e “Tipo de vencimento” (contrato.tipo_vencimento__c) do contrato for igual “Vencido” “Antecipado” e “Dia do vencimento” (contrato.Dia_vencimento__c) for maior que 28:

    • Término de apuração = dia igual 28, mês igual a mês da data de do término da apuração - 1 mês, ano igual ao ano da data de término da apuração.

    • Início de apuração = data do término de apuração - 1 mês.

    • O sistema define qual é o último dia do mês do início de apuração calculado na etapa anterior.

    • Início de apuração = ano do início de apuração, mês do início de apuração e último dia encontrado na etapa anterior.

Se o sistema entrou nessa condicional, quer dizer que o dia de vencimento do contrato não está aderente com o mês de fevereiro que o lançamento compete, pois o mês de fevereiro, com exceção de anos bissextos, não possui mais que 28 dias e, portanto, a data de apuração deverá respeitar o último dia do mês de fevereiro e não o dia de vencimento estipulado no contrato no campo “Dias de vencimento” (contrato.Dia_vencimento__c).

...

, portanto, a data de apuração deverá respeitar o último dia do mês de fevereiro e não o dia de vencimento estipulado no contrato no campo “Dias de vencimento” (contrato.Dia_vencimento__c)

...

.

  • Se as duas condições acima não foram atendidas:

    • Término de apuração = dia igual 28, mês igual a do vencimento do contrato, mês da data do de término da apuração - 1 mês, ano igual ao de apuração definida na etapa anterior, ano da data de término da de apuração definida na etapa anterior.

    • Início de apuração = data do término de apuração - 1 mês - 1 dia.

    • O sistema define qual é o último dia do mês do início de apuração calculado na etapa anterior.

    • Início de apuração = ano do início de apuração, mês do início de apuração e último dia encontrado na etapa anterior.

Se o sistema entrou nessa condicional, quer dizer que o dia de vencimento do contrato não está aderente com o mês de fevereiro que o lançamento compete, pois o mês de fevereiro, com exceção de anos bissextos, não possui mais que 28 dias e, portanto, a data de apuração deverá respeitar o último dia do mês de fevereiro e não o dia de vencimento estipulado no contrato no campo “Dias de vencimento” (contrato.Dia_vencimento__c).

  • Se as duas condições acima não foram atendidas:

    • Término de apuração = dia do vencimento do contrato, mês da data de término de apuração definida na etapa anterior, ano da data de término de apuração definida na etapa anterior.

    • Início de apuração = término de apuração - 1 mês - 1 dia.

Se o sistema entrou neste processamento, significa que o mês do lançamento não é fevereiro e, portanto, seguirá o processamento dos dias normalmente. Este processamento consiste em adicionar quantidade de dias para lançamento na data do próximo lançamento, sendo assim, define o término da apuração como sendo a data de vencimento da próxima fatura e o início de apuração como sendo menos um mês desta data mais um dia, para que o lançamento não cobre o valor novamente do último dia que já foi apurado no mês anterior.

...

  • Se o contrato é antecipado haverá um acréscimo de mais um mês para o término da apuração pois isso significa que a apuração deste lançamento compete ao mês seguinte de quando ele está sendo cobrado (primeiro paga depois usufrui):

    • Término de apuração = “início de apuração” (que foi definido na etapa anterior) + 1 mês - 1 dia.

Mês Fechado

Ciclo financeiro

O sistema cria um ciclo financeiro para controles dos lançamentos agrupados:

Os campos “Ano” e “Mês” que constará no ciclo financeiro será o ano e mês do “Término de apuração”.

gerarLancamentosAluguel

Este método recebe como parâmetro a “data de início de apuração” e “término de apuração” que foi calculada na etapa anterior de período de apuração.

...

Se o “Tipo de vencimento” for igual a “Antecipado” e “Período de apuração” igual a “Mês fechado”

  • A “data do lançamento” = data de término da apuração - 1 mês

...

Se o período de apuração igual “Mês fechado

  • Terminar de documentar mês fechado.

Se o período de apuração igual “Mês aberto

...

Se o mês da “data do próximo reajuste” do contrato for igual ao mês da “data de vencimento da próxima fatura” e o ano da “data do próximo reajuste” do contrato for igual ao ano da “data de vencimento da próxima fatura”

Se não houve erro para calcular o reajuste do aluguel o sistema irá criar o lançamento de aluguel da seguinte forma:

...

o campo “contrato de administração” (Contrato__c ) do lançamento = “Contrato de administração” (contrato.Contrato_administracao__c) que está sendo gerado o lançamento

...

Contrato_locacao__c = contrato.Id,

...

Lancamento_contrato__c debito =

...

Se o sistema entrou neste processamento, significa que o mês do lançamento não é fevereiro e, portanto, seguirá o processamento dos dias normalmente. Este processamento consiste em adicionar quantidade de dias para lançamento na data do próximo lançamento, sendo assim, define o término da apuração como sendo a data de vencimento da próxima fatura e o início de apuração como sendo menos um mês desta data mais um dia, para que o lançamento não cobre o valor novamente do último dia que já foi apurado no mês anterior.

  • Se “Tipo de vencimento” (contrato.tipo_vencimento__c)igual Antecipado

    • Se o contrato é antecipado haverá um acréscimo de mais um mês para o término da apuração pois isso significa que a apuração deste lançamento compete ao mês seguinte de quando ele está sendo cobrado (primeiro paga depois usufrui):

      • Término de apuração = “início de apuração” (que foi definido na etapa anterior) + 1 mês - 1 dia.

Mês Fechado

Ciclo financeiro

O sistema cria um ciclo financeiro para controles dos lançamentos agrupados:

Os campos “Ano” e “Mês” que constará no ciclo financeiro será o ano e mês do “Término de apuração”.

gerarLancamentosAluguel

Este método recebe como parâmetro a “Data de início de apuração” e “Término de apuração” que foi calculada na etapa anterior de período de apuração.

  • Se o “Tipo de vencimento” (contrato.tipo_vencimento__c) for igual a Antecipado e “Período de apuração” (parametrizacao.snap_brok__Periodo_apuracao_faturamento__c) do objeto de parametrizações do SnapProperty for igual a “Mês fechado

    • A “Data do lançamento” = data de término da apuração - 1 mês

  • Se o período de apuração igual Mês fechado

    • Terminar de documentar mês fechado.

  • Se o período de apuração igual Mês aberto

    • Se o mês da “Data do próximo reajuste” (contrato.Data_proximo_reajuste__c) for igual ao mês da “data de vencimento da próxima fatura” (contrato.Data_vencimento_proxima_fatura__c) e o ano da “Data do próximo reajuste” (contrato.Data_proximo_reajuste__c) do contrato for igual ao ano da “data de vencimento da próxima fatura” (contrato.Data_vencimento_proxima_fatura__c):

    • Se não houve erro para calcular o reajuste do aluguel o sistema irá criar o lançamento de aluguel da seguinte forma:

      • O campo “Contrato de administração” (lancamentoContrato.Contrato__c) do lançamento = “Contrato de administração” (contrato.Contrato_administracao__c) que está sendo gerado o lançamento;

      • O campo “Contrato de locação” (lancamentoContrato.Contrato_locacao__c) do lançamento = “Contrato de locação” (contrato.contrato.Id) que está sendo gerado o lançamento;

      • O campo “Ciclo de locação” (lancamentoContrato.Ciclo_locacao__r) do lançamento = ciclo;

      • O campo “Data do lançamento” (lancamentoContrato.Data_lancamento__c) do lançamento = datalancamento;

      • O campo “Histórico” (lancamentoContrato.Historico__c) do lançamento = Histórico

      • O campo “Imóvel” (lancamentoContrato.Imovel__c) do lançamento = “Imóvel” (contrato.Imovel__c) que está sendo gerado o lançamento;

      • O campo “Tipo de registro” (Lancamento_contrato__c.getRecordTypeInfosByName()) do lançamento = “Locatário”;

      • O campo “Situação” (Lancamentocontrato.Situacao__c) do lançamento = “Aprovado”;

      • O campo “Tipo de lançamento” (lancamentoContrato.Tipo_lancamento_contrato__c) do lançamento = “Aluguel”;

      • O campo “Valor do lançamento” (lancamentoContrato.Valor_lancamento__c) do lançamento = valorLancamento negativo.

  •   Lancamento_contrato__c debito = new Lancamento_contrato__c(
                               Contrato__c = contrato.Contrato_administracao__c,
                               Contrato_locacao__c = contrato.Id,
                               Ciclo_locacao__r = ciclo,
                               Data_lancamento__c = dataLancamento,
                               Historico__c = historico,
                               Imovel__c = contrato.Imovel__c,

...

  •                            RecordTypeId = Schema.SObjectType.Lancamento_contrato__c.getRecordTypeInfosByName().get('Locatário').getRecordTypeId(),
                               Situacao__c = 'Aprovado',
                               Tipo_lancamento_contrato__c = 'Aluguel',
                               Valor_lancamento__c =

...

  • - valorLancamento);
                           lancamentos.add(debito);
                         

...

Irá criar o lançamento de aluguel da seguinte forma:

...

Crédito

...

Débito

...

Tipo de registro

...

Locador

...

Locatário

...

Tipo de lançamento

...

Aluguel

...

  •  system.debug('aluguel débito: ' + debito);

Irá criar o lançamento de aluguel da seguinte forma:

Crédito

Débito

Contrato de administração

Número do contrato de administração que originou o lançamento

Número do contrato de administração que originou o lançamento

Contrato de locação

Número do contrato de locação que originou o lançamento

Número do contrato de locação que originou o lançamento

Ciclo de locação

Número do ciclo que originou o lançamento

Número do ciclo que originou o lançamento

Data do lançamento

Data de vencimento da próxima fatura

Data de vencimento da próxima fatura

Situação

Aprovado

Aprovado

Histórico

Aluguel referente ao período de "Início de apuração" a "Término de apuração"

Aluguel referente ao período de "Início de apuração" a "Término de apuração"

Imóvel

Imóvel principal do contratoImóvel principal do contratodo contrato

Imóvel principal do contrato

Tipo de registro

Locador

Locatário

Situação

Aprovado

Aprovado

Tipo de lançamento

Aluguel

Aluguel

Valor do lançamento

Valor do aluguel corrigido

-Valor do aluguel corrigido

Ciclo de locação

Número do ciclo que originou o lançamento

Número do ciclo que originou o lançamento

Contrato de administração

Número do contrato de administração que originou o lançamento

Número do contrato de administração que originou o lançamento

Contrato de locação

Número do contrato de locação que originou o lançamento

Número do contrato de locação que originou o lançamento

Se o sistema entrou nessa condicional, significa que está no mês e ano do reajuste do contrato e, portanto, será realizado o reajuste de acordo ao processamento do reajuste do aluguel. Para entender a lógica do reajuste consulte o artigo xxxxxxxxxxxxxxxxxxxxxxx.

O sistema também inicializará a renovação do seguro contra incêndio pois após o reajuste do contrato é necessário novos lançamentos de seguro para esse contrato. Para saber mais sobre o processamento do módulo de seguro, consulte o artigo xxxxxxxxxxxxxxxxxx.

Se não for mês e ano do reajuste do contrato, o sistema criará o lançamento de aluguel sem passar pelo processamento do reajuste nem geração do seguro contra incêndio. Os lançamentos de alugueis ficarão da seguinte forma:

...