1. Flujos de Notificación de GBDS 4¶
Cuando GBDS realiza operaciones de inscripción y actualización, se envían notificaciones a los puntos finales designados para informar su resultado. La entidad responsable de este flujo se llama Notificador.
Este documento describe algunos de los flujos de notificación durante las operaciones de inscripción y actualización.
See also
Para obtener más información sobre los flujos de notificación durante la secuencia y el control de calidad, consulte la documentación de Secuencia y Control de Calidad.
Note
Cualquier notificación enviada por el Notificador es una solicitud HTTP POST a un punto final configurado (http://<dirección>:<puerto>) que contiene un objeto JSON. El modelo JSON para cada notificación se muestra a continuación.
Warning
El punto final para recibir notificaciones debe ser implementado individualmente para cualquier sistema.
Important
El notificador solo acepta 200 como respuesta OK.
1.1. Transacción Aceptada¶
Todas las transacciones asíncronas recibidas se encolarán. Después del procesamiento, se enviará una notificación informando que la operación se completó.
El mensaje de notificación será como el siguiente ejemplo:
{
"operation": "<operación>", "tguid": "<tguid>", "status": "<estado>"
}
Note
Las posibles operaciones en este paso son: ENROLL, UPDATE o SEARCH.
Note
El notificador puede devolver diferentes estados según la operación que se esté realizando. Los posibles estados finales son:
| Operation | Status |
|---|---|
| Enroll/Update | ENROLLED, FAILED |
| Search | MATCH, NOT_MATCH, FAILED, PERSON_NOT_FOUND |
El estado FAILED ocurre cuando una transacción se aborta o no se puede finalizar.
El estado PERSON_NOT_FOUND ocurre cuando se solicita una búsqueda 1:1, pero el perfil de referencia no existe para la clave proporcionada.
En algunos casos, GBDS identifica una transacción que no se pudo finalizar y requiere más acción. Estos escenarios generan diferentes estados y se describen en las siguientes secciones.
1.2. Transacción Enviada para Revisión Manual¶
En los casos en que GBDS identificó problemas relacionados con la secuencia o el control de calidad y se envió la transacción para revisión manual para correcciones, se enviará una notificación informando que la inscripción está pendiente, como se muestra en el siguiente ejemplo:
{
"operation": "ENROLL", "tguid": "<tguid>", "status": "PENDING"
}
See also
Para obtener más información sobre los flujos de notificación durante la secuencia y el control de calidad, consulte la documentación de Secuencia y Control de Calidad.
See also
Consulte el Manual de MIR para obtener más información sobre cómo manejar las transacciones enviadas para revisión manual.
1.3. Transacción con Excepción Biométrica¶
Si se genera una excepción durante el procesamiento de la transacción, la transacción entrante se enviará para tratamiento de excepción para su análisis. En este caso, se envía una notificación informando que la transacción incurrió en una excepción, como se muestra en el siguiente ejemplo:
{
"operation": "ENROLL", "tguid": "<tguid>", "status": "EXCEPTION"
}
Note
Las notificaciones generadas por las operaciones de actualización no diferirán el campo “operación”, por lo que el campo "operación": "ENROLL" será igual para ambos tipos de operaciones.
See also
Consulte el Manual de ETR para obtener más información sobre cómo tratar las excepciones.
1.3.1. Tratamiento de Excepciones¶
El proceso de tratamiento de excepciones generará diferentes notificaciones en función de la decisión proporcionada, los flujos de notificación para cada decisión se presentarán en esta sección.