Tablero de centros de costo
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.
Parámetros de consulta
Sección titulada «Parámetros de consulta»yearintegerAño a consultar. Por defecto, el año actual.
Permiso
Sección titulada «Permiso»La ruta exige un usuario autenticado (auth:sanctum). El controlador no valida ningún permiso del módulo.
Campos de la respuesta
Sección titulada «Campos de la respuesta»totalsobjectTecho (budget), gasto (spent), disponible (available), cantidad de centros (centers) y de bloqueados (locked).
monthly_spentarrayGasto real de cada mes del año consultado, con month y spent.
groupsobjectPresupuesto y gasto agrupados por area, category y project.
running_outarrayCentros que se quedan sin saldo, con available, monthly_rate y days_left.
attentionarrayCentros que necesitan atención. reason es overspent, locked, expiring o alert.
idlearrayCentros 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.
curl -G \ "https://servererp.allendostmen.app/api/cost-center/dashboard" \ -H "Authorization: Bearer $TOKEN" \ -H "Accept: application/json" \ --data-urlencode "year=2026"const response = await fetch( "https://servererp.allendostmen.app/api/cost-center/dashboard?year=2026", { method: "GET", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", }, },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->get('https://servererp.allendostmen.app/api/cost-center/dashboard', [ 'year' => 2026, ]);{ "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" } ]}