Generar Factura Manualmente

Genera una factura desde una plantilla recurrente fuera del calendario programado, sin alterar la proxima fecha de generacion automatica.

Pasos

1. Ve a Facturas y selecciona la pestana Recurrentes.
2. Localiza la plantilla desde la que deseas generar la factura.
3. Clic en el boton “Generar Ahora” en la columna Acciones.
4. Confirma la accion en el dialogo de confirmacion.
5. La factura se genera con los datos actuales de la plantilla.

Nota

La generacion manual no afecta a la proxima fecha de generacion automatica. Si la plantilla esta programada para generar el dia 1 de cada mes y generas manualmente el dia 15, la proxima generacion automatica seguira siendo el dia 1 del mes siguiente.

Cuando usar la generacion manual

Caso de uso	Descripcion
Facturacion adelantada	El cliente solicita la factura antes de la fecha programada
Prueba de plantilla	Verificar que la plantilla genera correctamente antes de la primera ejecucion automatica
Facturacion irregular	Necesitas una factura adicional fuera del ciclo habitual
Plantilla pausada	Generar una factura puntual desde una plantilla que esta temporalmente pausada

Consejo

Si la plantilla tiene activada la Emision automatica, la factura generada manualmente tambien se emitira directamente. Si esta desactivada, se creara como borrador.

Como se que lo hice bien

• Toast de confirmacion: “Factura generada correctamente”.
• La factura aparece en la pestana Facturas (como borrador o emitida, segun la configuracion de la plantilla).
• En el historial de la plantilla aparece la nueva entrada con la fecha de generacion manual.
• La proxima fecha de generacion no ha cambiado.

Errores comunes

Mensaje	Causa	Solucion
”La plantilla esta finalizada”	La plantilla alcanzo su fecha de fin	Crea una nueva plantilla o elimina la fecha de fin
”Error al generar factura”	Problema temporal del servidor	Espera unos segundos y reintenta
”Cliente inactivo”	El cliente de la plantilla fue desactivado	Reactiva el cliente o actualiza la plantilla con otro cliente

Detalles técnicos

Proceso de generacion manual:

1. Se leen los datos de recurring_invoices y recurring_invoice_items.
2. Se crea un registro en invoices con status = 'draft' (o status = 'sent' si auto_emit = true).
3. Se copian los items a invoice_items.
4. Se registra la generacion en recurring_invoice_history.
5. No se modifica next_generation_date en recurring_invoices.

Query de diagnostico:

-- Ultima factura generada manualmente
SELECT rih.generated_at, i.invoice_number, 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
LIMIT 1;