Restofy Docs
Anticipos de clientes POST

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
min_value:1

Ejemplo de request

curl -X POST https://restofy.pro/api/customer-advances/get-customer-advance \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -H "X-Tenant-Key: <tenantKey>" \
  -d '{
    "prepaidAccountId": 1
}'

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

Ejemplo de respuesta

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

Request

{
    "prepaidAccountId": 2
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "customerAdvance": {
            "prepaidAccountId": 2,
            "prepaidUuid": "38ba380a-ab4a-11f1-b72d-f2569efa6eee",
            "accountId": 9113,
            "partyId": 1,
            "partyName": "Cliente Crédito",
            "partyPhone": "3000000099",
            "currentBalanceCents": 120000,
            "notes": "Anticipo evento corporativo",
            "status": "active",
            "isAvailable": 1,
            "createdByActorId": 15,
            "cashRegisterSessionId": 2,
            "createdAt": "2026-09-08T16:31:33.000Z",
            "expiresAt": null
        },
        "movements": [
            {
                "entryCode": "CUSTOMER-20260908-95170918",
                "entryType": "customer_advance_deposit",
                "description": "Anticipo de Cliente Crédito (test deposit)",
                "status": "normal",
                "occurredAt": "2026-09-08T16:31:34.000Z",
                "debitCents": 0,
                "creditCents": 45000
            },
            {
                "entryCode": "CUSTOMER-20260908-B8250487",
                "entryType": "customer_advance_deposit",
                "description": "Anticipo de Cliente Crédito (Anticipo evento corporativo)",
                "status": "normal",
                "occurredAt": "2026-09-08T16:31:33.000Z",
                "debitCents": 0,
                "creditCents": 75000
            }
        ]
    }
}