Factura recurrente¶
Una factura recurrente es una plantilla que se convierte sola en factura cada cierto tiempo: el arriendo mensual, el pedido semanal de un restaurante, la cuota anual. La creas desde la pantalla de ventas con el interruptor Recurrente y las administras en /app/plantillas.
Permiso y módulo
Necesitas ACCESO_POS. El interruptor Recurrente solo aparece si tu empresa tiene activo el módulo RECURRING_INVOICES (Módulos y feature flags).
Crear la plantilla desde el POS¶
- 1 Activa Recurrente antes de pulsar Guardar. En lugar de cobrar, se abre el diálogo Factura recurrente.
- 2 Nombre de la plantilla: obligatorio; sin él Guardar plantilla queda deshabilitado.
- 3 Periodicidad (Diaria, Semanal, Quincenal, Mensual, Anual) e Intervalo: "Mensual" con intervalo 2 genera cada dos meses.
- 4 Generar factura ahora: encendido, emite hoy la primera factura con el pago y la forma de pago que tengas en el POS; apagado, la factura abierta se descarta y la primera se genera en la Fecha inicio.
- 5 Guardar plantilla: confirma. Verás Plantilla guardada con Factura generada y plantilla recurrente configurada. o La primera generación será el …
- Arma la factura como siempre: cliente, productos, cantidades. Sin productos el servidor responde La factura no tiene productos.
- Enciende Recurrente y pulsa Guardar.
- Llena el diálogo y pulsa Guardar plantilla. Las líneas de la factura quedan copiadas en la plantilla; cambios posteriores en precios no la afectan.
Cómo se generan¶
Cada día, a primera hora, Agapanto revisa las plantillas activas cuya Próxima generación ya llegó y que no han pasado su Fecha fin. Por cada una crea una factura nueva con las mismas líneas, a nombre del mismo cliente y con el mismo tipo de documento, y calcula la siguiente fecha. No tienes que hacer nada: la factura aparece en Caja diaria y en el Historial como cualquier otra.
Las facturas automáticas nacen sin pago
La factura generada por la programación se guarda con pago 0, así que queda con la cuenta pendiente y aparece en Cartera. Regístrale el pago cuando el cliente pague (Ver, pagar y anular).
Fechas de fin de mes
Si la plantilla es mensual y arranca un 31, en los meses cortos se genera el último día del mes.
Administrar las plantillas¶
| Nombre | Entidad | Documento | Periodicidad | Próxima generación | Fin | Estado | Acciones |
|---|---|---|---|---|---|---|---|
| Pedido semanal Mesa 4 | Mesa 4 | Factura de venta | Semanal | 2026-09-09 | — | edit delete | |
| Arriendo local | Ana Restrepo | Factura de venta | Cada 2 Mensual | 2026-10-01 | 2027-06-30 | edit delete |
- Estado: el interruptor activa o pausa la plantilla sin borrarla. Pausada, no genera facturas.
- edit abre Editar plantilla: Nombre, Periodicidad (Diaria, Semanal, Mensual, Trimestral, Anual), Intervalo, Forma de pago (Contado / Crédito), Próxima generación y Fecha fin (opcional). Guarda con Guardar; verás Plantilla actualizada.
- delete pregunta ¿Eliminar la plantilla "…"? y la borra. Las facturas ya generadas no se tocan.
- Si la tabla está vacía verás No hay plantillas recurrentes. Créalas desde el POS con "Guardar como recurrente".
¿Problemas?
- No veo el interruptor Recurrente en el POS. Tu empresa no tiene activo RECURRING_INVOICES.
- Guardar plantilla está deshabilitado. Falta el Nombre de la plantilla.
- La factura no se generó en la fecha. Revisa en
/app/plantillasque la plantilla esté activa, que Próxima generación sea la esperada y que no haya pasado Fin. Si todo está bien, la generación corre una vez al día: espera al día siguiente. - Apagué "Generar factura ahora" y la factura abierta desapareció. Es lo esperado: la plantilla la reemplaza y la primera factura saldrá en la Fecha inicio.
Siguiente: Importar una compra (XML).