Kuenta Docs

Appearance

Crear deudor​

POST
/debtor

Crea un nuevo deudor (tercero) asociado a la organización del usuario actual.

Funcionalidad:

  • Registra una entidad (persona natural o jurídica) como deudor
  • Establece relación creditor-debtor
  • Valida datos de identificación únicos
  • Configura permisos y roles automáticamente

Tipos de entidad:

  • natural: Persona natural
  • legal: Persona jurídica

Casos de uso:

  • Registro de nuevos clientes
  • Onboarding de deudores
  • Gestión de cartera de terceros

Permisos requeridos: WriteChildEntity

Authorizations​

bearerAuth

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

TypeHTTP (bearer)

Parameters​

Header Parameters

Config-Organization-ID*

ID de la organización configuradora

Typestring
Required
Example550e8400-e29b-41d4-a716-446655440000
formatuuid
Organization-ID*

ID de la organización creditor

Typestring
Required
Example660e8400-e29b-41d4-a716-446655440001
formatuuid

Request Body​

application/json
JSON
{
"type": "string",
"idType": "string",
"idNumber": "string"
}

Responses​

Deudor creado exitosamente
application/json
JSON
{
"data": {
"debtor": {
"id": "string",
"type": "string",
"idType": "string",
"idNumber": "string",
"status": "string",
"parentID": "string",
"profile": {
"id": "string",
"name": "string",
"email": "string",
"phone": "string"
},
"createdAt": "string",
"updatedAt": "string"
}
},
"success": true
}

Playground​

Server
Authorization
Headers
Body

Samples​

Powered by VitePress OpenAPI