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

# Persones clau d'empresa: UBO i administradors

> Vincula titulars reals, administradors i directors a una empresa de Didit. Cada persona fa KYC com a usuari. KYB complet en una sola plataforma.

Cada entitat Business té **persones clau**: les persones físiques legalment responsables de l'empresa o que en són titulars reals. Didit les identifica durant el KYB i et permet vincular cada una a una entitat User per fer el KYC individual.

## Qui compta com a persona clau

| Rol | Descripció |
| - | - |
| **Administrador** | Consta al registre com a administrador de l'empresa |
| **Càrrec registrat** | Secretari, representant o altre càrrec oficial registrat |
| **Accionista** | Accionista registrat (corporatiu o individual) |
| **UBO (titular real en última instància)** | Persona física que, en última instància, posseeix o controla el 10/25/50% o més (llindar configurable) |
| **Signatari autoritzat** | Persona facultada per actuar en nom de l'empresa |

Consulta les pàgines [Funcionaris del KYB](https://docs.didit.me/ca/business-verification/officers.md) i [Titularitat](https://docs.didit.me/ca/business-verification/ownership.md) per a la taxonomia completa de rols i el càlcul de la cadena de titularitat.

## Com s'associen les persones clau a una empresa

**1. Identificades des del registre**

Durant el KYB, Didit consulta el registre mercantil i extreu tots els funcionaris i accionistes que hi figuren. Cada persona es converteix en un **registre de persona clau** vinculat a la sessió de Verificació d'empreses (KYB).

**2. Afegides per l'usuari (emplenades pel client)**

Els fluxos de treball poden incloure un pas "Persones clau" on l'administrador de l'empresa afegeix persones que no figuren al registre (per exemple, UBO identificats mitjançant una declaració corporativa).

**3. Agregades a l'entitat Business**

La llista de persones clau de l'entitat Business és la unió de les parts extretes del registre i de les afegides per l'usuari, sense duplicats per identitat.

Cada persona clau té un camp `source`:

* `REGISTRY`: extreta d'un registre oficial.
* `USER`: afegida per l'administrador de l'empresa durant el flux de KYB.

## Vincular una persona clau a una entitat User

Quan cal fer el KYC d'una persona clau (normalment UBO i administradors), la persona es pot vincular a una entitat 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 vincle es crea quan:

* Es du a terme una sessió de Verificació d'usuaris (KYC) per a la persona fent servir el mateix `vendor_data` que l'entitat User.
* Un analista associa manualment una part de l'empresa amb un User existent.

Un cop vinculat, l'estat de KYC de l'User es propaga a la vista de persones clau de l'entitat Business.

## Inspeccionar les persones clau

Des de la pàgina de detall de l'empresa a la consola, la pestanya **Persones clau** mostra:

* El nom, el rol, el percentatge de titularitat i la font (registre o afegida per l'usuari) de cada part
* L'estat de KYC dels Users vinculats
* L'estat del cribratge AML de cada persona
* Els documents associats (document d'identitat de l'administrador, declaració de UBO)

Per programa, les persones clau apareixen dins la matriu `key_people_checks[]` de la decisió de la sessió de Verificació d'empreses (KYB), dividit en dos grups:

```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`**: parts descobertes mitjançant la comprovació del registre.
* **`submitted.parties`**: parts que l'administrador de l'empresa ha afegit durant el flux de Persones clau (`source: USER`).
* **`ubo_kyc_summary`**: progrés agregat del KYC dels UBO.

Les matrius planes heretades `officers[]` i `beneficial_owners[]` es mantenen a la resposta per compatibilitat amb versions anteriors durant una versió més. Les integracions noves han d'utilitzar l'estructura de dos grups descrita més amunt. Consulta l'[esquema de resposta del KYB](https://docs.didit.me/ca/business-verification/response-schema.md#key_people_checks) per veure tots els camps.

## Accionistes corporatius

Quan un accionista és una empresa (i no una persona), Didit explora de manera recursiva la cadena de titularitat per identificar els titulars reals en última instància. Les parts corporatives poden activar opcionalment sessions filles de Verificació d'empreses (KYB).

Consulta [Estructura de titularitat](https://docs.didit.me/ca/business-verification/ownership.md) per a un exemple detallat de cadenes de titularitat de diversos nivells.

## Webhooks de persones clau

Els canvis en les persones clau es notifiquen mitjançant els esdeveniments de la sessió principal:

* `data.updated` (amb `session_kind: "business"`): les dades de la sessió, incloses les persones clau, s'han actualitzat.
* `status.updated` (amb `session_kind: "business"`): l'estat de la sessió ha canviat com a conseqüència.

Consulta els [webhooks del KYB](https://docs.didit.me/ca/business-verification/webhooks.md) per als payloads.

## Següents passos

> [card] [Funcionaris](https://docs.didit.me/ca/business-verification/officers.md)
>
> Identificació d'administradors i taxonomia de rols.

> [card] [Titularitat](https://docs.didit.me/ca/business-verification/ownership.md)
>
> UBO, accionistes corporatius i càlcul de la cadena.

> [card] [Flux de persones clau](https://docs.didit.me/ca/business-verification/key-people.md)
>
> El pas del KYB que recull les persones clau.


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