Restofy Docs

Saldo de anticipo de un contacto

POST /api/customer-advances/get-customer-advance-balance

Descripción

Devuelve el saldo de anticipo vigente para un contacto puntual.

Detalles

Consulta puntual del saldo de anticipo de un contacto. Devuelve el saldo activo si existe. Se usa al cobrar una orden con anticipo del contacto.

Permisos requeridos

auth-tenant

Request

Nombre Tipo Requerido Reglas
partyId int
min_value:1

Ejemplo de request

curl -X POST https://app.restofy.co/api/customer-advances/get-customer-advance-balance \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "partyId": 1
}'

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

Ejemplo de respuesta

Actualizado: 2026-07-15T13:20:48Z
HTTP 200

Request

{
    "partyId": 1
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "customerAdvance": {
            "prepaidAccountId": null,
            "accountId": null,
            "currentBalanceCents": 0,
            "status": null,
            "expiresAt": null,
            "partyId": 1,
            "partyName": "Cliente Crédito"
        }
    }
}