Documentación del Sistema

Appearance

Balance de Sumas y Saldos - Modos de Operacion ​

Modulo: Contabilidad Tipo: Process Estado: Implementado Fecha: 2025-12-31

Referencia Arquitectural: Este documento implementa el patron de consolidacion multi-schema. Para contexto general, consultar:

Descripcion General ​

Proposito ​

El Balance de Sumas y Saldos (tambien conocido como Balance de Comprobacion) debe soportar tres modos de operacion que permiten al usuario seleccionar el origen de los datos contables a consultar. Estos modos determinan si el informe muestra datos de prueba, datos oficiales, o una vista consolidada de ambos.

Problema de Negocio ​

Actualmente el Balance de Sumas y Saldos opera unicamente con datos oficiales. Las organizaciones necesitan:

  1. Simular escenarios contables antes de oficializarlos (modo prueba)
  2. Generar reportes oficiales para presentacion ante terceros (modo oficial)
  3. Obtener una vision completa que incluya tanto movimientos oficiales como proyecciones en prueba (modo consolidado)

Valor de Negocio ​

  • Planificacion financiera: Permite simular asientos y ver su impacto antes de oficializarlos
  • Cumplimiento normativo: Separacion clara entre datos oficiales y proyecciones
  • Toma de decisiones: Vision completa del estado contable incluyendo operaciones pendientes de oficializacion
  • Auditoria: Trazabilidad clara del origen de cada movimiento

Modos de Operacion ​

Modo 0: Solo Prueba ​

Descripcion: El informe muestra exclusivamente los movimientos contables registrados en el ambiente de prueba.

Casos de Uso:

  • Simular el impacto de asientos contables antes de oficializarlos
  • Evaluar proyecciones financieras
  • Capacitacion de personal sin afectar datos oficiales
  • Pruebas de cierre de ejercicio

Datos Incluidos:

  • Movimientos contables del ambiente de prueba
  • Saldos anteriores calculados desde el ambiente de prueba

Datos Excluidos:

  • Movimientos contables oficiales
  • Saldos del ambiente oficial

Comportamiento Esperado:

  • El informe utiliza el titulo estandar "BALANCE DE SUMAS Y SALDOS" (sin indicacion especial de modo)
  • Los totales reflejan unicamente operaciones de prueba
  • Los saldos anteriores corresponden al acumulado de prueba

Modo 1: Solo Oficial ​

Descripcion: El informe muestra exclusivamente los movimientos contables oficiales de la organizacion. Este es el modo por defecto y el utilizado para reportes formales.

Casos de Uso:

  • Generacion de estados financieros para presentacion externa
  • Reportes para auditores
  • Cumplimiento de obligaciones fiscales
  • Analisis financiero sobre datos reales

Datos Incluidos:

  • Movimientos contables oficiales
  • Saldos anteriores oficiales

Datos Excluidos:

  • Movimientos contables de prueba
  • Proyecciones o simulaciones

Comportamiento Esperado:

  • El informe utiliza el titulo estandar "BALANCE DE SUMAS Y SALDOS" (sin indicacion especial, es el modo por defecto)
  • Los totales reflejan la situacion contable real de la organizacion
  • Cumple con requisitos de presentacion formal

Modo 2: Consolidado (Oficial + Prueba) ​

Descripcion: El informe combina los movimientos contables de ambos ambientes (oficial y prueba), proporcionando una vision completa del estado contable actual y proyectado.

Casos de Uso:

  • Visualizar el impacto total incluyendo operaciones pendientes de oficializar
  • Planificacion de flujo de fondos considerando compromisos en prueba
  • Analisis de escenarios "what-if" sobre la base oficial
  • Revision previa a cierre de periodo incluyendo ajustes propuestos

Datos Incluidos:

  • Movimientos contables oficiales
  • Movimientos contables de prueba
  • Saldos anteriores consolidados (oficial + prueba)

Comportamiento Esperado:

  • El informe indica claramente "BALANCE DE SUMAS Y SALDOS - CONSOLIDADO" en el titulo
  • Los totales reflejan la suma de ambos ambientes
  • El usuario puede identificar que la informacion incluye datos de prueba mediante la indicacion en el titulo

Reglas de Negocio ​

RN-BCM-001: Fuente de Datos Maestros ​

Descripcion: La informacion de cuentas contables (codigo, nombre, tipo, nivel) siempre se obtiene del ambiente oficial, independientemente del modo seleccionado.

Justificacion: El plan de cuentas es unico para la organizacion y reside en el nivel empresa. No existe plan de cuentas separado por ambiente.

Comportamiento:

  • En modo 0 (prueba): Las cuentas se obtienen del maestro oficial
  • En modo 1 (oficial): Las cuentas se obtienen del maestro oficial
  • En modo 2 (consolidado): Las cuentas se obtienen del maestro oficial

RN-BCM-002: Calculo de Saldos Anteriores por Modo ​

Descripcion: Los saldos anteriores al periodo seleccionado se calculan segun el modo de operacion.

Comportamiento:

  • Modo 0: Saldo anterior = Acumulado de movimientos de prueba hasta fecha inicio - 1
  • Modo 1: Saldo anterior = Acumulado de movimientos oficiales hasta fecha inicio - 1
  • Modo 2: Saldo anterior = Acumulado oficial + Acumulado prueba hasta fecha inicio - 1

RN-BCM-003: Calculo de Movimientos del Periodo por Modo ​

Descripcion: Los movimientos del periodo (Debe y Haber) se calculan segun el modo seleccionado.

Comportamiento:

  • Modo 0: Movimientos = Solo transacciones de prueba en el periodo
  • Modo 1: Movimientos = Solo transacciones oficiales en el periodo
  • Modo 2: Movimientos = Transacciones oficiales + Transacciones de prueba en el periodo

RN-BCM-004: Integridad del Balance ​

Descripcion: En cualquier modo de operacion, el balance debe cumplir la ecuacion contable fundamental.

Validacion:

  • Total Debe = Total Haber (para movimientos del periodo)
  • La diferencia Debe - Haber debe ser igual al cambio en patrimonio neto

Comportamiento:

  • Si el balance no cuadra, el sistema debe alertar al usuario
  • La alerta debe indicar la diferencia y el modo de operacion

RN-BCM-005: Ejercicio Contable Compartido ​

Descripcion: El ejercicio contable seleccionado aplica por igual a ambos ambientes (oficial y prueba).

Justificacion: Los ejercicios contables residen en el nivel empresa y son compartidos por toda la organizacion.

Comportamiento:

  • El filtro de ejercicio aplica tanto a consultas oficiales como de prueba
  • No es posible consultar diferentes ejercicios por ambiente en el modo consolidado

RN-BCM-006: Cuentas sin Movimientos ​

Descripcion: Las cuentas que no tienen movimientos en el periodo seleccionado pueden mostrarse u ocultarse segun configuracion.

Comportamiento por Modo:

  • Una cuenta puede tener movimientos en oficial pero no en prueba (o viceversa)
  • En modo consolidado, la cuenta aparece si tiene movimientos en al menos uno de los ambientes
  • El saldo de la cuenta refleja solo los ambientes donde tiene movimientos

RN-BCM-007: Ordenamiento de Cuentas ​

Descripcion: El ordenamiento de las cuentas es consistente independientemente del modo de operacion.

Comportamiento:

  • Las cuentas se ordenan por codigo de cuenta
  • La estructura jerarquica (rubros, subrubros) se mantiene en todos los modos
  • Los subtotales se calculan segun los datos del modo seleccionado

Entidades Involucradas ​

Cuentas Contables ​

Ubicacion: Nivel Empresa (datos maestros compartidos)

Atributos Relevantes:

  • Codigo de cuenta
  • Descripcion/Nombre
  • Tipo de cuenta (Activo, Pasivo, Patrimonio, Resultado)
  • Nivel jerarquico (Rubro, Subrubro, Cuenta imputada)
  • Indicador de cuenta imputada (admite movimientos)

Rol en el Informe: Estructura base del balance, identica para todos los modos.

Movimientos Contables ​

Ubicacion: Nivel Sucursal o Caja (segun configuracion)

Atributos Relevantes:

  • Cuenta contable afectada
  • Importe al Debe
  • Importe al Haber
  • Fecha del movimiento
  • Numero de asiento
  • Detalle/Concepto

Rol en el Informe: Datos transaccionales que varian segun el modo de operacion.

Ejercicios Contables ​

Ubicacion: Nivel Empresa (datos maestros compartidos)

Atributos Relevantes:

  • Periodo (mes/ano o rango de fechas)
  • Estado (Abierto, Cerrado)
  • Fecha inicio
  • Fecha fin

Rol en el Informe: Filtro temporal que aplica a todos los modos.

Flujo de Usuario ​

Generacion del Informe por Modo ​

1. Usuario accede a "Informes > Balance de Comprobacion"

2. Usuario selecciona parametros:
   - Ejercicio contable
   - Periodo (mes/ano o rango de fechas)
   - Modo de operacion: Prueba | Oficial | Consolidado

3. Sistema valida parametros:
   - Ejercicio existe y tiene movimientos
   - Periodo es valido dentro del ejercicio
   - Usuario tiene permisos para el modo seleccionado

4. Sistema genera el informe:
   a) Obtiene estructura de cuentas (siempre desde maestro oficial)
   b) Segun modo seleccionado:
      - Modo 0: Consulta movimientos de prueba
      - Modo 1: Consulta movimientos oficiales
      - Modo 2: Consulta ambos y consolida
   c) Calcula saldos anteriores segun modo
   d) Calcula movimientos del periodo segun modo
   e) Calcula saldos finales

5. Sistema presenta resultados:
   - Indica modo de operacion en encabezado
   - Muestra balance con estructura jerarquica
   - Incluye subtotales por rubro
   - Muestra total general

Consideraciones Especiales ​

Ambiente de Prueba ​

Caracteristicas:

  • Contiene solo datos transaccionales (movimientos)
  • No contiene datos maestros (cuentas, ejercicios)
  • Los movimientos de prueba no afectan reportes oficiales
  • Puede contener asientos sin oficializar o simulaciones

Implicacion para el Balance:

  • Al consultar datos de prueba, la estructura de cuentas proviene del ambiente oficial
  • La relacion entre movimiento y cuenta se establece mediante el codigo de cuenta

Consolidacion de Datos ​

Proceso de Consolidacion (Modo 2):

  1. Consulta de movimientos oficiales por cuenta
  2. Consulta de movimientos de prueba por cuenta
  3. Combinacion de resultados:
    • Si una cuenta tiene movimientos en ambos ambientes: se suman
    • Si una cuenta tiene movimientos solo en un ambiente: se toma ese valor
  4. Recalculo de totales consolidados

Ordenamiento en Consolidado:

  • Los movimientos se agregan por cuenta
  • No se distingue visualmente el origen (oficial vs prueba) en el balance final
  • El total consolidado es la suma de ambos ambientes

Validaciones por Modo ​

ValidacionModo 0Modo 1Modo 2
Ejercicio existeSiSiSi
Periodo validoSiSiSi
Existen movimientosEn pruebaEn oficialEn alguno
Balance cuadraOpcionalRequeridoOpcional

Casos de Uso ​

UC-BCM-001: Generar Balance Oficial para Auditoria ​

Actor: Contador

Precondiciones:

  • Usuario tiene permiso CONTAB_INF
  • Existe ejercicio contable con movimientos oficiales

Flujo:

  1. Usuario selecciona ejercicio y periodo
  2. Usuario selecciona Modo 1 (Oficial)
  3. Sistema genera balance con datos oficiales
  4. Usuario exporta a PDF para presentar a auditores

Postcondiciones:

  • Balance refleja situacion contable oficial
  • Documento apto para presentacion formal

UC-BCM-002: Simular Impacto de Asientos Propuestos ​

Actor: Analista Contable

Precondiciones:

  • Usuario tiene permisos CONTAB_INF
  • Existen asientos en ambiente de prueba

Flujo:

  1. Usuario selecciona ejercicio y periodo
  2. Usuario selecciona Modo 0 (Prueba)
  3. Sistema genera balance con datos de prueba
  4. Usuario analiza impacto de los asientos propuestos
  5. Usuario decide si oficializar los asientos

Postcondiciones:

  • Usuario tiene visibilidad del impacto de cambios propuestos
  • Datos oficiales no fueron afectados

UC-BCM-003: Revisar Estado Contable Completo ​

Actor: Gerente Financiero

Precondiciones:

  • Usuario tiene permisos CONTAB_INF
  • Existen movimientos en ambos ambientes

Flujo:

  1. Usuario selecciona ejercicio y periodo
  2. Usuario selecciona Modo 2 (Consolidado)
  3. Sistema genera balance combinando ambos ambientes
  4. Usuario visualiza estado actual + proyecciones
  5. Usuario toma decisiones considerando el panorama completo

Postcondiciones:

  • Usuario tiene vision completa del estado contable
  • Puede identificar que la informacion incluye datos no oficiales

UC-BCM-004: Comparar Estado Oficial vs Proyectado ​

Actor: Contador Senior

Precondiciones:

  • Usuario tiene todos los permisos requeridos
  • Existen movimientos en ambos ambientes

Flujo:

  1. Usuario genera balance en Modo 1 (Oficial)
  2. Usuario guarda o anota totales oficiales
  3. Usuario genera balance en Modo 2 (Consolidado)
  4. Usuario compara diferencias entre ambos reportes
  5. Usuario identifica el impacto de operaciones pendientes

Postcondiciones:

  • Usuario conoce la diferencia entre estado actual y proyectado
  • Puede priorizar oficializacion de asientos criticos

Criterios de Aceptacion ​

Funcionales ​

  • [ ] AC-BCM-001: El usuario puede seleccionar entre tres modos de operacion: Prueba, Oficial, Consolidado
  • [ ] AC-BCM-002: En modo Prueba, el balance muestra exclusivamente movimientos del ambiente de prueba
  • [ ] AC-BCM-003: En modo Oficial, el balance muestra exclusivamente movimientos del ambiente oficial
  • [ ] AC-BCM-004: En modo Consolidado, el balance muestra la suma de movimientos de ambos ambientes
  • [ ] AC-BCM-005: La estructura de cuentas es identica en los tres modos (proviene del maestro oficial)
  • [ ] AC-BCM-006: Los saldos anteriores se calculan correctamente segun el modo seleccionado
  • [x] AC-BCM-007: El encabezado del informe indica claramente el modo de operacion (solo en modo Consolidado se muestra "- CONSOLIDADO" en el titulo)
  • [ ] AC-BCM-008: Los subtotales y totales son correctos para cada modo
  • [ ] AC-BCM-009: Usuario sin permiso de prueba solo puede generar modo Oficial
  • [ ] AC-BCM-010: El balance cuadra (Debe = Haber) en cada modo de operacion

De Presentacion ​

  • [x] AC-BCM-011: El modo seleccionado se muestra visualmente en el informe generado (aplica solo a modo Consolidado)
  • [ ] AC-BCM-012: La exportacion a Excel incluye indicacion del modo de operacion
  • [ ] AC-BCM-013: La exportacion a PDF incluye indicacion del modo de operacion

De Integridad ​

  • [ ] AC-BCM-014: Si no existen movimientos en el modo seleccionado, el sistema informa al usuario
  • [ ] AC-BCM-015: Los datos oficiales nunca se mezclan con datos de prueba excepto en modo Consolidado
  • [ ] AC-BCM-016: El cambio de modo no afecta los datos almacenados, solo la consulta

Dependencias ​

Funcionalidades Relacionadas ​

  • Sistema de ejercicios contables
  • Plan de cuentas contables
  • Registro de asientos contables
  • Exportacion Excel del balance (balance-comprobacion-excel.md)
  • Consolidacion multi-schema (consolidacion-informes-contables.md)

Integraciones ​

  • Modulo de Seguridad: verificacion de permisos por modo
  • Sistema de ambientes (oficial/prueba): determinacion de fuente de datos

Consolidación Multi-Schema ​

Implementado: 2025-12-31

El Balance de Comprobación ahora soporta consolidación multi-schema además de la consolidación de modos. Ambos tipos de consolidación pueden combinarse:

Combinación de Consolidaciones ​

El informe puede consolidar en dos dimensiones independientes:

  1. Consolidación de Modos (Oficial/Prueba):

    • Modo 0: Solo datos de prueba
    • Modo 1: Solo datos oficiales
    • Modo 2: Oficial + Prueba

  2. Consolidación Multi-Schema (Sucursales):

    • Sin consolidación: Solo sucursal actual
    • Con consolidación: Todas las sucursales de la organización

Matriz de Consolidación ​

ModoConsolidación Multi-SchemaResultado
0NoDatos de prueba de la sucursal actual
0SíDatos de prueba de todas las sucursales
1NoDatos oficiales de la sucursal actual
1SíDatos oficiales de todas las sucursales
2NoDatos oficial+prueba de la sucursal actual
2SíDatos oficial+prueba de todas las sucursales

Activación ​

La consolidación multi-schema se activa mediante el parámetro consolidado: true en la solicitud del informe.

Indicación Visual ​

Cuando está activa la consolidación multi-schema o de modos, el título del informe muestra:

  • "BALANCE DE SUMAS Y SALDOS - CONSOLIDADO"

Para más detalles sobre consolidación multi-schema, consultar:

Riesgos y Mitigaciones ​

RiesgoImpactoMitigacion
Usuario confunde datos de prueba con oficialesAltoIndicacion clara y prominente del modo en el informe
Datos de prueba incompletos generan balance descuadradoMedioValidacion y alerta al usuario sobre desbalance
Performance degradada en modo consolidadoMedioOptimizacion de consultas y feedback de progreso
Acceso no autorizado a datos de pruebaAltoValidacion estricta de permisos

Historial de Cambios ​

FechaVersionAutorDescripcion
2025-12-311.2SistemaAgregada sección de Consolidación Multi-Schema documentando soporte para consolidación de todas las sucursales. El Balance ahora soporta consolidación en dos dimensiones: modos (oficial/prueba) y sucursales (multi-schema). Matriz de consolidación agregada mostrando las 6 combinaciones posibles.
2025-12-311.1SistemaSincronizacion con implementacion: Estado cambiado a Implementado. Actualizado comportamiento de indicacion visual de modo (solo modo Consolidado muestra "- CONSOLIDADO" en titulo; modos Prueba y Oficial usan titulo estandar sin indicacion especial). Actualizados criterios de aceptacion AC-BCM-007 y AC-BCM-011 como cumplidos.
2025-12-311.0SistemaCreacion del documento de requerimientos para soporte de modos de operacion en Balance de Comprobacion