Operación de caja
POST
Entregar propinas al personal
POST /api/cashier/create-tip-payout
Descripción
Deja constancia del monto entregado al staff como pago de propinas tomado de la caja al cerrar el turno.
Detalles
Registra el monto pagado al staff por concepto de propinas durante el turno. El valor se descuenta del efectivo de la caja y queda reflejado en el cuadre. Cada pago registrado se suma a los anteriores: no reemplaza al pago previo, queda como una salida de efectivo adicional. Para dejar constancia de que no se pagó nada, se registra un monto de cero.
Permisos requeridos
cash.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| cashRegisterSessionId | int | Sí |
min_value:1
|
| amountCents | int | Sí |
min_value:0
|
| notes | string | No |
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>" \
-H "X-Tenant-Key: <tenantKey>" \
-d '{
"cashRegisterSessionId": 1,
"amountCents": 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,
"amountCents": 5000,
"notes": "propinas turno"
}Response
{
"success": true,
"message": "Propinas registradas",
"data": {
"cashRegisterSessionId": 2,
"type": "tip_payout",
"amountCents": 5000
}
}