Cierres de caja
POST
Listar órdenes de cortesía de la sesión
POST /api/cash-closures/list-comp-orders
Descripción
Devuelve el listado paginado de órdenes entregadas como cortesía durante la sesión, con búsqueda por código, mesero, mesa o monto.
Detalles
Retorna las órdenes que durante la sesión fueron entregadas como cortesía (sin generar cobro). Acepta una búsqueda libre sobre código de la orden, mesero, mesa o monto. Falla si la sesión no existe o el usuario no tiene permiso sobre ella.
Permisos requeridos
cash.closing.totals.view
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| cashRegisterSessionId | int | Sí |
min_value:1
|
| search | string | No |
max:100
|
Paginación
| defaultLimit | 25 |
| maxLimit | 100 |
| allowedSorts | eventAt, totalCents, orderCode |
| defaultSort | eventAt |
| defaultDir | desc |
Ejemplo de request
curl -X POST https://app.restofy.co/api/cash-closures/list-comp-orders \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"cashRegisterSessionId": 1
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-07-15T13:20:48Z
HTTP 200
Request
{
"cashRegisterSessionId": 2
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"orders": [],
"pagination": {
"page": 1,
"limit": 25,
"total": 0,
"totalPages": 0,
"hasNext": false,
"hasPrev": false
}
}
}