Listar anticipos de contactos
POST /api/customer-advances/list-customer-advances
Descripción
Devuelve los anticipos registrados con paginación, búsqueda libre y filtros por estado y disponibilidad.
Detalles
Retorna los anticipos del negocio con su saldo vigente, estado, fecha de creación y datos del contacto al que pertenecen. Incluye un resumen con los totales agregados del listado.
Permisos requeridos
finance.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| search | string | No |
max:100
|
| status | string | No |
in: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://app.restofy.co/api/customer-advances/list-customer-advances \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>"Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-07-15T13:20:48Z
HTTP 200
Request
[]Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"customerAdvances": [
{
"prepaidAccountId": 2,
"prepaidUuid": "8e5f0bc7-7eb3-11f1-ac02-f2368af4d8ac",
"accountId": 9113,
"partyId": 1,
"partyName": "Cliente Crédito",
"partyPhone": "3000000099",
"currentBalanceCents": 50000,
"status": "active",
"isAvailable": 1,
"createdAt": "2026-07-15T13:18:47.000Z",
"expiresAt": null
}
],
"pagination": {
"page": 1,
"limit": 25,
"total": 1,
"totalPages": 1,
"hasNext": false,
"hasPrev": false
},
"stats": {
"totalCount": 1,
"activeCount": "1",
"outstandingBalanceCents": "50000"
}
}
}