Programador de Lote Recorrente
Os modelos descrevem o que se repete; o Lote de Transações Recorrentes faz isso acontecer — o job noturno que encontra todo modelo ativo vencido e gera seus documentos. O painel de controle dele é o primeiro cartão na guia Operações do Console de Administração, e vale cinco minutos do entendimento de qualquer administrador.
Acesso necessário. O Console de Administração é uma tela de administrador: o conjunto de permissões Accounting Admin v2 o alcança por completo, e Accounting Controller v2 também pode abri-lo. Os conjuntos Accounts Payable v2 e Accounts Receivable v2 não conseguem vê-lo — programar esse lote é uma tarefa Core/Admin.
O cartão, controle por controle
- O subtítulo diz tudo: "Processa todos os modelos recorrentes ativos vencidos na data de execução e gera as Faturas de Venda, Faturas de Compra, Ordens de Compra ou Lançamentos Contábeis correspondentes."
- Linha de status: selo Programado/Não Programado, Próxima Execução Programada, Última Execução e seu resultado (Sucesso / Falha Parcial / Falha), além de contadores em tempo real — Modelos Ativos e Vencidos Hoje ("3 modelos estão vencidos hoje e serão processados na próxima execução programada.").
- Programação Diária: um Horário de Execução (formato 24 horas; aplica-se o fuso horário padrão da organização) — padrão 01:00, antes do início do expediente. Programe / Reprograme / Cancele a programação conforme necessário.
- Execução Manual com seletor de data: Executar Agora recebe uma Data de Execução — "Modelos com Próxima Data de Execução nesta data ou antes serão processados." Esta é a ferramenta de recuperação retroativa: o lote ficou desativado por uma semana? Execute com a data de hoje e cada geração perdida é recuperada (o ponteiro de próxima execução de cada modelo avança pelas execuções perdidas).
Comportamento que vale a pena conhecer
- Um modelo por transação: as falhas se isolam — um modelo com problema registra o erro e sofre rollback sozinho (resultado "Falha Parcial"), os demais são gerados. O log de auditoria traz os resultados por modelo, com um CSV das falhas anexado quando há muitas.
- Idempotente por data: executar novamente para a mesma data não duplica documentos — seguro usar Executar Agora quando houver dúvida.
- Sem execuções paralelas: um segundo início enquanto uma execução já está ativa é recusado — sem condições de corrida na numeração.
- Postagem Automática respeitada por modelo: o lote gera; cada documento é contabilizado ou aguarda conforme determinado pelo seu modelo.
O que o cartão responde, palavra por palavra
Toda ação se confirma em palavras claras — vale a pena reconhecê-las para saber quando algo não aconteceu:
| Você fez | O cartão responde |
|---|---|
| Programou a execução diária | "Recurring Transactions Batch scheduled daily at {time}." — e o job programado aparece como "REDA Recurring Transactions Daily" |
| Executou manualmente | "Recurring Transactions Batch is running for {date}. Job ID: {id}. Check the Audit Log for results once complete." |
| Removeu a programação | "O Lote de transações recorrentes foi removido do agendamento diário." — o cartão pergunta "Remove Daily Schedule?" antes |
| Escolheu uma data de execução sem nada vencido | "Nenhum modelo ativo vence até esta data. O lote será executado, mas não gerará documentos." — um aviso, não um erro |
| Digitou um horário de execução inválido | "Invalid time format. Expected HH:MM." ou "Valor de hora inválido. A hora deve ser 0-23, o minuto 0-59." |
| Encontrou uma falha operacional | "Failed to schedule job: {reason}" / "Failed to start batch: {reason}" / "Failed to unschedule job: {reason}" — o motivo é a solução |
Erros comuns a evitar
| Erro | Por que prejudica | Faça isto em vez disso |
|---|---|---|
| Presumir que os modelos disparam sem a programação | Modelos são dados; o lote é o motor — modelos ativos sem lote programado não geram nada, indefinidamente | Confirme que o selo diz Programado no dia em que você ativa seu primeiro modelo |
| Cancelar a programação para manutenção e esquecer de reprogramar | As datas de vencimento se acumulam silenciosamente — sem erro, porque nada está em execução para gerar um erro | Marque a reprogramação no calendário; ao retornar, um Executar Agora com a data de hoje recupera a lacuna |
| Fazer recuperação retroativa com uma data futura "para se adiantar" | Tudo vencido nessa data ou antes é gerado agora — as faturas de aluguel do mês que vem, datadas e numeradas hoje | Faça a recuperação com a data de hoje (ou a data perdida), nunca além disso; o futuro pertence à execução noturna |
| Ler "Falha Parcial" como ruído de fundo | Um modelo silenciosamente não está produzindo — geralmente um período contábil ainda não gerado, que acabará afetando todos os modelos | Abra o log de auditoria no dia em que vir isso; o modelo com falha e o motivo estão nomeados |
O que vem a seguir
- Programador de Operações — este cartão entre seus dez irmãos.
- Configuração de Modelos — o que o lote consome.
- Lotes de Documentos Recorrentes — a visão de operações em massa.
Perguntas frequentes
Para que documentos datados de "hoje" existam antes do início do expediente, e para que a geração preceda os lotes de aplicação automática das 07:00 que podem agir sobre eles. Altere se o seu ritmo for diferente — é apenas o padrão.
Não — "vencido" significa Próxima Data de Execução nessa data ou antes da data de execução. A primeira execução recolhe tudo que está em atraso; é a semântica de recuperação retroativa funcionando como projetada.
Administradores pelo Console de Administração. O lote em si é executado como o usuário automatizado do sistema — os documentos gerados não consomem a licença de ninguém.
Não — iniciar uma execução manual enquanto uma já está ativa é recusado diretamente, em vez de entrar em fila. Aguarde a execução ativa terminar (o registro no log de auditoria aparece) e execute novamente se ainda for necessário.
Verifique primeiro a Última Execução: se a execução das 01:00 teve sucesso, esses cinco venceram depois dela rodar (ou acabaram de ser ativados), e a execução desta noite os pegará. Se não puder esperar, Executar Agora com a data de hoje os processa imediatamente — a idempotência torna isso seguro.
Isso foi útil?