Catálogo de cuentas y períodos - FileXpress

Permiso requerido: accounting.accounts

Catálogo de cuentas

GET /accounting/accounts

Parámetro	Descripción
`only_movement_accounts`	`1` para devolver solo cuentas de movimiento (sin subcuentas), que son las únicas que aceptan partidas.
`type`	Filtra por tipo: `asset` (activo), `liability` (pasivo), `equity` (patrimonio), `revenue` (ingreso) o `expense` (gasto).
`search`	Busca por código o nombre.

{
  "status": true,
  "data": [
    { "id": "uuid", "code": "1101", "name": "Efectivo y equivalentes", "type": "asset", "level": 3, "parent_id": "uuid", "accepts_movements": false },
    { "id": "uuid", "code": "110101", "name": "Caja general", "type": "asset", "level": 4, "parent_id": "uuid", "accepts_movements": true }
  ]
}

Campo	Descripción
`accepts_movements`	`true` si la cuenta no tiene subcuentas y puede usarse en partidas.
`level`	Nivel jerárquico de la cuenta.

Períodos contables

GET /accounting/periods?year=2026

{
  "status": true,
  "data": [
    { "id": "uuid", "branch_id": "uuid", "year": 2026, "month": 10, "status": "ABIERTO" }
  ]
}

`status`	Significado
`ABIERTO`	Admite partidas.
`CERRADO`	Cerrado por el contador; no admite partidas nuevas.
`BLOQUEADO`	Bloqueado definitivamente.