Kuenta Docs

Appearance

Aprobar o rechazar solicitud de crédito​

PATCH
/receivable/{creditid}/approval

Procesa la aprobación o rechazo manual de una solicitud de crédito por cobrar.

Funcionalidad:

Este endpoint permite aprobar o rechazar créditos que requieren revisión manual,
cambiando su estado de manera controlada según las políticas de la organización.

Estados y transiciones válidas:

Estado inicial requerido:

  • 1 (Pending): Pendiente de aprobación manual

Estados resultantes:

  • Aprobación: 1 (Pending) → 2 (Approved)
  • Rechazo: 1 (Pending) → 3 (Rejected)

Validaciones:

  • Solo créditos en estado Pending pueden ser procesados
  • El rechazo requiere especificar un motivo (reason)
  • Las aprobaciones pueden incluir condiciones modificadas

Permisos requeridos:

  • write:receivables: Escritura de cuentas por cobrar
  • Usuario debe tener rol de aprobador en la organización

Authorizations​

test

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://test-api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones
or
stage

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://stage-api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones
or
demo

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://demo-api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones
or
prod

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones

Parameters​

Header Parameters

Config-Organization-ID*

ID de configuración de la organización.

Formato: UUID v4
Validación: Debe corresponder a una organización activa

Typestring
Required
Example123e4567-e89b-12d3-a456-426614174000
formatuuid
Organization-ID*

ID de la organización propietaria del crédito.

Nota: Campo legacy, usar Config-Organization-ID preferentemente

Typestring
Required
Example123e4567-e89b-12d3-a456-426614174000
formatuuid

Path Parameters

creditid*

ID único del crédito a aprobar o rechazar.

Formato: UUID v4
Validación: Debe corresponder a un crédito en estado Pending

Typestring
Required
Example123e4567-e89b-12d3-a456-426614174000
formatuuid

Request Body​

application/json

Aprobación sin modificaciones a los términos originales

JSON
{
"approval": true,
"reason": "Crédito aprobado según análisis de riesgo favorable",
"comments": "Cliente cumple todos los criterios"
}

Responses​

Crédito procesado exitosamente. El estado del crédito ha sido actualizado según la decisión tomada.
application/json

Ejemplo de crédito que pasó de Pending a Approved

JSON
{
"message": "credit",
"data": {
"ID": "123e4567-e89b-12d3-a456-426614174000",
"creditorID": "456e7890-e89b-12d3-a456-426614174001",
"debtorID": "789e0123-e89b-12d3-a456-426614174002",
"creditLineID": "def5678e-e89b-12d3-a456-426614174004",
"creditAnalysisID": "123e4567-e89b-12d3-a456-426614174005",
"status": 2,
"principal": "50000.00",
"time": 30,
"rate": "0.025",
"debtRate": "0.035",
"source": "web",
"amortizationMethod": "VarPrincipalInterestV3",
"reference": "CRE-2023-001234",
"note": "Crédito aprobado según análisis de riesgo favorable",
"userLastActionID": "123e4567-e89b-12d3-a456-426614174008",
"createdAt": "2023-12-01T10:30:00Z",
"updatedAt": "2023-12-01T16:00:00Z"
}
}

Playground​

Server
Authorization
Headers
Variables
Key
Value
Body

Samples​

Powered by VitePress OpenAPI