Kuenta Docs

Appearance

Validar firmas y formalizar cuenta por cobrar​

PUT
/receivable/{creditid}/validate-signature

Valida todas las firmas de documentos asociados a una cuenta por cobrar y formaliza el crédito una vez que todas las firmas estén completas y válidas. Este proceso marca el crédito como formalmente constituido y activa el calendario de pagos.

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​

Path Parameters

creditid*

ID único del crédito a validar y formalizar

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

Request Body​

application/json
JSON
{
"forceValidation": false,
"validationNotes": "Validación realizada después de confirmación telefónica",
"skipDocuments": [
[
]
]
}

Responses​

Firmas validadas y crédito formalizado exitosamente
application/json
JSON
{
"credit": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"status": "string",
"formalizedAt": "2024-01-30T18:00:00Z",
"activationDate": "2024-02-01",
"contractNumber": "CNT-2024-001-ABC"
},
"documentsValidated": [
{
"documentId": "456e7890-e12b-34c5-d678-901234567def",
"documentType": "string",
"signatureStatus": "string",
"validatedAt": "2024-01-30T18:00:00Z",
"signatories": [
{
"name": "Juan Pérez",
"role": "string",
"signatureMethod": "string",
"validatedAt": "2024-01-30T18:00:00Z"
}
]
}
],
"validationSummary": {
"totalDocuments": 3,
"totalSignatures": 5,
"validationMethod": "string",
"validationScore": 0.98,
"warnings": [
[
]
]
},
"nextSteps": {
"disbursementEligible": true,
"firstPaymentDue": "2024-03-01",
"notificationsScheduled": 2
}
}

Playground​

Server
Authorization
Variables
Key
Value
Body

Samples​

Powered by VitePress OpenAPI