Operación de caja
POST
Listar movimientos de efectivo de la sesión
POST /api/cashier/get-movements
Descripción
Devuelve los movimientos operativos de la sesión: aperturas, ingresos de dinero, retiros y pagos hechos desde la caja.
Detalles
Retorna las entradas y salidas de efectivo de la sesión que no provienen de ventas: la apertura inicial, ingresos y retiros manuales, y los pagos al cierre del turno (propinas, domicilios y base). Los saldos de clientes tienen su propio listado. Falla si la sesión no existe o el usuario no tiene acceso a ella.
Permisos requeridos
cash.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| cashRegisterSessionId | int | Sí |
min_value:1
|
Paginación
| defaultLimit | 25 |
| maxLimit | 50 |
| allowedSorts | createdAt |
| defaultSort | createdAt |
| defaultDir | desc |
| withTotal | true |
Ejemplo de request
curl -X POST https://restofy.pro/api/cashier/get-movements \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-H "X-Tenant-Key: <tenantKey>" \
-d '{
"cashRegisterSessionId": 1
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-09-08T16:35:34Z
HTTP 200
Request
{
"cashRegisterSessionId": 2
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"movements": [
{
"journalEntryId": 1,
"type": "cash_in",
"title": "Ingreso a caja - a cancelar",
"amountCents": 1500,
"direction": "in",
"notes": "Ingreso a caja - a cancelar",
"originName": "Caja fuerte del sistema",
"destinationName": "Caja Principal",
"createdAt": "2026-09-08T16:31:19.000Z",
"actorName": "App Testing"
}
],
"pagination": {
"page": 1,
"limit": 25,
"total": 1,
"totalPages": 1,
"hasNext": false,
"hasPrev": false
}
}
}