Saldos a favor
POST
Anular saldo a favor
POST /api/favor-balances/cancel-favor-balance
Descripción
Anula un saldo a favor revirtiendo su saldo vigente contra una cuenta de gasto.
Detalles
Revierte el saldo que el cliente aún no usó, deshaciendo el gasto con el que se otorgó. La cuenta de gasto ya está configurada. No mueve efectivo: el saldo a favor nunca ingresó como dinero. Lo que el cliente ya consumió no se modifica.
Permisos requeridos
finance.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| prepaidAccountId | int | Sí |
min_value:1
|
| reason | string | No |
max:200
|
Ejemplo de request
curl -X POST https://app.restofy.co/api/favor-balances/cancel-favor-balance \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"prepaidAccountId": 1
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-07-15T13:20:48Z
HTTP 200
Request
{
"prepaidAccountId": 2,
"reason": "test cancel"
}Response
{
"success": true,
"message": "Saldo a favor de cliente anulado",
"data": {
"prepaidAccountId": 2,
"journalEntryId": "2",
"balanceCents": 20000
}
}