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/banksRespuesta:
[
{
"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/studyEfecto: 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-documentRespuesta: Objeto JSON con el acta formal consolidada y enlace al PDF firmado.