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 |
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/customer-advances/list-customer-advances \
-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": {
"customerAdvances": [
{
"prepaidAccountId": 2,
"prepaidUuid": "39d4f73e-ab4a-11f1-b72d-f2569efa6eee",
"accountId": 9113,
"partyId": 1,
"partyName": "Cliente Crédito",
"partyPhone": "3000000099",
"currentBalanceCents": 50000,
"status": "active",
"isAvailable": 1,
"createdAt": "2026-09-08T16:31:34.000Z",
"expiresAt": null
}
],
"pagination": {
"page": 1,
"limit": 25,
"total": 1,
"totalPages": 1,
"hasNext": false,
"hasPrev": false
},
"stats": {
"totalCount": 1,
"activeCount": "1",
"outstandingBalanceCents": "50000"
}
}
}