Como Funciona o Faturamento Recorrente

O aluguel se fatura sozinho na REDA — mês após mês, sem que ninguém precise emitir uma fatura manualmente. Este artigo explica o mecanismo por trás disso: quando a próxima fatura é gerada, por que a REDA a emite antes de o período começar, e o comportamento que gera mais chamados de suporte do que qualquer outro — o locatário que recebe duas faturas no primeiro mês. Você também vai aprender as três coisas de que uma cobrança recorrente precisa antes de conseguir faturar, para que, quando alguém disser "não foi gerado nada ontem à noite", você saiba exatamente o que verificar. Não é necessário nenhum conhecimento prévio da REDA.

As peças em jogo

Três coisas precisam se alinhar para que o aluguel seja faturado automaticamente:

O REDA fatura com antecedência

Aqui está a ideia que explica quase tudo o que vem a seguir: uma execução fatura o próximo período, não o atual. O REDA emite a fatura antes de o período começar, para que o locatário sempre tenha a conta em mãos com antecedência. O que "próximo período" significa depende do período da cobrança:

Um ciclo mensal personalizado é opcional: se uma Regra de locação define um dia de início e fim mensal para a cobrança (digamos, 25 e 24), os períodos de faturamento correm do dia 25 ao dia 24, em vez de por mês do calendário. Um período de cobrança em branco é tratado como mensal.

Quando minha cobrança é recolhida?

Cada cobrança recorrente traz uma Next Recurring Invoice Date — a data em que uma execução vai recolhê-la. Como a REDA fatura com um ciclo de antecedência, essa data de recolhimento fica um ciclo antes do período que fatura. A data é determinada por um dia de processamento definido na Regra de locação (o Recurring Invoice Process Day - M para cobranças mensais; cobranças semanais usam o par - W, Recurring Invoice Process Day - W e Next Recurring Invoice Threshold Day - W, em que domingo é 1 e sábado é 7), e depois de cada execução ela avança sozinha: a REDA marca o fim do período que acabou de faturar e recalcula o próximo recolhimento a partir daí. Você não mantém essa data manualmente.

Se alguma vez precisar forçar a próxima fatura para uma data específica, a cobrança tem um Next Recurring Invoice Date Override. Defina-o e a próxima execução vai usá-lo.

A fatura dupla do primeiro mês (por design)

Este é o comportamento que lota a fila de suporte, então vale a pena deixar claro: um locatário que se muda perto do fim do mês pode receber duas faturas já na primeiríssima execução — o trecho de mudança e o mês cheio seguinte, gerados juntos no mesmo dia. Isso é intencional, não um erro.

Por que a REDA faz isso: porque ele fatura com antecedência. Imagine um locatário que se muda no dia 28. O período de mudança dele é um trecho minúsculo, e o próximo mês começa poucos dias depois. Se a REDA faturasse só o trecho, o locatário seria cobrado por um mês inteiro novo um ou dois dias depois, sem nenhuma antecedência. Por isso, na primeira execução de uma cobrança, se o contrato de locação começou na data limite da Regra de locação ou depois dela, a REDA gera as duas faturas de uma vez — o período do trecho (normalmente prorrateado), mais o próximo período completo.

O que cada execução produz

Para cada período que fatura, uma execução cria uma fatura com:

• O valor — o valor líquido da cobrança, ou o valor prorrateado quando o período é parcial e Do Prorate está ativado (veja Prorrateio).
• As datas — data de faturamento no início do período, data de vencimento na data de faturamento mais os dias de carência do código de cobrança, e o período coberto anexado ao comentário de faturamento como um intervalo entre colchetes.
• Agrupamento em lote — faturas agrupáveis são reunidas em uma conta consolidada quando duas ou mais compartilham uma chave de agrupamento (veja Faturas Consolidadas (Lotes)).
• Uma contagem de ocorrências — o contador de ocorrências geradas da cobrança sobe um a cada fatura, então uma dupla do primeiro ciclo o avança em dois.

O REDA mantém o par do primeiro ciclo como uma unidade atômica: se uma das duas faturas falhar ao ser gerada, a REDA remove a outra para que você nunca fique só com metade de um primeiro ciclo. As linhas com falha ficam registradas para um administrador revisar.

O registro recorrente de Rent Charges que impulsiona a execução mensal. Is Recurring está marcado, a janela From Date / To Date delimita o prazo do contrato de locação, o Charge Period mostra per month, e o Net Charge é de $1.200,00 — tudo o que o job recorrente precisa para emitir a fatura de cada mês.

A guia Accounting do contrato de locação depois que o job recorrente foi executado. A lista de Faturas Opp traz as faturas de aluguel de meses consecutivos — OI-65 (faturamento em 01/08/2026), OI-66 (01/09/2026) e OI-69 (01/10/2026), cada uma de 1.200,00 — uma linha para cada período que a cobrança gerou.

As execuções precisam ser agendadas

Isto é crítico para o go-live: nenhuma das execuções de faturamento recorrente sai de fábrica já agendada. Um administrador as agenda uma vez, no Admin Console, e até que isso seja feito, nenhum aluguel é faturado. Os períodos mensal, semanal e diário são agendados como execuções separadas. Veja Agendamento de Trabalhos em Segundo Plano para saber como.

Checklist: "por que não faturou?"

Quando uma fatura que você esperava não aparece, percorra esta lista em ordem — a causa é quase sempre uma destas:

Se um contrato de locação não tiver data de início, a execução não consegue montar uma janela de faturamento e registra o erro em vez de gerar qualquer coisa: "Erro ao processar a fatura da oportunidade."

Casos especiais

• Primeira fatura sob demanda. Marcar Create Opp Invoice pode faturar na hora — uma cobrança recorrente fatura imediatamente se sua próxima data for hoje ou anterior; uma cobrança única fatura de imediato (data de faturamento hoje) e nunca entra em lote.
• Promoções com um número fixo de ocorrências. Uma promoção configurada para faturar uma quantidade fixa continua faturando até atingir esse número, e então para sozinha.
• Quando o faturamento para sozinho. Uma cobrança para de faturar assim que sua janela se fecha — a execução nunca fatura além da To Date da cobrança, de uma Inactive Date se houver uma definida (um encerramento antecipado e definitivo, por exemplo por um chamado de remoção de cobrança), ou da data de término calculada do contrato de locação — o que ocorrer primeiro. Você não desliga nada manualmente; é a janela se esgotando que encerra o processo.
• Saída atrasada. Quando o dia de saída agendado passa, mas o locatário na verdade não saiu, uma execução dedicada fatura um período extra de holdover (essa execução também precisa ser agendada).
• Renovações. Fechar um chamado de renovação marca novamente Create Opp Invoice nas cobranças, então o faturamento segue direto para o prazo renovado.

Exemplo prático: os dois primeiros meses de Aisha

Contrato canônico: Aisha Rahman, Meridian Court #101, aluguel de 1.200,00/mês, Do Prorate ativado, contrato de locação começa em 2 de janeiro; a data limite da Regra de locação é o dia 15.

A mesma cobrança recorrente depois que uma execução foi disparada: sua data de último processamento fica registrada, sua data da próxima fatura avançou, e sua contagem de ocorrências recorridas subiu — o controle interno do motor sobre em que ponto do ciclo a cobrança está.

A lista de Scheduled Jobs do Admin Console — o job Recurring Charges no catálogo, com seu horário de execução recomendado pronto para agendar.

Os campos de cadência em uma regra de locação: o dia de processamento mensal que decide quando uma execução fatura, a data limite que rege o comportamento da primeira fatura, e os campos de dia de início e fim do ciclo personalizado para períodos de faturamento fora do calendário.

O que vem a seguir

1. Agendamento de Trabalhos em Segundo Plano — as execuções precisam ser agendadas antes de qualquer aluguel ser faturado.
2. Como Funciona o Faturamento na REDA — o modelo de opt-in duplo por trás do faturamento.
3. Prorrateio — como as faturas parciais do início e do fim são calculadas.
4. Faturas Consolidadas (Lotes) — como faturas agrupáveis são combinadas.
5. Faturas Explicadas — como ler uma fatura gerada, campo por campo.

Perguntas frequentes