PEPs y listas de bloqueo

Este conector busca el nombre de una persona en listas de personas políticamente expuestas (PEP) y en listas de bloqueo, y te devuelve las coincidencias encontradas con su porcentaje de similitud, la lista de la que provienen y los datos publicados en ella —cargo, dependencia, entidad, alias—.

Sirve para la revisión de prevención de lavado de dinero que exige identificar si tu cliente, o alguien relacionado con él, aparece en alguna de esas listas.

Para añadir este conector, ubícate en el nodo de tu workfloo en el que desees añadir tu llamada y haz clic. En la pantalla con los conectores disponibles, ve a Listas de bloqueo y elige PEPs y listas de bloqueo. Haz clic en siguiente.

En tu lienzo aparecerá el nodo PEPs y listas de bloqueo. También se agregará un formulario con los campos de nombre. Además, verás una ventana donde podrás configurar el conector.

Datos solicitados para la consulta

La búsqueda se hace por nombre completo, que se arma juntando los campos de nombre del formulario:

Campo	Obligatorio	¿Viene en el formulario?
Primer nombre	Sí	Sí, se agrega al crear el conector
Apellido paterno	Sí	Sí, se agrega al crear el conector
Segundo nombre	No	No, lo agregas tú
Apellido materno	No	No, lo agregas tú
Porcentaje de similitud	No	No, lo agregas tú

Al crear el conector, el formulario sólo recibe Primer nombre y Apellido paterno. Para buscar con el nombre completo —y para poder ajustar la similitud— agrega los demás desde el propio formulario:

Abre el nodo de formulario de tu workfloo.
Al final del panel, haz clic en Agregar campos.
Busca Segundo nombre, Apellido materno o Porcentaje de similitud y haz clic en el campo para añadirlo.
Guarda tu workfloo.

🚧
Busca con el nombre lo más completo posible:
La consulta compara el nombre que le mandas contra el de cada lista. Si el formulario sólo lleva primer nombre y apellido paterno, estás buscando con un nombre incompleto y los resultados cambian: puedes perder coincidencias reales o traer más homónimos de los necesarios.

El porcentaje de similitud

El campo Porcentaje de similitud define qué tan parecido tiene que ser un nombre de la lista al que buscas para considerarse coincidencia. Si no lo incluyes en el formulario, la consulta usa 100, es decir, sólo coincidencias exactas.

Bajarlo —por ejemplo a 80— amplía la búsqueda y ayuda con errores de captura, acentos o nombres invertidos, a cambio de más coincidencias que revisar. Es el parámetro que conviene calibrar según qué tan estricta deba ser tu revisión.

Configuración del conector

En la pestaña general este conector no te solicita credenciales: es un servicio que kiban mantiene, así que no necesitas contratar nada con un tercero ni configurar un vault.

En la pestaña Reintentos, se te mostrará un modal que te permite reintentar tu consulta hasta cinco veces, en caso de que así lo desees. También puedes seleccionar la opción no reintentar

👍
Nota:
La configuración de reintentos permite ejecutar nuevamente consultas si el servicio no está disponible sin reiniciar el flujo.

Salida de error

Junto al icono de tu conector se muestra una rama de error.

Una vez agregado el conector, tienes las siguientes posibilidades:

Cuando termine la ejecución de tu conector, terminar el flujo de tu workfloo.
Seguir con el flujo en la rama inferior (la rama de ejecución exitosa).
Definir un flujo alternativo si ocurrió un error en tu conector (salida de error).

Si haces clic en el signo + rojo se te ofrecen dos opciones: elegir un nuevo paso o uno existente, es decir, añadir un nuevo conector, o bien, hacer un enlace a alguno que ya se encuentre dentro de tu workfloo.

Si decides no determinar algún camino para seguir con el flujo, éste se terminará en cuanto se presente el error.

Si, por algún motivo, decides borrar el conector en el que determinaste una salida de error, se te muestra un modal de confirmación en el que se te advierte que todos los nodos relacionados con dicho conector en la rama de salida también serán eliminados. Si estás de acuerdo con ello, haz clic en guardar.

Guarda tu workfloo.

Ejecución

Al ejecutar tu workfloo, en el paso de PEPs y listas de bloqueo se capturan los datos de nombre en el formulario y la búsqueda se realiza de forma automática, sin intervención de tu cliente.

Que no haya coincidencias no es un error: la consulta se realizó, el flujo continúa por la rama de ejecución exitosa y el total de coincidencias llega en 0. Es, de hecho, el resultado que esperas en la mayoría de los casos.

Respuesta

Una vez que ejecutas tu workfloo, en el resumen de la ejecución, dentro de la pestaña Respuesta, podrás observar los siguientes datos:

Resumen

Dato	Descripción
Estatus	Estatus con el que respondió la consulta
Total de coincidencias	Cuántas coincidencias se encontraron
Código de validación	Código con el que se identifica la validación realizada

Coincidencias

Un renglón por cada coincidencia. Si no hubo ninguna, la sección llega vacía.

Dato	Descripción
Nombre completo	Nombre tal como aparece publicado en la lista
Similitud	Qué tanto se parece ese nombre al que buscaste, en porcentaje
Alias	Alias registrado, cuando la lista lo publica
Lista	Nombre de la lista en la que apareció
Tipo de lista	Clasificación de la lista, por ejemplo PEPs nacionales
País	País al que corresponde el registro
Entidad	Entidad federativa del registro
Posición	Cargo o posición por la que la persona está en la lista
Dependencia	Dependencia a la que pertenece
Tax ID	Identificador fiscal, cuando la lista lo publica

📘
Varios campos llegan vacíos según la lista:
Cada lista publica datos distintos. Una coincidencia en una lista de PEPs trae posición y dependencia pero no entidad; una de otra lista puede traer entidad y no cargo. Tómalo en cuenta si vas a decidir algo con un campo en particular.

🚧
Una coincidencia no es una conclusión:
Un porcentaje alto de similitud significa que los nombres se parecen, no que se trate de la misma persona: los homónimos son frecuentes. Usa el resultado para disparar una revisión —por ejemplo un paso de validación interna— y no para rechazar de forma automática.

Errores frecuentes

Estos casos terminan por la salida de error del nodo:

Situación	Qué significa
Servicio no disponible	La consulta no se pudo realizar en ese momento. Es el caso que cubren los reintentos