Ir al contenido

Listar cajas

GET/api/cashbox

Devuelve la lista paginada de cajas. Usa BaseControllerHelper::index, así que admite los filtros, el orden y la carga de relaciones comunes del sistema.

per_pageinteger

Registros por página. Por defecto 20.

searchstring

Texto a buscar en el nombre de la caja.

statusstring

Filtra por estado del registro.

not_statusstring

Excluye los registros con ese estado.

trashedboolean

Incluye también las cajas eliminadas.

only_trashedboolean

Devuelve solo las cajas eliminadas.

idsstring

Devuelve solo las cajas con esos identificadores.

not_idsstring

Excluye las cajas con esos identificadores.

filtersobject

Filtros por campo, que resuelve filterFields del modelo.

created_at_fromdate

Creadas desde esta fecha.

created_at_todate

Creadas hasta esta fecha.

updated_at_fromdate

Modificadas desde esta fecha.

updated_at_todate

Modificadas hasta esta fecha.

select_fieldsstring

Campos a devolver.

relationsstring

Relaciones a cargar. Ver Resumen.

count_relationsstring

Conteos de relaciones. Para la caja se admite unconciliatedMovements.

orderstring

Orden de los resultados. Campos permitidos: id, name, description, status, created_at, updated_at.

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

Ventana de terminal
curl -G \
"https://servererp.allendostmen.app/api/cashbox" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
--data-urlencode "per_page=20" \
--data-urlencode "search=central" \
--data-urlencode "order=name"
Lista de cajas200
{
"current_page": 1,
"data": [
{
"id": 3,
"name": "CAJA SEDE CENTRAL",
"description": "CAJA DE LA SEDE CENTRAL",
"code": null,
"status": "activo",
"previous_status": null,
"status_update_comment": null,
"status_update_date": null,
"status_update_user_id": null,
"create_user_id": 1,
"update_user_id": null,
"delete_user_id": null,
"restore_user_id": 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/cashbox?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "https://servererp.allendostmen.app/api/cashbox?page=1",
"next_page_url": null,
"path": "https://servererp.allendostmen.app/api/cashbox",
"per_page": 20,
"prev_page_url": null,
"to": 1,
"total": 1
}
Sin permiso403
{
"message": "This action is unauthorized."
}