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-11-02T19:00:57Z
HTTP 200
Request
{
"paidFromAccountId": 16,
"cashRegisterSessionId": 2,
"amountCents": 5000,
"notes": "Para el mesero de la mesa 3"
}Response
{
"success": true,
"message": "Propinas entregadas",
"data": {
"amountCents": 5000
}
}