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://restofy.pro/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-11-02T19:00:57Z

HTTP 200

Request

{
    "prepaidAccountId": 2
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "favorBalance": {
            "prepaidAccountId": 2,
            "prepaidUuid": "5b93b6c2-d116-11f1-8bb6-de64ef616b7c",
            "accountId": 9113,
            "partyId": 3,
            "partyName": "Cliente Saldo 6ae8d78139280",
            "partyPhone": "+573003785350",
            "currentBalanceCents": 0,
            "initialAmountCents": 0,
            "notes": "test",
            "status": "cancelled",
            "isAvailable": 1,
            "createdByActorId": 15,
            "createdAt": "2026-11-02T18:33:38.000Z",
            "expiresAt": null
        },
        "movements": [
            {
                "entryCode": "FAVORBAL-20261102-5C1A4D9E",
                "entryType": "favor_balance_cancel",
                "description": "Anulación saldo a favor de Cliente Saldo 6ae8d78139280",
                "status": "normal",
                "occurredAt": "2026-11-02T18:33:38.000Z",
                "debitCents": 20000,
                "creditCents": 0
            },
            {
                "entryCode": "FAVORBAL-20261102-93DBB99E",
                "entryType": "favor_balance_grant",
                "description": "Saldo a favor de Cliente Saldo 6ae8d78139280: test grant",
                "status": "normal",
                "occurredAt": "2026-11-02T18:33:38.000Z",
                "debitCents": 0,
                "creditCents": 20000
            }
        ]
    }
}