Ir al contenido

Tablero de centros de costo

GET/api/cost-center/dashboard

Devuelve el tablero de centros de costo: cuánto queda, a qué ritmo se va el gasto, qué centros se quedan sin saldo primero y qué presupuesto está dormido. Solo cuenta los centros raíz que no están anulados ni eliminados, para no duplicar el techo de los padres.

yearinteger

Año a consultar. Por defecto, el año actual.

La ruta exige un usuario autenticado (auth:sanctum). El controlador no valida ningún permiso del módulo.

totalsobject

Techo (budget), gasto (spent), disponible (available), cantidad de centros (centers) y de bloqueados (locked).

monthly_spentarray

Gasto real de cada mes del año consultado, con month y spent.

groupsobject

Presupuesto y gasto agrupados por area, category y project.

running_outarray

Centros que se quedan sin saldo, con available, monthly_rate y days_left.

attentionarray

Centros que necesitan atención. reason es overspent, locked, expiring o alert.

idlearray

Centros con saldo y sin movimientos hace 60 días o más, o sin ningún movimiento (days_idle es nulo). Se devuelven como máximo 8, ordenados por saldo.

Ventana de terminal
curl -G \
"https://servererp.allendostmen.app/api/cost-center/dashboard" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
--data-urlencode "year=2026"
Tablero200
{
"year": 2026,
"totals": {
"budget": 250000,
"spent": 98000.5,
"available": 151999.5,
"centers": 12,
"locked": 1
},
"monthly_spent": [
{
"month": 1,
"spent": 8000
},
{
"month": 2,
"spent": 9500.5
},
{
"month": 3,
"spent": 7200
},
{
"month": 4,
"spent": 0
},
{
"month": 5,
"spent": 0
},
{
"month": 6,
"spent": 0
},
{
"month": 7,
"spent": 0
},
{
"month": 8,
"spent": 0
},
{
"month": 9,
"spent": 0
},
{
"month": 10,
"spent": 0
},
{
"month": 11,
"spent": 0
},
{
"month": 12,
"spent": 0
}
],
"groups": {
"area": [
{
"name": "Administración",
"budget": 120000,
"spent": 60000,
"centers": 5,
"alert_threshold": 80
}
],
"category": [
{
"name": "Servicios",
"budget": 90000,
"spent": 40000,
"centers": 4,
"alert_threshold": 80
}
],
"project": [
{
"name": "Sin proyecto",
"budget": 40000,
"spent": 12000,
"centers": 3,
"alert_threshold": 0
}
]
},
"running_out": [
{
"id": 7,
"code": "0007",
"name": "Servicios generales",
"available": 1500,
"monthly_rate": 900,
"days_left": 50
}
],
"attention": [
{
"id": 9,
"code": "0009",
"name": "Viáticos",
"reason": "alert",
"percent": 85.2,
"threshold": 80,
"available": 2000,
"expires_at": null
}
],
"idle": [
{
"id": 11,
"code": "0011",
"name": "Capacitación",
"available": 5000,
"days_idle": 75,
"last_movement_at": "2026-09-05"
}
]
}