Renglones Presupuestarios y Centros de Costo - Guía ACE

Cambio importante (mayo 2026): Tras el Sub-proyecto 1, el concepto único de "centro de costo" se separó en tres dimensiones contables independientes:

• Renglones Presupuestarios (budget_positions) — partidas presupuestarias con código ACE-{Cat}-{Sub}-{Área} (149 en producción).
• Áreas Funcionales (functional_areas) — clasificador PDVSA con 26 códigos normalizados.
• Centros de Costo (cost_centers nuevo) — 22 unidades organizacionales con responsable y departamento.

Las páginas más actualizadas son Renglones Presupuestarios, Áreas Funcionales, Centros de Costo y Dimensiones Contables. Esta guía resume las tres.

Guía detallada para la configuración y uso de las dimensiones contables en el ERP ACE.

Las 3 dimensiones (más cuenta y proyecto = 5 dimensiones por línea)

Dimensión	Pregunta	Tabla	Cardinalidad
Renglón Presupuestario	¿Qué partida del presupuesto consume?	budget_positions	149
Área Funcional	¿Cómo se reporta a PDVSA?	functional_areas	26
Centro de Costo	¿Quién es responsable?	cost_centers	22
Cuenta	¿Qué naturaleza tiene?	accounting_accounts	~401
Proyecto	¿Para qué iniciativa?	projects	abierto

Nomenclatura ACE de Renglones Presupuestarios

Estructura del Código

ACE - {Área} - {Subcategoría}{Código} - {Tipo / Área Funcional}

Campo	Valores	Descripción
Empresa	ACE	Siempre ACE
Área	1 a 6	Categoría histórica del Excel
Subcategoría	1AL, 2MC, etc.	Identificador de subcategoría
Tipo / Área	LEV, EQPS, INPR, ATIN, TTT, …	Código del área funcional PDVSA

Áreas (legacy del Excel original)

#	Nombre	Ejemplos
1	Logística	Alimentación, transporte, combustibles
2	Mantenimiento	Compresores, motores, PIAS, líneas
3	Producción	Bombas mecánicas, análisis crudo, químicos
4	SG&A	Nómina, seguros, gastos admin
5	Infraestructura	Líneas de crudo/agua/gas, transformadores
6	Yacimientos	Taladros, procura eléctrica/mecánica, flush-by

Estas "Áreas" del Excel no son las functional_areas de la base de datos. La tabla functional_areas (26 códigos PDVSA normalizados) reemplazó la columna pdvsa_code y se referencia por FK desde cada renglón.

Códigos de Área Funcional típicos

Código	Significado	Costo
LEV	Levantamiento (gasto operativo recurrente)	OPEX
EQPS	Equipos (mantenimiento general)	OPEX
INPR	Inversión en Producción (CAPEX)	CAPEX
ATIN	Asistencia Técnica especializada	OPEX/CAPEX según uso
TTT	Tratamiento (operación específica)	OPEX

Nota: El cost_type (OPEX/CAPEX) vive en el renglón presupuestario, no en el área funcional. Un mismo INPR puede usarse en renglones OPEX o CAPEX diferentes.

Ejemplos completos

Código	Nombre	Tipo	Categoría	Área Funcional
ACE-1-1AL-LEV	Levantamiento Alimentación	OPEX	Logística	LEV
ACE-2-2MC-LEV	Levantamiento Mtto Compresores	OPEX	Mantenimiento	LEV
ACE-2-2MC-EQPS	Equipos Compresores de Gas	CAPEX	Mantenimiento	EQPS
ACE-3-3BM-EQPS	Bombas Mecánicas	CAPEX	Producción	EQPS
ACE-3-3AC-ATIN	Asistencia Técnica Análisis Crudo	CAPEX	Producción	ATIN

Tipos de Renglón Presupuestario

Tipo	Descripción	Cuentas típicas
OPEX	Gastos operativos recurrentes	5.x (gastos), 6.x (costos directos)
CAPEX	Inversiones de capital	1.2.x (activos fijos)

Tipos de Centro de Costo (modelo nuevo)

Clasificación	Uso
PRODUCTIVE	CC de actividades productivas directas
ADMINISTRATIVE	CC de gestión y administración
SUPPORT	CC de soporte a operaciones
PROJECT	CC vinculado a un proyecto específico

Jerarquía

Tanto renglones presupuestarios como centros de costo se organizan en árbol:

• Un nodo puede tener un padre y múltiples hijos.
• level se calcula automáticamente (0 = raíz).
• No se permiten ciclos (CHECK constraint en BD).
• No se puede desactivar un nodo con hijos activos.
• Al cambiar el padre, los level de descendientes se recalculan.

Mapeo Cuenta ↔ Renglón

Hasta el Sub-proyecto 1, las cuentas contables se almacenaban en un campo JSONB dentro del CC. Eso ya no existe. Ahora hay una tabla relacional:

account_budget_position_links (account_id, budget_position_id, role, is_active)

Roles soportados

Rol	Significado
DEBIT_DEFAULT	Cuenta por defecto al cargar al débito (única por cuenta)
CREDIT_DEFAULT	Cuenta por defecto al cargar al crédito (única por cuenta)
ALLOWED	Cuenta permitida sin ser default (whitelist amplia)

Categorías típicas de cuentas (referencia)

Grupo	Cuentas	Aplica típicamente a
Labor	5.1.x — Sueldos, SSO, INCES, FAOV	Todos los renglones
Beneficios	5.2.x — HCM, prestaciones, viáticos	Renglones con personal
Servicios y Contratos	6.1.x — Servicios contratados	Renglones operacionales
Materiales	6.3.x — Materiales y repuestos	Renglones de mantenimiento/producción
Estudios	6.2.x — Estudios y calibraciones	Renglones de producción/yacimientos
Oficina	5.5.x — Oficina y admin	Renglones administrativos

Consultar vía API

GET /api/accounting/positions/:id/accounts   # cuentas vinculadas a un renglón
GET /api/accounting/accounts/:id/positions   # renglones vinculados a una cuenta
POST /api/accounting/account-position-links  # crear vínculo
DELETE /api/accounting/account-position-links/:id

Ver en el Frontend

1. Detalle del Renglón > pestaña Cuentas Contables.
2. Las cuentas aparecen con: código contable, nombre, tipo (ASSET/LIABILITY/EXPENSE/REVENUE), naturaleza (Débito/Crédito), rol del vínculo.

Presupuesto por Período

Cambio importante (Sub-proyecto 1): Los campos mensuales (budget_jan, budget_feb, …, budget_q4, total_annual_budget) fueron eliminados de budget_positions. Se archivaron en la tabla budget_positions_legacy_excel para preservar el histórico.

El presupuesto productivo vive ahora en budget_lines.amount_* ligado a un BudgetPlan con período fiscal y monedas duales (USD/VES).

Resumen Presupuestario

El endpoint GET /api/budget/positions/:id/summary devuelve:

• Presupuesto asignado — total del renglón en el período fiscal actual.
• Comprometido — OCs y contratos aprobados pendientes (budget_commitments).
• Ejecutado — gastos realmente incurridos (budget_executions).
• Disponible — Asignado − Ejecutado − Comprometido.
• % Ejecutado — indicador de avance.
• Líneas presupuestarias — detalle por budget_line.
• Ejecuciones recientes — últimos 10 movimientos.

Permisos

Renglones Presupuestarios

Acción	Permiso
Ver	budget:positions:read
Crear / Editar	budget:positions:write

Centros de Costo

Acción	Permiso
Ver	accounting:cost-centers:read
Crear / Editar / Desactivar	accounting:cost-centers:write

Áreas Funcionales

Acción	Permiso
Ver	accounting:functional-areas:read
Crear / Editar	accounting:functional-areas:write

Mapeos cuenta↔renglón

Acción	Permiso
Ver	accounting:mappings:read
Crear / Editar	accounting:mappings:write

Permisos legacy cost-centers:* redirigen a budget:positions:* durante 1 release.