Arnaldo Ferreira
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.
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.
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
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
}
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.
Datos para el campo data:
documentNumber: Numero de documento
surname: Apellidos
givenNames: Nombres
sex: Opciones: M → Masculino y F → Femenino
nationality: Abreviacion de pais de origen. Ej: PRY → Paraguay, ARG → Argentina.
birthDate: fecha de nacimiento
expirationDate: fecha de vencimiento
issuingCountry: Abreviacion de pais de origen. Ej: PRY → Paraguay, ARG → Argentina.
state: Opciones: RE → Registrado, IC → Incompleto, NR → No Registrado, EX → Expirado. Recomendacion: Ya que todos los datos son introducidos manualmente, se debe colocar RE.
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"
}
Caso de exito:
{
"header": {
"code": "0",
"message": "Datos de la imagen guardados correctamente"
},
"data": {
"documentNumber": "5648089",
"surname": "FERREIRA MINADEO",
"givenNames": "ARNALDO DANIEL",
"sex": "M",
"nationality": "PRY",
"birthDate": "2001-11-11T03:00:00.000+00:00",
"expirationDate": "2027-01-19T03:00:00.000+00:00",
"kycId": 2049,
"issuingCountry": "PRY",
"state": "RE",
"creationDate": "2024-06-04T21:10:12.258+00:00",
"lastUpdate": "2024-06-04T21:10:12.258+00:00"
}
}
Caso de registro existente:
{
"header": {
"code": "1",
"message": "El documento con las datos que intenta registrar, ya existen"
},
"data": null
}
Caso de error:
{
"header": {
"code": "108",
"message": "Fallo al guardar datos de la imagen: "
},
"data": null
}
Este servicio tiene la funcion de realizar el guardado de las imagenes en la tabla KYC_IMAGES de las cuales se obtuvieron los datos guardados en la tabla KYC_DATA y se relaciona por medio del KYC_ID.
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.
Datos para el campo data:
kycId: Numero referencial a la tabla KYC_DATA
side: Especifica el lado de la imagen a ingresar. Opciones: F → Frontal y R → Trasero
type: queda siempre igual. (image/jpeg)
state: Estado de la imagenes si se validaron o no. Opciones: NV → No validado y VA → Validado. Por recomendacion si fue cargado por medio de este servicio dejar en NV para reconocer que no se pudo realizar por el flujo completo.
Form-data
1: Nombre del campo: "image" → Tipo: Archivo → Content-Type: image/jpeg
1: Nombre del campo: "data" → Tipo: Texto → {"kycId":2045,"side":"F","type":"image/jpeg","state":"NV"}
Caso de exito:
{
"header": {
"code": "0",
"message": "Imagen guardada correctamente"
},
"data": null
}
Caso de registro existente:
{
"header": {
"code": "1",
"message": "La imagen que intenta registrar, ya existe"
},
"data": null
}
Caso de error:
{
"header": {
"code": "108",
"message": "Fallo al guardar la imagen: "
},
"data": null
}