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

# Verifica aziendale KYB: API per i ruoli chiave

> Verifica amministratori, dirigenti e rappresentanti con Didit: modello persone chiave, tag multi-ruolo e screening AML. Da $2.00 a controllo.

Persone chiave, amministratori e rappresentanti non sono un concetto separato nel modello KYB di Didit: si trovano all'interno di [Key People](https://docs.didit.me/it/business-verification/key-people.md), insieme a UBO e azionisti, con uno o più ruoli assegnati a ogni persona. Una stessa persona può essere amministratore **e** azionista, oppure rappresentante **e** firmatario autorizzato: il soggetto porta con sé l'elenco completo dei ruoli, non soltanto uno.

## Tassonomia completa dei ruoli

Ogni persona chiave può ricoprire uno o più di questi ruoli:

### Governance / rappresentanza

| Ruolo | Descrizione |
| - | - |
| `director` | Membro del consiglio con responsabilità di governance |
| `non_executive_director` | Membro del consiglio senza compiti di gestione quotidiana |
| `chairman` | Presidente del consiglio |
| `secretary` | Segretario societario che si occupa di adempimenti amministrativi e di compliance |
| `representative` | Rappresentante legale o nominato della società |
| `authorized_signatory` | Persona autorizzata a firmare per conto della società |
| `trustee` | Trustee di una struttura che detiene partecipazioni societarie |
| `company_officer` | Ruolo generico di funzionario |
| `founder` | Socio fondatore della società |
| `legal_advisor` | Consulente legale incaricato della società |
| `other` | Qualsiasi ruolo al di fuori della tassonomia standard |

### Assetto proprietario / beneficiari

| Ruolo | Descrizione |
| - | - |
| `ubo` | Titolare effettivo (UBO): persona fisica che in ultima istanza possiede o controlla la società |
| `shareholder` | Azionista registrato (persona fisica o giuridica) |
| `beneficiary` | Beneficiario di un trust o di una struttura analoga |
| `settlor` | Disponente di un trust |
| `protector` | Protector di un trust |
| `investor` | Investitore (al di fuori delle strutture di partecipazione azionaria formale) |

Una stessa persona può appartenere a entrambe le categorie: ad esempio, un fondatore che è anche amministratore e UBO ha tre ruoli sullo stesso record di persona chiave.

## Record con più ruoli

Ogni record di persona chiave include un elenco di ruoli, ciascuno con le proprie percentuali di proprietà o di voto, ove pertinenti. Ecco come appare nella risposta un caso in cui una persona è amministratore e azionista:

```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/..."
}
```

## Collegamento KYC

Ogni persona chiave può essere collegata a una sessione di verifica degli utenti (KYC) individuale. Il collegamento avviene automaticamente quando le impostazioni del flusso per quel ruolo richiedono il KYC: il sistema avvia la sessione KYC figlia, invia alla persona il suo link di verifica via email (se questa opzione è attiva) e riporta lo stato sul soggetto.

Consulta [Assetto proprietario → Come le impostazioni dei ruoli guidano la verifica](https://docs.didit.me/it/business-verification/ownership.md#come-le-impostazioni-dei-ruoli-guidano-la-verifica) per la logica di instradamento completa. Per i valori di stato KYC adatti all'uso B2C, presenti su ogni soggetto (`Approved`, `Declined`, `Pending`), consulta lo [schema della risposta](https://docs.didit.me/it/business-verification/response-schema.md#blocco-company).

## Screening AML

Ogni persona chiave identificata viene automaticamente sottoposta a screening rispetto alle watchlist AML globali nell'ambito del processo di verifica aziendale. I match PEP sono particolarmente rilevanti per i ruoli di governance: amministratori e firmatari di società regolamentate compaiono spesso nelle liste PEP. Consulta [Screening AML delle aziende](https://docs.didit.me/it/business-verification/aml.md).

## Flag di verifica richiesta

Ogni soggetto porta un flag `requires_verification` che ti indica se il flusso richiede il KYC per quella persona:

| Valore | Significato |
| - | - |
| `true` | Il KYC deve essere completato per questa persona prima che la sessione possa essere approvata. |
| `false` | La persona è identificata e sottoposta a screening AML, ma non richiede un KYC individuale. |

Configura quali ruoli richiedono la verifica da *Workflows → \[KYB workflow] → Key People → impostazioni per ruolo*. Valori predefiniti tipici:

* Amministratori e UBO sopra la soglia del flusso → `requires_verification: true`.
* Firmatari autorizzati e segretari → facoltativo.
* Membri non esecutivi del consiglio → facoltativo.

## Saltare una persona chiave

Se una persona non può essere verificata (deceduta, irraggiungibile, non più attuale), può essere contrassegnata con `is_skipped: true`, sia dall'utente finale nel flusso ospitato (se le impostazioni del ruolo lo consentono) sia da un analista dalla console. I soggetti saltati sono esclusi dal controllo di verifica, ma compaiono comunque nella risposta a fini di audit.

## Incrocio dei dati tra fonti

I dati su ciascuna persona chiave possono provenire da tre fonti, e la console le mostra tutte e tre affiancate:

* **Dati del registro**: ciò che il registro ufficiale ha comunicato.
* **Inseriti dall'utente**: ciò che l'amministratore dell'azienda ha confermato o aggiunto nel flusso Key People.
* **Documenti caricati**: nomi estratti tramite OCR da atti costitutivi, libri dei soci o procure.

Le incongruenze compaiono come avvisi sulla decisione della sessione.

## Effetto sull'entità Business

Collegare una persona chiave a un'entità User tramite KYC crea una relazione duratura nell'[entità Business](https://docs.didit.me/it/entities/businesses/overview.md). Puoi quindi:

* Vedere ogni azienda per cui una persona ricopre un ruolo di governance o nell'assetto proprietario.
* Propagare nelle aziende in cui una persona opera come persona chiave le variazioni di stato di un'entità User (segnalata, bloccata).
* Eseguire il monitoraggio AML continuo su ogni persona collegata, indipendentemente da una specifica sessione KYB.

## Passaggi successivi

> [card] [Persone chiave](https://docs.didit.me/it/business-verification/key-people.md)
>
> Il flusso completo di Key People.

> [card] [Assetto proprietario](https://docs.didit.me/it/business-verification/ownership.md)
>
> Identificazione degli UBO e catene di proprietà.

> [card] [AML](https://docs.didit.me/it/business-verification/aml.md)
>
> Screening AML di aziende e persone.


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