INTEGRACIÓN DE REPORTES
 COBERTURA DE RIESGO - GARANTIAS COMUNITARIAS
(Version 1.0, septiembre 2025)

Introducción
el presente documento contiene la información requerida para que los clientes de cobertura de riesgo mediante uso de API REST (Representational state transfer), envíen en línea cada uno de los reportes requeridos como transacción de información propio del negocio, mediante cualquier dispositivo con interacción con el protocolo HTTP, por lo que es más simple y convencional que otras alternativas que se han usado en los últimos años como SOAP y XML-RPC.

Orígenes autorizados:
Antes de cada proceso de integración se deben registrar los orígenes https o IP de cada uno de los clientes. Cualquier petición proveniente diferente a las registradas será rechazada.

1.	Autenticación y obtención de token 
Esta API es requerida para que el cliente se autentique y obtenga el token temporal para uso de las demás APIs. 
<user>: Usuario proporcionado por Garantias comunitarias
<password>: contraseña proporcionada por Garantias comunitarias 

Método: GET
URL: URL https o EndPoint otorgado para la entidad 
Body  {"user":"<user>", "password":"<password>"} 
Responce:
{"status": 200, "access_token": "<token>"}
{"status": 400, "error": "invalid_client"}

2.	Reporte de desembolso

Con esta API los clientes pueden reportar uno a uno la información requerida en el desembolso.

Parametros:
Nota: consulte el anexo “diccionario de datos”
FileDto: el campo FileDto es el objeto para enviar el archivo que contiene el anexo 1 y esta conformado por los siguientes campos.
Base64String: Es el archivo en base 64 y es de tipo string.
Ext: campo de tipo string con la extensión del archivo que se envía (Ejemplo: pdf).
Ejemplo FileDto: 
{
vdfofvlj654ghghlñkfgñlffdkfdgldk…,
pdf
}

Método: POST
URL: URL https o EndPoint otorgado para la entidad

Headers
Authentication-Type: bearer “<token>”
Content-Type: application/json

Body
{
	"Numero de Convenio",
"Tipo de identificación",
"Identificación del cliente  (C.C / DNI / NIT / RUC)",
"Género del cliente",
"Edad",
"Nombre Persona Natural / Jurídica",
"Apellidos Persona Natural / Jurídica",
"Teléfono del cliente",
"Celular del cliente",
"Correo electrónico cliente",
"Dirección del cliente",
"Ciudad/Provincia/Municipio",
"Departamento/Región",
"CIIU",
"Número de pagaré",
"Número/Referencia del crédito",
"Sucursal de desembolso",
"Mes de desembolso",
"Valor/ Importe del crédito",
"Fecha desembolso",
"Fecha vencimiento",
"Tipo crédito",
"Portafolio",
"Prenda",
"Hipoteca",
"Valor/ Importe cuota",
"Plazo (meses)",
"Tasa interés nominal anual",
"Tasa interés efectiva anual",
"Período gracia",
"Tipo de cuota",
"Amortización cuota",
"Tipo de amortización de la cuota",
"Porcentaje comisión",
"Valor/Importe comisión",
"Valor/Importe Impuesto de comision",
"Valor/Importe Total comisión",
"Identificación codeudor C.C / DNI / NIT / RUC",
"Codeudor nombre Persona Natural / Jurídica",
"Codeudor apellidos",
"Codeudor Teléfono móvil",
"Codeudor dirección",
"Codeudor Provincia/Ciudad/Municipio",
"Codeudor Departamento / Región",
"Observaciones",
"FileDto"
}

Responce:
Status 200:
{
"status":"":"200"
"message":"Datos ingresados exitosamente! "
}

Status 400:
{
"status":"":"400”
"message":"<errores encontrados> "
}