Facturas Recurrentes

Ruta: /owner/invoices (pestana Recurrentes) Configura plantillas que generan facturas automaticamente segun la frecuencia que necesites.

Vista de lista

La pestana Recurrentes muestra todas las plantillas de facturacion recurrente. Cada plantilla define un cliente, conceptos y una frecuencia de generacion. El sistema crea automaticamente las facturas segun el calendario configurado.

Columnas de la tabla: Nombre, Cliente, Frecuencia, Proxima generacion, Importe, Estado, Acciones

Filtros disponibles: cliente, estado, frecuencia

Funciones

Funcion	Descripcion	Documentacion
Crear Plantilla	Configura una plantilla recurrente con cliente, conceptos y frecuencia	Ver
Ver Historial	Consulta el historial de facturas generadas desde una plantilla	Ver
Generar Manualmente	Genera una factura fuera del calendario programado	Ver

Frecuencias disponibles

Frecuencia	Intervalo	Ejemplo de uso
Diaria	Cada dia	Servicios de uso diario
Semanal	Cada 7 dias	Entregas semanales
Mensual	Cada mes (mismo dia)	Cuotas mensuales, alquileres
Trimestral	Cada 3 meses	Servicios trimestrales
Anual	Cada 12 meses	Suscripciones anuales, mantenimientos
Personalizada	Intervalo libre en dias	Cualquier periodicidad no estandar

Estados de la plantilla

  ┌─────────┐
  │ Activa  │◄──────────┐
  └────┬────┘           │
       │ Pausar    Reactivar
  ┌────▼────┐           │
  │ Pausada │───────────┘
  └────┬────┘
       │ Finalizar / Fecha fin alcanzada
  ┌────▼───────┐
  │ Finalizada │
  │   FINAL    │
  └────────────┘

Transiciones permitidas:

Desde	Hacia
Activa	Pausada, Finalizada
Pausada	Activa, Finalizada
Finalizada	(estado final)

Referencia tecnica

Detalles técnicos

Tablas de base de datos

Tabla	Columnas principales	FK
`recurring_invoices`	id, business_id, customer_id, frequency, start_date, end_date, next_generation_date, status, auto_emit	customers, businesses
`recurring_invoice_items`	id, recurring_invoice_id, description, quantity, unit_price, tax_rate	recurring_invoices
`recurring_invoice_history`	id, recurring_invoice_id, invoice_id, generated_at	recurring_invoices, invoices

Edge Functions

Funcion	Trigger	Descripcion
`generate-recurring-invoices`	Cron diario	Revisa plantillas activas y genera facturas pendientes

Queries de diagnostico

Plantillas activas con proxima generacion:

SELECT ri.*, c.name as cliente, ri.next_generation_date
FROM recurring_invoices ri
LEFT JOIN customers c ON ri.customer_id = c.id
WHERE ri.business_id = '<business_id>'
  AND ri.status = 'active'
ORDER BY ri.next_generation_date;

Historial de generacion:

SELECT rih.generated_at, i.invoice_number, i.total_amount, i.status
FROM recurring_invoice_history rih
JOIN invoices i ON rih.invoice_id = i.id
WHERE rih.recurring_invoice_id = '<recurring_invoice_id>'
ORDER BY rih.generated_at DESC;