Documentación del Sistema

Appearance

Consolidación de Informes Contables ​

Módulo: Contabilidad Tipo: Process Estado: Implementado (Parcial) Fecha: 2025-12-31

📚 Patrón Arquitectural: Este documento implementa el patrón general de consolidación multi-schema. Para entender la arquitectura completa, niveles de schema, y reglas arquitecturales, consultar: /docs/architecture/consolidacion-informes-multi-schema.md

Descripción ​

Problema de Negocio ​

Las organizaciones con múltiples sucursales necesitan obtener una visión unificada de su situación contable. Actualmente, cada sucursal gestiona su contabilidad de forma independiente, obligando a los usuarios a generar reportes individuales y consolidarlos manualmente.

Solución Propuesta ​

Implementar consolidación automática de informes contables que permita generar reportes unificados combinando datos de todas las sucursales con contabilidad activa. El usuario activa la consolidación mediante un indicador visual al generar cualquier informe contable.

Valor de Negocio ​

  • Visión empresarial unificada: Decisiones basadas en datos de toda la organización
  • Reducción de errores: Elimina consolidación manual
  • Ahorro de tiempo: Automatiza proceso que requiere trabajo manual significativo
  • Trazabilidad completa: Identifica origen de cada dato para auditoría
  • Cumplimiento normativo: Facilita estados financieros consolidados requeridos

Informes Contables con Consolidación ​

Los siguientes informes contables soportarán consolidación multi-schema:

1. Balance de Comprobación ✅ IMPLEMENTADO ​

Descripción: Muestra saldos de todas las cuentas contables al cierre de un período.

Estado de Implementación: ✅ Completado (2025-12-31)

Consolidación:

  • Datos maestros: Plan de cuentas compartido desde nivel empresa (único para toda la organización)
  • Datos transaccionales: Movimientos de todas las sucursales donde existe contabilidad activa
  • Agregación: Suma automática de debe, haber y saldos por cuenta contable
  • Alcance: Consolida TODAS las sucursales de la organización, independientemente de la sucursal donde esté ubicado el usuario
  • Presentación:
    • Total consolidado por cuenta
    • Título indica claramente cuando el informe es consolidado
    • Totales reflejan la suma de todas las sucursales

Activación:

  • Parámetro consolidado: true en la solicitud del informe
  • Compatible con los tres modos de operación:
    • Modo 0 (Prueba): Consolida datos de prueba de todas las sucursales
    • Modo 1 (Oficial): Consolida datos oficiales de todas las sucursales
    • Modo 2 (Consolidado Modo): Consolida datos oficiales + prueba de todas las sucursales

Columnas del informe:

  • Número de cuenta
  • Descripción de cuenta
  • Saldo anterior consolidado
  • Debe del período consolidado
  • Haber del período consolidado
  • Saldo del período
  • Saldo del ejercicio

2. Libro Diario General ​

Descripción: Lista cronológica de todos los asientos contables.

Consolidación:

  • Datos maestros: Plan de cuentas desde public
  • Datos transaccionales: Asientos desde schemas de cada sucursal
  • Agregación: Orden cronológico manteniendo origen
  • Presentación:
    • Asientos de todas las sucursales ordenados por fecha
    • Identificación clara de sucursal de origen
    • Numeración de asientos preservada por sucursal

Columnas típicas:

  • Fecha
  • Número de asiento
  • Sucursal de origen
  • Cuenta
  • Detalle
  • Debe
  • Haber

3. Libro Mayor ​

Descripción: Muestra movimientos de una cuenta contable específica.

Consolidación:

  • Datos maestros: Cuenta contable desde public
  • Datos transaccionales: Movimientos de la cuenta desde schemas de cada sucursal
  • Agregación: Movimientos ordenados cronológicamente
  • Presentación:
    • Saldo anterior consolidado
    • Movimientos de todas las sucursales ordenados por fecha
    • Identificación de sucursal por movimiento
    • Saldo acumulado consolidado

Columnas típicas:

  • Fecha
  • Comprobante
  • Sucursal de origen
  • Detalle
  • Debe
  • Haber
  • Saldo acumulado

4. Balance General (Estado de Situación Patrimonial) ​

Descripción: Estado financiero que muestra activos, pasivos y patrimonio.

Consolidación:

  • Datos maestros: Plan de cuentas y estructura desde public
  • Datos transaccionales: Saldos desde schemas de cada sucursal
  • Agregación: Suma de saldos por cuenta, agrupados por rubro
  • Presentación:
    • Activos consolidados (Corriente + No Corriente)
    • Pasivos consolidados (Corriente + No Corriente)
    • Patrimonio Neto consolidado
    • Verificación: Activo = Pasivo + Patrimonio

Estructura:

ACTIVO
  Activo Corriente
    - Caja y Bancos (consolidado)
    - Créditos (consolidado)
    - Bienes de Cambio (consolidado)
  Activo No Corriente
    - Bienes de Uso (consolidado)

PASIVO
  Pasivo Corriente
    - Deudas Comerciales (consolidado)
    - Deudas Financieras (consolidado)
  Pasivo No Corriente

PATRIMONIO NETO
  - Capital (consolidado)
  - Resultados Acumulados (consolidado)

5. Estado de Resultados (Ganancias y Pérdidas) ​

Descripción: Estado financiero que muestra ingresos, costos y gastos del período.

Consolidación:

  • Datos maestros: Plan de cuentas de resultados desde public
  • Datos transaccionales: Movimientos de cuentas de resultados desde schemas
  • Agregación: Suma de movimientos por cuenta de resultado
  • Presentación:
    • Ventas consolidadas
    • Costo de Ventas consolidado
    • Gastos consolidados
    • Resultado consolidado (Utilidad o Pérdida)

Estructura:

+ Ventas (consolidadas)
- Costo de Ventas (consolidado)
= Utilidad Bruta (consolidada)

- Gastos de Administración (consolidados)
- Gastos de Comercialización (consolidados)
= Resultado Operativo (consolidado)

+ Ingresos Financieros (consolidados)
- Gastos Financieros (consolidados)
= Resultado del Ejercicio (consolidado)

Frontend ​

Vistas ​

  • Reportes contables con opción de consolidación: Todas las pantallas de generación de reportes incluyen checkbox/toggle "Consolidar sucursales"
  • Visualización de reporte consolidado: Reportes muestran claramente que son consolidados e incluyen desglose por sucursal

Interacciones del Usuario ​

  1. Activar/desactivar consolidación: Checkbox o toggle antes de generar reporte
  2. Generar reporte consolidado: Sistema busca datos en todos los schemas elegibles automáticamente
  3. Identificar origen de datos: Ver de qué sucursal proviene cada línea
  4. Comparar datos entre sucursales: Visualizar composición del total
  5. Exportar reporte consolidado: Exportar a PDF/Excel manteniendo información de origen

Permisos ​

PermisoDescripción
CONTABILIDAD_INF_CONSOLIDADOSAcceso a generar informes consolidados
CONTABILIDAD_INFPrerequisito: acceso a informes contables básicos

Consideraciones:

  • Usuario solo ve datos consolidados de sucursales donde tiene permisos de contabilidad
  • Usuario con permiso en una sola sucursal puede activar consolidación (solo verá datos de esa sucursal)

Estados de UI ​

  • Estado inicial: Consolidación desactivada (muestra solo schema actual)
  • Estado activado: Indicador muestra "Consolidando X sucursales"
  • Estado cargando: Indicador de progreso durante generación (puede tomar más tiempo)
  • Estado éxito: Reporte muestra claramente que es consolidado y lista sucursales incluidas
  • Estado error: Mensajes claros si no hay sucursales disponibles o hay errores

Backend ​

Entidades de Negocio Específicas ​

Datos contables por sucursal:

  • Asientos contables
  • Movimientos contables
  • Saldos de cuentas

Configuración:

  • Lista de schemas con contabilidad activa
  • Permisos del usuario por sucursal

Resultado consolidado:

  • Datos agregados con identificación de origen
  • Totales consolidados
  • Desglose por sucursal

Reglas de Negocio Específicas ​

RN-CONT-001: Ecuación contable en consolidado ​

Descripción: El Balance General consolidado debe cumplir la ecuación contable.

Condición: Al generar Balance General consolidado.

Comportamiento:

  • Activo consolidado = Pasivo consolidado + Patrimonio consolidado
  • Si no se cumple, alertar al usuario de inconsistencias

RN-CONT-002: Períodos contables compartidos ​

Descripción: Los ejercicios contables están en LEVEL_EMPRESA, todas las sucursales comparten los mismos períodos.

Condición: Al solicitar consolidación con fechas específicas.

Comportamiento:

  • Validar que el período solicitado existe en el ejercicio contable activo
  • No validar compatibilidad entre sucursales (todas comparten ejercicios)

RN-CONT-003: Asientos balanceados ​

Descripción: Cada asiento contable debe estar balanceado (debe = haber) incluso en consolidado.

Condición: Al consolidar Libro Diario.

Comportamiento:

  • Verificar balance de cada asiento individualmente
  • Verificar balance total consolidado
  • Alertar si hay asientos desbalanceados

Casos de Uso ​

UC-001: Generar Balance de Comprobación Consolidado ​

Actor: Contador con permisos en múltiples sucursales

Precondiciones:

  • Usuario tiene permisos de contabilidad en al menos dos sucursales
  • Existe ejercicio contable activo
  • Hay datos contables en el período seleccionado

Flujo principal:

  1. Usuario accede a "Informes > Balance de Comprobación"
  2. Usuario selecciona período (mes/año o rango de fechas)
  3. Usuario activa opción "Consolidar sucursales"
  4. Sistema muestra "Se consolidarán X sucursales"
  5. Usuario confirma generación
  6. Sistema consulta plan de cuentas desde public
  7. Sistema consulta movimientos de cada schema con contabilidad activa
  8. Sistema agrega saldos por cuenta contable
  9. Sistema presenta balance consolidado
  10. Balance muestra totales consolidados y desglose por sucursal

Postcondiciones:

  • Usuario visualiza balance con datos de todas las sucursales
  • Puede identificar origen de cada dato
  • Totales consolidados son correctos

UC-002: Generar Estado de Resultados Consolidado ​

Actor: Gerente o Director Financiero

Precondiciones:

  • Usuario tiene permisos de contabilidad en todas las sucursales
  • Existe ejercicio contable cerrado o en curso

Flujo principal:

  1. Usuario accede a "Informes > Estado de Resultados"
  2. Usuario selecciona ejercicio o período
  3. Usuario activa consolidación
  4. Sistema genera estado de resultados consolidado
  5. Sistema muestra:
    • Ventas consolidadas de todas las sucursales
    • Costos consolidados
    • Gastos consolidados
    • Resultado del ejercicio consolidado

Postcondiciones:

  • Usuario tiene visión financiera global de la organización
  • Resultado consolidado refleja performance de todas las sucursales

Consideraciones ​

Seguridad ​

  • Validación de permisos por sucursal antes de incluir datos
  • Consolidación es solo lectura - no modifica datos originales
  • Auditar generación de reportes consolidados

Auditoría ​

Eventos a registrar:

  • Generación de informe consolidado (tipo, usuario, timestamp)
  • Sucursales incluidas en consolidación
  • Parámetros del reporte (fechas, cuentas, etc.)

Rendimiento ​

Expectativas:

  • 2-5 sucursales: 5-10 segundos
  • 10+ sucursales: hasta 30-60 segundos
  • Mostrar progreso para operaciones > 3 segundos

Optimizaciones:

  • Caché de plan de cuentas (se consulta una vez)
  • Consultas paralelas a schemas cuando sea posible
  • Considerar generación asíncrona para grandes volúmenes

Dependencias ​

Funcionalidades relacionadas:

  • Sistema de informes contables existente
  • Gestión de sucursales/schemas
  • Sistema de permisos por sucursal
  • Configuración de contabilidad activa

Integraciones:

  • Módulo de Administración: lista de sucursales
  • Módulo de Seguridad: verificación de permisos

Criterios de Aceptación ​

Balance de Comprobación (Implementado) ​

  • [x] AC-001: Usuario puede activar consolidación mediante parámetro consolidado: true
  • [x] AC-002: Con consolidación activa, reportes muestran datos de todas las sucursales con contabilidad activa
  • [x] AC-004: Sin consolidación, reportes muestran solo schema actual (comportamiento existente)
  • [x] AC-006: Reportes indican claramente que son consolidados en el título
  • [x] AC-007: Totales consolidados son correctos (suma de todas las sucursales)

Pendientes (Informes restantes) ​

  • [ ] AC-001b: Activar consolidación en Libro Diario General
  • [ ] AC-001c: Activar consolidación en Libro Mayor
  • [ ] AC-001d: Activar consolidación en Balance General
  • [ ] AC-001e: Activar consolidación en Estado de Resultados

Mejoras Futuras ​

  • [ ] AC-003: Usuario puede identificar origen (sucursal) de cada dato en el informe (columna adicional)
  • [ ] AC-005: Sistema muestra cuántas sucursales se consolidarán antes de generar
  • [ ] AC-008: Exportación a Excel mantiene columna de origen
  • [ ] AC-009: Indicador de progreso durante generación
  • [ ] AC-010: Balance General consolidado cumple ecuación contable (Activo = Pasivo + Patrimonio)
  • [ ] AC-011: Se registra en auditoría generación de reportes consolidados
  • [ ] AC-012: Optimización de rendimiento para más de 5 sucursales

Extensiones Futuras ​

Selección de Sucursales ​

Permitir al usuario seleccionar manualmente qué sucursales incluir en lugar de todas:

  • Selector con checkboxes
  • Persistencia durante la sesión
  • Filtrado de resultados por sucursal

Nota: Funcionalidad opcional, puede implementarse después de consolidación automática básica.

Otras Mejoras ​

  • Informes consolidados programados
  • Comparativas período actual vs. anterior consolidadas
  • Exportación con múltiples hojas (una por sucursal)
  • Dashboard con KPIs consolidados en tiempo real

Historial de Cambios ​

FechaVersionAutorDescripcion
2025-12-301.0SistemaReestructuración: documento específico de contabilidad. Extracción de conceptos arquitecturales generales a /docs/architecture/consolidacion-informes-multi-schema.md. Definición de informes contables específicos que soportarán consolidación.
2025-12-311.1SistemaImplementación de consolidación multi-schema en Balance de Comprobación. Actualización de estado a "Implementado (Parcial)". La consolidación incluye todas las sucursales de la organización donde existe contabilidad activa, sin restricción por sucursal del usuario. Compatible con los tres modos de operación (Prueba, Oficial, Consolidado).