Ir al contenido

Listar centros de costo

GET/api/cost-center

Devuelve la lista paginada. Usa BaseControllerHelper::index, así que admite los parámetros comunes de paginación, búsqueda, estado, filtros y fechas; están descritos en Paginación y filtros. Aquí solo se documenta lo propio del endpoint. La búsqueda search compara con nombre, código y descripción, también de los sub-centros.

cost_center_type_idinteger

Centros del tipo indicado o de cualquiera de sus tipos descendientes (el tipo propio o el de un sub-centro).

cost_center_type_idsstring

Varios tipos separados por coma, con la misma regla que cost_center_type_id.

single_fathersboolean

Con true, devuelve solo los centros sin padre.

parent_idinteger

Devuelve los sub-centros de ese padre.

project_nullboolean

Con true, devuelve solo los centros sin proyecto.

project_idinteger

Centros del proyecto indicado.

without_projectboolean

Con true y sin project_id, solo los centros sin proyecto; junto con project_id, los del proyecto más los que no tienen proyecto.

cashbox_idinteger

Centros sin cajas asociadas o asociados a esa caja.

yearinteger

Centros creados en ese año.

relationsstring

Relaciones a cargar. Se admite cualquiera de las del modelo; ver Resumen.

count_relationsstring

El modelo no define conteos de relaciones permitidos.

orderstring

Campos permitidos: id, name, created_at, updated_at y status (los del sistema, porque el modelo no define otros).

No exige un permiso del módulo: la política devuelve verdadero para cualquier usuario autenticado. Ver Permisos y políticas.

Ventana de terminal
curl -G \
"https://servererp.allendostmen.app/api/cost-center" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
--data-urlencode "per_page=20" \
--data-urlencode "single_fathers=true" \
--data-urlencode "search=servicios" \
--data-urlencode "order=name|ASC"
Lista de centros de costo200
{
"current_page": 1,
"data": [
{
"id": 7,
"cost_center_type_id": 3,
"code": "0007",
"name": "Servicios generales",
"description": "Gastos de operación de la sede",
"total_budget": 12000,
"spent_amount": 3500,
"available_amount": 8500,
"is_over_budget": false,
"is_locked": false,
"start_date": "2026-01-01",
"end_date": null,
"coin_id": 1,
"parent_id": null,
"project_id": null,
"status": "activo",
"previous_status": null,
"create_user_id": 1,
"update_user_id": null,
"delete_user_id": null,
"restore_user_id": null,
"restored_at": null,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T10:40:15.000000Z",
"deleted_at": null
}
],
"first_page_url": "https://servererp.allendostmen.app/api/cost-center?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "https://servererp.allendostmen.app/api/cost-center?page=1",
"next_page_url": null,
"path": "https://servererp.allendostmen.app/api/cost-center",
"per_page": 20,
"prev_page_url": null,
"to": 1,
"total": 1
}
Sin permiso403
{
"message": "This action is unauthorized."
}