Consolidacion de Informes de Compras

Modulo: Compras 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: Este documento sigue el mismo patron ya implementado en el modulo de 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 compra. Actualmente, cada sucursal gestiona sus compras de forma independiente, obligando a los usuarios a:

• Generar reportes individuales del Subdiario de Compras por cada sucursal
• Consolidar manualmente los datos en planillas de calculo
• Sumar importes gravados, exentos, IVA, percepciones y retenciones de forma manual
• Invertir tiempo significativo en preparacion de informes gerenciales
• Arriesgar errores humanos en la consolidacion manual
• Dificultar auditorias por falta de vision centralizada

Solucion Propuesta

Implementar consolidacion automatica del Subdiario de Compras que permita generar reportes unificados combinando datos de todas las sucursales con gestion de compras activa. El usuario activa la consolidacion mediante el parametro consolidado: true al generar cualquier informe de compras.

Valor de Negocio

• Vision empresarial unificada: Decisiones de compra basadas en datos de toda la organizacion
• Poder de negociacion con proveedores: Volumen consolidado permite mejores condiciones comerciales
• Reduccion de errores: Elimina consolidacion manual propensa a equivocaciones
• Ahorro de tiempo: Automatiza proceso que requiere trabajo manual significativo
• Cumplimiento fiscal: Facilita reportes consolidados de IVA Credito Fiscal, percepciones y retenciones requeridos por normativa
• Trazabilidad completa: Identifica origen de cada comprobante para auditoria
• Analisis de costos corporativo: Permite identificar patrones de compra y optimizar gastos
• Facilita auditorias: Vision completa de compras en un solo informe

---

Informes de Compras con Consolidacion

Subdiario de Compras Consolidado

Descripcion: El Subdiario de Compras es un informe que lista cronologicamente todas las operaciones de compra realizadas en un periodo determinado. Muestra para cada comprobante de compra la informacion completa de la operacion con su proveedor, importes gravados, impuestos y totales.

Estado de Implementacion: Pendiente

Datos que Muestra el Informe (por comprobante)

Dato	Descripcion
Fecha	Fecha de emision del comprobante de compra
Tipo	Tipo de comprobante (Factura A, Factura B, Nota de Credito A, etc.)
Numero	Numero completo del comprobante (punto de venta - numero)
Proveedor	Razon social del proveedor
CUIT	Numero de CUIT del proveedor
Gravado/Neto	Importe neto gravado
No Gravado	Importe no gravado (si aplica)
Exento	Importe exento de IVA (si aplica)
IVA Credito Fiscal	IVA discriminado (columnas dinamicas por alicuota: 21%, 10.5%, 27%, 5%, etc.)
Percepciones	Percepciones aplicadas (IVA, IIBB, Municipal, etc.)
Retenciones	Retenciones aplicadas (Ganancias, IIBB, SUSS, etc.)
Total	Total del comprobante

Comportamiento de la Consolidacion

Sin consolidacion (comportamiento existente):

• El informe muestra solo los comprobantes de compra de la sucursal actual
• Totales corresponden a la sucursal donde se encuentra el usuario

Con consolidacion activa (consolidado: true):

• El informe muestra comprobantes de todas las sucursales de la organizacion donde existe gestion de compras activa
• Los comprobantes se combinan y ordenan cronologicamente
• Cada linea del informe identifica claramente de que sucursal proviene el comprobante
• Se presentan totales consolidados de toda la organizacion
• El titulo del informe indica claramente que es un informe consolidado
• Se lista que sucursales fueron incluidas en la consolidacion

Columnas Adicionales en Modo Consolidado

Columna	Descripcion
Sucursal	Identificacion de la sucursal de origen del comprobante

Totales Consolidados

El informe debe presentar los siguientes totales consolidados al final:

Total	Descripcion
Total Gravado	Suma de importes gravados de todas las sucursales
Total No Gravado	Suma de importes no gravados de todas las sucursales
Total Exento	Suma de importes exentos de todas las sucursales
Total IVA CF por alicuota	Suma de IVA Credito Fiscal por cada alicuota (21%, 10.5%, etc.)
Total Percepciones	Suma de percepciones por tipo (IVA, IIBB, Municipal, etc.)
Total Retenciones	Suma de retenciones por tipo (Ganancias, IIBB, SUSS, etc.)
Total General	Suma total de todos los comprobantes de todas las sucursales

Modos de Operacion

Compatible con los tres modos de operacion del sistema:

• Modo Prueba: Consolida comprobantes en modo prueba de todas las sucursales
• Modo Oficial: Consolida comprobantes en modo oficial de todas las sucursales
• Modo Consolidado: Consolida comprobantes oficiales + prueba de todas las sucursales

Minuta de Compras

Descripcion: La Minuta de Compras es un informe contable que agrupa las transacciones de compra por cuenta contable, mostrando los totales de Debe y Haber.

Estado de Implementacion: Pendiente

Estructura del Informe

Columna	Descripcion
Cuenta	Numero de la cuenta contable
Descripcion	Nombre de la cuenta contable
Debe	Total del Debe para esa cuenta
Haber	Total del Haber para esa cuenta

Comportamiento de la Consolidacion

Sin consolidacion (comportamiento existente):

• La minuta muestra solo las transacciones contables de compras de la sucursal actual
• Totales de Debe y Haber corresponden a la sucursal donde se encuentra el usuario

Con consolidacion activa (consolidado: true):

• La minuta agrupa transacciones contables de compras de todas las sucursales de la organizacion
• Se suman los importes de Debe y Haber por cuenta contable a nivel organizacion
• Los totales reflejan la consolidacion de todas las sucursales
• El titulo del informe indica claramente que es una minuta consolidada

Ejemplo de Minuta de Compras

Cuenta | Descripcion                      | Debe        | Haber
-------|----------------------------------|-------------|-------------
2.1.01 | Proveedores                     |             | $800,000.00
5.1.01 | Compras Mercaderias             | $650,000.00 |
1.1.04 | IVA Credito Fiscal              | $136,500.00 |
1.1.05 | Percepciones IVA                | $13,000.00  |
-------|----------------------------------|-------------|-------------
       | TOTALES                         | $799,500.00 | $800,000.00

Nota: Los comprobantes de compra generan asientos contables que impactan en multiples cuentas. La minuta consolida estos impactos por cuenta contable sin mostrar el detalle de comprobantes individuales.

---

Frontend (Perspectiva de Negocio)

Vistas

• Generacion de Subdiario de Compras con opcion de consolidacion: La pantalla de generacion del informe incluye la opcion de activar consolidacion multi-sucursal

Interacciones del Usuario

1. Activar/desactivar consolidacion: El usuario puede marcar o desmarcar la opcion de consolidacion antes de generar el informe
2. Generar informe consolidado: Al solicitar el informe con consolidacion activa, el sistema automaticamente busca datos en todas las sucursales con gestion de compras activa
3. Visualizar origen de datos: El usuario puede ver de que sucursal proviene cada comprobante de compra
4. Verificar sucursales incluidas: El informe muestra claramente que sucursales fueron consolidadas
5. Exportar informe consolidado: Exportar a PDF/Excel manteniendo la informacion de sucursal de origen

Permisos Requeridos

Permiso	Descripcion
Ver informes de compras	Prerequisito: acceso a generar el Subdiario de Compras
Generar informes consolidados de compras	Acceso especifico para activar consolidacion multi-sucursal

Consideraciones de Permisos:

• El usuario solo ve datos consolidados de sucursales donde tiene permisos de compras
• Un usuario con permiso en una sola sucursal puede activar consolidacion (solo vera datos de esa sucursal)
• El acceso a informes consolidados requiere autorizacion especifica

Estados de Interfaz

Estado	Descripcion
Estado inicial	Consolidacion desactivada, muestra informe de sucursal actual
Estado activado	Indicador muestra "Consolidando X sucursales"
Estado cargando	Indicador de progreso durante generacion (puede tomar mas tiempo que informe simple)
Estado exito	Informe muestra claramente que es consolidado y lista sucursales incluidas
Estado error	Mensajes claros si no hay sucursales disponibles o hay errores de generacion

---

Backend (Perspectiva de Datos de Negocio)

Entidades de Negocio Involucradas

Datos de compras por sucursal:

• Comprobantes de compra (facturas, notas de credito, notas de debito)
• Detalle de importes (gravado, exento, no gravado)
• IVA Credito Fiscal por alicuota
• Percepciones aplicadas
• Retenciones aplicadas
• Datos del proveedor

Configuracion:

• Lista de sucursales con gestion de compras activa
• Permisos del usuario por sucursal

Resultado consolidado:

• Comprobantes agregados con identificacion de origen
• Totales consolidados por concepto
• Desglose por sucursal

Datos Necesarios para el Informe

Para cada comprobante de compra se requiere:

Dato	Descripcion
Fecha del comprobante	Fecha de emision
Tipo de comprobante	Factura A, FC B, NC A, NC B, ND A, ND B, etc.
Numero de comprobante	Punto de venta + numero
Datos del proveedor	Razon social, CUIT
Importe gravado	Importe neto gravado
Importe no gravado	Importe no gravado (opcional)
Importe exento	Importe exento (opcional)
IVA Credito Fiscal	Por alicuota aplicada
Percepciones	Por tipo de percepcion
Retenciones	Por tipo de retencion
Total del comprobante	Suma de todos los conceptos
Sucursal de origen	Identificacion de la sucursal

Relaciones de Negocio

• Cada comprobante de compra pertenece a una sucursal especifica
• Cada comprobante esta asociado a un proveedor
• Los comprobantes contienen uno o mas conceptos de IVA, percepciones o retenciones
• Los proveedores pueden tener operaciones en multiples sucursales

Validaciones de Negocio

Validacion	Descripcion
Rango de fechas valido	El periodo solicitado debe ser valido (fecha desde <= fecha hasta)
Gestion de compras activa	Solo se incluyen sucursales donde existe gestion de compras activa
Permisos de usuario	El usuario debe tener permisos de compras en cada sucursal incluida
Modo de operacion	El modo seleccionado (Prueba/Oficial/Consolidado) debe ser valido

---

Reglas de Negocio

RN-COMPRA-001: Numeracion de comprobantes preservada por sucursal

Descripcion: Cada sucursal mantiene su propia numeracion de comprobantes de compra. El numero de comprobante proviene del proveedor.

Condicion: Al consolidar comprobantes de multiples sucursales.

Comportamiento:

• Preservar numero de comprobante original
• Identificar sucursal de origen para cada comprobante
• Pueden existir comprobantes del mismo proveedor con mismo numero en distintas sucursales

---

RN-COMPRA-002: Integridad de totales consolidados

Descripcion: Los totales consolidados deben ser exactamente iguales a la suma de los totales de cada sucursal individual.

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 (por alicuota)
• Total percepciones consolidado = suma de percepciones de todas las sucursales (por tipo)
• Total retenciones consolidado = suma de retenciones de todas las sucursales (por tipo)
• Total general consolidado = suma de totales de todas las sucursales

---

RN-COMPRA-003: Solo sucursales con gestion de compras activa

Descripcion: La consolidacion solo incluye sucursales donde existe gestion de compras configurada y activa.

Condicion: Al determinar que sucursales incluir en la consolidacion.

Comportamiento:

• Verificar configuracion de gestion de compras por sucursal
• Excluir sucursales sin gestion de compras activa
• Informar al usuario cuantas y cuales sucursales se consolidan

---

RN-COMPRA-004: Visibilidad limitada por permisos

Descripcion: El usuario solo visualiza datos consolidados de sucursales donde posee permisos de compras.

Condicion: Al generar informe consolidado.

Comportamiento:

• Verificar permisos del usuario en cada sucursal antes de incluir datos
• Usuario con permisos en todas las sucursales ve consolidacion completa
• Usuario con permisos parciales ve consolidacion de sus sucursales autorizadas
• El informe indica que sucursales fueron incluidas (no muestra sucursales sin acceso)

---

RN-COMPRA-005: Percepciones y retenciones consolidadas por tipo

Descripcion: Las percepciones y retenciones se consolidan manteniendo su clasificacion por tipo.

Condicion: Al agregar datos de percepciones y retenciones.

Comportamiento:

• Percepciones IVA de todas las sucursales se suman en una columna
• Percepciones IIBB de todas las sucursales se suman en una columna
• Retenciones Ganancias de todas las sucursales se suman en una columna
• Retenciones IIBB de todas las sucursales se suman en una columna
• Cada tipo mantiene su total separado para cumplir requerimientos fiscales

---

RN-COMPRA-006: Notas de credito con valores negativos

Descripcion: Las notas de credito de proveedores se muestran con valores negativos en el informe.

Condicion: Al incluir notas de credito en el informe consolidado.

Comportamiento:

• Importes de NC se muestran con signo negativo
• Los totales consolidados reflejan el efecto de las NC (restan del total)
• Mismo comportamiento que en informe individual

---

RN-COMPRA-007: Columnas dinamicas en consolidado

Descripcion: Las columnas de IVA, percepciones y retenciones se muestran dinamicamente segun existan datos.

Condicion: Al generar informe consolidado.

Comportamiento:

• Si ninguna sucursal tiene IVA 27%, no aparece esa columna
• Si al menos una sucursal tiene Percepcion IIBB, aparece esa columna para todas
• Orden de columnas dinamicas es consistente (mismo orden que informe individual)

---

Casos de Uso

UC-001: Generar Subdiario de Compras Consolidado para Periodo Fiscal

Actor: Responsable de compras / Contador / Gerente administrativo

Precondiciones:

• Usuario tiene permisos de compras en al menos dos sucursales
• Existen comprobantes de compra en el periodo seleccionado
• Al menos una sucursal tiene gestion de compras activa

Flujo principal:

1. Usuario accede a "Informes > Subdiario de Compras"
2. Usuario selecciona periodo (fecha desde / fecha hasta)
3. Usuario selecciona modo (Prueba / Oficial / Consolidado)
4. Usuario activa opcion "Consolidar sucursales"
5. Sistema muestra "Se consolidaran X sucursales"
6. Usuario confirma generacion
7. Sistema obtiene comprobantes de compra de cada sucursal con gestion activa
8. Sistema combina comprobantes cronologicamente
9. Sistema agrega identificacion de sucursal a cada comprobante
10. Sistema calcula totales consolidados
11. Sistema presenta informe consolidado

Postcondiciones:

• Usuario visualiza Subdiario de Compras con datos de todas las sucursales
• Cada comprobante indica sucursal de origen
• Totales consolidados son correctos
• Informe indica que es consolidado

Flujos alternativos:

• Sin comprobantes: Si no hay comprobantes en el periodo, mostrar mensaje informativo
• Una sola sucursal: Si usuario solo tiene permisos en una sucursal, informe muestra datos de esa sucursal (igual que sin consolidar)
• Error de conexion: Si hay error al obtener datos de una sucursal, informar y continuar con las demas

---

UC-002: Generar Informe Consolidado para Negociacion con Proveedores

Actor: Gerente de compras / Responsable de negociaciones

Precondiciones:

• Usuario tiene permisos de compras en todas las sucursales
• Existe historial de compras con proveedores
• Se requiere vision consolidada para negociar condiciones

Flujo principal:

1. Usuario accede a generacion de Subdiario de Compras
2. Usuario selecciona periodo amplio (ej: ultimo ano)
3. Usuario activa consolidacion
4. Usuario genera informe
5. Sistema presenta datos consolidados de todas las sucursales
6. Usuario analiza volumenes de compra por proveedor
7. Usuario exporta informe para reunion de negociacion

Postcondiciones:

• Usuario tiene vision del volumen total de compras de la organizacion
• Puede identificar proveedores principales por volumen
• Dispone de informacion para negociar mejores condiciones comerciales

---

UC-003: Exportar Subdiario de Compras Consolidado para Auditoria

Actor: Auditor interno / Auditor externo / Contador

Precondiciones:

• Proceso de auditoria en curso
• Requerimiento de informacion de compras consolidada
• Usuario tiene permisos de acceso a datos de compras

Flujo principal:

1. Auditor solicita Subdiario de Compras del periodo auditado
2. Usuario genera informe con consolidacion activa
3. Sistema presenta informe con datos de todas las sucursales
4. Usuario verifica que todas las sucursales estan incluidas
5. Usuario exporta a Excel/PDF
6. Exportacion mantiene columna de sucursal de origen
7. Auditor recibe informe completo para revision

Postcondiciones:

• Auditor dispone de vision completa de compras de la organizacion
• Puede rastrear cada comprobante a su sucursal de origen
• Totales permiten validacion contra otras fuentes

---

UC-004: Preparar Declaracion Jurada de IVA Consolidada

Actor: Contador / Responsable impositivo

Precondiciones:

• Periodo fiscal a declarar
• Requiere totales de IVA Credito Fiscal consolidados
• Requiere totales de percepciones y retenciones

Flujo principal:

1. Usuario genera Subdiario de Compras consolidado del periodo fiscal
2. Sistema presenta totales de IVA por alicuota consolidados
3. Sistema presenta totales de percepciones por tipo
4. Sistema presenta totales de retenciones por tipo
5. Usuario utiliza totales para preparar declaracion jurada
6. Usuario verifica que totales consolidados coinciden con suma de sucursales

Postcondiciones:

• Usuario tiene totales fiscales consolidados para declaracion
• Totales de IVA CF estan desglosados por alicuota
• Percepciones y retenciones estan correctamente clasificadas

---

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 de ninguna sucursal
Datos sensibles de proveedores	El informe contiene datos de proveedores (CUIT, razon social) que deben protegerse
Auditoria de acceso	Registrar cuando se generan informes consolidados para control

Auditoria

Eventos a registrar:

Evento	Datos a Capturar
Generacion de informe consolidado	Usuario, fecha/hora, tipo de informe
Sucursales incluidas	Lista de sucursales consolidadas
Parametros del informe	Periodo consultado, modo de operacion
Exportacion	Formato de exportacion (PDF/Excel), fecha/hora

Rendimiento

Expectativas de tiempo de respuesta:

Escenario	Tiempo Esperado
2-5 sucursales	5-15 segundos
6-10 sucursales	15-30 segundos
10+ sucursales	hasta 60 segundos

Indicadores de progreso:

• Para operaciones mayores a 3 segundos, mostrar indicador de progreso
• Informar al usuario cuantas sucursales se estan procesando
• Considerar generacion asincrona para volumenes muy grandes

Factores que afectan rendimiento:

• Cantidad de sucursales a consolidar
• Volumen de comprobantes en el periodo
• Cantidad de conceptos (alicuotas IVA, percepciones, retenciones)

---

Dependencias

Funcionalidades Relacionadas

• Sistema de informes de compras existente (Subdiario de Compras individual)
• Gestion de sucursales de la organizacion
• Sistema de permisos por sucursal
• Configuracion de gestion de compras activa por sucursal
• Exportacion de informes a Excel/PDF

Integraciones con Otros Modulos

Modulo	Relacion
Administracion	Lista de sucursales activas
Seguridad	Verificacion de permisos por sucursal
Contabilidad	Patron de consolidacion implementado (referencia)

---

Criterios de Aceptacion

Funcionalidad Base

• [ ] AC-001: Usuario puede activar consolidacion mediante parametro consolidado: true
• [ ] AC-002: Con consolidacion activa, informe muestra datos de todas las sucursales con gestion de compras activa
• [ ] AC-003: Informe indica claramente en el titulo que es consolidado
• [ ] AC-004: Totales consolidados son correctos (igual a suma de totales de cada sucursal)
• [ ] AC-005: Cada linea del informe identifica sucursal de origen
• [ ] AC-006: Percepciones se consolidan correctamente por tipo
• [ ] AC-007: Retenciones se consolidan correctamente por tipo
• [ ] AC-008: Sin consolidacion, informe muestra solo sucursal actual (comportamiento existente preservado)

Datos del Informe

• [ ] AC-009: Comprobantes se ordenan cronologicamente en el consolidado
• [ ] AC-010: Notas de credito se muestran con valores negativos
• [ ] AC-011: IVA Credito Fiscal se totaliza por alicuota
• [ ] AC-012: Columnas dinamicas funcionan correctamente (solo aparecen si hay datos)
• [ ] AC-013: Datos de proveedor (razon social, CUIT) se muestran correctamente

Seguridad y Permisos

• [ ] AC-014: Usuario solo ve datos de sucursales donde tiene permisos
• [ ] AC-015: Informe lista que sucursales fueron incluidas
• [ ] AC-016: Se registra en auditoria la generacion de informes consolidados

Exportacion

• [ ] AC-017: Exportacion a Excel mantiene columna de sucursal de origen
• [ ] AC-018: Exportacion a PDF indica que es informe consolidado
• [ ] AC-019: Totales en exportaciones son correctos

Rendimiento

• [ ] AC-020: Indicador de progreso para operaciones mayores a 3 segundos
• [ ] AC-021: Tiempo de respuesta aceptable segun volumen (ver tabla de rendimiento)

---

Extensiones Futuras

Seleccion Manual de Sucursales

Permitir al usuario seleccionar manualmente que sucursales incluir en la consolidacion:

• Selector visual con checkboxes
• Persistencia de seleccion durante la sesion
• Opcion "Seleccionar todas" / "Deseleccionar todas"

Nota: Funcionalidad opcional, puede implementarse despues de consolidacion automatica basica.

Filtro por Proveedor en Consolidado

Permitir filtrar el informe consolidado por proveedor especifico:

• Ver todas las compras a un proveedor en todas las sucursales
• Util para analisis de volumen por proveedor
• Facilita negociaciones

Comparativa entre Sucursales

Generar informe comparativo que muestre:

• Totales de compra por sucursal
• Porcentaje de participacion de cada sucursal
• Ranking de sucursales por volumen de compra

Otras Mejoras

• Informes consolidados programados (generacion automatica periodica)
• Dashboard con indicadores de compras consolidados
• Alertas basadas en datos consolidados (ej: proveedor supera umbral)
• Exportacion con multiples hojas (una 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 compras. Basado en patron arquitectural de consolidacion multi-schema y referencia de implementacion en modulo de Contabilidad.