Kuenta Docs

Appearance

Actualizar perfil de deudor​

PUT
/debtor/{debtorid}/profile

Actualiza el perfil completo de un deudor incluyendo información personal,
financiera y campos personalizados.

Validación Automática

Este endpoint valida automáticamente todos los datos para garantizar su integridad:

  • Verificación de formato: Validación de estructura y contenido
  • Límites de seguridad: Prevención de sobrecarga de datos
  • Integridad de datos: Validación de UUIDs y referencias
  • Normalización: Limpieza automática de datos de entrada

Campos Requeridos

Personas Naturales:

  • firstName, lastName
  • idType, idNumber

Personas Jurídicas:

  • name (razón social)
  • idType, idNumber

Headers de contexto

Header Requerido Descripción
Configuration-ID Opcional UUID de la configuración de marca blanca. Se resuelve automáticamente.
Organization-ID Condicional UUID de la entidad activa

Sincronización de perfil

Este endpoint actualiza el perfil compartido (shared) del deudor. Los cambios:

  • NO se sincronizan al perfil master del deudor (sin reverse sync en API calls)
  • SÍ generan copias inmutables para créditos en evaluación via ProfileUpdatedEvent
  • La sincronización bidireccional solo ocurre durante el login del usuario a la marca blanca

Manejo de Errores

  • 400: Datos malformados o campos personalizados inválidos
  • 401: Token inválido o AmbiguousConfiguration para entidades multi-marca
  • 409: Datos duplicados (email, identificación, nombres de campos)
  • 422: Violaciones de reglas de negocio o límites

Authorizations​

bearerAuth

JWT token de autenticación. Utilice este esquema para autenticar solicitudes con un token JWT.

TypeHTTP (bearer)

Parameters​

Header Parameters

Configuration-ID

UUID de la configuración de marca blanca. Se resuelve automáticamente.

Typestring
formatuuid

Path Parameters

debtorid*

ID único del deudor

Typestring
Required
formatuuid

Request Body​

application/json
JSON
{
"natural": {
"firstName": "Juan Carlos",
"lastName": "Pérez García",
"email": "[email protected]",
"idType": 1,
"idNumber": "12345678",
"mobilePhone": "3001234567",
"customFields": [
{
"name": "ingreso_adicional",
"value": "1500000"
},
{
"name": "referencias_comerciales",
"arrayValue": [
"Empresa ABC",
"Consultoría XYZ"
]
}
]
}
}

Responses​

Perfil actualizado exitosamente
application/json
JSON
{
"profile": {
"ID": "123e4567-e89b-12d3-a456-426614174000",
"entityID": "456e7890-e89b-12d3-a456-426614174001",
"type": "natural",
"isCopy": false,
"natural": {
"profileID": "123e4567-e89b-12d3-a456-426614174000",
"status": true,
"firstName": "Juan Carlos",
"lastName": "Pérez García",
"email": "[email protected]",
"customFields": {
"ingreso_adicional": "1500000"
}
}
}
}

Playground​

Server
Authorization
Headers
Variables
Key
Value
Body

Samples​

Powered by VitePress OpenAPI