Gastos del negocio
POST
Listar gastos
POST /api/expenses/list-expenses-admin
Descripción
Listado paginado de gastos del negocio con búsqueda, filtros y totales del período.
Detalles
Devuelve los gastos del negocio de cualquier origen y fecha, con búsqueda por texto, filtro por estado, categoría y rango de fechas. Incluye los totales del set filtrado: gastado, cantidad y cancelados.
Permisos requeridos
reports.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| search | string | No |
max:100
|
| status | string | No |
max:20
|
| categoryId | int | No |
min_value:1
|
| dateFrom | datetime | No | — |
| dateTo | datetime | No | — |
Paginación
| defaultLimit | 25 |
| maxLimit | 200 |
| defaultDir | desc |
| withTotal | true |
| allowedSorts | [createdAt, amountCents] |
Ejemplo de request
curl -X POST https://restofy.pro/api/expenses/list-expenses-admin \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-H "X-Tenant-Key: <tenantKey>"Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-09-08T16:35:34Z
HTTP 200
Request
{
"limit": 100
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"expenses": [],
"pagination": {
"page": 1,
"limit": 100,
"total": 0,
"totalPages": 0,
"hasNext": false,
"hasPrev": false
},
"stats": {
"totalCents": "0",
"totalCount": 0,
"cancelledCount": "0"
}
}
}