---
title: Catalogos y presupuestos
category:
  uri: guides
content:
  excerpt: Consulta cuentas, cajas y categorias; crea presupuestos y partidas.
---

# Catalogos y presupuestos

## Catalogos financieros

- `GET /categories` lista categorías visibles.
- `GET /accounts` lista cuentas activas.
- `GET /accounts/{accountId}/cashboxes` lista las cajas de una cuenta.
- `GET /balances` devuelve saldos por cuenta y caja.

Consulta estos recursos antes de crear movimientos para evitar almacenar identificadores obsoletos en una integración.

Al crear una categoría, `scope: tracker` requiere `catalog:write:tracker`; `scope: user` requiere `catalog:write:user`.

## Presupuestos

`POST /budgets` permite crear:

- Presupuestos `tracking`, con `period` y `startsOn`.
- Presupuestos `planning`, con `startsOn` y `endsOn`.

El presupuesto se crea en borrador. Después, `POST /budgets/{budgetId}/lines` agrega partidas y `GET /budgets/{budgetId}` devuelve detalle, resumen y ejecución.

```json
{
  "categoryId": "transport",
  "concept": "Transporte mensual",
  "lineType": "expense",
  "lineKind": "variable_estimate",
  "amountDecimal": "1500.00",
  "frequency": "month"
}
```

Las escrituras de categorías, presupuestos y partidas requieren `Idempotency-Key`.