Caja
POST
Abrir una sesión de caja
POST /api/cashier/open-session
Descripción
Inicia una nueva sesión de trabajo en una caja registradora declarando el monto de efectivo con el que se arranca el turno.
Detalles
Crea una sesión activa sobre la caja indicada usando el monto de apertura declarado como base inicial. Solo puede existir una sesión abierta por caja: si ya hay una activa, la solicitud falla. La caja queda marcada como preferida del usuario y la sesión recién creada se devuelve en la respuesta.
Permisos requeridos
cash.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| cashRegisterId | int | Sí |
min_value:1
|
| openingAmountCents | int | Sí |
min_value:0
|
| notes | string | No |
max:500
|
Ejemplo de request
curl -X POST https://app.restofy.co/api/cashier/open-session \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"cashRegisterId": 1,
"openingAmountCents": 1
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-07-15T13:20:48Z
HTTP 200
Request
{
"cashRegisterId": 1,
"openingAmountCents": 0
}Response
{
"success": true,
"message": "Caja abierta",
"data": {
"cashRegisterId": 1,
"activeSession": {
"cashRegisterSessionId": 2,
"cashRegisterId": 1,
"openedByActorId": 15,
"openingAmountCents": 0,
"openedAt": "2026-07-15T13:18:38.000Z",
"notes": null,
"cashRegisterName": "Caja Principal",
"openedByActorName": "App Testing"
}
}
}