Saltar al contenido principal

Intentos y Reintento de NF-e

El sistema implementa reintento automático para emisiones que fallan.

Worker Automático

Se ejecuta cada 30 minutos y realiza:

  1. Procesar reintentos: NF-e pendientes o con error que aún tienen intentos
  2. Actualizar estado: Consultar el proveedor para NF-e en processing (últimos 7 días)
  3. Auto-emisión por pago: Emitir NF-e para facturas pagadas (política on_full_payment)
  4. Auto-emisión por finalización: Emitir para facturas finalizadas (política on_finalization)
  5. Auto-emisión por cuota: Emitir para cuotas pagadas (política per_installment)

Lógica de Reintento

Intervalos Predeterminados

IntentoIntervaloTiempo acumulado
1.°Inmediato0 min
2.°+30 min30 min
3.°+60 min1h30
4.°+180 min4h30
5.°+360 min~10h30

Los intervalos son configurables por organización vía retryDelaysMinutes.

Máximo de Intentos

  • Emisión: 5 intentos (configurable vía maxIssueAttempts)
  • Cancelación: 5 intentos (configurable vía maxCancelAttempts)

Tras agotar los intentos, el estado cambia a error.

Tratamiento de Errores

  • Los errores en la auto-emisión son no bloqueantes (esperados cuando NF-e no está habilitada)
  • Logs detallados para cada intento
  • Contadores de procesos y errores por ejecución del worker