Appearance
Estadisticas de Facturacion por Lotes
Modulo: Membresias Tipo: View Estado: Implementado Fecha: 2026-01-27
Descripcion
Problema que resuelve
El proceso de facturacion por lotes de membresias procesa decenas o cientos de socios en una sola ejecucion. Al finalizar, el usuario necesita conocer rapidamente el resultado del procesamiento:
- Falta de visibilidad: Sin un resumen, el usuario no sabe cuantos socios se facturaron exitosamente, cuantos tuvieron errores o cuantos fueron omitidos
- Dificultad para diagnosticar problemas: Los errores de facturacion (rechazos de ARCA, datos invalidos, condiciones no cumplidas) requieren identificacion rapida para correccion
- Metricas de negocio ausentes: El usuario no tiene acceso inmediato al monto total facturado ni a la cantidad de comprobantes generados
- Errores ARCA dispersos: Los errores del organismo fiscal (ARCA) pueden ser variados y requieren agrupacion para identificar patrones
Solucion implementada
Se implementa una vista de resumen de resultados que presenta estadisticas agregadas al finalizar cada ejecucion de facturacion por lotes. La vista muestra metricas clave del procesamiento, incluyendo totales, errores agrupados y montos.
Valor de negocio
- Visibilidad inmediata: El usuario conoce el resultado del procesamiento al instante
- Diagnostico rapido: Los errores se muestran agrupados para identificar problemas sistematicos
- Control de gestion: Las metricas de montos y comprobantes permiten verificar la consistencia del lote
- Toma de decisiones: Los resultados facilitan decidir si se requiere re-facturacion o correccion de datos
Contexto del sistema
Esta vista se presenta al finalizar el proceso de facturacion por lotes de membresias, mostrando el resumen de la ejecucion recien completada.
Proceso de Negocio
Generacion de estadisticas
Al completarse el proceso de facturacion por lotes, el sistema calcula y presenta las siguientes metricas:
Metricas principales
| Metrica | Descripcion | Fuente |
|---|---|---|
| Total de socios procesados | Cantidad de socios que fueron evaluados por el proceso | Conteo de todos los registros procesados |
| Socios facturados exitosamente | Cantidad de socios para los cuales se genero factura correctamente | Conteo de registros exitosos |
| Socios con error | Cantidad de socios cuya facturacion fallo | Conteo de registros con error |
| Socios omitidos | Cantidad de socios que fueron excluidos del procesamiento | Conteo de registros omitidos |
| Monto total facturado | Suma de los importes de todas las facturas generadas exitosamente | Suma de montos de facturas exitosas |
| Comprobantes generados | Cantidad de comprobantes fiscales emitidos | Conteo de comprobantes creados |
Detalle de errores
Los errores se presentan con informacion que permite identificar y corregir cada caso:
| Dato | Descripcion |
|---|---|
| Socio afectado | Identificacion del socio cuya facturacion fallo |
| Tipo de error | Clasificacion del error (rechazo ARCA, datos invalidos, etc.) |
| Mensaje de error | Descripcion especifica del problema. Los mensajes se muestran COMPLETOS sin truncamiento, con ajuste automatico de texto y paginacion inteligente para evitar superposicion de valores |
Errores ARCA agrupados
Cuando la facturacion implica autorizacion del organismo fiscal (ARCA), los errores de rechazo se agrupan por tipo para identificar problemas sistematicos:
| Agrupacion | Descripcion |
|---|---|
| Codigo de error ARCA | Codigo numerico del rechazo |
| Descripcion del error | Mensaje COMPLETO del organismo fiscal, sin truncamiento. El texto se ajusta automaticamente con saltos de linea para su correcta visualizacion |
| Cantidad de afectados | Cuantos socios tienen este mismo error |
Frontend (Perspectiva de Usuario)
Vistas
Modal de resultados de facturacion por lotes
- Se presenta automaticamente al finalizar el proceso de facturacion
- Muestra las metricas principales en formato de tarjetas resaltadas
- Incluye detalle de cada socio procesado con su resultado
- Los errores ARCA se muestran agrupados en seccion separada
Componentes de la vista
Seccion de metricas resumen
- Tarjeta: Total de socios procesados
- Tarjeta: Facturados exitosamente (destacado en verde)
- Tarjeta: Con errores (destacado en rojo)
- Tarjeta: Omitidos (destacado en amarillo)
- Tarjeta: Monto total facturado
- Tarjeta: Comprobantes generados
Seccion de detalles
- Lista de todos los socios procesados con su resultado individual
- Para cada socio: identificacion, resultado (exito/error/omitido), mensaje
Seccion de errores ARCA (si aplica)
- Agrupacion de errores por codigo ARCA
- Para cada grupo: codigo, descripcion COMPLETA (sin limite de caracteres), cantidad de afectados
Interacciones del usuario
- Visualizar resumen: Al finalizar la facturacion, el usuario ve inmediatamente las metricas principales
- Revisar detalles: El usuario puede explorar el detalle de cada socio procesado
- Identificar errores: El usuario revisa los errores agrupados para diagnosticar problemas
- Cerrar y continuar: El usuario cierra el modal de resultados para volver a la pantalla de facturacion
Permisos
| Permiso | Descripcion | Acciones permitidas |
|---|---|---|
| Facturacion de membresias | Permiso requerido para ejecutar la facturacion | Ver resultados de la ejecucion |
Estados de UI
- Procesando: Indicador de progreso mientras se ejecuta la facturacion
- Resultados disponibles: Modal con el resumen completo del lote procesado
- Sin errores: El resumen muestra todos los socios exitosos (seccion de errores vacia)
- Con errores parciales: El resumen muestra socios exitosos y socios con error
- Todo con errores: El resumen muestra que ningun socio fue facturado exitosamente
Backend (Perspectiva de Datos de Negocio)
Entidades de negocio involucradas
Respuesta de Facturacion por Lotes
Estructura que contiene el resumen completo del procesamiento.
| Dato de negocio | Descripcion |
|---|---|
| Periodo | Periodo procesado (mes/ano) |
| Total procesados | Cantidad total de socios evaluados |
| Total exitosos | Cantidad de facturas generadas correctamente |
| Total errores | Cantidad de socios con error |
| Detalles | Lista de resultados individuales por socio |
Detalle Individual de Facturacion
Resultado del procesamiento de un socio individual.
| Dato de negocio | Descripcion |
|---|---|
| Socio | Identificacion del socio procesado |
| Resultado | Exitoso, error u omitido |
| Comprobante | Referencia al comprobante generado (si exitoso) |
| Error | Descripcion del error (si fallo) |
| Monto | Importe facturado (si exitoso) |
Relaciones de negocio
- Una respuesta de facturacion contiene multiples detalles individuales
- Cada detalle corresponde a un socio procesado
- Los detalles exitosos tienen referencia a un comprobante generado
- Los detalles con error tienen informacion del error ocurrido
Validaciones de negocio
No aplica. Esta funcionalidad es de solo lectura (presentacion de resultados).
Reglas de Negocio
RN-001: Estadisticas coherentes
Descripcion: La suma de socios exitosos, con error y omitidos debe ser igual al total de socios procesados. Las metricas deben ser matematicamente coherentes.
Condicion: Se presentan los resultados de facturacion.
Accion:
- Total procesados = Total exitosos + Total errores + Total omitidos
- Monto total = Suma de montos de todas las facturas exitosas
RN-002: Agrupacion de errores ARCA
Descripcion: Los errores provenientes del organismo fiscal (ARCA) se agrupan por codigo de error para facilitar la identificacion de problemas sistematicos.
Condicion: Existen errores de tipo ARCA en el procesamiento.
Accion:
- Agrupar errores por codigo de rechazo ARCA
- Mostrar la descripcion COMPLETA del error (sin limite de caracteres) y la cantidad de socios afectados por cada codigo
- Presentar en seccion separada del detalle individual
RN-003: Visualizacion completa de mensajes de error
Descripcion: Los mensajes de error se presentan COMPLETOS, sin truncamiento, de forma legible y sin interferir con otros datos del reporte.
Condicion: Existen mensajes de error en el procesamiento (ARCA, exclusiones, errores genericos).
Accion:
- Los mensajes de error se muestran en su totalidad, SIN truncamiento ni limite de caracteres
- El texto se ajusta automaticamente con saltos de linea (word-wrap) para adaptarse al ancho disponible
- Los saltos de linea originales en los mensajes se preservan y muestran correctamente
- La paginacion calcula correctamente el espacio requerido considerando saltos de linea y longitud de mensajes
- Los valores del reporte no se superponen entre si gracias al control de saltos de pagina
- Se limita a 12 errores por pagina para garantizar espacio adecuado para mensajes largos
RN-004: Presentacion inmediata de resultados
Descripcion: Los resultados de la facturacion se presentan inmediatamente al finalizar el procesamiento, sin requerir navegacion adicional por parte del usuario.
Condicion: El proceso de facturacion por lotes finaliza.
Accion:
- Presentar automaticamente el modal de resultados
- Mostrar las metricas principales de forma destacada
- Permitir al usuario explorar los detalles a su ritmo
Casos de Uso
CU-001: Revision de resultados de facturacion exitosa
Actor: Usuario de Facturacion
Precondiciones:
- El usuario ejecuto un proceso de facturacion por lotes
- El proceso finalizo con todos los socios facturados exitosamente
Flujo principal:
- El proceso de facturacion finaliza
- El sistema presenta automaticamente el modal de resultados
- El usuario visualiza las metricas:
- Total procesados: 150
- Exitosos: 150
- Errores: 0
- Monto total: $2,500,000
- Comprobantes: 150
- El usuario verifica que los numeros son coherentes
- El usuario cierra el modal
Postcondiciones:
- El usuario confirmo visualmente que el lote fue procesado correctamente
- No se requieren acciones correctivas
CU-002: Diagnostico de errores de facturacion
Actor: Usuario de Facturacion
Precondiciones:
- El usuario ejecuto un proceso de facturacion por lotes
- El proceso finalizo con errores parciales
Flujo principal:
- El proceso de facturacion finaliza
- El sistema presenta automaticamente el modal de resultados
- El usuario visualiza las metricas:
- Total procesados: 150
- Exitosos: 140
- Errores: 10
- Monto total: $2,350,000
- Comprobantes: 140
- El usuario revisa la seccion de errores ARCA agrupados:
- Error 10016: "CUIT inválido" - 7 socios afectados
- Error 10048: "Punto de venta no autorizado" - 3 socios afectados
- El usuario identifica los patrones de error
- El usuario cierra el modal para corregir los datos y re-facturar
Postcondiciones:
- El usuario identifico los errores y sus causas
- El usuario puede tomar acciones correctivas (corregir datos, re-facturar)
Flujos alternativos:
- Errores sin patron: Si los errores son variados, el usuario revisa el detalle individual de cada socio con error
Consideraciones
Seguridad
- Los resultados solo son visibles para el usuario que ejecuto la facturacion
- Los datos sensibles (CUIT, nombres) se muestran solo con el permiso de facturacion
Auditoria
- El resultado de la facturacion (exitoso/errores) queda registrado como parte del proceso de facturacion por lotes
- No se genera auditoria adicional por la visualizacion de estadisticas
Rendimiento
- Las estadisticas se calculan durante el proceso de facturacion, no requieren consultas adicionales al finalizar
- El modal se carga con los datos ya disponibles en memoria
- Para lotes grandes (500+ socios), el detalle individual puede requerir scroll pero los totales se muestran inmediatamente
Dependencias
Funcionalidades relacionadas
- Facturacion por lotes: Proceso que genera las estadisticas
- Integracion con ARCA: Los errores del organismo fiscal se incluyen en las estadisticas
- Re-facturacion: Proceso de correccion que puede iniciarse tras revisar los errores
Criterios de Aceptacion
- [x] AC-001: Al finalizar la facturacion, se presenta automaticamente el resumen de resultados
- [x] AC-002: El resumen muestra el total de socios procesados
- [x] AC-003: El resumen muestra la cantidad de socios facturados exitosamente
- [x] AC-004: El resumen muestra la cantidad de socios con error
- [x] AC-005: El resumen muestra la cantidad de socios omitidos
- [x] AC-006: El resumen muestra el monto total facturado
- [x] AC-007: El resumen muestra la cantidad de comprobantes generados
- [x] AC-008: Los errores ARCA se muestran agrupados por codigo de error
- [x] AC-009: Las metricas son coherentes (exitosos + errores + omitidos = total)
- [x] AC-010: El detalle individual muestra el resultado de cada socio procesado
- [x] AC-011: Los mensajes de error se muestran COMPLETOS, sin truncamiento
- [x] AC-012: El texto de mensajes largos se ajusta automaticamente con saltos de linea
- [x] AC-013: Los valores del reporte no se superponen entre si
- [x] AC-014: La paginacion maneja correctamente mensajes con saltos de linea
- [x] AC-015: Se preservan los saltos de linea originales de los mensajes de error
Notas Adicionales
Relacion con re-facturacion
Los resultados de estadisticas de facturacion alimentan directamente la decision de re-facturar. Cuando un usuario identifica errores (especialmente errores corregibles como datos de CUIT invalidos), puede corregir los datos y ejecutar una re-facturacion para los socios afectados.
Metricas derivadas
A partir de las metricas basicas, el usuario puede calcular:
- Tasa de exito: Exitosos / Total procesados
- Importe promedio: Monto total / Comprobantes generados
- Impacto de errores: Cantidad de socios afectados por cada tipo de error
Historial de Cambios
| Fecha | Version | Autor | Descripcion |
|---|---|---|---|
| 2026-01-27 | 1.0 | Sistema | Documentacion de funcionalidad implementada |
| 2026-02-04 | 1.1 | Sistema | Mejora en visualizacion de errores: mensajes COMPLETOS sin truncamiento, ajuste automatico de texto (word-wrap), preservacion de saltos de linea, paginacion inteligente con limite de 12 errores por pagina |