Emissão recorrente
Atualizado em
Nesta página
Um agendamento recorrente emite a mesma nota todo mês (ou toda semana, trimestre ou ano) para um cliente, no dia que você escolher. É o recurso certo para mensalidades, contratos de suporte e honorários fixos.
Pré-requisitos#
automacao:gerenciarpara criar e editar agendamentos;automacao:lerpara consultar. Owner, Admin e Emissor têm as duas; o Visualizador só lê.- Cliente e serviço cadastrados, configuração fiscal completa e certificado válido.
Criar um agendamento#
- No menu, abra Notas › Automação › Agendamentos.
- Clique em Novo agendamento e dê um nome (ex.: "Mensalidade Padaria Silva").
- Escolha o cliente e os itens da nota (serviço, quantidade, valor e tributos). Os itens ficam guardados como estavam na hora do cadastro.
- Defina a frequência: semanal, mensal, trimestral ou anual.
- Escolha o dia: um dia do mês de 1 a 28, último dia do mês ou um dia da semana.
- Defina o início e o fim: uma data final ou um número máximo de emissões.
- Escolha a competência: mês corrente ou mês anterior.
- Configure o reajuste, se houver: valor fixo, percentual fixo ou índice informado por você antes do mês de reajuste.
- Ligue Enviar ao cliente por e-mail para que o PDF e o XML saiam junto com a autorização.
- Escolha o modo:
- Gerar rascunho para aprovação: a nota cai na fila de aprovação e só é emitida quando alguém aprova.
- Emitir direto: a nota é transmitida sem revisão.
- Salve.
Quando a nota sai#
A Emitra verifica os agendamentos ao longo do dia e processa a sua empresa depois do horário configurado (padrão 07, horário de Brasília). Cada agendamento com data de execução vencida gera a nota daquela competência.
Sem nota duplicada#
Cada agendamento gera no máximo uma nota por competência. Se a execução rodar duas vezes (por um reprocessamento ou pelo botão Executar agora), a segunda é ignorada.
Quando algo dá errado#
| Situação | O que acontece |
|---|---|
| Falha técnica (Sefin fora, timeout) | Novas tentativas automáticas; a execução fica "tentando de novo" |
| Rejeição da Sefin | Sem nova tentativa; a execução fica "rejeitada" com o código e a mensagem, e o admin é avisado por e-mail e no painel |
| Assinatura bloqueada | Execução não feita, motivo TENANT_INADIMPLENTE |
| Limite de notas esgotado | Execução não feita, motivo COTA_EXCEDIDA |
| Certificado vencido | Execução não feita, motivo CERTIFICADO_VENCIDO |
Quem tem automacao:gerenciar recebe o aviso por e-mail. Pela API, assine recurring.execution_failed e recurring.execution_skipped em Webhooks.
Ações no agendamento#
- Pausar e Retomar. Ao retomar, a próxima data é recalculada sem emitir o que ficou para trás, a menos que você marque Emitir ocorrências perdidas.
- Executar agora. Emite a competência atual na hora, com a mesma proteção contra duplicidade.
- Histórico de execuções. Mostra cada competência, o status, o número da nota ou o motivo.
A IA não mexe nos agendamentos#
O assistente de IA não cria, não altera e não dispara agendamentos. Quem programa a recorrência é você.