Restofy Docs
Caja POST

Registrar el pago de propinas al cierre del turno

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 cierre de la sesión. El valor se descuenta del efectivo de la caja y queda reflejado en el cuadre del turno. Si ya existía un pago de propinas registrado en la misma sesión, el nuevo valor lo reemplaza por completo.

Permisos requeridos

cash.module

Request

Nombre Tipo Requerido Reglas
cashRegisterSessionId int
min_value:1
amountCents int
min_value:0
notes string No
max:500

Ejemplo de request

curl -X POST https://app.restofy.co/api/cashier/create-tip-payout \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "cashRegisterSessionId": 1,
    "amountCents": 1
}'

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": "snapshot test"
}

Response

{
    "success": true,
    "message": "Propinas registradas",
    "data": {
        "cashRegisterSessionId": 2,
        "type": "tip_payout",
        "amountCents": 2000
    }
}