> ## 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 de persones clau KYB: UBO i administradors

> Verifica UBO, accionistes i administradors amb Didit en un sol flux KYB amb comprovacions per rol. Des de $2.00 per verificació, sense contractes.

**Persones clau** és el model unificat de Didit per a totes les persones físiques i entitats corporatives vinculades a l'empresa que verifiques: titulars reals (UBO), accionistes (individuals i corporatius), administradors, representants i altres càrrecs. Un únic flux de Persones clau ho cobreix tot, amb una distribució de la verificació segons el rol i una comparació completa en paral·lel entre les persones i entitats obtingudes del registre i les enviades per l'usuari.

> [!NOTE]
>
> Per a la vista de Persones clau a nivell d'empresa, que mostra com s'agreguen els càrrecs i els UBO entre sessions, consulta [Empreses → Persones clau](https://docs.didit.me/ca/entities/businesses/key-people.md).

## Com funciona

**1. Precompletat amb el registre (opcional)**

Si el flux de treball activa el precompletat amb el registre, la pantalla de Persones clau es precompleix amb els UBO, accionistes i càrrecs disponibles extrets de la consulta al registre.
L'usuari final pot editar, afegir o eliminar persones abans d'enviar, fins i tot quan la informació de titularitat encara està pendent.
Els càrrecs que ja s'han rebut continuen disponibles mentre es recull l'informe de titularitat.
Abans de l'enviament, els resultats tardans omplen els camps que no s'han tocat i afegeixen les persones que falten, sense substituir les edicions ni restaurar les persones eliminades.
Un editor obert no es modifica; el precompletat addicional s'aplica quan el sol·licitant el tanca.
Amb el precompletat amb el registre desactivat, els sol·licitants introdueixen les persones ells mateixos, i els resultats tardans del registre no omplen aquest formulari.
Les dades del registre que arriben després de l'enviament continuen formant part de l'evidència del registre, però no canvien la llista de persones enviada ni creen automàticament sessions filles de verificació addicionals.

**2. Enviament des del flux allotjat**

L'usuari final envia la llista definitiva de persones clau a través del flux de verificació allotjat. Per defecte, no cal que cridis tu aquest pas: passa dins del flux KYB la URL del qual vas lliurar des de [Crear sessió](https://docs.didit.me/ca/sessions-api/create-session.md).
Si vols mantenir la teva pròpia interfície, utilitza els endpoints de [esborrany de persona](https://docs.didit.me/ca/sessions-api/kyb-create-party-draft.md) i [enviar persones](https://docs.didit.me/ca/sessions-api/kyb-submit-parties.md).

**3. Encaminament de la verificació segons el rol**

Per a cada persona enviada, Didit comprova la configuració de verificació del rol:

* Aplica el llindar de titularitat del flux: els UBO i accionistes per sota del percentatge configurat no requereixen verificació individual.
* Respecta la marca «saltar la verificació» que l'usuari final hagi establert, si el rol permet saltar-la.
* Crea una sessió filla de Verificació d'usuaris (KYC) per a les persones que requereixen KYC.
* Crea una subsessió KYB filla per als UBO corporatius quan el flux té activat el KYB niat.

**4. Progressió de l'estat**

L'estat de la funcionalitat Persones clau passa a `Awaiting User` mentre qualsevol sessió filla necessària encara estigui en curs. Quan totes les sessions filles acaben, l'estat s'agrega com a `Approved`, `Declined` o `In Review` segons els resultats.

## Rols recollits

Les persones clau poden tenir un o diversos dels rols següents; una mateixa persona en pot tenir diversos alhora (per exemple, administradora **i** accionista). La taxonomia completa:

| Categoria | Rols |
| - | - |
| **Titularitat** | `ubo`, `shareholder`, `beneficiary`, `settlor`, `protector`, `investor` |
| **Govern / representació** | `director`, `non_executive_director`, `chairman`, `secretary`, `representative`, `authorized_signatory`, `trustee`, `company_officer`, `founder`, `legal_advisor`, `other` |

Cada rol es pot configurar individualment al flux de treball: activat o desactivat, obligatori o opcional per a KYC, assignat a un flux KYC concret i, opcionalment, que es pot ometre. Consulta [Titularitat](https://docs.didit.me/ca/business-verification/ownership.md) per als detalls de la distribució de la verificació.

## Dades recollides per persona clau

El flux allotjat demana un conjunt predeterminat de camps i els camps personalitzats addicionals configurats al flux de treball. Consulta [Titularitat → Camps recollits](https://docs.didit.me/ca/business-verification/ownership.md#dades-recollides-per-a-cada-persona-clau) per a la llista completa.

## Confirmació del registre

Abans del pas de Persones clau, l'usuari final revisa les dades de l'empresa extretes de la **Verificació del Registre** i, si ho vol, edita qualsevol camp. A continuació, el flux allotjat emmagatzema:

* El **detall del registre** que Didit ha normalitzat a partir de la consulta al registre (`registry_data`).
* Les **dades confirmades per l'usuari** (`user_provided_data`) amb una marca de temps que indica quan les va confirmar l'usuari.
* Una vista canònica combinada als camps de primer nivell de l'empresa: les confirmades per l'usuari quan n'hi ha, i les del registre com a alternativa en cas contrari.

Consulta [Dades de l'empresa → Dades del registre vs. proporcionades per l'usuari](https://docs.didit.me/ca/business-verification/company-data.md#dades-del-registre-i-dades-proporcionades-per-l’usuari) per al model complet.

## Estructura a la resposta de decisió

Després de l'enviament, les persones clau recollides apareixen a la decisió KYB dins de `key_people_checks[]`, dividides en dos grups: **registre** (el que ha revelat el proveïdor) i **enviades** (el que l'administrador de l'empresa ha confirmat a través del flux). A més, hi ha un `ubo_kyc_summary` que resumeix el progrés KYC dels UBO. Consulta la [referència completa de key\_people\_checks](https://docs.didit.me/ca/business-verification/response-schema.md#key_people_checks).

## Comportament en tornar a enviar

* **Persones clau** i **Verificació del Registre** no es poden tornar a enviar directament. Per tornar a verificar una persona concreta, torna a enviar la sessió filla KYC d'aquesta persona.
* Quan es torna a enviar una sessió filla KYC, l'estat de la funcionalitat pare Persones clau torna automàticament a `Awaiting User`.
* Quan la sessió filla reenviada acaba, la funcionalitat principal torna a agregar l'estat segons els estats de totes les sessions filles.
* Una sessió filla que s'ha eliminat, o que ha caducat abans que la persona la comencés, no es pot tornar a enviar: [regenera la persona](https://docs.didit.me/ca/sessions-api/regenerate-kyb-party.md) per emetre un enllaç nou sobre la mateixa persona.

## Quant de temps dura l'enllaç de verificació d'una persona clau

La sessió KYC filla d'una persona clau segueix el temps de caducitat de la sessió del flux de treball KYC configurat per al seu rol, no el del flux de treball KYB. Si assignes un rol a un flux KYC que permet quatre setmanes, l'enllaç d'aquesta persona es podrà utilitzar durant quatre setmanes, fins i tot si la sessió de l'empresa està configurada per caducar abans.

El valor és una configuració per flux de treball, d'1 hora a 4 setmanes (`session_expiration_time`, en segons), a *Workflows → \[KYC workflow] → Settings*.

La caducitat canvia el que pots fer amb la part. Un enllaç que va caducar abans que la persona comencés, com un enllaç la sessió del qual s'ha eliminat, es pot tornar a emetre amb [Regenera la sessió KYC de persones clau](https://docs.didit.me/ca/sessions-api/regenerate-kyb-party.md). Les sessions eliminades compleixen els requisits encara que la persona ja hagués començat o acabat la verificació. Les sessions importades no hi tenen dret per caducitat; han d'haver estat eliminades. Una sessió que no s'ha eliminat i que la persona ja havia començat no hi té dret per caducitat.

## Opcions de configuració

Tot el comportament de les persones clau es configura per flux de treball des de la Business Console:

| Configuració | Què controla |
| - | - |
| **Emplenament previ des del registre** | Emplena prèviament el formulari de persones clau amb dades del registre |
| **Camps addicionals — persones** | Camps personalitzats per recollir per a cada part corresponent a una persona |
| **Camps addicionals — empreses** | Camps personalitzats per recollir per a cada part corporativa |
| **Llindar de titularitat d'UBO** | Percentatge mínim de titularitat per classificar algú com a UBO |
| **Llindar de titularitat d'accionista** | Percentatge mínim de titularitat per classificar algú com a accionista |
| **Configuració per rol** | Per a cada rol: activat o desactivat, requerir KYC, flux KYC a utilitzar, omissible |
| **KYB niat per a UBO corporatius** | Quan està activat, els UBO corporatius activen la seva pròpia sessió KYB filla |
| **Reutilitzar individus verificats** | Consulta [Reutilització d'individus verificats entre comprovacions KYB](#reutilització-d’individus-verificats-entre-comprovacions-kyb) més avall |
| **Notificar les parts per correu electrònic** | Envia automàticament a cada persona clau un correu electrònic amb el seu enllaç de verificació |

Configura-ho a *Workflows → \[KYB workflow] → Key People* de la consola.

## Reutilització d'individus verificats entre comprovacions KYB

Quan **Reutilitzar individus verificats** està activat en un flux de treball (per defecte), una persona clau no ha de tornar a fer el KYC cada vegada que apareix en una nova comprovació KYB. Didit busca un KYC aprovat existent d'una comprovació KYB anterior i l'enllaça a la nova part, en lloc de crear una sessió KYC filla nova.

> [!NOTE]
>
> Aquest és un mecanisme diferent de [KYC reutilitzable](https://docs.didit.me/ca/core-technology/reusable-kyc/overview.md), que permet que un *usuari final* porti voluntàriament una sessió completada entre aplicacions separades integrades amb Didit mitjançant un token de compartició o importació. La reutilització de KYB d'aquesta pàgina és automàtica, la configura el flux de treball i es limita a les persones clau d'una mateixa aplicació: no hi ha cap token de compartició i no cal que l'usuari final faci res.

**Coincidència.** Una possible coincidència es troba comparant el nom complet de la persona indicada (sense distingir majúscules i minúscules, i amb els espais inicials i finals eliminats) amb les persones clau de les altres comprovacions KYB de l'aplicació. No hi ha cap altre senyal de coincidència: no es requereix ni es comprova cap coincidència de número de document, de correu electrònic o de telèfon. Un nom escrit amb una ortografia diferent, amb un segon nom o amb una transliteració no coincidirà, i en casos excepcionals dues persones diferents que comparteixen nom podrien coincidir. Tingues-ho en compte quan revisis els resultats de persones clau.

**Abast.** La cerca abasta totes les altres comprovacions KYB que pertanyen a la *mateixa aplicació*, no només la comprovació KYB actual ni altres aplicacions de la teva organització. Una persona verificada com a UBO a l'Empresa A es pot trobar quan més tard aparegui com a administradora a l'Empresa B, sempre que les dues comprovacions s'executin sota la mateixa aplicació.

**Estats elegibles.** Només el KYC més recent d'una part amb l'estat **Aprovada** és elegible per a la reutilització. Un KYC amb l'estat **Rebutjada** per a aquell nom bloqueja la reutilització completament: la part queda marcada i es demana un KYC nou en lloc de recórrer al rebutjat. Un KYC amb l'estat **En Revisió** mai es considera una possible coincidència.

**Conservació.** La cerca només té en compte les sessions KYC creades en aproximadament l'últim any i que no s'han eliminat. Si l'única sessió coincident queda fora d'aquesta finestra, o la persona o l'organització l'ha eliminat, la comprovació no troba cap coincidència elegible i sol·licita un KYC nou sense avisar. Mai falla ni bloqueja l'enviament de persones clau.

**Facturació.** Un KYC reutilitzat no es torna a facturar. Enllaçar una sessió ja aprovada amb la nova part no té cap càrrec addicional; només es factura una vegada, pel KYC original.

```txt Example theme={null}
Company A: Jane Doe submitted as UBO, KYC approved.
Company B (same application): Jane Doe submitted as a director.
"Reuse verified individuals" is enabled, so Company B's Key People
check links Jane's existing approved KYC instead of requesting a
new one - free, and instantly Approved for that party.
```

## Propers passos

> [card] [Titularitat](https://docs.didit.me/ca/business-verification/ownership.md)
>
> Camps recollits, dades personalitzades i conciliació entre les dades del registre i les dades enviades.

> [card] [Administradors i representants](https://docs.didit.me/ca/business-verification/officers.md)
>
> Rols de govern dins del model de persones clau.

> [card] [Esquema de la resposta](https://docs.didit.me/ca/business-verification/response-schema.md#key_people_checks)
>
> Referència camp per camp de `key_people_checks[]`.


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