Listar saldos a favor — Restofy Docs

Descripción

Listado paginado de saldos a favor otorgados a clientes con filtros opcionales.

Detalles

Devuelve los saldos a favor con su saldo vigente, estado, fecha de creación y datos del cliente. Incluye totales agregados del listado.

Permisos requeridos

finance.module

Request

Nombre	Tipo	Requerido	Reglas
search	string	No	max:100
status	string	No	enum:active,redeemed,expired,cancelled
isAvailable	bool	No	—

Paginación

defaultLimit	25
maxLimit	100
defaultDir	desc
withTotal	true
allowedSorts	[createdAt, currentBalanceCents, partyName]

Ejemplo de request

curl -X POST https://restofy.pro/api/favor-balances/list-favor-balances \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -H "X-Tenant-Key: <tenantKey>"

Los valores son demo: reemplázalos por datos reales del negocio.

Ejemplo de respuesta

Actualizado: 2026-09-08T16:35:34Z

HTTP 200

Request

[]

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "favorBalances": [
            {
                "prepaidAccountId": 2,
                "prepaidUuid": "41d3917c-ab4a-11f1-b72d-f2569efa6eee",
                "accountId": 9113,
                "partyId": 1,
                "partyName": "Cliente Crédito",
                "partyPhone": "3000000099",
                "currentBalanceCents": 12000,
                "initialAmountCents": 0,
                "status": "active",
                "isAvailable": 1,
                "createdAt": "2026-09-08T16:31:48.000Z",
                "expiresAt": null
            }
        ],
        "pagination": {
            "page": 1,
            "limit": 25,
            "total": 1,
            "totalPages": 1,
            "hasNext": false,
            "hasPrev": false
        },
        "stats": {
            "totalCount": 1,
            "activeCount": "1",
            "outstandingBalanceCents": "12000",
            "totalGrantedCents": "0"
        }
    }
}