> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# API KYB de directivos y representantes: roles clave

> Didit verifica directores y representantes autorizados con personas clave, varios roles y screening AML. Desde $2.00 por verificación.

Los directivos, directores y representantes **no son un concepto independiente en el modelo KYB de Didit**: forman parte de [Personas clave](https://docs.didit.me/es/business-verification/key-people.md) 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:

```json theme={null}
{
  "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](https://docs.didit.me/es/business-verification/ownership.md#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](https://docs.didit.me/es/business-verification/response-schema.md#bloque-company).

## 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](https://docs.didit.me/es/business-verification/aml.md).

## 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](https://docs.didit.me/es/entities/businesses/overview.md). 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

> [card] [Personas clave](https://docs.didit.me/es/business-verification/key-people.md)
>
> El flujo completo de personas clave.

> [card] [Propiedad](https://docs.didit.me/es/business-verification/ownership.md)
>
> Identificación de UBO y cadenas de propiedad.

> [card] [AML](https://docs.didit.me/es/business-verification/aml.md)
>
> Análisis AML de empresas y personas.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.