Skip to Content
DecoCredit Docs
Referencia de API

Referencia de API: Créditos, Estudio & Documentos

Especificación técnica de los endpoints REST para originación, auditoría y simulación.

Todos los endpoints requieren autenticación mediante Bearer JWT y validación de cabecera X-Tenant-Id.

1. Simulación y Proyección de Créditos

Generar PDF de Proyección

POST /credits/simulate/pdf
Content-Type: application/json

{
  "productId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "amount": "5000000",
  "installments": 12,
  "periodicity": "monthly",
  "amortizationSystem": "french",
  "firstDueDate": "2026-12-15"
}

Respuesta: Flujo binario application/pdf con la tabla completa y encabezado oficial.


2. Catálogo Bancario y Empleos

Listar Bancos Oficiales

GET /credits/banks

Respuesta:

[
  {
    "id": "bancolombia",
    "name": "Bancolombia",
    "code": "007",
    "isActive": true
  },
  {
    "id": "davivienda",
    "name": "Davivienda",
    "code": "051",
    "isActive": true
  }
]

Registrar Fuentes Laborales

POST /customers/:customerId/employments
Content-Type: application/json

{
  "employmentType": "public_employee",
  "companyName": "Alcaldía de Medellín",
  "position": "Profesional Universitario",
  "startDate": "2020-03-01",
  "monthlyIncome": "4500000"
}

3. Mesa de Estudio Operativa

Tomar Solicitud a Estudio

POST /credit-applications/:id/study

Efecto: Bloquea la solicitud para el analista autenticado y actualiza el estado a EN_ESTUDIO. Rechaza con 403 si el analista es el mismo originador.

Calificar Documento Específico

POST /credit-applications/:id/documents/:docId/review
Content-Type: application/json

{
  "verdict": "REJECTED",
  "presetCommentId": "doc_illegible",
  "comment": "La cédula presenta esquinas cortadas y reflejo sobre el número de identificación."
}

Emitir Acta de Historial de Crédito

POST /credit-applications/:id/history-document

Respuesta: Objeto JSON con el acta formal consolidada y enlace al PDF firmado.

On this page