Appearance
Historial de Lotes de Facturacion
Modulo: Membresias Tipo: View Estado: Implementado Fecha: 2026-02-27 Fecha Implementacion: 2026-03-17
Descripcion
Problema que resuelve
El proceso de facturacion por lotes de membresias genera un informe PDF con los resultados detallados inmediatamente despues de la ejecucion. Sin embargo, ese informe se produce con datos que solo existen en el momento de la ejecucion: una vez que el usuario cierra la pantalla o navega a otra seccion, no hay forma de volver a obtener ese PDF.
Este problema es especialmente critico cuando la facturacion se ejecuta en segundo plano (modo asincrono): el usuario no esta presente en la pantalla al momento de finalizar el proceso, y si no accede a los resultados inmediatamente desde la notificacion, pierde la posibilidad de obtener el informe.
Actualmente no existe ningun mecanismo para:
- Consultar el historial de lotes ejecutados: El usuario no puede ver que lotes se ejecutaron, cuando, ni con que resultado
- Reimprimir el informe de resultados: Una vez perdido el momento de la ejecucion, el PDF no puede regenerarse
- Revisar lotes fallidos o abortados: Los errores ocurridos durante la ejecucion no son consultables posteriormente
Valor para el negocio
- Acceso permanente a resultados: El usuario puede consultar y reimprimir el informe de cualquier lote ejecutado, sin limite de tiempo
- Soporte para facturacion asincrona: En modo de ejecucion en segundo plano, el historial es la forma principal y confiable de acceder a los resultados del lote
- Trazabilidad operativa: El historial permite verificar que lotes se ejecutaron, quien los ejecuto, y cual fue el resultado
- Resolucion de incidentes: Ante consultas o reclamos, el operador puede reimprimir el informe exacto de un lote pasado para verificar que ocurrio con un socio especifico
Contexto
- Esta funcionalidad complementa el proceso de facturacion por lotes ya implementado (ver Facturacion por Lotes)
- Se ubica en la seccion "Utilidades" del modulo de membresias
- Cubre tanto lotes de tipo facturacion como de tipo refacturacion
- Opera exclusivamente dentro de la sucursal activa (schema activo)
Frontend (Perspectiva de Usuario)
Vistas
Pantalla de Historial de Lotes
Nueva seccion dentro de "Utilidades" del modulo de membresias que presenta:
- Listado de todos los lotes de facturacion y refacturacion ejecutados, incluyendo simulaciones (modo prueba)
- Cada fila del listado muestra informacion resumida del lote, con indicacion visual del modo (oficial o prueba)
- Los lotes de simulacion se identifican con un badge "Simulacion" en el listado
- Filtros disponibles: por periodo (mes/ano) y por modo (Todos / Prueba / Oficial)
- Accion de ver detalle y reimprimir el informe PDF para cada lote que tenga detalle disponible
- Accion de eliminar disponible exclusivamente en lotes de simulacion
Datos mostrados en el listado
Cada lote en el historial presenta la siguiente informacion:
| Dato | Descripcion |
|---|---|
| Tipo de operacion | Facturacion o Refacturacion |
| Periodo | Mes y ano del periodo facturado |
| Fecha de ejecucion | Fecha y hora en que se ejecuto el lote |
| Rango de socios | Desde y hasta que ID de socio se proceso |
| Total procesados | Cantidad total de socios procesados |
| Comprobantes exitosos | Cantidad de comprobantes generados correctamente |
| Comprobantes fallidos | Cantidad de comprobantes que fallaron |
| Estado del lote | Indica si el lote fue exitoso, parcialmente fallido o abortado |
| Modo | Indica si el lote fue ejecutado en modo oficial o prueba (simulacion) |
Interacciones del Usuario
Consultar historial
- El operador de membresias accede a la seccion "Utilidades" del modulo de membresias
- El sistema muestra el listado de lotes ejecutados, ordenados del mas reciente al mas antiguo
- El operador puede visualizar la informacion resumida de cada lote, incluyendo el modo de ejecucion
- El operador puede filtrar por periodo y por modo (Todos / Prueba / Oficial)
Ver detalle y reimprimir informe PDF
- El operador identifica el lote del cual necesita ver el detalle o reimprimir el informe
- El operador acciona el boton "Ver detalle" en la fila correspondiente
- El sistema abre el modal de resultados con el detalle completo del lote
- El operador puede generar el informe PDF con el detalle completo del lote
- El PDF generado es identico al que se genero en el momento de la ejecucion original (sin marca de agua ni indicador de reimpresion)
Eliminar lote de simulacion
- El operador identifica un lote de simulacion en el historial (marcado con badge "Simulacion")
- El operador acciona el boton "Eliminar" disponible en la fila del lote de simulacion
- El sistema solicita confirmacion antes de proceder
- Tras confirmacion, el sistema elimina el lote del historial
- La fila desaparece del listado al completarse la eliminacion
Consultar lote fallido o abortado
- El operador identifica un lote con estado fallido o abortado en el historial
- El operador puede ver el detalle de errores asociados al lote
- Si el lote tiene detalle disponible, el operador puede reimprimir el informe que incluye el desglose de errores por socio
Estados de UI
| Estado | Descripcion | Elementos visuales |
|---|---|---|
| Listado cargado | Se muestran los lotes del historial | Tabla con lotes ordenados por fecha descendente |
| Sin historial | No hay lotes ejecutados en la sucursal | Mensaje "No se encontraron lotes ejecutados" |
| Cargando detalle | Se esta obteniendo el detalle del lote seleccionado | Indicador de carga en el boton "Ver detalle" |
| Generando PDF | Se esta generando el informe para imprimir | Indicador de carga en el boton de imprimir dentro del modal |
| Lote sin detalle disponible | El lote es anterior a la implementacion de esta funcionalidad | Boton "Ver detalle" deshabilitado con tooltip "Detalle no disponible para lotes anteriores a esta version" |
| Lote de simulacion | El lote fue ejecutado en modo prueba | Badge "Simulacion" en la fila; boton "Eliminar" visible |
| Eliminando lote | Se esta procesando la eliminacion del lote de simulacion | Confirmacion del usuario requerida antes de proceder |
Permisos
| Permiso | Descripcion | Acciones permitidas |
|---|---|---|
| Facturacion masiva de membresias | Permiso existente que habilita la facturacion por lotes | Ver historial de lotes, reimprimir informes PDF |
Todos los usuarios con permiso de facturacion de membresias pueden ver todos los lotes de la sucursal activa. No existe filtrado por usuario: cualquier operador con el permiso ve el historial completo de la sucursal.
Backend (Perspectiva de Datos de Negocio)
Entidades de Negocio
Registro de Lote de Facturacion
Entidad que representa la ejecucion de un lote de facturacion o refacturacion, con su resultado y detalle por socio.
| Dato de negocio | Descripcion |
|---|---|
| Tipo de operacion | Facturacion o Refacturacion |
| Periodo | Mes y ano facturado |
| Fecha de ejecucion | Momento en que se inicio el lote |
| Fecha de finalizacion | Momento en que termino el lote |
| Rango de socios | IDs de socio desde y hasta |
| Usuario ejecutor | Quien ejecuto el lote |
| Total procesados | Cantidad total de socios procesados |
| Comprobantes exitosos | Cantidad de comprobantes generados correctamente |
| Comprobantes fallidos | Cantidad de comprobantes con error |
| Detalle por socio | Resultado individual de cada socio procesado |
Detalle por Socio
Cada socio procesado en el lote tiene un registro con su resultado:
| Estado | Datos del detalle |
|---|---|
| Exitoso | Identificador del socio, nombre, tipo de comprobante (A/B/C), numero de comprobante, CAE, monto total, cantidad de items |
| Excluido | Identificador del socio, nombre, motivo de exclusion (ej: "Ya facturado en este periodo") |
| Error | Identificador del socio, nombre, observaciones de ARCA con codigo y mensaje de error |
Para los socios con estado exitoso, los items individuales de la factura (descripcion, cantidad, precio unitario, total) se obtienen desde la factura registrada en el modulo de Ventas a traves del identificador de factura asociado.
Relaciones de Negocio
- Un lote de facturacion contiene el detalle de todos los socios procesados (exitosos, excluidos y con error)
- Un socio exitoso tiene una factura registrada en el modulo de Ventas con sus items detallados
- El historial muestra tanto lotes de ejecucion efectiva como lotes de simulacion (modo prueba)
- Los lotes de simulacion son eliminables por el operador; los lotes reales son inmutables
- El historial se limita a la sucursal activa (cada sucursal tiene su propio historial)
Validaciones de Negocio
- El historial muestra tanto lotes de ejecucion efectiva como lotes de simulacion (modo prueba); ambos tipos son visibles
- Los lotes de simulacion se identifican visualmente con un badge y pueden ser eliminados; los lotes reales son inmutables
- Solo pueden eliminarse lotes con
simulacion = true; los lotes consimulacion = falseretornan error 403 si se intenta eliminar - Los lotes anteriores a la implementacion de esta funcionalidad no tienen detalle disponible; el sistema indica claramente esta situacion
- El PDF reimpreso reproduce fielmente el informe original, sin alteraciones
- Los filtros disponibles (periodo y modo) permiten acotar la vista sin paginar manualmente todo el historial
Reglas de Negocio
RN-001: Visibilidad de simulaciones en el historial
Descripcion: El historial de lotes muestra tanto lotes de ejecucion efectiva (modo oficial) como lotes de simulacion (modo prueba). Los lotes de simulacion se identifican con un badge visual "Simulacion" en el listado.
Condicion: Al cargar el historial de lotes.
Accion:
- Mostrar todos los lotes (oficiales y de simulacion) ordenados por fecha descendente
- Indicar el modo de ejecucion de cada lote en la columna "Modo"
- Marcar visualmente con badge "Simulacion" los lotes ejecutados en modo prueba
- Permitir filtrar por modo: Todos / Prueba / Oficial
RN-002: Scope por sucursal activa
Descripcion: El historial muestra exclusivamente los lotes ejecutados en la sucursal donde el usuario esta trabajando actualmente. No se muestra informacion de otras sucursales.
Condicion: Al consultar el historial.
Accion:
- Mostrar solo los lotes correspondientes a la sucursal activa del usuario
- No ofrecer opcion de consultar otras sucursales
RN-003: PDF identico al original
Descripcion: El informe PDF reimpreso desde el historial es visualmente identico al generado en el momento de la ejecucion del lote. No se agrega marca de agua, encabezado de reimpresion ni ningun otro indicador que lo diferencie del original.
Condicion: El operador solicita reimprimir el informe de un lote.
Accion:
- Generar el PDF con el mismo formato y datos del informe original
- Los items de facturas exitosas se obtienen desde las facturas registradas en Ventas
- Los excluidos y errores se obtienen desde el detalle registrado al momento de la ejecucion
RN-004: Lotes anteriores a la migracion sin detalle
Descripcion: Los lotes ejecutados antes de la implementacion de esta funcionalidad no tienen el detalle por socio disponible. El sistema debe comunicar claramente esta situacion al usuario en lugar de mostrar un error.
Condicion: El operador intenta reimprimir un lote que no tiene detalle registrado.
Accion:
- Deshabilitar la accion de reimprimir para ese lote
- Mostrar un mensaje informativo: "Detalle no disponible para lotes anteriores a esta version"
RN-005: Lotes fallidos y abortados en el historial
Descripcion: Los lotes que fallaron total o parcialmente durante la ejecucion tambien aparecen en el historial. El detalle de errores permite al operador identificar que socios tuvieron problemas y que errores reporto ARCA.
Condicion: Un lote finalizo con errores o fue abortado.
Accion:
- Incluir el lote en el historial con su estado correspondiente (parcialmente fallido o abortado)
- Mostrar la cantidad de comprobantes fallidos junto a los exitosos
- Permitir reimprimir el informe que incluye el desglose de socios con error y sus observaciones de ARCA
RN-006: Cobertura de tipos de operacion
Descripcion: El historial incluye tanto lotes de facturacion como de refacturacion. Ambos tipos se presentan en el mismo listado, diferenciados por su tipo de operacion.
Condicion: Al cargar el historial.
Accion:
- Listar ambos tipos de lote en una unica vista
- Identificar visualmente el tipo de operacion de cada lote (facturacion o refacturacion)
RN-007: Eliminacion exclusiva de lotes de simulacion
Descripcion: Solo los lotes ejecutados en modo simulacion (prueba) pueden eliminarse del historial. Los lotes de facturacion real son inmutables y no pueden eliminarse bajo ninguna circunstancia.
Condicion: El operador intenta eliminar un lote del historial.
Accion:
- Mostrar el boton "Eliminar" unicamente en filas de lotes con
modoSimulacion = true - Solicitar confirmacion del usuario antes de proceder con la eliminacion
- Al confirmar, eliminar el lote del historial y remover la fila del listado
- Si el servidor rechaza la eliminacion de un lote real (403), mostrar mensaje de error al usuario
- Los lotes de facturacion real (oficial) no tienen boton de eliminar en la interfaz
Casos de Uso
CU-001: Reimprimir informe de un lote reciente
Actor: Operador de membresias
Objetivo: Obtener nuevamente el informe PDF de resultados de un lote de facturacion ejecutado hace varios dias
Precondiciones:
- El operador tiene permiso de facturacion masiva de membresias
- El lote fue ejecutado despues de la implementacion de esta funcionalidad (tiene detalle disponible)
- El lote fue una ejecucion efectiva (no simulacion)
Flujo principal:
- El operador accede a la seccion "Utilidades" del modulo de membresias
- El sistema muestra el listado de lotes ejecutados, ordenados por fecha descendente
- El operador identifica el lote deseado por su periodo, fecha de ejecucion y tipo de operacion
- El operador acciona el boton de reimprimir PDF del lote
- El sistema genera el informe PDF con el detalle completo (socios exitosos con items, excluidos con motivo, errores con observaciones ARCA)
- El sistema presenta el PDF al operador para descarga o visualizacion
Postcondiciones:
- El operador tiene el PDF con los resultados exactos del lote
- El PDF es identico al generado originalmente
Flujos alternativos:
- 4a. Lote sin detalle disponible: El boton de reimprimir esta deshabilitado. El sistema muestra el mensaje "Detalle no disponible para lotes anteriores a esta version"
CU-002: Consultar resultado de facturacion asincrona desde el historial
Actor: Operador de membresias
Objetivo: Acceder al informe de resultados de un lote que se ejecuto en segundo plano y cuya notificacion ya fue descartada
Precondiciones:
- El operador ejecuto un lote de facturacion en modo asincrono
- La notificacion de finalizacion ya fue consumida o el operador no pudo acceder a los resultados en ese momento
Flujo principal:
- El operador accede al historial de lotes en la seccion "Utilidades"
- El sistema muestra el listado incluyendo el lote ejecutado en segundo plano
- El operador identifica el lote por su periodo y fecha de ejecucion
- El operador acciona reimprimir PDF
- El sistema genera y presenta el informe PDF completo
Postcondiciones:
- El operador accede a los resultados del lote asincrono sin depender de la notificacion original
CU-003: Verificar un lote con errores parciales
Actor: Operador de membresias
Objetivo: Revisar el detalle de un lote que tuvo comprobantes fallidos para identificar los socios afectados
Precondiciones:
- Existe un lote en el historial con comprobantes fallidos (estado parcialmente fallido)
Flujo principal:
- El operador accede al historial de lotes
- El operador identifica un lote con comprobantes fallidos por las cantidades mostradas en el resumen
- El operador acciona reimprimir PDF del lote
- El sistema genera el informe que incluye la seccion de errores con las observaciones ARCA por cada socio afectado
- El operador revisa el informe para identificar los socios con error y los codigos/mensajes de ARCA
- El operador toma las acciones correctivas necesarias (corregir datos del socio, reintentar, etc.)
Postcondiciones:
- El operador conoce que socios tuvieron errores y los motivos especificos reportados por ARCA
Consideraciones
Seguridad
Control de acceso:
- El historial de lotes es accesible para todos los usuarios con permiso de facturacion masiva de membresias
- No existe filtrado por usuario ejecutor: cualquier operador autorizado ve todos los lotes de la sucursal
- El acceso esta limitado a la sucursal activa del usuario (multi-tenant)
Auditoria
El historial de lotes utiliza los registros de auditoria ya generados por el proceso de facturacion por lotes. No se generan registros de auditoria adicionales por la consulta o reimpresion desde el historial.
Rendimiento
Volumenes esperados:
- El listado contiene los lotes ejecutados historicamente para la sucursal activa
- La frecuencia de ejecucion de lotes es baja (tipicamente uno o pocos por mes por sucursal)
- La reimpresion del PDF es una operacion puntual, no masiva
Dependencias
Funcionalidades relacionadas
- Facturacion por Lotes: Proceso que genera los lotes cuyos resultados se consultan en el historial
- Modulo de Ventas: Fuente de los items detallados de cada factura exitosa para la reimpresion del informe
Servicios externos
- Servicio de generacion de informes PDF: Genera el informe de resultados al reimprimir desde el historial
Criterios de Aceptacion
- [x] AC-001: El operador puede acceder a la seccion "Historial de Lotes" desde "Utilidades" del modulo de membresias
- [x] AC-002: El listado muestra los lotes de facturacion y refacturacion de la sucursal activa, incluyendo lotes de simulacion identificados con badge visual
- [x] AC-003: Cada lote en el listado muestra: tipo de operacion, periodo, fecha de ejecucion, rango de socios, totales de procesados/exitosos/fallidos, y modo (oficial o prueba)
- [x] AC-004: Los lotes se muestran ordenados por fecha de ejecucion descendente (mas recientes primero)
- [x] AC-005: El operador puede ver el detalle e imprimir el informe PDF de cualquier lote que tenga detalle disponible
- [x] AC-006: El PDF impreso desde el historial es identico al generado en el momento de la ejecucion (sin marca de agua ni indicador de reimpresion)
- [x] AC-007: Los lotes fallidos o abortados aparecen en el historial con su detalle de error
- [x] AC-008: El informe del historial de un lote con errores incluye el desglose de errores por socio con las observaciones de ARCA
- [x] AC-009: Los lotes anteriores a la implementacion de esta funcionalidad muestran boton "Ver detalle" deshabilitado con tooltip "Detalle no disponible para lotes anteriores a esta version"
- [x] AC-010: Un lote ejecutado hoy puede visualizar e imprimir su informe PDF exacto 30 dias despues desde el historial
- [x] AC-011: En modo asincrono, el historial permite acceder a los resultados del lote sin depender de la notificacion original
- [x] AC-012: Los lotes de simulacion (modo prueba) aparecen en el historial identificados con badge "Simulacion"
- [x] AC-013: El operador puede eliminar un lote de simulacion tras confirmacion; la fila desaparece del listado al completarse la eliminacion
- [x] AC-014: No existe boton "Eliminar" en lotes de facturacion real; los lotes oficiales son inmutables
- [x] AC-015: El operador puede filtrar el historial por periodo (mes/ano) y por modo (Todos / Prueba / Oficial)
Notas Adicionales
Relacion con la funcionalidad existente
Esta funcionalidad no modifica el proceso de facturacion por lotes existente ni el flujo de visualizacion de resultados inmediatos. Agrega una via alternativa y permanente para acceder a los resultados de lotes ya ejecutados.
Lotes anteriores a la migracion
Los lotes ejecutados antes de la implementacion de esta funcionalidad no cuentan con el detalle necesario para reimprimir el informe. Estos lotes aparecen en el historial con su informacion resumida (periodo, totales, fecha) pero la reimpresion no esta disponible. Esta es una limitacion conocida y esperada que se comunica al usuario de forma clara.
Items de facturas en la reimpresion
El informe reimpreso incluye los items individuales de cada factura exitosa (descripcion, cantidad, precio unitario, total) tal como se muestran en el informe original. Estos items se reconstruyen desde las facturas registradas en el modulo de Ventas al momento de la reimpresion, garantizando que la informacion sea consistente con lo facturado.
Historial de Cambios
| Fecha | Version | Autor | Descripcion |
|---|---|---|---|
| 2026-02-27 | 1.0 | Sistema | Creacion del documento - Definicion de requerimientos para historial y reimpresion de lotes de facturacion |
| 2026-03-17 | 2.0 | Sistema | Implementacion - Simulaciones visibles en historial con badge, eliminacion de lotes de prueba, filtros por periodo y modo, columna modo en listado, criterios de aceptacion actualizados |