Como funciona o faturamento recorrente
A recorrência implementada é mensal e gera pedidos. A rotina depende do agendador do backend estar habilitado e funcionando.
Preparar o ciclo
- Cadastre a assinatura e confira cliente, produto, quantidade e valor.
- Na edição, defina uma Data de vencimento compatível com a vigência desejada.
- Selecione um dia em Data de cobrança e salve.
- Peça à equipe técnica para conferir o job da assinatura e o fuso usado pelo servidor.
- No dia previsto, consulte os pedidos do cliente e confira os itens e valores gerados.
A interface não exibe o estado real do job. Ver “Todo dia 10” na ficha comprova apenas que o campo está salvo.
Regras observadas
| Condição | Resultado no backend |
|---|---|
| Criar uma assinatura | Salva o registro, sem criar job ou pedido. |
| Editar enviando um dia válido diferente do anterior | Cancela o job anterior e cria um job mensal. |
| Novo dia igual ao dia atual | Solicita execução imediata, além da repetição mensal. |
| Enviar o mesmo dia já salvo | Não recria nem verifica um job ausente. |
| Omitir o dia na edição, ou removê-lo | Cancela o job, mesmo quando a omissão mantém o campo anterior no cadastro. |
| Chegar à execução com Data de vencimento ultrapassada | Remove o job sem gerar novo pedido. |
| Assinatura já excluída | O job se remove quando tentar executar. |
O agendamento usa 0 0 DIA * *, sem fuso explícito no job. Não há rotina de compensação documentada para dias 29, 30 ou 31 em meses sem esse dia. A Data de venda futura não impede a execução; Parcelas não encerra o job depois de determinado número de ciclos; o estado Pago também não impede novas execuções.
Vigência e vencimento do pedido
A Data de vencimento da assinatura é um limite fixo. O código não a incrementa a cada mês. Embora a ficha a chame de “Próximo vencimento”, ela não representa um cálculo automático do próximo ciclo.
O vencimento do pedido gerado é a data da execução normalizada para o início do dia no servidor. É um campo diferente do limite de vigência da assinatura.
Exemplo: uma assinatura com cobrança no dia 10 e vigência até 01/10/2027 pode gerar pedidos nos dias 10 dos meses anteriores. Uma execução em 10/10/2027 encontra a vigência ultrapassada e remove o job. O preço do item é obtido do catálogo no momento da execução.
Conferir o resultado
Consulte Pedidos e pagamentos. Se não houver pedido, confira vigência, execução do agendador e a última edição feita. A correção da falha de cancelamento por omissão está registrada na análise técnica; a documentação não altera esse comportamento da aplicação.