REDA One Centro de ajuda
PT
Idioma
English EN Español ES Português PT Italiano em breve Français FR Deutsch em breve العربية em breve
reda.one ↗
Início / REDA One / Faturamento / Cronogramas e reconhecimento / Ajustes por Inflação

Ajustes por Inflação

Aluguéis que acompanham um índice publicado — o IPC, ou qualquer referência que os seus contratos de locação usem — sem ninguém editar valores em uma planilha. É isso que os ajustes por inflação da REDA fazem: você monta uma regra, carrega os números do índice mês a mês, e a REDA reajusta os aluguéis na periodicidade programada. Este artigo mostra como configurar isso, explica as duas vias que um ajuste pode seguir (as configurações de cobrança de aluguel do imóvel ou as cobranças de um contrato de locação vigente) e ajuda você a se recuperar da falha que todo mundo encontra primeiro — um ajuste que dá erro porque o índice do mês nunca foi carregado. Ele também explica por que os chamados de ajuste aparecem já fechados. Este é um recurso voltado ao administrador; cada termo é definido conforme aparece.

Como chegar lá. Abra o Iniciador de aplicativos (o ícone de grade no canto superior esquerdo de qualquer página) → REDA Admin → a guia Regras de inflação; as entradas mensais do índice ficam sob cada regra. Para executar uma regra sob demanda, abra-a e clique em Run Manually. Para tentar novamente um ajuste que falhou, abra o chamado resultante e use a ação Reprocess Inflation.
Acesso necessário. O controle total das regras exige o conjunto de permissões REDA - Master Data - Admin. O conjunto REDA - Inflation Adjustment User permite visualizar regras e executar ajustes (e atualizar configurações de cobrança de aluguel), mas não editar as próprias regras; REDA - Master Data - Read Only permite visualizar.

As peças em jogo

Cinco peças trabalham juntas. Entender a cadeia faz todo o resto se encaixar:

Uma regra de inflação — a política: com que frequência reajustar, em que dia e por qual método. Uma regra é definida para ajustar imóveis ou contratos de locação (nunca os dois ao mesmo tempo).
As entradas da regra — o índice publicado, carregado uma linha por mês. Esses são os dados brutos que a regra lê.
Uma execução — agendada ou manual, que recolhe qualquer regra com ajuste vencido.
Um chamado Inflation Adjustment — criado já fechado. Fechar o chamado é o que aplica a mudança, de modo que um chamado que aparece como Closed no instante em que surge está funcionando conforme projetado.
As mudanças aplicadas — configurações de cobrança de aluguel ou cobranças do contrato de locação já inflacionadas e, opcionalmente, uma fatura de regularização para os períodos já faturados.

Montando uma regra

Uma regra é definida por um punhado de campos obrigatórios mais algumas opções que moldam o cálculo. A escolha mais importante de todas é Applicable For, que decide se a regra ajusta as configurações de cobrança de aluguel de Property ou as cobranças de Opportunity (o contrato de locação) — ela também controla quais dos outros campos você precisa preencher.

CampoO que ele define
Applicable For (obrigatório)Property ajusta as configurações de cobrança de aluguel de um imóvel; Opportunity ajusta as cobranças de um contrato de locação ativo.
Frequency (obrigatório)Com que frequência reajustar: Monthly, Quarterly (3 Months), Semi-Annually (6 Months) ou Annually.
Inflation Calculation Day (obrigatório)Day of the Month (obrigatório para regras Property) ou Lease Start Date (o aniversário do contrato de locação, para regras Opportunity).
Start DateObrigatório para regras Property — a âncora a partir da qual o cronograma conta.
Update Rent Setup ForObrigatório para regras Property — quais valores-base são inflacionados: New Lease, Renewal ou ambos.
Tolerância (meses)Uma janela retroativa para encontrar o índice publicado mais recente; entradas mais antigas são ignoradas. Em branco significa ilimitada.

Três opções afinam a aritmética. Differential Calculation aplica apenas a variação desde a entrada anterior, em vez do número cheio do índice. Ignore Negative Rates estabelece piso zero para a taxa aplicada, de modo que os aluguéis nunca diminuem. Prorate Invoice (em regras Opportunity) emite uma fatura de regularização proporcional para qualquer parte do período atual que já tenha sido faturada.

A REDA protege as combinações obrigatórias. Em uma regra Property, todas estas condições precisam ser satisfeitas, e cada uma tem a sua própria mensagem quando não são:

"Inflation Calculation Day should be Day of the Month if rule is applicable for Property."
"Day of the month must be provided if Inflation Calculation Day is selected "Day of the Month"."
"Please select "Update Rent Setup For" if rule is applicable on the property."
"Start Date must be provided for Inflation Rule applicable on Property."

Depois que uma regra tem contratos de locação vinculados a ela, a REDA também impede que você troque o Applicable For dela — mudar o alvo de uma regra que já está em uso deixaria o histórico dela órfão, então faça essa escolha antes de vincular qualquer coisa.

Carregando as entradas do índice

Uma regra não reajusta nada enquanto você não a alimentar com o índice. Cada entrada da regra é o número publicado de um mês, e existe exatamente uma entrada por mês:

CampoObrigatórioSignificado
Inflation IndexSimA taxa publicada bruta (%) do mês.
Month / YearSim / SimO período. O ano precisa ser um ano válido de quatro dígitos.
Previous Rule EntryAutomáticoA entrada do período anterior, que a REDA normalmente preenche para você; ela alimenta o cálculo diferencial.
Effective IndexCalculadoA taxa efetivamente aplicada — o diferencial (esta entrada menos a anterior) quando o Differential Calculation está ativo; caso contrário, o índice cheio, com piso zero sob o Ignore Negative Rates.

Informe um ano que não seja um ano real de quatro dígitos e a REDA impede você:

"Value must be a valid year."

A REDA também rejeita uma segunda entrada para a mesma regra, mês e ano, então você não consegue carregar um mês em duplicidade por acidente. O número-chave a observar é o Effective Index — é essa a taxa que a REDA realmente usa, depois que as opções de diferencial e de taxa negativa fizeram o seu papel.

Via A — configurações de cobrança de aluguel do imóvel

Quando uma regra Property é executada, ela procura imóveis que tenham essa regra, sejam de um tipo locável (edifícios e condomínios ficam de fora das execuções em nível de imóvel — você ajusta as unidades, não a estrutura) e estejam vencidos no cronograma. Para cada um, ela escolhe a entrada de índice mais recente cujo mês seja igual ou anterior ao mês em processamento e esteja dentro da janela de tolerância da regra. Se não existir nenhuma entrada assim, a execução dá erro — a falha clássica de primeira viagem, tratada em recuperação, abaixo.

A execução então cria um chamado Inflation Adjustment nascido fechado, e fechá-lo aplica a mudança: o valor-base de cada configuração de cobrança de aluguel é inflacionado pelo índice efetivo, para o que você tiver selecionado entre New Lease / Renewal em Update Rent Setup For. A data do último cálculo do imóvel é registrada, e a próxima data é recalculada a partir dela.

Via B — cobranças de contratos de locação ativos

Uma regra Opportunity é executada sobre os contratos de locação ativos para contabilidade que estão vencidos. Cada contrato usa a sua própria regra de inflação, se tiver uma; caso contrário, usa a regra de locação designada do imóvel. A seleção da entrada e o chamado nascido fechado funcionam exatamente como na Via A — a diferença está no que muda.

Aqui, a REDA reajusta as cobranças vigentes do contrato de locação — mas só aquelas cujo código de cobrança tem Include in Inflation Calculation marcado (de modo que o aluguel sobe enquanto, digamos, uma cobrança fixa de estacionamento não sobe). Para cada cobrança elegível, a cobrança existente é inativada (encerrada no dia anterior ao ajuste) e uma nova cobrança é inserida com o valor inflacionado — o valor antigo × (1 + índice efetivo ÷ 100) — cobrindo o restante do período.

Se a opção Prorate Invoice da regra estiver ativa e o período atual já tiver sido faturado à taxa antiga, a REDA também emite uma Fatura Opp de regularização pela diferença proporcional, com o comentário de faturamento indicando Inflation Adjustment (from - to) e a data de vencimento seguindo os dias de carência do código de cobrança. Essa diferença proporcional usa a mesma matemática de taxa diária de qualquer período parcial — veja Prorrateio.

Por que os chamados de ajuste nascem fechados

Todo ajuste produz um chamado Inflation Adjustment, e a REDA o cria já fechado. Isso é proposital: nesses chamados, o fechamento é o ato que aplica a mudança, então não há nada para você trabalhar — um chamado que aparece como Closed é um ajuste bem-sucedido. Os únicos que precisam de atenção são os que pararam em Processing Error, que carregam a falha no campo Error Message e também ficam registrados para revisão. Para tentar um novamente, use a ação Reprocess Inflation no chamado; ela limpa o erro e fecha o chamado de novo para executá-lo outra vez. Ela não mexe em um chamado que já foi fechado com sucesso — não há nada a refazer.

Colocando para rodar

Existem duas execuções em segundo plano — uma para a via do imóvel, outra para a via do contrato de locação — e, como acontece com a maior parte da automação de faturamento, nenhuma das duas já vem agendada. Um administrador as agenda uma vez no Console de Administração (veja Agendamento de Trabalhos em Segundo Plano). Ambas têm um requisito firme:

As execuções de inflação precisam ser agendadas com um tamanho de lote de exatamente 1. As duas execuções de inflação processam um único registro por trabalho. Agende qualquer uma delas com um tamanho de lote maior e ela se recusa a rodar: "Only one record can be processed in one job. Please limit batch size to 1." Defina o tamanho do lote como 1 e ela prossegue.

Para ajustar uma regra sob demanda sem esperar a execução agendada, abra a regra e clique em Run Manually; a REDA submete o trabalho e envia um e-mail para você quando ele termina.

Quando uma execução falha, e como se recuperar

A falha que você vai encontrar primeiro é uma execução que não consegue achar um índice para o mês que está processando — porque a entrada nunca foi carregada:

"Inflation Index not defined for the period."

A correção é exatamente o que parece: carregue a entrada do mês que faltava e execute novamente (ou use o Reprocess Inflation no chamado com erro). Veja o mapa completo de solução de problemas:

SintomaCausaCorreção
"Inflation Index not defined for the period."Nenhuma entrada para o mês dentro da janela de tolerância da regraCarregue a entrada do mês e execute novamente ou use o Reprocess Inflation
O Ticket Status indica Processing ErrorOcorreu uma falha ao aplicar o ajusteUse a ação Reprocess Inflation (ela limpa o erro e fecha o chamado de novo)
O Reprocess recusa o chamadoO chamado já foi fechado com sucessoNada a fazer — o ajuste está concluído
"Only one record can be processed in one job. Please limit batch size to 1."A execução foi agendada com um tamanho de lote acima de 1Reagende-a com tamanho de lote 1
Um edifício não foi ajustadoEdifícios e condomínios ficam de fora das execuções em nível de imóvelAjuste as unidades, não a estrutura do edifício

Via A versus Via B em um relance

AspectoVia A — ImóvelVia B — Contrato de locação
Applicable ForPropertyOpportunity
Âncora de tempoStart Date da regra + frequência, no Day of the MonthO aniversário do contrato de locação (Lease Start Date), ou um dia do mês
Quem se qualificaImóveis com uma regra Property, de um tipo locável, vencidos agoraContratos de locação ativos para contabilidade vencidos agora
Regra usadaA Inflation Rule (Property) do imóvelA regra própria do contrato de locação; se não houver, a Inflation Rule (Lease) do imóvel
O que mudaValores-base das configurações de cobrança de aluguel (New / Renewal)Cobranças recorrentes vigentes (pelo sinalizador do código): a antiga é encerrada, a nova entra a ×(1 + índice/100)
Saída extra—Uma fatura de regularização proporcional opcional
VeículoChamado Inflation Adjustment nascido fechadoO mesmo

Exemplo prático: um reajuste anual pelo IPC

Monte uma regra Opportunity CPI Annual — Leases: Annually, no aniversário do contrato de locação, Tolerance de 2 meses, Prorate Invoice ativo. Carregue as entradas do índice: maio 3.10%, junho ausente, julho 3.40%. O contrato de locação de demonstração é Meridian Court #101 — Aisha Rahman — com o aluguel definido em 1,200.00 e aniversário em janeiro.

Quando a execução do aniversário lê a entrada de julho, ela infla o aluguel em 3.40%: a cobrança antiga é encerrada no dia anterior, e uma nova cobrança assume a 1,200.00 × 1.034 = 1,240.80. Como o período atual já tinha sido faturado à taxa antiga, a REDA emite uma fatura de regularização pela diferença proporcional de 40.80, com o comentário indicando Inflation Adjustment (from - to).

Agora a variante de falha. Suponha que a execução caia em um mês cuja entrada nunca foi carregada e não exista nenhuma dentro da tolerância — ela dá erro com "Inflation Index not defined for the period." Você carrega a entrada e usa o Reprocess Inflation no chamado com erro, e o ajuste se completa.

A guia Regras de inflação listando uma regra com o seu escopo de aplicação e a sua frequência
A guia Regras de inflação: cada regra mostra em um relance a que ela se aplica — aqui, uma regra anual com escopo Opportunity ancorada na data de início do contrato de locação —, para que você distinga os reajustes em nível de imóvel dos que são em nível de contrato.
Um registro de regra de inflação com o seu valor de Applicable For, o dia de cálculo, a frequência e as opções
Uma regra de inflação configurada para se aplicar por contrato de locação: o dia de cálculo segue a data de início de cada contrato, a frequência é anual, e o bloco de opções ativa o cálculo diferencial e o prorrateio da fatura. As suas entradas de índice aparecem listadas ao lado.
Uma entrada de regra de inflação mostrando o índice efetivo em um exemplo com diferencial
Uma entrada da regra com o cálculo diferencial ativo: o índice bruto é 3.40%, mas, como a entrada anterior estava em 3.10%, o Effective Index resolve para a diferença de 0.30% efetivamente aplicada.
Um chamado Inflation Adjustment nascido fechado em um contrato de locação
Um chamado Inflation Adjustment, criado já como Closed para registrar a execução: ele nomeia a regra e o contrato de locação que foram reajustados, e oferece a ação Reprocess Inflation caso alguma execução precise ser refeita.

O que vem a seguir

  1. Como Funciona o Faturamento na REDA — o modelo de cobranças e faturas em que as cobranças inflacionadas se encaixam.
  2. Prorrateio — a matemática de taxa diária por trás da fatura de regularização.
  3. Códigos de Cobrança — o sinalizador Include in Inflation Calculation que decide quais cobranças são reajustadas.
  4. Agendamento de Trabalhos em Segundo Plano — as duas execuções e o requisito de tamanho de lote 1.
  5. Cronogramas de Aluguel em Linha Reta — outro recurso de faturamento orientado a cronograma, para aluguéis escalonados.

Perguntas frequentes

Não existe nenhuma entrada de índice para o mês em processamento dentro da janela de tolerância da regra. Carregue a entrada do mês e use o Reprocess Inflation no chamado com erro (ou execute a regra novamente).

É proposital — a execução cria esses chamados já nascidos fechados, porque é o fechamento que aplica o ajuste. Somente os chamados em Processing Error precisam da sua atenção.

Somente as cobranças cujo código de cobrança tem Include in Inflation Calculation marcado são reajustadas. Uma cobrança que ficou de fora desse sinalizador permanece no seu valor fixo.

Só se você permitir. Ative o Ignore Negative Rates e o índice efetivo passa a ter piso zero, de modo que uma taxa publicada negativa nunca reduz o aluguel.

As regras Property exigem três coisas no lugar: "Inflation Calculation Day should be Day of the Month if rule is applicable for Property." · "Please select "Update Rent Setup For" if rule is applicable on the property." · "Start Date must be provided for Inflation Rule applicable on Property." Forneça as três e ela salva.

O Reprocess Inflation só repete chamados em Processing Error. Um chamado que já está fechado foi bem-sucedido, então não há nada a refazer.

Isso foi útil?