> ## Documentation Index
> Fetch the complete documentation index at: https://docs.filexpress.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Catálogo de cuentas y períodos

> Consultar el plan de cuentas y el estado de los períodos contables

**Permiso requerido:** `accounting.accounts`

## Catálogo de cuentas

```http theme={null}
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. |

```json theme={null}
{
  "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

```http theme={null}
GET /accounting/periods?year=2026
```

```json theme={null}
{
  "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. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.