Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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 y no alterar la forma de guardado de datos en las tablas correspondientes al mismo.

...

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.


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"
}

...

{
    "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
}


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

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.

Request:

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"}


Response posibles:

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
}