Appearance
Consolidacion de Informes de Ventas
Modulo: Ventas Tipo: Process Estado: Planificado Fecha: 2026-01-12
Patron Arquitectural: Este documento implementa el patron general de consolidacion multi-schema. Para entender la arquitectura completa, niveles de schema, y reglas arquitecturales, consultar:
/docs/architecture/consolidacion-informes-multi-schema.md
Implementacion de Referencia: Esta funcionalidad sigue el mismo patron ya implementado en Contabilidad. Ver:
/docs/features/contabilidad/consolidacion-informes-contables.md
Descripcion
Problema de Negocio
Las organizaciones con multiples sucursales necesitan obtener una vision unificada de sus operaciones de venta. Actualmente, cada sucursal gestiona su facturacion de forma independiente, obligando a los usuarios a:
- Generar el Subdiario de Ventas de cada sucursal por separado
- Consolidar manualmente los datos en planillas externas
- Realizar calculos manuales de totales de IVA, percepciones y montos gravados
- Invertir tiempo significativo en un proceso propenso a errores
- Demorar la presentacion de informes fiscales consolidados
Solucion Propuesta
Implementar consolidacion automatica del Subdiario de Ventas que permita generar reportes unificados combinando datos de todas las sucursales con gestion de ventas activa. El usuario activa la consolidacion mediante un parametro consolidado: true al generar el informe.
Valor de Negocio
- Vision empresarial unificada: Acceso inmediato al panorama completo de ventas de toda la organizacion
- Reduccion de errores: Elimina la consolidacion manual que genera inconsistencias y errores de calculo
- Ahorro de tiempo significativo: Automatiza un proceso que requiere horas de trabajo manual
- Analisis de performance corporativo: Facilita comparativas y analisis de ventas a nivel organizacional
- Cumplimiento normativo: Simplifica la preparacion de reportes fiscales consolidados (IVA Ventas, percepciones aplicadas)
- Trazabilidad completa: Identifica el origen de cada comprobante para auditorias
Informes de Ventas con Consolidacion
Subdiario de Ventas
Descripcion: El Subdiario de Ventas es un informe que lista cronologicamente todas las operaciones de venta realizadas en un periodo determinado. Para cada comprobante de venta registrado, muestra la informacion fiscal y comercial completa necesaria para el control y la presentacion impositiva.
Estado de Implementacion: Pendiente
Datos que muestra el informe:
Para cada comprobante de venta:
- Fecha de emision del comprobante
- Tipo de comprobante (Factura A, Factura B, Nota de Credito, etc.)
- Numero de comprobante
- Datos del cliente (razon social, CUIT)
- Monto gravado (base imponible sujeta a IVA)
- Monto exento (operaciones exentas de IVA)
- IVA debito fiscal (discriminado por alicuota si corresponde)
- Percepciones aplicadas (IIBB, IVA, otras)
- Total del comprobante
Consolidacion:
- Datos maestros: Tipos de comprobantes, alicuotas de IVA y conceptos de percepciones compartidos desde nivel empresa (unicos para toda la organizacion)
- Datos transaccionales: Comprobantes de venta de todas las sucursales donde existe gestion de ventas activa
- Agregacion: Combinacion cronologica de comprobantes de todas las sucursales, ordenados por fecha de emision
- Alcance: Consolida TODAS las sucursales de la organizacion, independientemente de la sucursal donde este ubicado el usuario
Presentacion del informe consolidado:
- Titulo indica claramente que es un informe consolidado
- Lista de sucursales incluidas en la consolidacion
- Cada linea de comprobante identifica la sucursal de origen
- Numeracion de comprobantes preservada por sucursal
- Totales consolidados al final del informe:
- Total gravado consolidado
- Total exento consolidado
- Total IVA debito fiscal consolidado
- Total percepciones consolidado
- Total general consolidado
Activacion:
- Parametro
consolidado: trueen la solicitud del informe - Sin el parametro o con
consolidado: false, el informe muestra solo datos de la sucursal actual (comportamiento existente)
Columnas del informe:
| Columna | Descripcion |
|---|---|
| Fecha | Fecha de emision del comprobante |
| Tipo | Tipo de comprobante (FA, FB, NC, ND, etc.) |
| Numero | Numero completo del comprobante (punto de venta + numero) |
| Cliente | Razon social o nombre del cliente |
| CUIT | Numero de identificacion tributaria del cliente |
| Gravado | Monto gravado (base imponible) |
| Exento | Monto exento de IVA |
| IVA | IVA debito fiscal |
| Percepciones | Total de percepciones aplicadas |
| Total | Monto total del comprobante |
| Sucursal | Sucursal de origen (solo en modo consolidado) |
Minuta de Ventas
Descripcion: La Minuta de Ventas es un informe contable que agrupa las transacciones de venta por cuenta contable, mostrando los totales de Debe y Haber. Es un resumen del Subdiario de Ventas organizado por cuentas del plan contable.
Estado de Implementacion: Pendiente (consolidación)
Diferencia con Subdiario de Ventas:
- El Subdiario lista cada comprobante individualmente
- La Minuta agrupa y totaliza por cuenta contable
- La Minuta muestra Debe y Haber por cada cuenta
Datos que muestra el informe:
La Minuta de Ventas presenta:
| Columna | Descripcion |
|---|---|
| Cuenta | Número de la cuenta contable |
| Descripción | Nombre de la cuenta contable |
| Debe | Total del Debe para esa cuenta en el período |
| Haber | Total del Haber para esa cuenta en el período |
Consolidacion de Minuta:
Cuando se activa la consolidación, la Minuta:
- Consolida totales por cuenta de todas las sucursales: Suma los totales de Debe y Haber de cada cuenta contable de todas las sucursales
- Mantiene estructura del plan contable: Las cuentas contables son compartidas a nivel empresa
- Presenta totales verificables: Los totales consolidados deben coincidir con los totales del Subdiario consolidado
Ejemplo de Minuta Consolidada:
MINUTA DE VENTAS - CONSOLIDADO
Período: Enero 2026
Sucursales: Suc0001, Suc0002, Suc0003
Cuenta | Descripción | Debe | Haber
-------|----------------------------------|-------------|-------------
1.1.01 | Caja | | $500,000.00
1.1.02 | Banco Cuenta Corriente | | $300,000.00
4.1.01 | Ventas Gravadas 21% | $600,000.00 |
2.1.05 | IVA Débito Fiscal | $126,000.00 |
-------|----------------------------------|-------------|-------------
TOTAL | 15 Registros | $726,000.00 | $800,000.00Presentacion del informe consolidado:
- Título indica claramente que es una Minuta consolidada de Ventas
- Lista de sucursales incluidas en la consolidación
- Tabla con cuenta, descripción, debe y haber
- Total de registros y suma de debe y haber
Activacion:
- Parametro
consolidado: trueen la solicitud del informe - Sin el parametro, la minuta muestra solo datos de la sucursal actual
Valor de negocio de Minuta consolidada:
- Resumen contable corporativo: Visión rápida de impacto contable de ventas en todas las sucursales
- Verificación de asientos: Control de que debe = haber a nivel consolidado
- Análisis de cuentas: Identificación de cuentas con mayor movimiento
- Cumplimiento normativo: Facilita auditorías con resumen por cuenta
Frontend (Perspectiva de Negocio)
Vistas
- Generacion de Subdiario de Ventas: Pantalla existente de generacion de informes de ventas que incorpora la opcion de consolidacion
- Generacion de Minuta de IVA Ventas: Pantalla para generar minuta resumen con opción de consolidación
- Visualizacion de informe consolidado: El informe generado muestra claramente que es consolidado e incluye la lista de sucursales incluidas
- Visualizacion de Minuta consolidada: Muestra totales por concepto de todas las sucursales
Interacciones del Usuario
- Activar/desactivar consolidacion: El usuario marca o desmarca la opcion de consolidacion antes de generar el informe
- Seleccionar periodo: El usuario indica las fechas desde/hasta para el informe
- Ver informacion de consolidacion: El sistema muestra cuantas sucursales seran incluidas antes de generar
- Generar informe consolidado: El sistema busca comprobantes en todas las sucursales elegibles automaticamente
- Identificar origen de datos: El usuario puede ver de que sucursal proviene cada comprobante
- Exportar informe consolidado: El usuario puede exportar el informe a Excel o PDF manteniendo la informacion de origen
Permisos
| Permiso | Descripcion | Acciones permitidas |
|---|---|---|
| Acceso a informes de ventas | Permiso base para acceder al modulo de informes de ventas | Ver y generar informes de la sucursal actual |
| Generacion de informes consolidados | Permiso especifico para activar la consolidacion | Generar informes que incluyan datos de todas las sucursales |
Consideraciones de permisos:
- El usuario solo ve datos consolidados de sucursales donde tiene permisos de ventas
- Un usuario con permiso en una sola sucursal puede activar consolidacion (solo vera datos de esa sucursal)
- La consolidacion respeta los permisos existentes por sucursal
Estados de UI
| Estado | Descripcion |
|---|---|
| Estado inicial | Consolidacion desactivada, informe mostrara solo sucursal actual |
| Estado activado | Indicador muestra "Se consolidaran X sucursales" con lista de nombres |
| Estado cargando | Indicador de progreso durante la generacion (puede tomar mas tiempo que informe simple) |
| Estado exito | Informe muestra claramente que es consolidado, lista sucursales incluidas, totales consolidados |
| Estado error | Mensajes claros si no hay sucursales disponibles, no hay datos en el periodo, o hay errores de acceso |
Backend (Perspectiva de Datos de Negocio)
Entidades de Negocio Involucradas
Datos de ventas por sucursal:
- Comprobantes de venta (facturas, notas de credito, notas de debito)
- Detalle de comprobantes (items vendidos)
- Datos fiscales del comprobante (gravado, exento, IVA, percepciones)
Datos maestros compartidos (nivel empresa):
- Tipos de comprobantes de venta
- Alicuotas de IVA
- Conceptos de percepciones
- Puntos de venta por sucursal
Configuracion:
- Sucursales con gestion de ventas activa
- Permisos del usuario por sucursal
Resultado consolidado:
- Comprobantes de todas las sucursales ordenados cronologicamente
- Identificacion de sucursal de origen por comprobante
- Totales consolidados de gravado, exento, IVA, percepciones y total general
Datos Necesarios para el Informe
Para generar el Subdiario de Ventas consolidado, se requiere:
| Dato | Descripcion | Origen |
|---|---|---|
| Fecha de emision | Fecha en que se emitio el comprobante | Comprobante de venta |
| Tipo de comprobante | Codigo y descripcion del tipo de documento | Datos maestros compartidos |
| Numero de comprobante | Punto de venta + numero correlativo | Comprobante de venta |
| Cliente | Razon social/nombre del cliente | Comprobante de venta |
| CUIT | Identificacion tributaria del cliente | Comprobante de venta |
| Monto gravado | Base imponible sujeta a IVA | Comprobante de venta |
| Monto exento | Operaciones exentas | Comprobante de venta |
| IVA | Debito fiscal calculado | Comprobante de venta |
| Percepciones | Percepciones de IIBB, IVA u otras | Comprobante de venta |
| Total | Suma de gravado + exento + IVA + percepciones | Comprobante de venta |
| Sucursal origen | Identificacion de la sucursal donde se emitio | Contexto de sucursal |
Relaciones de Negocio
- Cada comprobante de venta pertenece a una sucursal especifica
- Los comprobantes de venta referencian clientes registrados en el sistema
- Los tipos de comprobante son compartidos por toda la organizacion
- Las alicuotas de IVA son las mismas para todas las sucursales
- Los puntos de venta son especificos de cada sucursal
Validaciones de Negocio
| Validacion | Descripcion |
|---|---|
| Rango de fechas valido | Las fechas desde/hasta deben ser coherentes (desde <= hasta) |
| Periodo no excesivo | El rango de fechas no debe ser mayor a un periodo razonable (ej: 1 año) |
| Gestion de ventas activa | Solo se incluyen sucursales donde la gestion de ventas esta activa |
| Permisos por sucursal | Solo se incluyen datos de sucursales donde el usuario tiene permisos |
| Existencia de datos | Debe existir al menos un comprobante en el periodo para generar el informe |
Reglas de Negocio
RN-VENTAS-001: Numeracion de comprobantes por sucursal
Descripcion: Cada sucursal mantiene su propia numeracion de comprobantes. Los puntos de venta son unicos por sucursal.
Condicion: Al consolidar comprobantes de multiples sucursales.
Comportamiento:
- La numeracion de cada comprobante se preserva tal como fue emitida
- No se renumeran los comprobantes al consolidar
- El punto de venta permite identificar la sucursal de origen
- Pueden existir numeros de comprobante repetidos si son de diferentes puntos de venta
RN-VENTAS-002: Totales consolidados verificables
Descripcion: Los totales consolidados deben ser matematicamente verificables como la suma de los totales de cada sucursal.
Condicion: Al calcular totales del informe consolidado.
Comportamiento:
- Total gravado consolidado = Suma de gravado de todas las sucursales
- Total exento consolidado = Suma de exento de todas las sucursales
- Total IVA consolidado = Suma de IVA de todas las sucursales
- Total percepciones consolidado = Suma de percepciones de todas las sucursales
- Total general consolidado = Suma de totales de todas las sucursales
- Si hay discrepancias, alertar al usuario de posibles inconsistencias
RN-VENTAS-003: Solo sucursales con gestion de ventas activa
Descripcion: La consolidacion incluye unicamente sucursales donde la gestion de ventas esta habilitada.
Condicion: Al determinar que sucursales incluir en la consolidacion.
Comportamiento:
- Verificar configuracion de gestion de ventas activa por sucursal
- Excluir sucursales sin gestion de ventas (ej: sucursales solo administrativas)
- Informar al usuario cuales sucursales fueron incluidas y cuales excluidas
- Si ninguna sucursal tiene ventas activas, informar al usuario
RN-VENTAS-004: Respeto de permisos por sucursal
Descripcion: El usuario solo ve datos consolidados de sucursales donde tiene permisos de acceso a ventas.
Condicion: Al generar informe consolidado.
Comportamiento:
- Validar permisos del usuario en cada sucursal antes de incluir datos
- Usuario con permisos en sucursal A y B solo ve datos de A y B, aunque existan C y D
- Si usuario tiene permiso en una sola sucursal, el informe consolidado mostrara solo esa sucursal
- La cantidad de sucursales mostradas puede variar segun el usuario que genera el informe
RN-VENTAS-005: Ordenamiento cronologico
Descripcion: Los comprobantes en el informe consolidado se presentan ordenados cronologicamente por fecha de emision.
Condicion: Al presentar el listado de comprobantes consolidados.
Comportamiento:
- Ordenar todos los comprobantes por fecha de emision (ascendente)
- Comprobantes con misma fecha se ordenan por sucursal y luego por numero
- El ordenamiento es independiente de la sucursal de origen
- Facilita la lectura secuencial y la verificacion contra libros fiscales
Casos de Uso
UC-001: Generar Subdiario de Ventas Consolidado
Actor: Usuario de ventas con permisos en multiples sucursales
Precondiciones:
- Usuario tiene permisos de ventas en al menos una sucursal
- Usuario tiene permiso para generar informes consolidados
- Existe al menos una sucursal con gestion de ventas activa
- Existen comprobantes de venta en el rango de fechas seleccionado
Flujo principal:
- Usuario accede a la seccion de informes de ventas
- Usuario selecciona "Subdiario de Ventas"
- Usuario define el periodo (fecha desde y fecha hasta)
- Usuario activa la opcion "Consolidar sucursales"
- Sistema muestra "Se consolidaran X sucursales" con la lista de nombres
- Usuario confirma la generacion del informe
- Sistema consulta los comprobantes de venta de todas las sucursales elegibles
- Sistema ordena los comprobantes cronologicamente
- Sistema calcula totales consolidados (gravado, exento, IVA, percepciones, total)
- Sistema presenta el informe con titulo indicando que es consolidado
- Usuario visualiza el informe con datos de todas las sucursales
Postcondiciones:
- Usuario visualiza el Subdiario de Ventas con datos de todas las sucursales con permisos
- Cada linea del informe identifica la sucursal de origen
- Totales consolidados son correctos y verificables
- El informe indica claramente que es consolidado
Flujos alternativos:
- Sin datos en periodo: El sistema informa que no existen comprobantes en el periodo seleccionado para las sucursales incluidas
- Sin sucursales elegibles: El sistema informa que no hay sucursales con gestion de ventas activa donde el usuario tenga permisos
- Error de acceso: El sistema muestra mensaje de error si hay problemas de conectividad con alguna sucursal
UC-002: Exportar Subdiario de Ventas Consolidado para Revision Gerencial
Actor: Gerente de ventas o Director comercial
Precondiciones:
- Usuario tiene permisos en todas las sucursales de la organizacion
- Se ha generado previamente un informe consolidado
- El informe contiene datos de multiples sucursales
Flujo principal:
- Usuario genera el Subdiario de Ventas consolidado (segun UC-001)
- Usuario selecciona la opcion de exportacion
- Usuario elige el formato de exportacion (Excel o PDF)
- Sistema genera el archivo exportado manteniendo:
- Titulo indicando que es consolidado
- Lista de sucursales incluidas
- Columna de sucursal de origen por cada comprobante
- Totales consolidados
- Sistema permite descargar el archivo generado
- Usuario descarga y utiliza el archivo para revision gerencial
Postcondiciones:
- Archivo exportado contiene toda la informacion del informe consolidado
- La columna de sucursal de origen esta presente
- Totales son verificables contra los datos detallados
- Formato es adecuado para presentacion gerencial
Flujos alternativos:
- Archivo muy grande: El sistema avisa si el archivo excede un tamano razonable y ofrece alternativas (dividir por mes, reducir periodo)
- Error de generacion: El sistema muestra mensaje de error si hay problemas al generar el archivo
UC-003: Generar Informe para Presentacion de IVA Ventas
Actor: Responsable de impuestos
Precondiciones:
- Usuario tiene permisos de ventas en todas las sucursales
- Es periodo de presentacion de declaracion jurada de IVA
- Existen comprobantes de venta en el periodo fiscal
Flujo principal:
- Usuario accede al Subdiario de Ventas
- Usuario selecciona el periodo mensual correspondiente (ej: mes anterior)
- Usuario activa la consolidacion
- Sistema genera informe consolidado
- Usuario verifica que los totales de IVA coincidan con la posicion fiscal
- Usuario exporta el informe como respaldo de la presentacion impositiva
- Usuario utiliza los totales para completar la declaracion jurada
Postcondiciones:
- Total de IVA consolidado disponible para declaracion jurada
- Detalle de comprobantes disponible para eventuales fiscalizaciones
- Respaldo documental generado y archivado
Consideraciones
Seguridad
| Aspecto | Descripcion |
|---|---|
| Validacion de permisos | Verificar permisos del usuario en cada sucursal antes de incluir datos |
| Solo lectura | La consolidacion es solo lectura, no modifica datos originales en ninguna sucursal |
| Segregacion de datos | Cada sucursal mantiene sus datos separados, la consolidacion es una vista unificada |
| Auditoria de acceso | Registrar cada generacion de informe consolidado |
Auditoria
Eventos a registrar:
| Evento | Datos a capturar |
|---|---|
| Generacion de informe consolidado | Usuario, fecha y hora, tipo de informe |
| Periodo consultado | Fecha desde, fecha hasta |
| Sucursales incluidas | Lista de sucursales cuyos datos fueron consolidados |
| Exportacion realizada | Formato de exportacion, fecha y hora |
Rendimiento
Expectativas de tiempo de respuesta:
| Escenario | Tiempo esperado |
|---|---|
| 2-5 sucursales | 5-10 segundos |
| 6-10 sucursales | 10-20 segundos |
| Mas de 10 sucursales | Hasta 30-60 segundos |
Indicadores para el usuario:
- Mostrar indicador de progreso para operaciones que excedan 3 segundos
- Informar al usuario la cantidad de sucursales que se estan consultando
- Considerar generacion en segundo plano para volumenes muy grandes
Dependencias
Funcionalidades Relacionadas
- Sistema de informes de ventas existente (Subdiario de Ventas)
- Gestion de sucursales
- Sistema de permisos por sucursal
- Configuracion de gestion de ventas activa por sucursal
Procesos de Negocio Relacionados
- Presentacion de declaraciones juradas de IVA
- Preparacion de informes gerenciales de ventas
- Analisis de performance comercial por sucursal
- Auditorias fiscales
Referencia a Implementacion Existente
Esta funcionalidad sigue el mismo patron implementado en el modulo de Contabilidad:
- Ver:
/docs/features/contabilidad/consolidacion-informes-contables.md - Patron arquitectural:
/docs/architecture/consolidacion-informes-multi-schema.md
Criterios de Aceptacion
La funcionalidad se considera completa cuando:
- [ ] AC-001: Usuario puede activar consolidacion mediante parametro
consolidado: trueal generar el informe - [ ] AC-002: Con consolidacion activa, el informe muestra datos de todas las sucursales con gestion de ventas activa donde el usuario tiene permisos
- [ ] AC-003: El titulo del informe indica claramente que es un informe consolidado
- [ ] AC-004: El informe lista las sucursales que fueron incluidas en la consolidacion
- [ ] AC-005: Cada linea del informe identifica la sucursal de origen del comprobante
- [ ] AC-006: Los totales consolidados son correctos (suma verificable de todas las sucursales):
- Total gravado consolidado
- Total exento consolidado
- Total IVA consolidado
- Total percepciones consolidado
- Total general consolidado
- [ ] AC-007: Los comprobantes se presentan ordenados cronologicamente por fecha de emision
- [ ] AC-008: Sin consolidacion (parametro
consolidado: falseo ausente), el informe muestra solo datos de la sucursal actual (comportamiento existente preservado) - [ ] AC-009: El usuario puede exportar el informe consolidado a Excel manteniendo la columna de sucursal de origen
- [ ] AC-010: El usuario puede exportar el informe consolidado a PDF manteniendo la identificacion de origen
- [ ] AC-011: Se muestra indicador de progreso durante la generacion del informe consolidado
- [ ] AC-012: Se registra en auditoria cada generacion de informe consolidado (usuario, fecha, sucursales incluidas)
Extensiones Futuras
Seleccion Manual de Sucursales
Permitir al usuario seleccionar manualmente que sucursales incluir en lugar de todas:
- Selector con checkboxes para elegir sucursales
- Persistencia de seleccion durante la sesion
- Filtrado de resultados por sucursal seleccionada
Nota: Funcionalidad opcional, puede implementarse despues de la consolidacion automatica basica.
Otras Mejoras Posibles
- Informes consolidados programados (generacion automatica periodica)
- Comparativas de ventas entre sucursales
- Exportacion con multiples hojas (una por sucursal)
- Dashboard de ventas consolidadas en tiempo real
- Graficos comparativos de performance por sucursal
Historial de Cambios
| Fecha | Version | Autor | Descripcion |
|---|---|---|---|
| 2026-01-12 | 1.0 | Sistema | Creacion del documento de requerimientos de negocio para consolidacion de informes de ventas. Basado en el patron arquitectural de consolidacion multi-schema y la implementacion de referencia en Contabilidad. |