Operación de caja
POST
Entregar propinas al personal
POST /api/cashier/create-tip-payout
Descripción
Registra la entrega de propinas al personal y la descuenta de lo que se le debe.
Detalles
Registra el monto de propinas entregado al personal y lo descuenta del total que se le debe. La plata puede salir del efectivo de una caja abierta, de un banco o de una caja fuerte. Desde caja, la salida se refleja en el cierre de esa caja. Cada entrega se suma a las anteriores. Falla si el monto supera lo que se le debe al personal o si el banco o la caja fuerte no tienen saldo suficiente.
Permisos requeridos
cash.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| amountCents | int | Sí |
min_value:1
|
| paidFromAccountId | int | Sí |
min_value:1
|
| cashRegisterSessionId | int | No |
min_value:1
|
| notes | string | Sí |
min:2
max:500
|
Ejemplo de request
curl -X POST https://restofy.pro/api/cashier/create-tip-payout \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"amountCents": 1,
"paidFromAccountId": 1,
"notes": "string"
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-10-09T02:12:12Z
HTTP 200
Request
{
"cashRegisterSessionId": 2,
"amountCents": 5000,
"notes": "propinas turno"
}Response
{
"success": true,
"message": "Propinas registradas",
"data": {
"cashRegisterSessionId": 2,
"type": "tip_payout",
"amountCents": 5000
}
}