Operación de caja
POST
Listar el historial de órdenes recientes
POST /api/cashier/list-order-history
Descripción
Devuelve en un solo listado las órdenes cobradas, de cortesía y canceladas de las últimas horas, de todas las cajas del restaurante.
Detalles
Retorna las órdenes que ya terminaron dentro de la ventana de horas configurada, sin importar en qué caja se atendieron: las cobradas, las que se entregaron como cortesía y las canceladas. Cada orden informa su estado, la hora en que terminó, quién la atendió y en qué caja quedó. Se puede pedir un solo estado o todos juntos, y el resultado llega paginado de lo más reciente a lo más antiguo. La ventana de horas la define la configuración del restaurante y no se puede ampliar desde la consulta. Quien no puede ver todas las numeraciones recibe solo los cobros hechos con la numeración predeterminada de su caja.
Permisos requeridos
cash.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| status | string | No |
enum:all,paid,comped,cancelled
|
| search | string | No |
max:100
|
Paginación
| defaultLimit | 25 |
| maxLimit | 50 |
| allowedSorts | eventAt |
| defaultSort | eventAt |
| defaultDir | desc |
| withTotal | true |
Ejemplo de request
curl -X POST https://restofy.pro/api/cashier/list-order-history \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>"Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-10-09T02:12:12Z
HTTP 200
Request
[]Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"windowHours": 4,
"orders": [],
"pagination": {
"page": 1,
"limit": 25,
"total": 0,
"totalPages": 0,
"hasNext": false,
"hasPrev": false
}
}
}