Saldos a favor
POST
Saldo a favor de un contacto
POST /api/favor-balances/get-favor-balance-for-party
Descripción
Devuelve el saldo a favor vigente para un contacto puntual.
Detalles
Consulta puntual del saldo a favor de un contacto. Devuelve el saldo activo si existe. Se usa al cobrar una orden con el saldo a favor del contacto.
Permisos requeridos
auth-tenant
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| partyId | int | Sí |
min_value:1
|
Ejemplo de request
curl -X POST https://app.restofy.co/api/favor-balances/get-favor-balance-for-party \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"partyId": 1
}'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
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"favorBalance": {
"prepaidAccountId": 2,
"accountId": 9113,
"currentBalanceCents": 30000,
"status": "active",
"expiresAt": null,
"partyId": 1,
"partyName": "Cliente Crédito"
}
}
}