Módulo de Presupuesto
🔑 Acceso al Módulo
Menú Principal: Presupuesto
El módulo de Presupuesto es accesible desde el menú lateral principal. Las opciones disponibles son:
- Dashboard: Presupuesto > Dashboard
- Planes: Presupuesto > Planes
- Categorías: Presupuesto > Categorías
- Ejecución: Presupuesto > Ejecución
- Compromisos: Presupuesto > Compromisos
- Conciliación: Presupuesto > Conciliación
Permisos requeridos: budget:read, budget:*, finance:read o finance:*

Descripción General
El módulo de Presupuesto gestiona la planificación financiera, control de gastos y seguimiento de ejecución presupuestaria de la empresa.
Características Principales
📊 Planificación Presupuestaria

- Creación de planes presupuestarios por proyecto
- Versionamiento de presupuestos
- Partidas presupuestarias detalladas
- Presupuestos por período fiscal
💼 Compromisos Presupuestarios


- Registro de compromisos antes de ejecutar gastos
- Control de disponibilidad presupuestaria
- Seguimiento de compromisos vs ejecución
- Dashboard de compromisos
🔗 Integración con Contabilidad
- Generación automática de asientos contables
- Enlaces configurables por partida
- Sincronización de ejecución presupuestaria
- Reportes consolidados
📈 Control y Seguimiento
- Ejecución presupuestaria en tiempo real
- Comparación presupuesto vs real
- Alertas de sobre-ejecución
- Reportes de desviaciones
🎯 Integración con Proyectos
- Presupuestos vinculados a proyectos
- Seguimiento por actividad
- Control de gastos mixtos
- Trazabilidad completa
Conceptos Clave
Plan Presupuestario
Documento que define el presupuesto para un proyecto o período específico.
Componentes:
- Código único
- Proyecto asociado
- Período fiscal
- Partidas presupuestarias
- Monto total aprobado
Partida Presupuestaria
Línea específica dentro del plan presupuestario.
Información:
- Código de partida
- Descripción
- Categoría de gasto
- Monto presupuestado
- Cuenta contable asociada
- Centro de costos
Compromiso Presupuestario
Reserva de presupuesto antes de ejecutar un gasto.
Propósito:
- Asegurar disponibilidad de fondos
- Evitar sobre-ejecución
- Control previo de gastos
- Trazabilidad de autorizaciones
Ejecución Presupuestaria
Registro del gasto real contra el presupuesto.
Proceso:
- Compromiso → Reserva presupuesto
- Ejecución → Gasto real
- Pago → Salida de efectivo
- Contabilización → Asiento contable
Estructura del Módulo
Modelos de Datos
BudgetPlan (Plan Presupuestario)
- code: Código único del plan
- projectId: Proyecto asociado
- fiscalYear: Año fiscal
- status: DRAFT, APPROVED, ACTIVE, CLOSED
- totalBudget: Monto total aprobado
- version: Número de versión
BudgetLine (Partida Presupuestaria)
- budgetPlanId: Plan al que pertenece
- code: Código de partida
- description: Descripción
- category: Categoría de gasto
- budgetedAmount: Monto presupuestado
- committedAmount: Monto comprometido
- executedAmount: Monto ejecutado
- accountingAccountId: Cuenta contable
BudgetCommitment (Compromiso Presupuestario)
- code: Código único (COM-2026-00001)
- budgetLineId: Partida afectada
- description: Descripción del compromiso
- amount: Monto comprometido
- status: PENDING, APPROVED, EXECUTED, CANCELLED
- sourceModule: Módulo origen (procurement, projects, etc.)
- sourceEntityId: ID de la entidad origen
BudgetExecution (Ejecución Presupuestaria)
- budgetLineId: Partida afectada
- commitmentId: Compromiso relacionado (opcional)
- description: Descripción de la ejecución
- amount: Monto ejecutado
- executionDate: Fecha de ejecución
- journalEntryId: Asiento contable generado
Flujo de Trabajo
1. Creación del Plan Presupuestario
Proceso:
- Navegar a Presupuesto > Planes
- Crear nuevo plan
- Asociar a proyecto
- Definir período fiscal
- Agregar partidas presupuestarias
- Guardar como borrador
2. Aprobación del Presupuesto
Proceso:
- Revisar plan en borrador
- Verificar totales y partidas
- Enviar para aprobación
- Aprobadores revisan y aprueban
- Estado cambia a APPROVED
- Plan queda activo para uso
3. Registro de Compromisos
Proceso:
- Identificar necesidad de gasto
- Crear compromiso presupuestario
- Seleccionar partida presupuestaria
- Verificar disponibilidad
- Registrar monto y descripción
- Aprobar compromiso
- Presupuesto se reserva
4. Ejecución del Gasto

Proceso:
- Gasto real se registra
- Se vincula a compromiso (si existe)
- Se actualiza ejecución presupuestaria
- Se genera asiento contable automático
- Saldos se actualizan
5. Seguimiento y Control
Proceso:
- Revisar dashboard de presupuesto
- Analizar desviaciones
- Generar reportes
- Tomar acciones correctivas
Versionamiento de Presupuestos
Concepto
Permite mantener múltiples versiones de un plan presupuestario para comparación y auditoría.
Casos de Uso
- Presupuesto Original: Versión 1.0 aprobada inicialmente
- Revisión: Versión 2.0 con ajustes aprobados
- Suplemento: Versión 3.0 con fondos adicionales
Proceso de Versionamiento
Crear Nueva Versión:
- Desde plan existente
- Clic en "Crear Versión"
- Sistema copia partidas actuales
- Nueva versión en estado DRAFT
Modificar Nueva Versión:
- Ajustar montos
- Agregar/eliminar partidas
- Documentar cambios
Aprobar Nueva Versión:
- Enviar para aprobación
- Aprobadores comparan versiones
- Al aprobar, se activa nueva versión
Historial de Versiones:
- Ver todas las versiones
- Comparar versiones lado a lado
- Trazabilidad de cambios
Dashboard de Presupuesto
Indicadores Principales
Resumen Ejecutivo:
- Total Presupuestado
- Total Comprometido
- Total Ejecutado
- Disponible
Por Estado:
- Compromisos Pendientes
- Compromisos Aprobados
- En Ejecución
- Completados
Alertas:
- Partidas sobre-ejecutadas
- Compromisos vencidos
- Presupuesto agotado
Gráficos
Ejecución por Categoría:
- Gráfico de barras
- Presupuestado vs Ejecutado
- Por categoría de gasto
Tendencia Mensual:
- Línea de tiempo
- Ejecución acumulada
- Proyección
Distribución:
- Gráfico circular
- Porcentaje por partida
- Top 10 partidas
Reportes
Reporte de Ejecución Presupuestaria
EJECUCIÓN PRESUPUESTARIA
Proyecto: [Nombre Proyecto]
Período: Enero 2026
Partida Presupuestado Comprometido Ejecutado Disponible %Ejec
─────────────────────────────────────────────────────────────────────────────────
Materiales $100,000.00 $30,000.00 $25,000.00 $45,000.00 25%
Mano de Obra $150,000.00 $50,000.00 $45,000.00 $55,000.00 30%
Equipos $80,000.00 $20,000.00 $15,000.00 $45,000.00 19%
Servicios $50,000.00 $10,000.00 $8,000.00 $32,000.00 16%
─────────────────────────────────────────────────────────────────────────────────
TOTAL $380,000.00 $110,000.00 $93,000.00 $177,000.00 24%
Reporte de Compromisos
Lista todos los compromisos por estado con detalles de partida, monto y origen.
Reporte de Desviaciones
Identifica partidas con sobre-ejecución o sub-ejecución significativa.
Reporte Comparativo de Versiones
Compara diferentes versiones del presupuesto lado a lado.
Integración con Otros Módulos
Con Contabilidad
- Asientos automáticos por ejecución
- Enlaces configurables
- Sincronización de saldos
Con Proyectos
- Presupuestos por proyecto
- Seguimiento de actividades
- Control de gastos
Con Compras
- Compromisos desde órdenes de compra
- Ejecución al recepcionar
- Trazabilidad completa
Con AFE
- Vinculación de AFE con presupuesto
- Control de autorizaciones
- Seguimiento de gastos
Permisos y Roles
Permisos Disponibles
budget.view- Ver presupuestosbudget.create- Crear planesbudget.edit- Editar borradoresbudget.approve- Aprobar presupuestosbudget.commit- Crear compromisosbudget.execute- Registrar ejecuciónbudget.reports- Ver reportesbudget.admin- Administrar configuración
Roles Típicos
- Gerente de Proyecto: create, edit, commit, execute, reports
- Gerente Financiero: view, approve, reports, admin
- Contador: view, reports
- Aprobador: view, approve
Navegación
Mejores Prácticas
✅ Recomendaciones
- Crear presupuestos detallados por partida
- Registrar compromisos antes de ejecutar gastos
- Revisar ejecución mensualmente
- Mantener versiones documentadas
- Configurar alertas de sobre-ejecución
- Conciliar con contabilidad periódicamente
⚠️ Advertencias
- No ejecutar sin compromiso previo en proyectos grandes
- Verificar disponibilidad antes de comprometer
- No modificar presupuestos aprobados sin versionamiento
- Documentar razones de desviaciones
- No cerrar períodos sin conciliar
Conciliación Presupuestaria
