Tentativas e Retry de NF-e
O sistema implementa retry automático para emissões que falham.
Worker Automático
Executa a cada 30 minutos e realiza:
- Processar retries: NF-e pendentes ou com erro que ainda têm tentativas
- Atualizar status: Consultar o provedor para NF-e em
processing(últimos 7 dias) - Auto-emissão por pagamento: Emitir NF-e para faturas pagas (política
on_full_payment) - Auto-emissão por finalização: Emitir para faturas finalizadas (política
on_finalization) - Auto-emissão por parcela: Emitir para parcelas pagas (política
per_installment)
Lógica de Retry
Intervalos Padrão
| Tentativa | Intervalo | Tempo acumulado |
|---|---|---|
| 1ª | Imediata | 0 min |
| 2ª | +30 min | 30 min |
| 3ª | +60 min | 1h30 |
| 4ª | +180 min | 4h30 |
| 5ª | +360 min | ~10h30 |
Os intervalos são configuráveis por organização via retryDelaysMinutes.
Máximo de Tentativas
- Emissão: 5 tentativas (configurável via
maxIssueAttempts) - Cancelamento: 5 tentativas (configurável via
maxCancelAttempts)
Após esgotar as tentativas, o status muda para error.
Tratamento de Erros
- Erros na auto-emissão são não-bloqueantes (esperados quando NF-e não está habilitada)
- Logs detalhados para cada tentativa
- Contadores de processos e erros por execução do worker