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

# Persone chiave: titolari effettivi e amministratori

> Collega titolari effettivi, amministratori e direttori a un'azienda Didit. Ognuno esegue la KYC come entità utente. KYB chiuso su un'unica piattaforma.

## Chi rientra tra le persone chiave

Ogni entità Business ha **persone chiave**: le persone fisiche legalmente responsabili dell'azienda o che ne detengono la titolarità effettiva. Didit le identifica durante la KYB e ti consente di collegare ciascuna di esse a un'entità User per la KYC individuale.

| Ruolo | Descrizione |
| - | - |
| **Amministratore** | Indicato nel registro come amministratore dell'azienda |
| **Funzionario** | Segretario, rappresentante o altro funzionario registrato |
| **Azionista** | Azionista registrato (società o persona fisica) |
| **UBO (Ultimate Beneficial Owner)** | Persona fisica che in ultima istanza possiede o controlla il 10/25/50%+ (soglia configurabile) |
| **Firmatario autorizzato** | Persona autorizzata ad agire per conto dell'azienda |

Consulta le pagine [Funzionari KYB](https://docs.didit.me/it/business-verification/officers.md) e [Assetto proprietario](https://docs.didit.me/it/business-verification/ownership.md) per la tassonomia completa dei ruoli e il calcolo della catena proprietaria.

## Come le persone chiave si collegano a un Business

**1. Identificate dal registro**

Durante la KYB, Didit interroga il registro delle imprese ed estrae tutti i funzionari e gli azionisti elencati. Ciascuna persona diventa un **record di persona chiave** collegato alla sessione di Verifica aziendale (KYB).

**2. Aggiunte dall'utente (compilate dal cliente)**

I workflow possono includere un passaggio "Persone Chiave" in cui l'amministratore aziendale aggiunge persone non presenti nel registro (ad esempio UBO identificati tramite dichiarazione aziendale).

**3. Aggregate nell'entità Business**

L'elenco delle persone chiave dell'entità Business è l'unione delle parti estratte dal registro e di quelle aggiunte dall'utente, deduplicate in base all'identità.

Ogni persona chiave ha un campo `source`:

* `REGISTRY`: estratta da un registro ufficiale.
* `USER`: aggiunta dall'amministratore aziendale durante il flusso KYB.

## Collegare una persona chiave a un'entità User

Quando è richiesta la KYC per una persona chiave (in genere UBO e amministratori), la persona può essere collegata a un'entità 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
```

Il collegamento viene creato quando:

* Una sessione di Verifica degli utenti (KYC) viene eseguita per la persona usando gli stessi `vendor_data` dell'entità User.
* Un analista associa manualmente una persona dell'azienda a un User esistente.

Una volta collegato, lo stato KYC dell'User viene propagato alla vista delle persone chiave del Business.

## Consultare le persone chiave

Dalla pagina di dettaglio del Business nella console, la scheda **Persone Chiave** mostra:

* Nome, ruolo, percentuale di proprietà e fonte (registro o aggiunta dall'utente) di ciascuna persona
* Stato KYC degli User collegati
* Stato dello screening AML per persona
* Documenti associati (documento d'identità dell'amministratore, dichiarazione UBO)

A livello programmatico, le persone chiave compaiono nell'array `key_people_checks[]` della decisione della sessione di Verifica aziendale (KYB), suddiviso in due gruppi:

```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`**: parti individuate tramite il controllo sul registro.
* **`submitted.parties`**: parti aggiunte dall'amministratore aziendale durante il flusso Persone Chiave (`source: USER`).
* **`ubo_kyc_summary`**: avanzamento aggregato della KYC degli UBO.

Gli array piatti `officers[]` e `beneficial_owners[]` restano nella risposta per compatibilità con le versioni precedenti, ancora per una release. Le nuove integrazioni dovrebbero usare la struttura a due gruppi descritta sopra. Consulta lo [schema della risposta KYB](https://docs.didit.me/it/business-verification/response-schema.md#key_people_checks) per tutti i campi.

## Azionisti societari

Quando un azionista è a sua volta una società (non una persona), Didit esplora ricorsivamente la catena proprietaria per identificare i titolari effettivi finali. Le parti societarie possono facoltativamente avviare sessioni KYB figlie.

Consulta [Struttura dell'assetto proprietario](https://docs.didit.me/it/business-verification/ownership.md) per un esempio dettagliato di catene di proprietà su più livelli.

## Webhook delle persone chiave

Le modifiche alle persone chiave vengono notificate tramite gli eventi della sessione padre:

* `data.updated` (con `session_kind: "business"`): i dati della sessione, incluse le persone chiave, sono stati aggiornati.
* `status.updated` (con `session_kind: "business"`): lo stato della sessione è cambiato di conseguenza.

Consulta i [webhook KYB](https://docs.didit.me/it/business-verification/webhooks.md) per i payload.

## Passaggi successivi

> [card] [Funzionari](https://docs.didit.me/it/business-verification/officers.md)
>
> Identificazione degli amministratori e tassonomia dei ruoli.

> [card] [Assetto proprietario](https://docs.didit.me/it/business-verification/ownership.md)
>
> UBO, azionisti societari e calcolo della catena.

> [card] [Flusso Persone Chiave](https://docs.didit.me/it/business-verification/key-people.md)
>
> Il passaggio KYB che raccoglie le persone chiave.


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