Contabilidad

Endpoints para gestionar asientos contables, plan de cuentas, períodos contables y reglas de determinación.

Asientos contables

Listar asientos

GET /journal-entries

Parámetro	Tipo	Descripción
page	number	Página (default: 1)
limit	number	Registros por página (default: 50)
startDate	string	Fecha inicio (YYYY-MM-DD)
endDate	string	Fecha fin (YYYY-MM-DD)
status	string	posted, draft, reversed
entryType	string	automatic, manual, reversal

Obtener asiento por ID

GET /journal-entries/:id

Crear asiento manual

POST /journal-entries

{
  "date": "2026-04-16",
  "description": "Ajuste contable",
  "lines": [
    {
      "chartOfAccountId": 1,
      "debit": 1000.00,
      "credit": 0,
      "lineDescription": "Débito a caja"
    },
    {
      "chartOfAccountId": 2,
      "debit": 0,
      "credit": 1000.00,
      "lineDescription": "Crédito a ingresos"
    }
  ]
}

Validación de balance

La suma de débitos debe ser igual a la suma de créditos. Si no cuadra, el API devuelve error 400.

Publicar asiento borrador

POST /journal-entries/:id/post

Reversar asiento

POST /journal-entries/:id/reverse

Crea un nuevo asiento con débitos y créditos invertidos y marca el original como reversed.

Imprimir asiento

POST /journal-entries/:id/print

Devuelve un PDF del asiento contable.

---

Libro mayor

Consultar libro mayor

GET /journal-entries/ledger

Parámetro	Tipo	Descripción
chartOfAccountId	number	Cuenta contable
startDate	string	Fecha inicio
endDate	string	Fecha fin

---

Plan de cuentas

Listar cuentas

GET /chart-of-accounts

Crear cuenta

POST /chart-of-accounts

{
  "code": "1101",
  "name": "Caja General",
  "type": "asset",
  "parentId": null,
  "isActive": true
}

Actualizar cuenta

PUT /chart-of-accounts/:id

Eliminación de cuentas del plan

Solo desde la aplicación web; las API keys no admiten DELETE en el plan de cuentas.

Importar plan por defecto

POST /chart-of-accounts/import-default

Importa un plan de cuentas estándar para Honduras.

---

Períodos contables

Listar períodos

GET /accounting-periods

Crear período

POST /accounting-periods

Cerrar período

POST /accounting-periods/:id/close

Operación irreversible

Cerrar un período impide crear o modificar asientos en las fechas de ese período.

Reabrir período

POST /accounting-periods/:id/reopen

---

Reglas de determinación contable

Definen qué cuentas del plan se usan automáticamente para asientos de documentos y pagos.

Listar reglas

GET /account-determination-rules

Crear / actualizar regla

POST /account-determination-rules

Resolver cuenta

POST /account-determination-rules/resolve

Dado un contexto (tipo de documento, tipo de operación), devuelve la cuenta contable que aplica.

---

Asientos automáticos

Los asientos se generan automáticamente en estos casos:

Evento	Tipo de asiento
Crear factura de venta (01, 113)	CxC + Ingresos + ISV
Crear factura de compra (103, 105, 106)	Gasto/Compra + ISV + CxP
Confirmar documento (extracción automática)	Asiento pospuesto hasta confirmación
Registrar pago (cobro/pago)	Banco/Caja + CxC o CxP
Cancelar documento	Reversión del asiento original
Cancelar pago	Reversión del asiento de pago

Documentos con extracción automática

Los documentos de compra creados con extracción automática desde factura no generan asiento al guardarse. El asiento se crea al confirmar el documento.