> ## 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 verificació de càrrecs i representants KYB

> Verifica administradors, càrrecs i representants amb Persones clau de Didit, etiquetes multirol i cribratge AML. Des de $2.00 per verificació.

Els càrrecs, els administradors i els representants **no són un concepte separat en el model KYB de Didit**. Es troben dins de les [Persones clau](https://docs.didit.me/ca/business-verification/key-people.md), juntament amb els UBO i els accionistes, i cada persona té assignats un o diversos rols. Una mateixa persona pot ser administradora **i** accionista, o representant **i** signant autoritzat. La persona conserva la llista completa de rols, no només un rol.

## Taxonomia completa de rols

Cada persona clau pot tenir un o diversos d'aquests rols:

### Govern / representació

| Rol | Descripció |
| - | - |
| `director` | Membre del consell amb responsabilitats de govern |
| `non_executive_director` | Membre del consell sense funcions de gestió diària |
| `chairman` | President del consell |
| `secretary` | Secretari de l'empresa, amb funcions administratives i de compliment |
| `representative` | Representant legal o designat de l'empresa |
| `authorized_signatory` | Persona facultada per signar en nom de l'empresa |
| `trustee` | Fiduciari d'una estructura que té participacions en empreses |
| `company_officer` | Càrrec general |
| `founder` | Membre fundador de l'empresa |
| `legal_advisor` | Assessor jurídic contractat per a l'empresa |
| `other` | Qualsevol rol fora de la taxonomia estàndard |

### Titularitat / beneficiari

| Rol | Descripció |
| - | - |
| `ubo` | Titular real: persona física que, en última instància, posseeix o controla l'empresa |
| `shareholder` | Accionista registrat (persona física o jurídica) |
| `beneficiary` | Beneficiari d'un fideïcomís o d'una estructura similar |
| `settlor` | Constituent d'un fideïcomís |
| `protector` | Protector d'un fideïcomís |
| `investor` | Inversor (fora de les estructures formals de propietat accionarial) |

Una mateixa persona pot tenir rols de les dues categories. Per exemple, un fundador que també és administrador i UBO té tres rols en el mateix registre de persona clau.

## Registres amb múltiples rols

Cada registre de persona clau inclou una llista de rols. Cada rol té els seus percentatges de titularitat o de vot, quan s'escau. Així es veu en la resposta un cas d'administrador i 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ó amb KYC

Cada persona clau es pot vincular a una sessió individual de verificació d'usuaris (KYC). La vinculació es fa automàticament quan la configuració del flux de treball del rol exigeix KYC: el sistema crea la sessió KYC secundària, envia a la persona el seu enllaç de verificació (si aquesta opció està activada) i n'actualitza l'estat en el registre de la persona.

Consulta [Titularitat → Com la configuració dels rols determina la verificació](https://docs.didit.me/ca/business-verification/ownership.md#com-la-configuració-dels-rols-determina-la-verificació) per conèixer la lògica completa d'encaminament. Per als valors d'estat de KYC aptes per a B2C que apareixen en cada registre de persona (`Approved`, `Declined`, `Pending`), consulta l'[esquema de la resposta](https://docs.didit.me/ca/business-verification/response-schema.md#bloc-company).

## Cribratge AML

Cada persona clau identificada se sotmet automàticament al cribratge amb les llistes de vigilància AML globals, com a part del procés de verificació de l'empresa. Les coincidències PEP són especialment rellevants per als rols de govern: els administradors i els signants d'empreses regulades sovint apareixen en llistes de PEP. Consulta el [cribratge AML de l'empresa](https://docs.didit.me/ca/business-verification/aml.md).

## Indicador de verificació obligatòria

Cada registre de persona té un indicador `requires_verification` que indica si el flux exigeix KYC per a aquesta persona:

| Valor | Significat |
| - | - |
| `true` | El KYC ha de completar-se per a aquesta persona abans que la sessió pugui aprovar-se. |
| `false` | La persona està identificada i sotmesa al cribratge AML, però no necessita KYC individual. |

Configura quins rols requereixen verificació des de *Fluxos de treball → \[flux de treball KYB] → Persones clau → configuració per rol*. Valors per defecte habituals:

* Administradors i UBO per sobre del llindar del flux → `requires_verification: true`.
* Signants autoritzats i secretaris → opcional.
* Membres no executius del consell → opcional.

## Ometre una persona clau

Si no es pot verificar una persona (perquè ha mort, no es pot contactar amb ella o és un registre històric), es pot marcar amb `is_skipped: true`. Ho pot fer l'usuari final en el flux allotjat (si la configuració del rol permet ometre-la) o un analista des de la consola. Els registres de les persones omeses queden exclosos del control de verificació, però continuen apareixent a la resposta per a l'auditoria.

## Referència creuada entre fonts

Les dades de cada persona clau poden procedir de tres llocs, i la consola els mostra tots tres un al costat de l'altre:

* **Registres del registre mercantil**: el que ha declarat el registre oficial.
* **Enviades per l'usuari**: el que l'administrador de l'empresa ha confirmat o afegit al flux de persones clau.
* **Documents carregats**: noms extrets amb OCR d'estatuts de l'empresa, registres d'accionistes o documents de poder.

Les incoherències apareixen com a advertències en la decisió de la sessió.

## Efecte sobre l'entitat Business

Quan una persona clau es vincula a una entitat d'usuari mitjançant KYC, es crea una relació duradora amb l'[entitat Business](https://docs.didit.me/ca/entities/businesses/overview.md). Després pots:

* Veure totes les empreses en què cada persona exerceix un rol de govern o de titularitat.
* Propagar els canvis d'estat d'un usuari (marcat, bloquejat) a les empreses on actua com a persona clau.
* Executar el monitoratge AML continu de cada persona vinculada, independentment de qualsevol sessió KYB concreta.

## Següents passos

> [card] [Persones clau](https://docs.didit.me/ca/business-verification/key-people.md)
>
> El flux complet de persones clau.

> [card] [Titularitat](https://docs.didit.me/ca/business-verification/ownership.md)
>
> Identificació d'UBO i cadenes de titularitat.

> [card] [AML](https://docs.didit.me/ca/business-verification/aml.md)
>
> Cribratge AML de l'empresa i de la persona.


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