Programação de Transações Recorrentes
O manual do administrador para o lote que transforma modelos recorrentes em documentos. Os usuários desenham os modelos; você garante que o motor funcione.
Acesso que você vai precisar. Programar e executar este lote exige o conjunto de permissões Accounting Admin v2; o Accounting Controller v2 também consegue acessar o console. Os conjuntos Accounts Payable v2 e Accounts Receivable v2 não conseguem vê-lo — todos os demais apenas encontram os documentos que ele gera.
Os controles do card
| Controle / exibição | O que faz ou informa |
|---|---|
| Selo de status | Programado ou Não programado — se a geração acontece sem você. |
| Próxima execução programada | Quando a próxima passagem automática dispara. |
| Última execução | Carimbo de data/hora mais o resultado — Informativo (limpa), Aviso (parcial), Crítico (falhou). |
| Ver Log de Auditoria | O registro completo da execução: processados / bem-sucedidos / com falha, com um motivo por falha. |
| Programar / Reprogramar | Escolha o horário da execução diária. |
| Cancelar programação | Pausa a automação até ser reprogramada. |
| Executar agora | Uma passagem de geração avulsa e imediata. |
O que uma execução faz
Encontra o que está vencido
Duas condições definem "vencido": o modelo está Ativo, e sua Próxima Data de Execução é hoje ou anterior. Modelos em Rascunho e Concluídos nunca são tocados.
Gera cada documento
Datado do dia da execução, no período contábil correto, com linhas copiadas do modelo, data de vencimento conforme os dias de pagamento do modelo — e vinculado de volta ao seu modelo. Um documento por modelo por data, então a duplicação é impossível mesmo que o lote de alguma forma seja executado duas vezes.
Contabiliza onde solicitado
Modelos com Auto Post têm seus documentos contabilizados no mesmo momento. Se a contabilização falhar, toda a geração daquele modelo é revertida — sem rascunhos quebrados — e a falha entra no registro de auditoria da execução com seu motivo.
Avança a programação
A Próxima Data de Execução de cada modelo processado avança de acordo com sua frequência, os contadores são atualizados, e modelos que atingem sua data final ou limite de ocorrências mudam para Concluído.
Programando-o
Diariamente, no início da manhã — depois da sincronização de câmbio (FX) para que documentos em moeda estrangeira recebam a taxa do dia, antes dos lotes de aplicação automática para que o que ele gera possa ser correspondido na mesma noite. Executar agora depois que os usuários ativarem modelos que querem gerados imediatamente.
Uma manhã na prática — o primeiro dia do mês da Meridian
A Meridian Properties Group fatura suas faturas de venda recorrentes de clientes a partir de modelos. Ao amanhecer de 1º de julho o lote é executado: ele encontra cada modelo Ativo cuja Próxima Data de Execução é 1º de julho ou anterior, gera as Faturas de Venda correspondentes datadas de 1º de julho no período 2026-07, contabiliza as que têm Auto Post nos seus modelos, e avança a Próxima Data de Execução de todos os modelos para 1º de agosto. Um modelo falha — o problema de período da sua entidade é detalhado no registro de auditoria — e apenas a geração daquele modelo é revertida; o restante da execução de faturamento já está nos livros antes de a equipe de contas a receber se sentar. O responsável pelo modelo corrige a causa, o administrador clica em Executar agora, e a última fatura se junta às suas irmãs.
Erros comuns a evitar
| Erro | Por que prejudica | Faça isso em vez disso |
|---|---|---|
| Esperar que o lote recupere uma lacuna depois de ficar sem programação | Ele gera para a data de execução e avança as programações — datas perdidas continuam perdidas | Crie documentos de recuperação clonando, depois deixe a programação retomar |
| Programá-lo antes da sincronização de câmbio (FX) | Documentos em moeda estrangeira são gerados com a taxa de ontem | Sincronização de câmbio primeiro na ordem noturna, este lote depois |
| Corrigir você mesmo os problemas de dados do modelo a partir do log | Os motivos de falha costumam ser problemas do modelo (período fechado em um modelo com Auto Post, produto ausente) que vão se repetir no próximo ciclo | Encaminhe o motivo ao responsável pelo modelo; corrija o modelo, não o sintoma |
| Hesitar em usar Executar agora com medo de duplicatas | Novos modelos ficam sem gerar enquanto você espera a noite | Use Executar agora livremente — um documento por modelo por data é garantido por design |
| Julgar a execução por "nenhuma notícia" | Um resultado de Aviso com três modelos revertidos parece idêntico a um sucesso à distância | Confira o resultado da Última Execução diariamente; abra Ver Log de Auditoria em qualquer coisa que não seja Informativo |
Monitorando-o
Verde significa: o card mostra Programado, o carimbo de data/hora da última execução está dentro da janela esperada, e o ícone de resultado é informativo. Qualquer outra coisa, clique em Ver Log de Auditoria — o registro da execução lista processados / bem-sucedidos / com falha com um motivo por falha. Um hábito útil: os motivos de falha aqui costumam ser problemas do modelo (um período fechado para um modelo com Auto Post, um produto ausente) — encaminhe-os ao responsável pelo modelo em vez de corrigir os dados você mesmo.
Solução de problemas
| Sintoma | Causa provável → ação |
|---|---|
| “Nada foi gerado” | O modelo não está Ativo, ou sua Próxima Data de Execução ainda não está vencida — verifique o modelo antes do lote. |
| Falhas de Auto Post no log | Geralmente um período fechado ou validação falhada — a geração foi revertida de forma limpa; corrija e use Executar agora. |
| Documentos ausentes para datas antigas | O lote ficou sem programação naquelas datas; ele não recupera automaticamente. Os usuários criam recuperações clonando. |
O que vem a seguir
- Lote de Transações Recorrentes — o que o lote faz, em profundidade.
- Guia Operações — o console.
- Log de Auditoria — como ler o histórico de execuções.
Perguntas frequentes
A próxima execução gera o documento para a data de vencimento e avança a programação — ela não recupera cada período perdido individualmente. Crie manualmente os documentos de recuperação necessários (clonar torna isso rápido) e deixe a programação retomar.
Não — o lote é executado uma vez por dia para todos; a própria frequência de cada modelo decide se hoje é o seu dia. A nuance de horário raramente importa para documentos contábeis: datas, não carimbos de hora, comandam os livros.
Não. A geração é, por design, um documento por modelo por data, então uma segunda passagem no mesmo dia não encontra nada pendente para modelos já processados.
O modelo pedia Auto Post e a contabilização falharia — geralmente por um período fechado ou uma validação. Em vez de deixar um rascunho quebrado, o lote reverte a geração de forma limpa e registra o motivo. Corrija a causa e use Executar agora.
As execuções programadas rodam sob o contexto de processo automatizado da plataforma — elas não consomem uma licença de usuário, e os registros de auditoria mostram o processo automatizado como o executor.
Isso foi útil?