Caja
POST
Registrar un retiro de efectivo de la caja
POST /api/cashier/create-cash-out
Descripción
Resta dinero de la caja durante la sesión, dejando registrado el motivo del retiro.
Detalles
Registra una salida de efectivo de la caja por fuera de los pagos al cierre del turno (retiro de excedente, anticipo al dueño, corrección, etc.). El monto se descuenta del efectivo de la sesión y queda reflejado como movimiento dentro del cuadre del turno. La nota del motivo es obligatoria. Solo se permite mientras la sesión sigue abierta.
Permisos requeridos
cash.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| cashRegisterSessionId | int | Sí |
min_value:1
|
| amountCents | int | Sí |
min_value:1
|
| notes | string | Sí |
min:1
max:500
|
Ejemplo de request
curl -X POST https://app.restofy.co/api/cashier/create-cash-out \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"cashRegisterSessionId": 1,
"amountCents": 1,
"notes": "string"
}'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,
"amountCents": 2000,
"notes": "retiro excedente"
}Response
{
"success": true,
"message": "Retiro registrado",
"data": {
"cashRegisterSessionId": 2,
"type": "cash_out",
"amountCents": 2000
}
}