Appearance
Informe de Ventas por Artículos
Módulo: Ventas Tipo: View Estado: Planificado Fecha: 2026-05-13
Descripción
El informe de Ventas por Artículos permite conocer qué productos se vendieron, en qué cantidades, a qué precio y con qué margen de utilidad, en un período determinado. El análisis puede hacerse agrupado por vendedor o por cliente, con distintos niveles de detalle según la necesidad del usuario.
Valor para el negocio:
- Identificar los artículos más y menos vendidos por vendedor o por cliente
- Analizar márgenes de utilidad por producto y agrupación de artículos
- Comparar el desempeño de vendedores a nivel de mix de productos
- Detectar artículos deficitarios (utilidad negativa) para tomar decisiones comerciales
Contexto:
- El informe se ubica en
Ventas → Informes → Estadísticas → Ventas por Artículos - Genera un documento PDF con el resultado de la consulta
- Los artículos se organizan dentro de agrupaciones y líneas según el catálogo de productos del sistema
Frontend (Perspectiva de Usuario)
Vistas
- Formulario de consulta con los parámetros de generación del informe
- Documento PDF generado con el resultado, visualizable e imprimible
Interacciones del Usuario
- Seleccionar si el informe se analiza por vendedor o por cliente
- Definir el rango de vendedores o clientes a incluir
- Activar o desactivar la visualización de agrupaciones de artículos
- Activar o desactivar el desglose por línea dentro de cada agrupación
- Activar el modo resumido para ver solo totales por agrupación (sin detalle artículo por artículo)
- Elegir si el costo informado es unitario o total (unitario × cantidad vendida)
- Definir el rango de fechas del período a consultar
- Generar el informe en PDF
- Salir sin generar informe
Estados de UI
- Formulario con valores por defecto al abrirse (fechas y rangos pre-cargados)
- Los campos de rango cambian según el switch vendedor/cliente activo
- Indicador de carga mientras se genera el PDF
- El PDF se abre o descarga al completarse la generación
Backend (Perspectiva de Datos de Negocio)
Entidades de Negocio
- Artículo: Producto vendido con código, denominación, agrupación y línea
- Agrupación de artículos: Categoría de primer nivel que agrupa artículos relacionados
- Línea de artículos: Subcategoría dentro de una agrupación
- Vendedor: Persona responsable de la venta
- Cliente: Destinatario de la venta
- Comprobante de venta: Documento que registra la operación comercial
- Punto de venta: Identificación del local o canal de venta
Datos Necesarios
Para cada artículo vendido en el período:
- Código y denominación del artículo
- Agrupación y línea a la que pertenece
- Número de transacciones en que aparece
- Cantidad total de unidades vendidas
- Importe total vendido
- Precio promedio por unidad
- Costo del artículo (unitario o total según parametrización)
- Peso promedio de las unidades
- Utilidad por unidad y utilidad total
- Porcentaje de utilidad
Relaciones de Negocio
- Cada venta de artículo pertenece a un vendedor o cliente (según eje del informe)
- Cada artículo pertenece a una línea, y cada línea pertenece a una agrupación
- Las ventas se totalizan por línea, por agrupación, por vendedor/cliente y en el total general
- El costo referenciado corresponde al costo registrado al momento de la venta
Validaciones de Negocio
- El rango de fechas debe ser coherente (desde ≤ hasta)
- El rango de vendedores o clientes debe ser válido según el tipo seleccionado
- Debe existir al menos una venta en el período y rango seleccionados para generar el informe
Reglas de Negocio
RN-VXA-001: El switch vendedor/cliente determina el eje de análisis
- Condición: Al seleccionar "Vendedor" o "Cliente" en el formulario
- Acción: El sistema cambia los campos de rango disponibles y agrupa los resultados del informe según el eje elegido. Ambos modos son excluyentes: no se puede analizar por vendedor y por cliente simultáneamente.
RN-VXA-002: Modo resumido colapsa el detalle al nivel de agrupación
- Condición: Cuando el usuario activa la opción "Resumido"
- Acción: El informe muestra únicamente los totales por agrupación para cada vendedor o cliente, sin listar artículos individuales ni líneas. El documento PDF lo indica explícitamente en su encabezado.
RN-VXA-003: El costo informado depende del checkbox "Costo Total"
- Condición: Al generar el informe
- Acción (inactivo): La columna de costo muestra el costo unitario del artículo
- Acción (activo): La columna de costo muestra el costo total = costo unitario × cantidad vendida
- El encabezado del PDF refleja cuál de los dos modos está activo
RN-VXA-004: Fechas por defecto al abrir el formulario
- Condición: Al abrir el formulario de consulta
- Acción: El campo "Desde Fecha" se pre-carga con el primer día del año en curso; el campo "Hasta Fecha" se pre-carga con la fecha actual del sistema. El usuario puede modificar ambos valores antes de generar.
RN-VXA-005: Informa Agrupación e Informa Línea controlan el nivel de detalle
- Condición: Al generar el informe con detalle completo (Resumido desactivado)
- Acción: Si "Informa Agrupación" está activo, los artículos se agrupan bajo su categoría con subtotal por agrupación. Si además "Informa Línea" está activo, dentro de cada agrupación se desglosa por subcategoría con subtotal por línea. Si ninguno está activo, los artículos se listan sin estructura de agrupación.
Casos de Uso
UC-001: Analizar ventas por vendedor con detalle completo
Actor: Jefe de ventas
Precondiciones:
- Usuario tiene acceso al módulo de informes de ventas
- Existen ventas registradas en el período seleccionado
Flujo principal:
- Usuario accede a
Ventas → Informes → Estadísticas → Ventas por Artículos - Sistema presenta el formulario con switch en "Vendedor" y fechas pre-cargadas
- Usuario mantiene el rango de vendedores completo
- Usuario activa "Informa Agrupación" e "Informa Línea"
- Usuario deja "Resumido" y "Costo Total" desactivados
- Usuario presiona "Informe"
- Sistema genera el PDF con el detalle de cada artículo vendido por cada vendedor, organizado por agrupación y línea, mostrando costo unitario y utilidades
Flujos alternativos:
- 6a. No hay ventas en el período → Sistema informa que no existen datos para los parámetros seleccionados y no genera el PDF
Postcondiciones:
- PDF generado con el detalle completo de ventas por artículo por vendedor
UC-002: Obtener resumen ejecutivo de ventas por vendedor
Actor: Gerente comercial
Precondiciones:
- Usuario tiene acceso al módulo de informes de ventas
- Existen ventas registradas en el período seleccionado
Flujo principal:
- Usuario accede al formulario de consulta
- Sistema presenta el formulario con switch en "Vendedor"
- Usuario activa "Resumido"
- Usuario activa "Costo Total" para ver el impacto del costo en volumen
- Usuario ajusta el rango de fechas al mes anterior
- Usuario presiona "Informe"
- Sistema genera el PDF con solo los totales por agrupación de cada vendedor, indicando costo total y utilidad total
Postcondiciones:
- PDF generado con visión consolidada por agrupación por vendedor, apto para presentación de gestión
UC-003: Revisar compras de un cliente específico por artículo
Actor: Analista de cuentas / vendedor
Precondiciones:
- Usuario tiene acceso al módulo de informes de ventas
- El cliente existe y tiene compras en el período seleccionado
Flujo principal:
- Usuario accede al formulario de consulta
- Usuario cambia el switch a "Cliente"
- Usuario ingresa el mismo código en "Desde Cliente" y "Hasta Cliente" para limitar a un cliente puntual
- Usuario activa "Informa Agrupación" e "Informa Línea"
- Usuario ajusta el rango de fechas según necesidad
- Usuario presiona "Informe"
- Sistema genera el PDF con el detalle de todos los artículos adquiridos por ese cliente en el período, organizados por agrupación y línea
Postcondiciones:
- PDF generado con el historial de compras por artículo del cliente seleccionado
Consideraciones
Seguridad
- Solo usuarios autenticados con acceso al módulo de informes de ventas pueden generar este informe
- El informe muestra datos de ventas de la sucursal del usuario; el acceso a otras sucursales queda sujeto a los permisos del sistema
- Los valores de costo y utilidad son datos sensibles; solo usuarios con permiso de visualización de costos deben ver esas columnas
Rendimiento
- Períodos amplios (año completo, todos los vendedores, todos los artículos) pueden generar documentos extensos y demorar la generación
- El tiempo de respuesta esperado para consultas comunes (un mes, rango acotado) es menor a 10 segundos
Dependencias
Módulos internos
- Artículos: Catálogo de productos con agrupaciones y líneas
- Vendedores: Registro de vendedores activos del sistema
- Clientes: Registro de clientes del sistema
- Comprobantes de venta: Fuente de datos transaccionales del informe
Servicios externos
- Servicio de generación de PDF: Servicio externo que convierte los datos del informe en documento PDF
Criterios de Aceptación
- [ ] El switch Vendedor/Cliente activa los rangos correctos y el informe agrupa según el eje seleccionado
- [ ] El rango de vendedores o clientes filtra correctamente los datos incluidos
- [ ] Con "Informa Agrupación" activo, el PDF organiza los artículos bajo su categoría con subtotal por agrupación
- [ ] Con "Informa Línea" activo, el PDF desglosa las líneas dentro de cada agrupación con subtotal por línea
- [ ] Con "Resumido" activo, el PDF muestra solo totales por agrupación sin detalle de artículos individuales
- [ ] Con "Costo Total" activo, el costo del informe corresponde a costo unitario × cantidad vendida; sin él, costo unitario
- [ ] Al abrir el formulario, "Desde Fecha" es el primer día del año en curso y "Hasta Fecha" es la fecha actual
- [ ] Los subtotales por línea, agrupación, vendedor/cliente y total general son matemáticamente correctos
- [ ] Si no existen datos para los parámetros seleccionados, el sistema informa al usuario y no genera el PDF
- [ ] El PDF generado es legible, paginado y refleja claramente los parámetros de la consulta realizada
Historial de cambios
| Fecha | Versión | Autor | Descripción |
|---|---|---|---|
| 2026-05-13 | 1.0 | Diego Marmiroli | Creación del documento. Basado en formulario de consulta y análisis de ejemplos de PDF (Vendedores, Clientes, Resumido). |