Verifica aziendale KYB: API per i ruoli chiave

Persone chiave, amministratori e rappresentanti non sono un concetto separato nel modello KYB di Didit: si trovano all’interno di Key People, 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:

{
  "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 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.

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.

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

Persone chiave

Il flusso completo di Key People.

Assetto proprietario

Identificazione degli UBO e catene di proprietà.

AML

Screening AML di aziende e persone.

Primi passi

Funzionalità

Profili aziendali

Riferimento

Console

Verifica aziendale KYB: API per i ruoli chiave

Tassonomia completa dei ruoli

Governance / rappresentanza

Assetto proprietario / beneficiari

Record con più ruoli

Collegamento KYC

Screening AML

Flag di verifica richiesta

Saltare una persona chiave

Incrocio dei dati tra fonti

Effetto sull’entità Business

Passaggi successivi

Persone chiave

Assetto proprietario

AML

​Tassonomia completa dei ruoli

​Governance / rappresentanza

​Assetto proprietario / beneficiari

​Record con più ruoli

​Collegamento KYC

​Screening AML

​Flag di verifica richiesta

​Saltare una persona chiave

​Incrocio dei dati tra fonti

​Effetto sull’entità Business

​Passaggi successivi

Persone chiave

Assetto proprietario

AML

Tassonomia completa dei ruoli

Governance / rappresentanza

Assetto proprietario / beneficiari

Record con più ruoli

Collegamento KYC

Screening AML

Flag di verifica richiesta

Saltare una persona chiave

Incrocio dei dati tra fonti

Effetto sull’entità Business

Passaggi successivi