Facturación Masiva de Suscripciones

Descripción General

El submódulo de Facturación Masiva ejecuta el procesamiento en lote (batch processing) de miles de contratos de suscripción periódicos de forma concurrente. Dirigido a Directores de Facturación y Jefes de Sistemas. Evita la digitación manual individual al generar de manera automática las facturas electrónicas, aplicar los cobros recurrentes y encolar el envío masivo de los comprobantes fiscales por correo electrónico a cada suscriptor.

Flujo Operativo

1. Acceso a la vista: Navega a /process/billing desde el menú principal.

2. Diligenciamiento de parámetros del lote:

   • Periodo a Facturar: Selecciona el mes y año contable correspondiente (ej: Septiembre 2026).
   • Filtro de Segmentación: Selecciona facturar Todas las suscripciones activas o filtra por Zona / Ruta de distribución o Tipo de Plan.
   • Fecha de Emisión y Vencimiento del Lote: Define los días hábiles para el pago oportuno de la cuota.
   • Previsualización y Auditoría: Haz clic en Calcular Pre-liquidación para verificar el número total de suscriptores aptos y el importe global esperado sin emitir facturas definitivas.

3. Ejecución y Confirmación: Haz clic en el botón Ejecutar Facturación Masiva. El motor backend de Go procesa el lote mediante worker pools concurrentes (POST /api/v1/billing/run), genera las facturas electrónicas ante la DIAN y reporta el resultado: "Lote procesado: X facturas emitidas exitosamente, 0 errores".

Reglas de Negocio y Validaciones

• Prevención Estricta de Doble Facturación: El sistema valida mediante índices únicos que un suscriptor no reciba más de una factura por el mismo periodo de servicio (mes/año).
• Procesamiento Asíncrono Resiliente: Si una factura individual presenta error de validación tributaria o rechazo puntual en la DIAN, el trabajo en lote continúa procesando el resto de suscriptores y genera un archivo log de incidencias para revisión.

Tabla de Estados y Acciones Permitidas

Estado del Lote	Descripción	Acciones Disponibles
Pre-liquidado	Simulación de facturas y totales calculados sin emisión.	Revisar listado, excluir suscriptores manualmente.
En Ejecución	Proceso en segundo plano ejecutándose en el servidor.	Monitorear barra de progreso porcentual.
Finalizado	Facturas generadas, firmadas y enviadas al correo del cliente.	Descargar resumen de facturación, exportar reporte contable.

Restricciones Operativas

Una vez iniciado el procesamiento en lote definitivo, este no puede pausarse ni cancelarse a mitad de camino para preservar la secuencia estricta de números de consecutivos fiscales autorizados por la DIAN.