Consultar Validacion - ReconoSERID/SDK-ReconoSERID-Android GitHub Wiki
+ Nueva Consultar Validacion - SDK 3.1.0Método
fun getConsultValidation(
consultValidationIn: ConsultValidationIn,
listener: CallbackConsultValidation
)
| Parámetro JSON | Nombre Kotlin | Tipo | Requerido | Descripción | Valor por defecto |
|---|---|---|---|---|---|
| clave/Clave | clave | String? | Sí | Clave de consulta | "" |
| codigoCliente/CodigoCliente | codigoCliente | String? | Sí | Código del cliente | "" |
| guidConv/GuidConv | guidConv | String? | No | GUID del convenio | "" |
| procesoConvenioGuid/ProcesoConvenioGuid | procesoConvenioGuid | String? | No | GUID del proceso de convenio | "" |
| usuario/Usuario | usuario | String? | Sí | Usuario que realiza la consulta | "" |
** Callback (CallbackConsultValidation) **
interface CallbackConsultValidation {
fun onSuccess(response: ConsultValidationOut)
fun onError(error: RespuestaTransaccion)
}
Respuesta Exitosa (ConsultValidationOut)
(Asumiendo estructura estándar)
-
resultado: [Tipo de dato según respuesta] - Resultado de la validación
-
respuestaTransaccion: RespuestaTransaccion - Estado de la operación
Respuesta de Error (RespuestaTransaccion)
-
esExitosa: Boolean - false en caso de error
-
errorEntransaccion: List - Detalles del error
Ejemplo de Uso
val consulta = ConsultValidationIn(
clave = "CONSULTA_123",
codigoCliente = "CLIENTE_X",
usuario = "USER_001",
guidConv = "conv-guid-456"
)
ServicesOlimpia.getInstance().getConsultValidation(consulta, object : CallbackConsultValidation {
override fun onSuccess(response: ConsultValidationOut) {
// Procesar resultado de validación
}
override fun onError(error: RespuestaTransaccion) {
error.errorEntransaccion.firstOrNull()?.let {
// Manejar error específico: it.codigo, it.descripcion
} ?: run {
// Manejar error genérico
}
}
})
1.Campos Obligatorios:
- Mínimo requerido: clave, codigoCliente y usuario
- Anterior - Consultar Validación - SDK <3.0.3Método para consultar una validación
#!java
public void onGetConsultValidation(@NotNull ConsultValidationIn consultValidationIn, @NotNull CallbackConsultValidation listener)
#!Kotlin
fun onGetConsultValidation(consultValidationIn : ConsultValidationIn, listener: CallbackConsultValidation)
Parametros de entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| consultValidationIn | ConsultValidationIn | SI | Es una objeto que contiene los datos de la consulta de la validación |
| CallbackConsultValidation | Callback | SI | Retorna un ConsultValidationOut y RespuestaTransaccion |
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| clave | String | SI | Clave del asesor que se entregó con las credenciales del convenio |
| codigoCliente | String | Opcional | Se recomienda que vaya vacío |
| guidConv | String | SI | Identificador del convenio |
| procesoConvenioGuid | String | SI | Identificador del proceso convenio |
| usuario | String | SI | Nombre del asesor que se entregó con las credenciales del convenio |
#!java
public ConsultValidationIn( String clave,
String codigoCliente,
String guidConv,
String procesoConvenioGuid,
String usuario)
#!Kotlin
fun ConsultValidationIn( clave : String,
codigoCliente : String,
guidConv : String,
procesoConvenioGuid : String,
usuario : String)
y devuelve:
| Parámetro | Tipo | Descripción |
|---|---|---|
| ConsultValidationOut | Object | Objeto que contiene la información de la consulta |
| RespuestaTransaccion | Object | Objeto que describe si el servicio fue o no consultado |
| Parámetro | Tipo | Descripción |
|---|---|---|
| code | Integer | Código asociado a la consulta del servicio |
| codeName | String | Descripción asociada a la consulta del servicio |
| data | Object | Objeto que contiene la solicitud del ciudadano |
| DataError | Object | Objeto que describe si el servicio fue o no consultado correctamente |
| Parámetro | Tipo | Descripción |
|---|---|---|
| aprobado | Boolean | Verifica si el proceso fue aprobado o no |
| asesor | String | Asesor almacenado del ciudadano |
| cancelado | Boolean | Verifica si el proceso fue cancelado o no |
| celular | String | Número de celular almacenado del ciudadano |
| codigoCliente | String | Número de codigoCliente almacenado del ciudadano |
| comparacionRostroDocumento | Boolean | Verifica sí el rostro sé comparo con el documento |
| String | Email almacenado del ciudadano | |
| encontradoEnFuente | Boolean | Verifica si el ciudadano fue encontrado en las fuentes abiertas |
| estadoDescripcion | String | Descripcion del resultado de la validación |
| estadoProceso | Integer | Devuelve 1- si es enrolamiento y 2 – si es validación |
| fechaFinalizacion | String | Fecha de finalización de la emisión |
| fechaDeRegistro | String | Fecha de registro de la emisión |
| fechaNacimiento | String | Fecha de nacimiento del solicitante |
| finalizado | Boolean | Verifica si el proceso fue finalizado o no |
| fuentesAbiertas | Object | Objeto que contiene la consulta de las fuentes abiertas |
| guidConv | String | GuidConvenio almacenado del ciudadano |
| motivoCancelacion | Any() | Ignorar |
| motivoId | Integer | Id de la emisión |
| nombreSede | String | Nombre de la sede del solicitante |
| numDoc | String | Número de documento almacenado del ciudadano |
| primerApellido | String | Primer apellido del solicitante |
| primerNombre | String | Primer nombre del solicitante |
| procesoConvenioGuid | String | ProcesoConvenioGuid almacenado del ciudadano |
| scoreProceso | Any() | Ignorar |
| scoreRostroDocumento | Integer | Sí el rostro sé comparo con el documento, arroja un porcentaje de comparación (0 siendo nada parecidos, 100 identicos) |
| sede | String | Sede del solicitante |
| segundoApellido | String | Segundo apellido del solicitante |
| segundoNombre | String | Segundo nombre del solicitante |
| servicio | List | Objeto que contiene una información listada de los servicios asociados alciudadano |
| tipoDoc | String | Tipo de documento almacenado ( CC, CE, TI, etc) |
| Parámetro | Tipo | Descripción |
|---|---|---|
| estado | String | Estado asociada a las fuentes abiertas |
| fecha | String | Fecha de consulta de las fuentes abiertas |
| fuentes | List | Información de las fuentes abiertas |
| fuentesRaw | List | Información adicional de las fuentes abiertas |
| hibp | Object | Ignorar |
| ipGeo | Object | Ignorar |
| ipScam | Object | Ignorar |
| queryToken | String | queryToken asociado a la consulta de fuentes abiertas |
| riesgo | Boolean | Riesgo del ciudadano en las fuentes abiertas |
| score | Integer | Porcentaje asociado a la consulta de fuentes abiertas |
| texto | String | Texto asociado a la consulta de fuentes abiertas |
| transactionGuid | String | TransactionGuid asociado a la consulta de fuentes abiertas |
| Parámetro | Tipo | Descripción |
|---|---|---|
| Barcode | Object | Información del barcode contenida en el servicio |
| documentIsValid | Boolean | Indica si el documento es válido o no |
| fecha | String | Fecha de consulta del servicio |
| score | Integer | Porcentaje del servicio |
| servicio | String | Nombre de consulta del servicio |
| subTipos | Any() | Ignorar |
| terminado | Boolean | Indica si el servicio fue terminado correctamente o no |
| tipo | String | Tipo de servicio cosultado |
| Parámetro | Tipo | Descripción |
|---|---|---|
| fechaExpedicionDoc | String | Fecha de expedición del documento |
| fechaNacimiento | String | Fecha de nacimiento del solicitante |
| numDoc | String | Número del documento a almacenar |
| primerApellido | String | Primer apellido del solicitante |
| primerNombre | String | Primer nombre del solicitante |
| rh | String | RH del solicitante |
| segundoApellido | String | Segundo apellido del solicitante |
| segundoNombre | String | Segundo nombre del solicitante |
| sexo | String | Genero del solicitante |
| tipoDoc | String | Tipo de documento almacenado en el barcode (CC, TI, CE, etc) |
#!java
public ConsultValidationOut( int code, //Código asociado a la consulta del servicio
String codeName, //Descripción asociada a la consulta del servicio
Data data) //Objeto que contiene la consulta de validación del ciudadano
DataError dataError) //Objeto que describe si el servicio fue o no consultado correctamente
#!Kotlin
fun ConsultValidationOut(code: Integer, //Código asociado a la consulta del servicio
codeName: String, //Descripción asociada a la consulta de validación del servicio
data: Data) //Objeto que contiene la solicitud del ciudadano
dataError: DataError) //Objeto que describe si el servicio fue o no consultado correctamente
Ej:
#!java
un ConsultValidationIn( clave : String,
codigoCliente : String,
guidConv : String,
procesoConvenioGuid : String,
usuario : String)
ConsultValidationIn consultValidationIn = new ConsultValidationIn();
consultValidationIn.setClave("clave");
requestValidationIn.setCodigoCliente(""); //Se recomienda que vaya vacío
requestValidationIn.setGuidConv("guidConv");
requestValidationIn.setProcesoConvenioGuid("procesoConvenioGuid");
requestValidationIn.setUsuario("usuario");
ServicesOlimpia.getInstance().getConsultValidation(consultValidationIn, new OlimpiaInterface.CallbackConsultValidation() {
@Override
public void onSuccess(ConsultValidationOut consultValidationOut) {
//Implementación
}
@Override
public void onError(RespuestaTransaccion transactionResponse) {
//Implementación
}
});
#!Kotlin
val consultValidationIn = ConsultValidationIn()
consultValidationIn.clave("clave")
consultValidationIn.codigoCliente("") //Se recomienda que vaya vacío
consultValidationIn.guidConv("guidConv")
consultValidationIn.procesoConvenioGuid("procesoConvenioGuid")
consultValidationIn.usuario("usuario")
ServicesOlimpia.getInstance()
.getRequestValidation(consultValidationIn, object : CallbackConsultValidation {
override fun onSuccess(consultValidationOut: ConsultValidationOut) {
// Implementación
}
override fun onError(respuestaTransaccion: RespuestaTransaccion) {
// Implementación
}
})