Chart of Accounts Service

Descripción General

El ChartOfAccountsService gestiona el plan de cuentas contable de la empresa, permitiendo crear, actualizar y organizar la estructura de cuentas según normas IFRS y locales chilenas.

Arquitectura

flowchart LR
    subgraph Frontend
        PC[ChartOfAccountsViewIsland]
    end
    
    subgraph Orchestrator
        R["/api/admin/chart-of-accounts"]
        S[ChartOfAccountsService]
        Repo[ChartOfAccountsRepository]
    end
    
    subgraph Database
        T["administracion.plan_contable"]
    end
    
    PC -->|HTTPS| R
    R --> S
    S --> Repo
    Repo -->|SQL| T

Endpoints

GET /api/admin/chart-of-accounts

Lista todas las cuentas del plan contable ordenadas jerárquicamente.

Respuesta exitosa (200):

[
  {
    "codigo": "1",
    "nombre": "ACTIVOS",
    "tipo": "ACTIVO",
    "naturaleza": "D",
    "nivel": 1,
    "imputable": false,
    "cuenta_padre": null,
    "codigo_ifrs": "1000",
    "activo": true
  },
  {
    "codigo": "1.1",
    "nombre": "Activo Corriente",
    "tipo": "ACTIVO",
    "naturaleza": "D",
    "nivel": 2,
    "imputable": false,
    "cuenta_padre": "1",
    "codigo_ifrs": "1100",
    "activo": true
  }
]

GET /api/admin/chart-of-accounts/tree

Retorna el plan de cuentas en formato árbol (alias de /).

GET /api/admin/chart-of-accounts/:codigo

Obtiene una cuenta específica por su código.

POST /api/admin/chart-of-accounts

Crea una nueva cuenta contable.

Request Body:

{
  "codigo": "1.1.1",
  "nombre": "Caja",
  "tipo": "ACTIVO",
  "naturaleza": "D",
  "nivel": 3,
  "imputable": true,
  "cuenta_padre": "1.1",
  "codigo_ifrs": "1110"
}

PUT /api/admin/chart-of-accounts/:codigo

Actualiza una cuenta existente.

DELETE /api/admin/chart-of-accounts/:codigo

Elimina una cuenta (solo si no tiene movimientos).

Tipos de Cuenta

Tipo	Naturaleza	Descripción
ACTIVO	Deudora (D)	Bienes y derechos
PASIVO	Acreedora (C)	Obligaciones con terceros
PATRIMONIO	Acreedora (C)	Capital de propietarios
INGRESO	Acreedora (C)	Entradas de recursos
GASTO	Deudora (D)	Salidas de recursos

Estructura Jerárquica

graph TD
    A["1 - ACTIVOS"] --> B["1.1 - Activo Corriente"]
    A --> C["1.2 - Activo No Corriente"]
    B --> D["1.1.1 - Efectivo"]
    B --> E["1.1.2 - Cuentas por Cobrar"]
    D --> F["1.1.1.1 - Caja Chica"]
    D --> G["1.1.1.2 - Banco Estado"]
    
    style A fill:#2563eb,color:#fff
    style B fill:#3b82f6,color:#fff
    style C fill:#3b82f6,color:#fff
    style D fill:#60a5fa,color:#000
    style E fill:#60a5fa,color:#000

Reglas de Negocio

1. Código único: Cada cuenta debe tener un código único en el plan
2. Niveles: Máximo 6 niveles de profundidad
3. Imputabilidad: Solo cuentas de último nivel pueden recibir movimientos
4. IFRS: Código IFRS opcional para reportes internacionales
5. Cuenta padre: Debe existir antes de crear hijos

Ubicación del Código

• Directoryorchestrator/src/

  • Directoryroutes/admin/

    • chart-of-accounts.ts
  • Directorydomain/chart-of-accounts/

    • ChartOfAccountsService.ts
    • ChartOfAccountsRepository.ts
    • types.ts

Ver También

• CapitalService - Movimientos de capital
• CompanyService - Datos de empresa