Nomenclatura PDVSA — Renglones Presupuestarios

Cambio importante (mayo 2026): Esta página antes describía la nomenclatura aplicada a "centros de costo". Tras el Sub-proyecto 1, los códigos PDVSA viven como áreas funcionales (tabla functional_areas) y se asocian a los renglones presupuestarios (tabla budget_positions, ex-cost_centers). Los centros de costo verdaderos (cost_centers nuevo) representan unidades organizacionales y NO llevan código PDVSA.

Referencia de códigos PDVSA y su relación con renglones presupuestarios y áreas funcionales en ACE.

---

Tres tablas, tres preguntas

Tabla	Pregunta	Ejemplo
functional_areas	¿Cómo se reporta a PDVSA?	LEV, INPR, EQPS
budget_positions	¿Qué partida del presupuesto consume?	ACE-1-1AL-LEV
cost_centers	¿Quién es responsable?	CC-OPS-POZOS

El código PDVSA vive en functional_areas.code y se referencia como functional_area_id desde renglones, líneas presupuestarias y asientos.

---

Formato del Código de Renglón Presupuestario

Los renglones presupuestarios en ACE siguen el patrón histórico del Excel original:

ACE - {CATEGORÍA} - {SUBCATEGORÍA} - {CÓDIGO_PDVSA}

Ejemplos: ACE-1-1AL-LEV, ACE-2-2MC-EQPS, ACE-CAPEX-INPR.

Cada renglón está vinculado a un área funcional (FK functional_area_id) que aporta el código PDVSA normalizado.

---

Catálogo de Áreas Funcionales (26)

Ver la lista completa en Áreas Funcionales. Resumen:

UPSTREAM_OPERATIONS (10)

LEV, LRTR, SGL, SCT, SST, RCT, RST, INPR, REC, TTT

MAINTENANCE (6)

MEP, MCT, MTQ, OLT, EQPS, VEH

SUPPORT (6)

SHA, PTIN, CCT, SSG, SIF, ATIN

ADMINISTRATIVE (4)

ADM, PER, POL, CUGS

El catálogo es abierto: pueden agregarse áreas adicionales conforme cambie la operación o los requerimientos contractuales con PDVSA.

---

Reglas de Asignación

1. Un renglón presupuestario tiene un único cost_type: OPEX o CAPEX.
2. Un renglón referencia una única área funcional (functional_area_id NOT NULL).
3. El código del renglón es inmutable una vez tiene asientos contables asociados.
4. Las líneas presupuestarias heredan cost_type del plan presupuestario (BudgetPlan.budgetType); el renglón debe coincidir.
5. Los compromisos (BudgetCommitment) se vinculan a una línea presupuestaria que determina el renglón.
6. Un proyecto puede consumir renglones OPEX y CAPEX simultáneamente.

---

Campos del modelo BudgetPosition

Campo	Tipo	Descripción
code	STRING	Código del renglón (ACE-1-1AL-LEV)
name	STRING	Nombre descriptivo
description	TEXT	Detalle
cost_type	ENUM	OPEX o CAPEX
category	STRING	Categoría libre
sub_category	STRING	Subcategoría libre
functional_area_id	UUID FK	Área funcional PDVSA (NOT NULL)
parent_id	UUID FK	Padre en jerarquía (opcional)
status	ENUM	ACTIVE / INACTIVE

Las columnas legacy pdvsa_code, pdvsa_description, budget_jan/feb/mar/q1/q2/q3/q4, total_annual_budget, detalle, accounting_accounts (JSONB), allocated_budget, currency, fiscal_year, department_id, manager_id fueron eliminadas en M9. Los datos del Excel original se preservaron en la tabla histórica budget_positions_legacy_excel.

---

Filtros disponibles en la API

GET /api/budget/positions
GET /api/budget/positions/by-cost-type/OPEX
GET /api/budget/positions/by-cost-type/CAPEX
GET /api/budget/positions/by-functional-area/:faId

GET /api/accounting/functional-areas
GET /api/accounting/functional-areas/by-category/:category

---

Referencias

• Áreas Funcionales — catálogo PDVSA completo (26 códigos).
• Renglones Presupuestarios — guía operativa.
• Centros de Costo — unidades organizacionales (modelo nuevo).
• Dimensiones Contables — cómo se cruzan las 5 dimensiones por línea de asiento.
• api-reference-centros-de-costo.md — endpoints legacy.
• guia-administrador.md — configuración inicial.