Listar contactos con anticipo activo
POST /api/customer-advances/list-customers-with-advance
Descripción
Devuelve los contactos con saldo de anticipo vigente, con o sin filtro de búsqueda.
Detalles
Sin filtro retorna los 5 contactos con mayor saldo de anticipo, priorizando los más relevantes para el cajero. Con filtro por nombre busca por coincidencia y retorna hasta 25 contactos.
Permisos requeridos
auth-tenant
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| query | string | No |
max:100
|
Ejemplo de request
curl -X POST https://restofy.pro/api/customer-advances/list-customers-with-advance \
-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": {
"customers": [
{
"partyId": 1,
"partyName": "Cliente Crédito",
"partyPhone": "3000000099",
"prepaidAccountId": 2,
"currentBalanceCents": 240000,
"expiresAt": null
}
]
}
}