Detalle de un anticipo
POST /api/customer-advances/get-customer-advance
Descripción
Devuelve los datos de un anticipo y los últimos movimientos que afectaron su saldo.
Detalles
Retorna los datos del anticipo (contacto, saldo, estado) junto con los últimos 50 movimientos contables que afectaron su saldo.
Permisos requeridos
finance.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| prepaidAccountId | int | Sí |
min_value:1
|
Ejemplo de request
curl -X POST https://app.restofy.co/api/customer-advances/get-customer-advance \
-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-07-15T13:20:48Z
HTTP 200
Request
{
"prepaidAccountId": "2"
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"customerAdvance": {
"prepaidAccountId": 2,
"prepaidUuid": "8e33eaba-7eb3-11f1-ac02-f2368af4d8ac",
"accountId": 9113,
"partyId": 3,
"partyName": "Cliente Anticipo",
"partyPhone": "+573005241951",
"currentBalanceCents": 0,
"notes": "test deposit",
"status": "cancelled",
"isAvailable": 1,
"createdByActorId": 15,
"cashRegisterSessionId": 2,
"createdAt": "2026-07-15T13:18:47.000Z",
"expiresAt": null
},
"movements": [
{
"entryCode": "CUSTOMER-20260715-417ACFA2",
"entryType": "customer_advance_cancel",
"description": "Anulación anticipo de Cliente Anticipo - devolución",
"status": "normal",
"occurredAt": "2026-07-15T13:18:48.000Z",
"debitCents": 50000,
"creditCents": 0
},
{
"entryCode": "CUSTOMER-20260715-031721A6",
"entryType": "customer_advance_deposit",
"description": "Anticipo de Cliente Anticipo (test deposit)",
"status": "normal",
"occurredAt": "2026-07-15T13:18:47.000Z",
"debitCents": 0,
"creditCents": 50000
}
]
}
}