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-09-13T21:05:19Z

HTTP 200

Request

{
    "prepaidAccountId": 2
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "favorBalance": {
            "prepaidAccountId": 2,
            "prepaidUuid": "1ba284ab-acb4-11f1-b72d-f2569efa6eee",
            "accountId": 9113,
            "partyId": 3,
            "partyName": "Cliente Saldo 6aa70f26634b4",
            "partyPhone": "+573007259228",
            "currentBalanceCents": 0,
            "initialAmountCents": 0,
            "notes": "test",
            "status": "cancelled",
            "isAvailable": 1,
            "createdByActorId": 15,
            "createdAt": "2026-09-13T21:01:27.000Z",
            "expiresAt": null
        },
        "movements": [
            {
                "entryCode": "FAVORBAL-20260913-B65CDD30",
                "entryType": "favor_balance_cancel",
                "description": "Anulación saldo a favor de Cliente Saldo 6aa70f26634b4",
                "status": "normal",
                "occurredAt": "2026-09-13T21:01:27.000Z",
                "debitCents": 20000,
                "creditCents": 0
            },
            {
                "entryCode": "FAVORBAL-20260913-20D92F7F",
                "entryType": "favor_balance_grant",
                "description": "Saldo a favor de Cliente Saldo 6aa70f26634b4: test grant",
                "status": "normal",
                "occurredAt": "2026-09-13T21:01:27.000Z",
                "debitCents": 0,
                "creditCents": 20000
            }
        ]
    }
}