Agendamento de Trabalhos em Segundo Plano
Esta é a etapa de configuração mais importante da REDA, e a mais fácil de esquecer. Uma organização REDA recém-criada cria contratos de locação perfeitamente bem — e depois nunca os fatura, porque o faturamento recorrente, as multas por atraso, as taxas de mês a mês, a inflação, os cronogramas de linha reta, os instantâneos e as vistorias recorrentes são todos trabalhos em segundo plano, e a REDA vem com nenhum deles agendado. Agendá-los pelo Admin Console é uma tarefa obrigatória de entrada em produção. Este artigo mostra o que já é executado de fábrica, o catálogo completo de trabalhos, como agendá-los e abortá-los, o tamanho dos lotes e como diagnosticar a falha silenciosa clássica em que "as faturas simplesmente nunca aconteceram".
Acesso necessário. O console requer o conjunto de permissões REDA - Master Data - Admin — o único que concede acesso a ele. Qualquer outro usuário vê "You do not have permission to perform this action in the REDA Admin Console." Peça ao seu administrador para atribuir esse conjunto.
O que já vem em execução e o que você precisa agendar
Duas coisas são executadas em uma organização REDA recém-criada sem que você faça nada. Ambas são rotinas diárias de manutenção, e nenhuma aparece no catálogo de trabalhos do console:
| Já em execução | O que faz | Onde está documentado |
|---|---|---|
| Lançamento automático de cronogramas de pagamento | Marca as cronogramas de pagamento vencidas como lançadas, diariamente | Cronogramas de Pagamento e contabilização automática |
| Reposição de exceções de horário do calendário | Cria as próximas instâncias de exceções de horário recorrentes do calendário, diariamente | Bloqueios e exceções de horários |
Tudo o mais — todos os 13 trabalhos da próxima seção — espera você agendá-lo. A periodicidade de cada um é uma decisão do administrador, não algo fixado na instalação.
O catálogo de 13 trabalhos
Estes são os trabalhos que você agenda no console. Os horários padrão abaixo escalonam o trabalho ao longo da noite; a última coluna mostra o que silenciosamente deixa de acontecer se você mantiver um trabalho sem agendamento.
| # | Trabalho | O que faz | Agendamento padrão | Se não for agendado |
|---|---|---|---|---|
| 1 | Ajuste de Inflação — Propriedade | Aplica as regras de inflação vencidas às configurações de aluguel da propriedade (reajustando-as) | Diário, 00:00 | O aluguel da propriedade nunca é indexado pela inflação |
| 2 | Ajuste de Inflação — Contratos de Locação | Aplica as regras de inflação vencidas aos contratos de locação ativos, reajustando suas cobranças | Diário, 00:15 | Os aluguéis dos contratos nunca se ajustam; as datas de vencimento se acumulam (autorrecupera-se assim que agendado) |
| 3 | Cobranças Recorrentes — Mensal | Gera as faturas do período para as cobranças mensais vencidas hoje | Diário, 01:00 | Nenhuma fatura de aluguel recorrente — a consequência mais grave |
| 4 | Cobranças Recorrentes — Diária | O mesmo, para cobranças de ciclo diário | Diário, 01:15 | As cobranças de ciclo diário nunca são faturadas |
| 5 | Cobranças Recorrentes — Semanal | O mesmo, para cobranças de ciclo semanal | Diário, 01:30 | As cobranças de ciclo semanal nunca são faturadas |
| 6 | Cobranças Recorrentes de Saída Atrasada | Fatura um período extra para locatários que ultrapassaram a data de saída agendada sem registro de saída efetiva | Diário, 03:00 | Os locatários remanescentes deixam de ser cobrados |
| 7 | Cálculo de Cronograma de Linha Reta | Constrói cronogramas de aluguel em linha reta para contratos de locação sinalizados como pendentes | Diário, 04:30 | Os contratos sinalizados mantêm cronogramas "pendentes" para sempre (a ação por contrato individual continua funcionando) |
| 8 | Vistorias Recorrentes | Clona a próxima ocorrência das vistorias recorrentes vencidas hoje | Diário, 05:00 | As vistorias recorrentes deixam de se regenerar |
| 9 | Instantâneos de Reconciliação | Constrói os instantâneos de faturamento e ocupação do mês anterior para as propriedades sinalizadas | 1º dia do mês, 06:00 | Nenhum instantâneo mensal (a ação por propriedade individual continua funcionando) |
| 10 | Taxas de Mês a Mês — Por Dia | Fatura as taxas de mês a mês por dia em contratos de locação expirados | Diário, 10:00 | As taxas de mês a mês por dia nunca são faturadas |
| 11 | Taxas de Mês a Mês — Mensal | Fatura as taxas de mês a mês mensais | Diário, 10:15 | As taxas de mês a mês mensais nunca são faturadas |
| 12 | Multas por Atraso — Por Dia | Cria faturas de multa por atraso por dia em faturas vencidas | Diário, 22:00 | As multas por atraso por dia nunca são cobradas |
| 13 | Multas por Atraso — Mensal | Cria faturas filhas de multa por atraso mensal em faturas vencidas | Diário, 22:15 | As multas por atraso mensais nunca são cobradas |
Alguns pontos de referência que vale a pena lembrar: as cobranças recorrentes são executadas às 01:00, as multas por atraso às 22:00, e o único trabalho que por padrão roda no dia 1º do mês é o dos instantâneos (06:00). Repare que os dois trabalhos de taxas mensais rodam por padrão diariamente: 10:15 e 22:15, quinze minutos depois dos seus equivalentes por dia. Isso é proposital: a taxa é mensal (cobrada uma vez por fatura), mas o trabalho precisa rodar todo dia para pegar as faturas conforme elas se tornam elegíveis. Se você os agendar mensalmente, a maioria das taxas nunca será cobrada. As faturas de multa por atraso e de mês a mês são criadas como filhas vinculadas ao registro vencido ou pai, e é seguro executá-las diariamente — a REDA rastreia o que já cobrou e não duplica.
Agendando um trabalho
Abortando um trabalho
Para interromper um trabalho agendado, aborte-o na mesma guia. O REDA pede confirmação com "Abort this scheduled job? Future runs will stop immediately. In-flight executions complete normally." — ou seja, uma execução já em andamento é concluída, e apenas as execuções futuras param. O abortar é deliberadamente restrito aos trabalhos do próprio catálogo da REDA; não é possível abortar daqui trabalhos de plataforma não relacionados.
Tamanho dos lotes
Vários trabalhos processam registros em lotes, e o tamanho do lote é uma configuração. Existem seis configurações de tamanho de lote, todas definidas como 50 por padrão: cobranças recorrentes, saída atrasada, multas por atraso mensais, multas por atraso por dia, taxas de mês a mês mensais e taxas de mês a mês por dia. Elas ficam em Configurações Globais do Aplicativo, e cada trabalho lê sua configuração no momento da execução — então uma alteração passa a valer na próxima execução, sem necessidade de reagendar.
Dois trabalhos são fixos e não configuráveis: ambos os trabalhos de Ajuste de Inflação processam um registro por vez por design. Não há configuração de tamanho para eles, então não tente acelerá-los com uma. Você só precisará revisitar os tamanhos de lote se uma execução estiver lenta ou esbarrando em limites da plataforma.
Horários, fusos horários e dias perdidos
Dois fatos operacionais importam aqui, e ambos podem pegar um administrador novo de surpresa.
Os trabalhos são executados no fuso horário do usuário que os agendou. Se você agendar o trabalho de cobrança recorrente da 01:00 a partir de um usuário cujo fuso horário difere da sua região de operação, ele será executado à 01:00 no horário desse usuário. Agende a partir de um usuário configurado com o fuso horário de operação da organização, para que os horários signifiquem o que você espera.
Cada lote grava um log de execução com contagens de sucesso e falha, e as falhas enviam e-mail aos seus administradores. Monitore as execuções nos Registros assíncronos do REDA.
Lista de verificação da entrada em produção
- Faça login como um usuário configurado com o fuso horário de operação da organização, com REDA - Master Data - Admin.
- Abra o Admin Console → Trabalhos Agendados e agende todos os 13 trabalhos — nos horários padrão, ou deslocados para suas horas de menor movimento, mantendo a ordem relativa entre eles.
- Confirme na lista de Trabalhos Agendados do Salesforce que 13 entradas prefixadas por REDA agora estão ao lado das 2 rotinas de manutenção que já vinham em execução.
- Na manhã seguinte, verifique os Registros assíncronos do REDA para as primeiras execuções e confirme que as faturas esperadas existem.
- Só revisite os tamanhos de lote se uma execução estiver lenta ou limitada (veja Configurações Globais do Aplicativo).
Os horários padrão são escalonados para que as dependências se mantenham — a inflação reajusta um contrato de locação antes que o faturamento recorrente da 01:00 o cobre. Ao deslocar os horários, mantenha a inflação antes das cobranças recorrentes.
Exemplo prático: a Meridian entra em produção
No dia da entrada em produção, o administrador da Meridian Properties agenda todos os 13 trabalhos nos seus horários padrão. Três contratos de locação carregam, cada um, um aluguel mensal de 1.200,00, todos com vencimento de fatura no dia 1º. Na manhã seguinte, a execução de cobrança recorrente da 01:00 criou três faturas de 1.200,00; a execução de multa por atraso das 22:00 não criou nada, porque nada estava vencido.
Compare isso com a mesma organização em que os trabalhos nunca foram agendados: os mesmos três contratos de locação, o mesmo dia 1º do mês — e nenhuma fatura em lugar nenhum, e nenhum erro em lugar nenhum. O único sintoma é a ausência. Essa ausência, em uma organização recém-criada, quase nunca é um bug; é um trabalho sem agendamento.
O que vem a seguir
- Lista de verificação da entrada em produção — esta etapa de agendamento é o núcleo dela.
- Registros assíncronos do REDA — monitore o que cada trabalho fez e identifique falhas.
- Configurações Globais do Aplicativo — onde ficam as seis configurações de tamanho de lote.
- Como Funciona o Faturamento Recorrente — o que o trabalho de cobrança recorrente produz, e a recuperação após um dia perdido.
- Multas por Atraso e Ajustes por Inflação — as outras automações que esses trabalhos impulsionam.
Perguntas frequentes
Os trabalhos de cobrança recorrente não estão agendados. O REDA vem sem nenhum trabalho de faturamento agendado, então isso é esperado até que você aja. Agende os trabalhos 3–5 no console e verifique os Registros assíncronos do REDA após a próxima execução.
Não. O REDA mantém uma única instância de cada trabalho; agendá-lo novamente substitui o agendamento existente em vez de adicionar um segundo.
Uma execução desse trabalho ainda está em andamento. Aguarde a conclusão e tente novamente.
Os trabalhos são executados no fuso horário do usuário que os agendou. Reagende a partir de um usuário configurado com o fuso horário de operação da sua organização.
As multas por atraso, as taxas de mês a mês e os ajustes de inflação se recuperam automaticamente na próxima execução ("vencidos até hoje"). As cobranças recorrentes não — elas correspondem exatamente à data de hoje, então os dias perdidos exigem atenção manual (veja Como Funciona o Faturamento Recorrente).
O abortar é deliberadamente restrito aos trabalhos do próprio catálogo da REDA, para que você não interrompa acidentalmente um trabalho de plataforma não relacionado.
Isso foi útil?