Pagos en Cuotas
Las facturas pueden ser divididas en múltiples cuotas con fechas de vencimiento individuales.
Estados de la Cuota
scheduled → pending → paid
↓
overdue
↓
canceled
| Status | Descripción |
|---|---|
| scheduled | Vencimiento futuro, esperando procesamiento |
| pending | El vencimiento llegó, esperando pago |
| paid | Cuota pagada |
| overdue | Vencida y no pagada |
| canceled | Cancelada (factura anulada) |
Creando Cuotas
Al crear o editar una factura, informe las cuotas:
| Campo | Descripción |
|---|---|
| Valor (centavos) | Monto de la cuota |
| Fecha de vencimiento | Fecha de pago esperada |
Reglas de Validación
- Mínimo de 2 cuotas
- Las fechas deben ser estrictamente crecientes
- La suma de los valores debe ser igual al total de la factura
- La fecha de vencimiento de la factura se define como la fecha de la última cuota
Cobro de Cuotas
Procesamiento Secuencial
Las cuotas se procesan secuencialmente — cada cuota solo se cobra cuando la anterior está pagada:
- El worker busca cuotas con vencimiento ≤ hoy
- Verifica si la cuota anterior está pagada (o si es la primera)
- Para
charge_automatically: cobra el método de pago predeterminado - Vincula el pago a la cuota
- Si es la última cuota: factura marcada como
paid
Política de NF-e por Cuota
Cuando la política de NF-e es per_installment, una nota fiscal es emitida para cada cuota pagada individualmente.
Cancelación
Cuando la factura es anulada:
- Todas las cuotas con status
scheduledopendingson canceladas - Las cuotas ya pagadas no son afectadas