Saldos a favor
POST
Otorgar saldo a favor
POST /api/favor-balances/create-favor-balance
Descripción
Otorga un saldo a favor al cliente, imputado a una cuenta de gasto.
Detalles
Suma el monto otorgado al saldo a favor del cliente. El gasto queda imputado a la cuenta configurada para este fin (devolución, ajuste comercial). No mueve efectivo de caja, pero se otorga desde una caja con sesión abierta. El motivo es obligatorio. Puede pedir PIN según la configuración del restaurante.
Permisos requeridos
finance.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| partyId | int | Sí |
min_value:1
|
| amountCents | int | Sí |
min_value:1
|
| cashRegisterSessionId | int | Sí |
min_value:1
|
| reason | string | Sí |
min:1
max:200
|
| notes | string | No |
max:500
|
| expiresAt | datetime | No | — |
| pin | string | No |
max:60
|
Ejemplo de request
curl -X POST https://app.restofy.co/api/favor-balances/create-favor-balance \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"partyId": 1,
"amountCents": 1,
"cashRegisterSessionId": 1,
"reason": "string"
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-07-15T13:20:48Z
HTTP 200
Request
{
"partyId": 1,
"amountCents": 25000,
"cashRegisterSessionId": 2,
"reason": "test grant",
"notes": "test"
}Response
{
"success": true,
"message": "Saldo a favor de cliente otorgado",
"data": {
"prepaidAccountId": "2",
"amountCents": 25000
}
}