get_budget_vs_actual

Generado

Generado desde el código con python -m docsgen; una prueba falla si deja de coincidir. Las descripciones vienen del código y se mantienen en inglés: es el idioma en que las leen los agentes.

Qué hace

Share of each category’s budget spent in a month, to see what is over or close.

Use it for “am I over budget?” or “which categories are nearly used up?”. Amounts in currency units, spending as a positive number; utilization_pct above 100 means over budget. For what is still available in each category use get_category_balances; for the month’s totals, get_monthly_summary; for several months, get_spending_trends. One YNAB request; changes nothing.

Comportamiento

Tipo	solo lectura
Confirmación	no
Deshacer	no
Idempotente	sí
Peticiones a YNAB	1 para el ejemplo de abajo, con la caché vacía

Parámetros

Nombre	Tipo	Obligatorio	Por defecto	Descripción
plan_id	string	sí	—	YNAB plan id or ‘last-used’.
month	string	no	"current"	ISO month ‘YYYY-MM-01’ or ‘current’.

Devuelve

array of object

Campo	Tipo	Descripción
id	string	YNAB id of the category.
name	string	Category name.
group	string	Name of the category’s group, e.g. Fun for Tennis.
budgeted	number	Amount assigned to the category this month.
actual	number	Amount spent this month, as a positive number.
balance	number	What is left: budgeted minus spent, plus what was carried over; negative when overspent.
utilization_pct	number	Spent as a share of budgeted, in percent; above 100 means overspent, 0 when nothing is budgeted.

Ejemplo

Argumentos:

{
  "plan_id": "demo-budget",
  "month": "2026-09-01"
}

Respuesta sobre el presupuesto de demostración:

[
  {
    "id": "cat-rent",
    "name": "Alquiler",
    "group": "Facturas",
    "budgeted": 950.0,
    "actual": 950.0,
    "balance": 0.0,
    "utilization_pct": 100.0
  },
  {
    "id": "cat-power",
    "name": "Luz",
    "group": "Facturas",
    "budgeted": 64.2,
    "actual": 64.2,
    "balance": 0.0,
    "utilization_pct": 100.0
  },
  {
    "id": "cat-internet",
    "name": "Fibra",
    "group": "Facturas",
    "budgeted": 29.99,
    "actual": 29.99,
    "balance": 0.0,
    "utilization_pct": 100.0
  },
  {
    "id": "cat-phone",
    "name": "Teléfono",
    "group": "Facturas",
    "budgeted": 19.99,
    "actual": 19.99,
    "balance": 0.0,
    "utilization_pct": 100.0
  },
  "… 6 more"
]

Errores

• month must be 'current' or the first day of a month as YYYY-MM-01, got '{month}'.

Los errores propios de YNAB llegan como Error calling tool '<tool>': YNAB <status>: <detail>.

Ver también

• Revisar un mes