> ## 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.

# Personas clave de empresas: UBO y directivos

> Vincula UBO, directivos, directores y beneficiarios finales a una entidad Business de Didit. Cada uno pasa KYC como entidad User. KYB integral.

Cada entidad Business tiene **personas clave**: las personas físicas legalmente responsables de la empresa o que son sus beneficiarios finales. Didit las identifica durante el KYB y te permite vincular cada una a una entidad User para realizar el KYC individual de cada una.

## Quién se considera persona clave

| Rol | Descripción |
| - | - |
| **Director** | Figura en el registro como director de la empresa |
| **Cargo de la empresa** | Secretario, representante u otro cargo registrado |
| **Accionista** | Accionista registrado (empresa o persona física) |
| **UBO (beneficiario final)** | Persona física que, en última instancia, posee o controla el 10/25/50%+ (umbral configurable) |
| **Firmante autorizado** | Persona facultada para actuar en nombre de la empresa |

Consulta las páginas de [cargos en KYB](https://docs.didit.me/es/business-verification/officers.md) y [propiedad](https://docs.didit.me/es/business-verification/ownership.md) para ver la taxonomía completa de roles y el cálculo de la cadena de propiedad.

## Cómo se asocian las personas clave a una entidad Business

**1. Identificadas a partir del registro**

Durante el KYB, Didit consulta el registro de empresas y extrae todos los directivos y accionistas que figuran en él. Cada persona se convierte en un **registro de persona clave** vinculado a la sesión de Verificación de empresas (KYB).

**2. Añadidas por el usuario (completadas por el cliente)**

Los flujos de verificación (workflows) pueden incluir un paso "Personas clave" en el que el administrador de la empresa añade personas que no figuran en el registro (por ejemplo, UBO identificados mediante una declaración corporativa).

**3. Agregadas en la entidad Business**

La lista de personas clave de la entidad Business es la unión de las personas extraídas del registro y las añadidas por el usuario, sin duplicados por identidad.

Cada persona clave tiene un campo `source`:

* `REGISTRY`: extraída de un registro oficial.
* `USER`: añadida por el administrador de la empresa durante el flujo de KYB.

## Vincular una persona clave a una entidad User

Cuando una persona clave requiere KYC (normalmente los UBO y los directores), la persona puede vincularse a una entidad User:

```mermaid theme={null}
flowchart LR
    B[Business: biz-acme]
    P1[Key Person: Jane Doe, Director]
    P2[Key Person: John Smith, UBO 40%]
    U1[User: user-jane]
    U2[User: user-john]
    P1 --> B
    P2 --> B
    P1 -.linked.-> U1
    P2 -.linked.-> U2
```

El vínculo se crea cuando:

* Se ejecuta una sesión de Verificación de usuarios (KYC) para la parte con el mismo `vendor_data` que la entidad User.
* Un analista asocia manualmente a una persona de la empresa con un User existente.

Una vez vinculada, el estado de KYC del User se propaga a la vista de personas clave de la entidad Business.

## Consultar las personas clave

Desde la página de detalle de la entidad Business en la consola, la pestaña **Personas clave** muestra:

* El nombre, el rol, el porcentaje de propiedad y el origen (registro o incorporación por el usuario) de cada persona
* El estado de KYC de los Users vinculados
* El estado del análisis AML de cada persona
* Los documentos asociados (documento de identidad del director, declaración de UBO)

Mediante la API, las personas clave aparecen dentro del array `key_people_checks[]` de la decisión de la sesión de Verificación de empresas (KYB), divididas en dos grupos:

```json theme={null}
"key_people_checks": [
  {
    "status": "Approved",
    "node_id": "feature_kyb_key_people",
    "registry": {
      "officers": [
        { "uuid": "...", "name": "Jane Doe", "role": "director", "kyc_status": "Approved", "kyc_session_url": "..." }
      ],
      "beneficial_owners": [
        { "uuid": "...", "name": "John Smith", "roles": ["ubo"], "ownership_min_shares": 40, "kyc_status": "Pending" }
      ]
    },
    "submitted": {
      "parties": [
        { "uuid": "...", "entity_type": "person", "name": "Alice Chen", "role": "ubo", "ownership_percent": 35.0, "source": "USER", "requires_verification": true, "kyc_session_status": "Not Started", "kyc_session_url": "..." }
      ]
    },
    "ubo_kyc_summary": { "total": 2, "approved": 1, "flagged": 0, "pending": 1 }
  }
]
```

* **`registry.officers` / `registry.beneficial_owners`**: personas detectadas mediante la comprobación en el registro.
* **`submitted.parties`**: personas que el administrador de la empresa añadió durante el flujo de personas clave (`source: USER`).
* **`ubo_kyc_summary`**: progreso agregado del KYC de los UBO.

Los arrays planos heredados `officers[]` y `beneficial_owners[]` se mantienen en la respuesta por compatibilidad con versiones anteriores durante una versión adicional. Las nuevas integraciones deben usar la estructura de dos grupos descrita arriba. Consulta el [esquema completo de la respuesta de KYB](https://docs.didit.me/es/business-verification/response-schema.md#key_people_checks) para ver todos los campos.

## Accionistas corporativos

Cuando un accionista es a su vez una empresa (y no una persona), Didit explora recursivamente la cadena de propiedad para identificar a los beneficiarios finales. Opcionalmente, las partes corporativas pueden iniciar sesiones secundarias de Verificación de empresas (KYB).

Consulta [Estructura de propiedad](https://docs.didit.me/es/business-verification/ownership.md) para ver un ejemplo práctico de cadenas de propiedad con varios niveles.

## Webhooks de personas clave

Los cambios en las personas clave se notifican a través de los eventos de la sesión principal:

* `data.updated` (con `session_kind: "business"`): se actualizaron los datos de la sesión, incluidas las personas clave.
* `status.updated` (con `session_kind: "business"`): el estado de la sesión cambió como consecuencia.

Consulta [Webhooks de KYB](https://docs.didit.me/es/business-verification/webhooks.md) para ver los payloads.

## Próximos pasos

> [card] [Cargos](https://docs.didit.me/es/business-verification/officers.md)
>
> Identificación de directores y taxonomía de roles.

> [card] [Propiedad](https://docs.didit.me/es/business-verification/ownership.md)
>
> UBO, accionistas corporativos y cálculo de la cadena.

> [card] [Flujo de personas clave](https://docs.didit.me/es/business-verification/key-people.md)
>
> El paso del KYB que recopila a las personas clave.


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