Guardar_Biometria - ReconoSERID/SDK-ReconoSERID-Android GitHub Wiki
+ Nuevo Guardar Biometría - SDK 3.1.0
Guardar Biometría
Método para guardar la información biométrica de un ciudadano.
Método
fun guardarBiometria(
guardarBiometriaIn: GuardarBiometriaIn,
listener: CallbackSaveBiometry
)
Estructura de Entrada (GuardarBiometriaIn)
| Parámetro JSON | Nombre Kotlin | Tipo | Requerido | Descripción | Valor por Defecto |
|---|---|---|---|---|---|
| GuidCiu/guidCiu | guidCiu |
String? | Sí | ID único del ciudadano | "" |
| GuidProcesoConvenio/guidProcesoConvenio | guidProcesoConvenio |
String? | Sí | ID del proceso de convenio | "" |
| IdServicio/idServicio | idServicio |
Int | Sí | ID del servicio | 0 |
| SubTipo/subTipo | subTipo |
String? | Sí | Tipo de biometría (ej: "FACE") | "" |
| Valor/valor | valor |
String? | Sí | Imagen biométrica (Base64) | "" |
| Formato/formato | formato |
String? | No | Formato de la imagen | "JPG_B64" |
| DatosAdi/datosAdi | datosAdi |
String? | No | Datos adicionales | "" |
| Usuario/usuario | usuario |
String? | Sí | Usuario ejecutor | "" |
| GuidConvenio/guidConvenio | guidConvenio |
String? | No | ID del convenio | "" |
| Actualizar/actualizar | actualizar |
Boolean? | No | Actualizar registro existente | false |
| BiometriaGesto/biometriaGesto | gestureBiometric |
String? | No | Imagen de gesto (Base64) | "" |
| FormatoGesto/formatoGesto | gestureFormat |
String? | No | Formato del gesto | "JPG_B64" |
| BiometriaOriginal | originalBiometric |
String? | No | Biometría original | "" |
| FormatoOriginal | originalFormat |
String? | No | Formato original | "" |
Callback (CallbackSaveBiometry)
interface CallbackSaveBiometry {
fun onSuccess(guardarBiometria: GuardarBiometria)
fun onError(respuestaTransaccion: RespuestaTransaccion)
}
Respuesta Exitosa (GuardarBiometria)
- guidBio: String - ID único de la biometría
- respuestaTransaccion: RespuestaTransaccion - Estado de la operación
Respuesta de Error (RespuestaTransaccion)
- esExitosa: Boolean - false en caso de error
- errorEntransaccion: List - Detalles del error
Ejemplos de uso
val datosBiometria = GuardarBiometriaIn(
guidCiu = "ciudadano-123",
guidProcesoConvenio = "proceso-456",
idServicio = 1,
subTipo = "IRIS",
valor = "base64...",
usuario = "operador-01"
)
ServicesOlimpia.getInstance().guardarBiometria(datosBiometria, object : CallbackSaveBiometry {
override fun onSuccess(respuesta: GuardarBiometria) {
// Biometría guardada: respuesta.guidBio
}
override fun onError(error: RespuestaTransaccion) {
if (error.errorEntransaccion.isEmpty()) {
// Error genérico
} else {
// Error específico: error.errorEntransaccion[0].codigo
}
}
})
Notas
- La clase es Parcelable para pasar entre componentes Android
- Los campos marcados con ? son nullable
- Para imágenes se recomienda formato JPG en Base64 (JPG_B64)
- Anterior - Guardar Biometría - SDK <3.0.3
Guardar Biometría
Método para guardar la información biométrica de un ciudadano.
#!java
public void guardarBiometria(@NotNull GuardarBiometriaIn guardarBiometriaIn, @NotNull CallbackSaveBiometry listener)
#!Kotlin
fun guardarBiometria(guardarBiometriaIn : GuardarBiometriaIn, listener: CallbackSaveBiometry)
- Próximamente new Guardar Biometria
Recibe como paramteros
Parámetros
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| GuardarBiometriaIn | Object | SI | Object con parametros requeridos |
| CallbackSaveBiometry | Callback | SI | Retorna un GuardarBiometria y RespuestaTransaccion |
Parámetros GuardarBiometriaIn
Parámetro | Tipo | Requerido | Descripción
------------------- | ------------- | ------------- | -------------
GuidCiu | String | SI | Identificación único del ciudadano
GuidProcesoConvenio| String | SI | Identificación único del proceso del convenio
IdServicio | Integer | SI | Id del servicio (-5: Biometria Facial -> Subtipo: Frontal. -4: Documentos -> Subtipos: Anverso o Reverso)
SubTipo | String | SI | Diferencia el servicio (-5: Biometria Facial -> Subtipo: Frontal. -4: Documentos -> Subtipos: Anverso o Reverso)
valor | String | SI | Datos biométricos Base64 (formato de la imagen "JPG_B64", puede apoyarse en la clase ImageUtils.getEncodedBase64FromFilePath(pathFace) para pasar la imagen a B64 )
formato | String | SI | Tipo de formato de imagen (JPG_B64 preferiblemente o PNG_B64)
+ gestureBiometric | String | SI | Datos biométricos Base64 (formato de la imagen "JPG_B64", puede apoyarse en la clase ImageUtils.getEncodedBase64FromFilePath(pathFace) para pasar la imagen a B64 )
+ gestureFormat | String | SI | Tipo de formato de imagen (JPG_B64 preferiblemente o PNG_B64)
datosAdi | String | Opcional | Datos adicionales, al ser opcional puede ir vacío ("")
usuario | String | SI | Usuario que guarda información
GuidConvenio | String | SI | Identificación único del convenio
actualizar | Boolean | SI | (default)false no se actualiza la biometria. *true: se actualiza la biometria (re enrolamiento)
#!java
public GuardarBiometriaIn(String guidCiu, //Identificación único del ciudadano
String GuidProcesoConvenio, //Identificación único del ciudadano
int idServicio, //Id del servicio
String subTipo, //Diferencia el servicio
String valor, //Datos biométricos Base64
String formato, //Tipo de formato de imagen (formato de la imagen "JPG_B64")
String gestureBiometric, //Datos biométricos Base64
String gestureFormat, //Tipo de formato de imagen (formato de la imagen "JPG_B64")
String datosAdi, //Datos adicionales
String usuario, //Usuario que guarda información
String guidConvenio, //Identificación único del convenio
boolean actualizar) // *false no se actualiza la biometria. *true: se actualiza la biometria
#!Kotlin
fun GuardarBiometriaIn(guidCiu : String, //Identificación único del ciudadano
GuidProcesoConvenio : String, //Identificación único del ciudadano
idServicio : Integer,//Id del servicio
subTipo : String, //Diferencia el servicio
valor : String, //Datos biométricos Base64
formato : String, //Tipo de formato de imagen (formato de la imagen "JPG_B64")
gestureBiometric : String, //Datos biométricos Base64
gestureFormat : String, //Tipo de formato de imagen (formato de la imagen "JPG_B64")
datosAdi : String, //Datos adicionales
usuario : String, //Usuario que guarda información
guidConvenio : String, //Identificación único del convenio
actualizar : boolean) // *false no se actualiza la biometria. *true: se actualiza la biometria
y devuelve la clase GuardarBiometria
Parámetros GuardarBiometria
| Parámetro | Tipo | Descripción |
|---|---|---|
| guidBio | String | Identificador único de biometría |
| RespuestaTransaccion | List | Respuesta de la transacción |
| ComparacionDocumento | Object | Objeto que contiene la información de la comparación al guardar la biometría |
Parámetros ComparacionDocumento
| Parámetro | Tipo | Descripción |
|---|---|---|
| mensaje | String | Mensaje asociado a la comparación del documento |
| porcentajeValidacionANI | Integer | Porcentaje de validación con ANI |
| porcentajeValidacionBarcode | Integer | Porcentaje de validación con el Barcode |
#!java
public GuardarBiometria(String guidBio, RespuestaTransaccion respuestaTransaccion, ComparacionDocumento comparacionDocumento)
#!Kotlin
fun GetCitizenProcessOut(guidBio: String, respuestaTransaccion : RespuestaTransaccion, comparacionDocumento : ComparacionDocumento)
ej:
#!java
GuardarBiometriaIn guardarBiometriaIn = new GuardarBiometriaIn();
guardarBiometriaIn.setGuidCiu(guidCiu);
guardarBiometriaIn.setGuidProcesoConvenio(guidProcesoConvenio);
guardarBiometriaIn.setIdServicio("5");
guardarBiometriaIn.setSubTipo(subtipo);
guardarBiometriaIn.setFormato("JPG_B64");
guardarBiometriaIn.setGestureFormat("JPG_B64");
guardarBiometriaIn.setDatosAdi("");
guardarBiometriaIn.setUsuario("test");
guardarBiometriaIn.setValor(ImageUtils.getEncodedBase64FromFilePath(pathFace));
guardarBiometriaIn.setGestureBiometric(ImageUtils.getEncodedBase64FromFilePath(pathFaceTwo));//pathFaceTwo es la segunda captura que se realiza
guardarBiometriaIn.setGuidConvenio(GuidConvenio);
guardarBiometriaIn.setActualizar(false);
ServicesOlimpia.getInstance().guardarBiometria(guardarBiometriaIn, new OlimpiaInterface.CallbackSaveBiometry() {
@Override
public void onSuccess(GuardarBiometria saveBiometry) {
// Implementación
}
@Override
public void onError(RespuestaTransaccion transactionResponse) {
// Implementación
}
});
#!Kotlin
val guardarBiometriaIn = GuardarBiometriaIn();
guardarBiometriaIn.guidCiu = guidCiu
guardarBiometriaIn.guidProcesoConvenio = guidProcesoConvenio
guardarBiometriaIn.idServicio = 5
guardarBiometriaIn.subTipo = "Frontal"
guardarBiometriaIn.formato = JPG_B64"
guardarBiometriaIn.datosAdi = ""
guardarBiometriaIn.gestureFormat = JPG_B64"
guardarBiometriaIn.usuario = "test"
guardarBiometriaIn.valor = ImageUtils.getEncodedBase64FromFilePath(stringExtra)
guardarBiometriaIn.gestureBiometric = ImageUtils.getEncodedBase64FromFilePath(stringExtra)// se envía la segunda imagen capturada
guardarBiometriaIn.guidConvenio = GuidConvenio
guardarBiometriaIn.actualizar = false
ServicesOlimpia.getInstance()
.guardarBiometria(guardarBiometriaIn, object : CallbackSaveBiometry {
override fun onSuccess(saveBiometry: GuardarBiometria) {
// Implementación
}
override fun onError(respuestaTransaccion: RespuestaTransaccion) {
// Implementación
}
})