API KYB de directivos y representantes: roles clave

Los directivos, directores y representantes no son un concepto independiente en el modelo KYB de Didit: forman parte de Personas clave junto con los UBO y los accionistas, y cada persona lleva uno o varios roles. Una misma persona puede ser directora y accionista, o representante y firmante autorizada: la persona tiene asignada la lista completa de roles, no solo uno.

Taxonomía completa de roles

Cada persona clave puede tener uno o varios de estos roles:

Gobierno corporativo / representación

Rol	Descripción
`director`	Miembro del consejo con responsabilidades de gobierno
`non_executive_director`	Miembro del consejo sin funciones de gestión diaria
`chairman`	Presidente del consejo
`secretary`	Secretario de la empresa, encargado de tareas administrativas y de cumplimiento
`representative`	Representante legal o designado de la empresa
`authorized_signatory`	Persona facultada para firmar en nombre de la empresa
`trustee`	Fiduciario de una estructura que tiene participaciones en la empresa
`company_officer`	Cargo general en la empresa
`founder`	Miembro fundador de la empresa
`legal_advisor`	Asesor jurídico contratado por la empresa
`other`	Cualquier rol fuera de la taxonomía estándar

Propiedad / beneficiario

Rol	Descripción
`ubo`	Beneficiario final (Ultimate Beneficial Owner): persona física que en última instancia posee o controla la empresa
`shareholder`	Accionista registrado (persona física o jurídica)
`beneficiary`	Beneficiario de un fideicomiso o estructura similar
`settlor`	Fideicomitente de un fideicomiso
`protector`	Protector de un fideicomiso
`investor`	Rol de inversor (fuera de las estructuras formales de propiedad accionarial)

Una misma persona puede pertenecer a ambas categorías: por ejemplo, un fundador que también es director y UBO tiene tres roles en el mismo registro de personas clave.

Registros con varios roles

Cada registro de persona clave incluye una lista de roles, cada uno con sus propios porcentajes de propiedad o de voto cuando corresponda. Así se ve en la respuesta una persona que es directora y accionista:

{
  "uuid": "...",
  "name": "Jane Doe",
  "first_name": "John",
  "last_name": "Doe",
  "entity_type": "person",
  "roles": [
    { "role": "director", "ownership_percent": null, "voting_percent": null },
    { "role": "shareholder", "ownership_percent": 15.0, "voting_percent": 15.0 }
  ],
  "kyc_status": "Approved",
  "kyc_session_url": "https://verify.didit.me/..."
}

Vinculación con KYC

Cada persona clave puede vincularse a una sesión individual de Verificación de usuario (KYC). La vinculación se produce automáticamente cuando la configuración del flujo de verificación (workflow) para ese rol exige KYC: el sistema crea la sesión KYC secundaria, envía por correo electrónico a la persona su enlace de verificación (si esa opción está activada) y registra el estado en la parte correspondiente. Consulta Propiedad → Cómo la configuración de roles determina la verificación para ver la lógica de enrutamiento completa. Para los valores de estado KYC seguros para B2C que se muestran en cada parte correspondiente (Approved, Declined, Pending), consulta el esquema de respuesta.

Análisis AML

Cada persona clave identificada se somete automáticamente a análisis en listas de vigilancia AML globales como parte del proceso de verificación de empresas. Las coincidencias PEP son especialmente relevantes para las funciones de gobierno corporativo: los directores y firmantes de empresas reguladas suelen aparecer en listas PEP. Consulta Análisis AML de empresas.

Indicador de verificación obligatoria

Cada parte incluye un indicador requires_verification que te dice si el flujo exige KYC para esa persona:

Valor	Significado
`true`	El KYC de esta persona debe completarse antes de que la sesión pueda aprobarse.
`false`	La persona ha sido identificada y sometida a controles AML, pero no necesita un KYC individual.

Configura qué roles requieren verificación en Workflows → [flujo KYB] → Key People → configuración por rol. Valores predeterminados habituales:

Directores y UBO por encima del umbral del flujo → requires_verification: true.
Firmantes autorizados y secretarios → opcional.
Miembros no ejecutivos del consejo → opcional.

Omitir una persona clave

Si una persona no puede verificarse (fallecida, ilocalizable o histórica), puede marcarse con is_skipped: true, ya sea por el usuario final en el flujo alojado (si la configuración del rol permite omitirla) o por un analista desde la consola. Las personas omitidas quedan excluidas del requisito de verificación, pero siguen apareciendo en la respuesta a efectos de auditoría.

Contraste entre fuentes

Los datos de cada persona clave pueden proceder de tres fuentes, y la consola muestra las tres en paralelo:

Registros oficiales: lo que publicó el registro oficial.
Aportados por el usuario: lo que el administrador de la empresa confirmó o añadió en el flujo de personas clave.
Documentos subidos: nombres extraídos mediante OCR de estatutos sociales, libros de registro de accionistas o poderes notariales.

Las incoherencias aparecen como advertencias en la decisión de la sesión.

Efecto en la entidad Business

Vincular una persona clave a una entidad User mediante KYC crea una relación duradera en la entidad Business. A partir de ahí puedes:

Ver todas las empresas en las que cada persona desempeña una función de administración o propiedad.
Propagar los cambios de estado de un User (marcado, bloqueado) a las empresas en las que actúa como persona clave.
Ejecutar la monitorización AML continua de cada persona vinculada, con independencia de cualquier sesión KYB concreta.

Próximos pasos

Personas clave

El flujo completo de personas clave.

Propiedad

Identificación de UBO y cadenas de propiedad.

AML

Análisis AML de empresas y personas.

Primeros pasos

Funciones

Perfiles de empresa

Referencia

Consola

API KYB de directivos y representantes: roles clave

Taxonomía completa de roles

Gobierno corporativo / representación

Propiedad / beneficiario

Registros con varios roles

Vinculación con KYC

Análisis AML

Indicador de verificación obligatoria

Omitir una persona clave

Contraste entre fuentes

Efecto en la entidad Business

Próximos pasos

Personas clave

Propiedad

AML

​Taxonomía completa de roles

​Gobierno corporativo / representación

​Propiedad / beneficiario

​Registros con varios roles

​Vinculación con KYC

​Análisis AML

​Indicador de verificación obligatoria

​Omitir una persona clave

​Contraste entre fuentes

​Efecto en la entidad Business

​Próximos pasos

Personas clave

Propiedad

AML

Taxonomía completa de roles

Gobierno corporativo / representación

Propiedad / beneficiario

Registros con varios roles

Vinculación con KYC

Análisis AML

Indicador de verificación obligatoria

Omitir una persona clave

Contraste entre fuentes

Efecto en la entidad Business

Próximos pasos