Preanálisis facial

Requisitos de acceso

• Permiso (módulo): viewKycQueue (ver el resultado) y reviewKyc (decidir)
• Ruta: dentro del detalle (/kyc-queue/:userId)
• Licencia/Feature: preanálisis facial habilitado para el tenant (faceMatch.enabled)

Qué es / cuándo usarlo

El preanálisis facial compara automáticamente el rostro impreso en el documento de identidad con el rostro de la selfie enviada por el inversor, y muestra el resultado en el detalle de la cola. Sirve para que el Compliance Officer llegue a la pantalla sabiendo ya dónde mirar: los casos evidentes quedan evidentes, y los dudosos quedan señalados.

La comparación se ejecuta dentro de la propia plataforma, sin consulta a servicio externo y sin costo por análisis. Ninguna imagen sale del entorno.

El veredicto es apoyo a la decisión, no la decisión

El preanálisis nunca rechaza a nadie por sí solo. Un resultado "Divergente" señala el caso para revisión — quien decide sigue siendo el Compliance Officer, con step-up, como en cualquier otra decisión de la cola.

Dónde aparece

En el detalle del inversor, en una tarjeta propia justo encima de Documentos del usuario — a propósito: lees el veredicto e inmediatamente después tienes las dos imágenes lado a lado para comprobar con tus propios ojos.

Cómo leer el resultado

La tarjeta muestra un veredicto (con color) y la distancia que lo generó.

Veredicto	Color	Qué significa	Qué hacer
Coincide	Verde	El rostro de la selfie coincide con el del documento con holgura.	Caso fácil. Sigue con la decisión normalmente.
Revisar	Amarillo	Semejanza en la franja intermedia.	Compara las imágenes antes de decidir.
Divergente	Rojo	Las imágenes no parecen ser de la misma persona.	Revisión obligatoria. Considera pedir reenvío.
No concluyente	Gris	No fue posible medir (sin rostro detectado, formato no soportado…).	Analiza manualmente, como si el preanálisis no existiera.
Fallo técnico	Gris	El motor de comparación falló.	Ídem. No invalida el registro.

La distancia

La distancia es cuánto difieren los dos rostros entre sí: cuanto menor, más parecidos. Cero significa imágenes idénticas.

La tarjeta también muestra los umbrales de la medición — los valores que separaron "coincide" de "divergente" en aquel momento. Quedan registrados junto con el resultado porque son los que dan sentido al número: si la configuración del tenant cambia después, la medición antigua sigue siendo explicable.

Como referencia de orden de magnitud:

Situación	Distancia típica
Misma persona, foto buena	cercana a 0
Misma persona, documento antiguo o mal escaneado	puede subir bastante
Personas diferentes	bien por encima del umbral de divergencia

Un documento malo aumenta la distancia sin que haya fraude

Una foto de documento antigua, plastificada, escaneada o de baja resolución aleja las mediciones — y no ocurre por igual para todo el mundo. Por eso mismo "Divergente" pide revisión en vez de rechazar. Trata el resultado como una invitación a mirar, nunca como prueba.

Otros campos de la tarjeta

• Documento utilizado — qué pieza sirvió de referencia (documento de identidad, documento bancario…).
• Rostros detectados — cuántos rostros aparecieron en cada imagen. Pasaporte y licencia de conducir suelen tener dos (el retrato y la ghost image), lo cual es normal. Más de un rostro en la selfie, en cambio, es una señal en sí misma — puede ser alguien sosteniendo la foto de otra persona.
• Medido el y Motor — cuándo se hizo la medición y con qué versión del modelo, para auditoría.

Aprobación automática

Cuando el tenant habilita la aprobación automática (faceMatch.autoApprove), un veredicto Coincide promueve la cuenta por sí solo, sin esperar a que el Compliance Officer abra la pantalla. En ese caso:

• la cuenta pasa a APPROVED y el inversor queda liberado de inmediato;
• la decisión queda registrada con revisado por SYSTEM_FACE_MATCH;
• la tarjeta muestra el mensaje "Esta medición aprobó la cuenta automáticamente";
• las notas de la revisión guardan la distancia, el umbral y el motor utilizados.

Lo que la aprobación automática nunca hace

• No rechaza. Ningún veredicto rechaza una cuenta por sí solo.
• No resucita cuentas rechazadas. Solo actúa sobre cuentas con estado general Pendiente.
• No sobrescribe una decisión humana. Si un Compliance Officer ya registró cualquier decisión para ese inversor, la automatización no actúa.

La aprobación automática es independiente del modo del tenant

autoApprove no respeta el modo AUTO × MANUAL: son claves separadas. Activada en un tenant MANUAL, aprueba cuentas sin pasar por el Compliance Officer. Si la política del tenant exige decisión humana en todos los casos, mantén la aprobación automática desactivada y usa el preanálisis solo como triaje.

Cuándo se ejecuta el análisis

• Al enviar documentos — en cuanto el inversor completa el par (documento + selfie), el análisis se ejecuta en segundo plano. Es aquí donde la aprobación automática ocurre sin depender de que alguien abra la cola.
• Al abrir el detalle — si aún no hay resultado, la medición se hace en el momento, en pocos segundos.

El resultado se reaprovecha: mientras el par de imágenes sea el mismo, el veredicto no se recalcula. Si el inversor reenvía el documento o la selfie, el análisis se rehace automáticamente.

Cuándo resulta no concluyente

Motivo mostrado	Significado
No hay documento de identidad con foto	Falta la pieza de referencia.
No hay selfie enviada	Falta la prueba de vida.
Ningún rostro detectado en el documento / en la selfie	El detector no encontró rostro en la imagen.
Formato de archivo no soportado	El preanálisis acepta JPEG y PNG. PDF no está soportado.
No fue posible leer los archivos	Fallo al buscar las imágenes en el almacenamiento.
Superó el tiempo límite / motor no disponible	Fallo técnico, reprocesado automáticamente.

Documento en PDF

Si el inversor envió la identidad como PDF, el preanálisis no puede leerlo y la tarjeta queda "No concluyente". No es señal de problema con el registro — es una limitación del análisis. Compara las imágenes manualmente en la sección Documentos del usuario.

Privacidad

La plataforma guarda únicamente el veredicto, la distancia y el contexto de la medición (qué documento se usó, cuántos rostros, qué umbrales). La firma biométrica calculada para la comparación se descarta y nunca se almacena.

Reglas de negocio / cuidados

Atención

• "Divergente" no es rechazo. Rechazar la cuenta sigue exigiendo un motivo y step-up.
• "Coincide" no sustituye la lectura del documento. Un rostro compatible no valida nombre, número, vigencia ni autenticidad de la pieza.
• Compara las imágenes siempre que el veredicto sea "Revisar" — la franja existe literalmente para eso.
• No concluyente no es sospecha. Es ausencia de información: decide con los demás paneles.

Pantallas relacionadas

• Detalle y decisión
• Cola (lista)