Autor:

Arnaldo Ferreira

Descripcion:

Kyc-utils es un modulo desarrollado en Java 17 con springboot 3.2.6,  de la necesidad de migrar el uso del legacy KYC que se dara de baja, buscando cubrir las funcionalidades del mismo, buscando no alterar la forma de guardado de datos en las tablas correspondientes al mismo.

Servicios rest:

1. http://{$url/ip:puerto}/api/kyc/utils/upload
2. http://{$url/ip:puerto}/api/kyc/utils/upload/data
3. http://{$url/ip:puerto}/api/kyc/utils/upload/image

Tablas impactadas:

1. Esquema: Cedula
   1. Tabla: KYC_DATA
   2. Tabla: KYC_IMAGES

Detalles de servicios:

Servicio #1 - http://{$url/ip:puerto}/api/kyc/utils/upload

Este servicio tiene la funcion de realizar el guardado de datos en las tablas mencionadas anteriormente. Primero se realiza la insercion  en la tabla de KYC_DATA, donde se registran los datos extraido de la cedula enviados en el request, y donde se genera el KYC_ID, el cual funciona como cable foranea para las referencias en la tabla de de KYC_IMAGES, para poder ubicar las imagenes frontales y traser enviadas por el usuario para obtener los datos.

Request:

Form-data

1: Nombre del campo: "front" → Tipo: Archivo → Content-Type: image/jpeg

2: Nombre del campo: "rear" → Tipo: Archivo → Content-Type: image/jpeg

3: Nombre del campo: "jsondata" → Tipo: Texto

Response posibles:

Caso de exito:

{
    "header": {
       "code": "0",
       "message": "Datos e imagenes guardadas correctamente"
    },
   "data": null
}

Caso de registro existente:

{
    "header": {
       "code": "1",
       "message": "El documento con las datos que intenta registrar, ya existen"
    },
   "data": null

}

Casos de error:

{
    "header": {
       "code": "108",
       "message": ("Fallo al guardar datos de la imagen: " || "Fallo al guardar la imagen frontal: " || "Fallo al guardar la imagen trasera: "
    },
   "data": null

}

Servicio #2 - http://{$url/ip:puerto}/api/kyc/utils/upload/data

Este servicio tiene la funcion de realizar el guardado de los datos extraidos de las imagenes de las cedulas, realizando una insercion en la tabla KYC_DATA y generando el KYC_ID al cual estaran vinculados las imagenes posteriormente para la relacion entre ellos.

Esta servicio esta creado solo para necesidad de casos especificos donde no se pueda realizar el registro en estas tablas y no se tenga que realizar por medio de scripts.

Request:

JSON:

{
    "documentNumber": "5648089",
    "surname":"FERREIRA MINADEO",
    "givenNames":"ARNALDO DANIEL",
    "sex":"M",
    "nationality":"PRY",
    "birthDate":"11-11-2001",
    "expirationDate":"19-01-2027",
    "issuingCountry":"PRY",
    "state":"RE"
}

Response posibles:

Caso de exito:

{
    "header": {
       "code": "0",
       "message": "Datos de la imagen guardados correctamente"
    },
    "data": null
}