Detalle de saldo a favor

Descripción

Devuelve un saldo a favor del cliente con sus últimos movimientos.

Detalles

Retorna los datos del saldo a favor (cliente, saldo vigente, estado, fechas) y los últimos 50 movimientos que sumaron o consumieron ese saldo.

Permisos requeridos

finance.module

Request

Nombre	Tipo	Requerido	Reglas
prepaidAccountId	int	Sí	min_value:1

Ejemplo de request

curl -X POST https://app.restofy.co/api/favor-balances/get-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
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "favorBalance": {
            "prepaidAccountId": 2,
            "prepaidUuid": "9349d0ba-7eb3-11f1-ac02-f2368af4d8ac",
            "accountId": 9113,
            "partyId": 1,
            "partyName": "Cliente Crédito",
            "partyPhone": "3000000099",
            "currentBalanceCents": 25001,
            "initialAmountCents": 0,
            "notes": "test",
            "status": "active",
            "isAvailable": 1,
            "createdByActorId": 15,
            "createdAt": "2026-07-15T13:18:56.000Z",
            "expiresAt": null
        },
        "movements": [
            {
                "entryCode": "FAVORBAL-20260715-733C3E6D",
                "entryType": "favor_balance_grant",
                "description": "Saldo a favor de Cliente Crédito: test grant",
                "status": "normal",
                "occurredAt": "2026-07-15T13:18:56.000Z",
                "debitCents": 0,
                "creditCents": 1
            },
            {
                "entryCode": "FAVORBAL-20260715-0A7CB44A",
                "entryType": "favor_balance_grant",
                "description": "Saldo a favor de Cliente Crédito: test grant",
                "status": "normal",
                "occurredAt": "2026-07-15T13:18:56.000Z",
                "debitCents": 0,
                "creditCents": 25000
            }
        ]
    }
}