> ## 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: registro e UBO > Didit verifica aziende tramite registri, titolari effettivi (UBO), dirigenti e AML. Da $2.00 per verifica, senza contratti. La Verifica aziendale (KYB) di Didit ti consente di verificare aziende ed entità giuridiche prima di eseguirne l'onboarding sulla tua piattaforma. Il sistema automatizza le ricerche nei registri delle imprese, identifica i titolari effettivi e i dirigenti, sottopone tutte le parti a screening rispetto alle watchlist AML e raccoglie i documenti a supporto, il tutto all'interno di un unico workflow. Ogni azienda verificata viene tracciata come [profilo aziendale](https://docs.didit.me/it/business-verification/business-profiles.md), che aggrega i risultati di tutte le sessioni. Questa lezione di Didit Academy segue una verifica aziendale dall'inizio alla fine: la dashboard KYB, il controllo nel registro, azionisti e UBO, lo screening AML e ciò che il rappresentante dell'azienda vede dal proprio lato. [Verifica un'azienda (KYB), dall'inizio alla fine — Didit Academy](https://www.youtube.com/embed/JEnW_sEe35Y?rel=0\&playsinline=1) Se non conosci ancora il KYB di Didit, inizia con la [guida rapida](https://docs.didit.me/it/business-verification/quickstart.md) per un percorso completo di circa 10 minuti, poi leggi la [guida all'integrazione](https://docs.didit.me/it/business-verification/integration-guide.md) per le modalità da usare in produzione. Per il modello dell'entità Business sottostante (con i collegamenti a Users, blocklist, importazione ed esportazione), consulta [Aziende](https://docs.didit.me/it/entities/businesses/overview.md). ## Come funziona **1. Crea una sessione aziendale** Avvia una verifica aziendale creando una sessione con un **workflow KYB**. Quando il tipo di workflow è KYB, Didit crea automaticamente una sessione aziendale: ```bash theme={null} curl -X POST https://verification.didit.me/v3/session/ \ -H "x-api-key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "workflow_id": "your-kyb-workflow-id", "vendor_data": "company-123" }' ``` Il tipo di sessione è determinato dal workflow, quindi non servono campi aggiuntivi. I workflow KYB creano automaticamente sessioni aziendali con le funzionalità specifiche per le aziende attivate. **2. Ricerca nel registro delle imprese** Didit interroga i registri ufficiali delle imprese ai livelli **Lite**, **Shareholders** o **UBOs**, ciascuno con un prezzo per paese: vedi [prezzi del registro](https://docs.didit.me/it/getting-started/kyb-registry-pricing.md). Il livello Lite recupera: | Dati | Descrizione | | - | - | | **Nome azienda** | Ragione sociale registrata | | **Numero di registrazione** | Numero ufficiale di registrazione dell'azienda | | **Paese** | Paese di costituzione | | **Stato** | Attiva, sciolta, cancellata, ecc. | | **Tipo azienda** | Ltd, LLC, PLC, SA, GmbH, ecc. | | **Data di costituzione** | Data di registrazione dell'azienda | | **Sede legale** | Indirizzo ufficiale della sede legale | | **Codice fiscale** | Codice di identificazione fiscale (ove disponibile) | I dati del registro vengono confrontati con le informazioni fornite per rilevare eventuali incoerenze. **3. Persone chiave: UBO, azionisti, amministratori e rappresentanti** Il sistema identifica ogni persona ed entità giuridica collegata all'azienda nel modello unificato **Persone Chiave**: * **UBO**: persone fisiche che possiedono o controllano in ultima istanza l'azienda, con le relative percentuali dell'assetto proprietario e di voto * **Azionisti** (persone fisiche e giuridiche): ciascuno con la propria percentuale dell'assetto proprietario * **Amministratori, rappresentanti, segretari, firmatari autorizzati e altri ruoli di responsabilità**: con il relativo tag di ruolo specifico * **Livelli di assetto proprietario**: società madri nella catena di proprietà, con KYB annidato facoltativo Una stessa persona può avere più tag di ruolo (ad esempio amministratore **e** azionista). Ogni ruolo viene configurato singolarmente nel workflow: quali ruoli richiedono KYC, quale workflow KYC utilizzare e se l'utente finale può saltare la verifica. Per saperne di più, consulta [Persone chiave](https://docs.didit.me/it/business-verification/key-people.md) e [Assetto proprietario](https://docs.didit.me/it/business-verification/ownership.md). **4. Screening AML** Tutte le parti identificate vengono sottoposte automaticamente a screening rispetto alle watchlist AML globali: * **AML Azienda**: sottopone l'entità aziendale a screening rispetto a sanzioni, notizie negative e liste di provvedimenti delle autorità di vigilanza * **AML persona**: sottopone individualmente ogni persona chiave (UBO, azionista, amministratore, rappresentante, ecc.) * Utilizza lo stesso [sistema di rischio a due punteggi](https://docs.didit.me/it/core-technology/aml-screening/overview.md) (punteggio di corrispondenza + punteggio di rischio) della verifica degli utenti **5. Raccolta dei documenti** Raccogli e verifica i documenti a supporto: | Tipo di documento | Esempi | | - | - | | **Atto costitutivo** | Certificato di costituzione della società | | **Statuto sociale** | Statuto, atto costitutivo | | **Prova di residenza** | Bollette delle utenze ed estratti conto bancari per la sede legale | | **Libro dei soci** | Registro ufficiale dei soci | | **Bilanci** | Bilanci annuali, relazioni di revisione | | **Certificati fiscali** | Certificati di registrazione fiscale o di conformità fiscale | | **Documenti personalizzati** | Eventuali documenti aggiuntivi richiesti dal tuo processo di compliance | Gli analisti possono richiedere all'azienda documenti aggiuntivi durante il processo di revisione. **6. Revisione e decisione** La sessione aziendale riceve uno stato complessivo basato su tutti i controlli: | Stato | Significato | | - | - | | **Approvata** | Tutti i controlli superati: l'azienda è verificata | | **In revisione** | Uno o più controlli richiedono una revisione manuale | | **Rifiutata** | Un controllo critico non superato (ad esempio azienda sciolta o entità sanzionata) | Gli analisti possono esaminare tutti i dati raccolti nella Business Console, aggiungere commenti, richiedere documenti aggiuntivi e prendere una decisione finale. ## Ciclo di vita della sessione aziendale Ogni verifica aziendale viene eseguita all'interno di una **sessione aziendale** che traccia l'avanzamento attraverso i seguenti stati: | Stato | Descrizione | | - | - | | `"Not Started"` | Sessione creata, ma la verifica non è ancora iniziata | | `"In Progress"` | Verifica in corso: ricerche nel registro, screening AML o raccolta dei documenti in svolgimento | | `"Approved"` | Tutti i controlli superati: l'azienda è verificata | | `"Declined"` | Un controllo critico non è stato superato (ad esempio, società sciolta o entità sanzionata) | | `"In Review"` | Uno o più controlli richiedono una revisione manuale da parte di un analista | | `"Resubmitted"` | Sessione precedentemente rifiutata e reinviata con dati aggiornati | Ogni sessione ha un `session_id` univoco, un `session_number` progressivo e un `session_token` per il link di verifica ospitato. Quando una sessione viene creata con un identificativo `vendor_data`, Didit la collega automaticamente al corrispondente [profilo aziendale](https://docs.didit.me/it/business-verification/business-profiles.md). ## Stati delle funzionalità La verifica aziendale monitora lo stato di ciascuna componente in modo indipendente: | Funzionalità | Descrizione | | - | - | | **Controllo registro** | Ricerca nel registro delle imprese ed estrazione dei dati | | **AML Azienda** | Screening AML a livello aziendale rispetto a sanzioni e watchlist | | **Documenti** | Raccolta dei documenti, OCR e verifica incrociata | | **Persone chiave** | Identificazione di titolari effettivi e dirigenti, AML e KYC | Ogni funzionalità può essere: `"Not Finished"`, `"Approved"`, `"Declined"`, `"In Review"` o `"Resub Requested"`. Lo stato generale della sessione aggrega gli stati delle singole funzionalità: la sessione è `"Approved"` solo quando tutte le funzionalità richieste sono superate. ## Eventi webhook Le sessioni aziendali generano i seguenti eventi webhook: | Evento | Evento scatenante | | - | - | | `status.updated` | Lo stato della sessione è cambiato. Il payload contiene `session_kind: "business"` per le sessioni KYB. | | `data.updated` | Un revisore ha modificato i dati del registro o Persone chiave nella console, oppure il registro ha segnalato una modifica. Il payload contiene `session_kind: "business"`. Per l'avanzamento segui `status.updated`. | | `business.status.updated` | È cambiato lo stato dell'[entità aziendale](https://docs.didit.me/it/entities/businesses/overview.md) collegata (`ACTIVE` / `FLAGGED` / `BLOCKED`). | | `business.data.updated` | Sono cambiati i campi del profilo o i contatori aggregati dell'entità aziendale collegata. | I payload webhook includono `session_kind: "business"` e il `business_session_id` per distinguerli dagli eventi di verifica utente. Per la verifica della firma e i dettagli di consegna consulta [Webhook](https://docs.didit.me/it/integration/webhooks.md). ## Funzionalità principali | Capacità | Descrizione | | - | - | | **Ricerche automatiche nel registro** | Interroga i registri ufficiali delle imprese nei paesi supportati al livello Lite, Shareholders o UBOs, [con prezzi per paese](https://docs.didit.me/it/getting-started/kyb-registry-pricing.md) | | **Identificazione degli UBO** | Estrazione automatica delle strutture di titolarità effettiva con le percentuali | | **Screening dei dirigenti** | Identificazione e verifica di amministratori, segretari e altri dirigenti | | **AML Azienda** | Screening dell'entità aziendale rispetto a sanzioni e watchlist | | **AML Persona** | Screening individuale di tutti gli UBO e i dirigenti identificati | | **Collegamento KYC** | Collegamento di ogni persona identificata a una sessione di Verifica degli utenti (KYC) per la verifica dell'identità | | **Raccolta dei documenti** | Richieste di documenti strutturate con monitoraggio dei caricamenti | | **Controllo incrociato OCR** | Estrazione dei dati dai documenti caricati e confronto con i dati del registro | | **Profili aziendali** | Creazione automatica del profilo e aggregazione delle sessioni per ogni azienda verificata | | **Stati a livello di funzionalità** | Monitoraggio indipendente dello stato per registro, AML, documenti e persone chiave | | **Valutazione del rischio** | Tag di avviso su ogni controllo e azioni del workflow che trasformano lo stato dell'azienda, i risultati AML e i risultati sull'assetto proprietario in un esito | | **Webhook** | Ricezione in tempo reale degli eventi del ciclo di vita della sessione e degli aggiornamenti dei dati tramite [webhook](https://docs.didit.me/it/integration/webhooks.md) | ## Sessioni aziendali e sessioni utente | Funzionalità | Sessione utente | Sessione aziendale | | - | - | - | | **Obiettivo** | Singola persona | Azienda o entità giuridica | | **Tipo di sessione** | `user` (predefinito) | `business` | | **Controlli principali** | ID, rilevamento della vitalità, confronto facciale, AML | Ricerca nel registro, UBO, dirigenti, AML Azienda | | **Controlli aggiuntivi** | Telefono, email, prova di residenza, NFC | Raccolta dei documenti, AML Persona, collegamento KYC | | **Payload webhook** | Eventi di sessione standard | Includono `session_kind: "business"` e `business_session_id` | ## Prossimi passi > [card] [Profili aziendali](https://docs.didit.me/it/business-verification/business-profiles.md) > > Monitora le aziende tra una sessione e l'altra con profili, tag e operazioni in blocco. > [card] [Dati aziendali](https://docs.didit.me/it/business-verification/company-data.md) > > Ricerche nel registro, stato dell'azienda e confronto incrociato dei dati. > [card] [Struttura proprietaria](https://docs.didit.me/it/business-verification/ownership.md) > > Identificazione degli UBO, azionisti aziendali e catene di titolarità. > [card] [Dirigenti e amministratori](https://docs.didit.me/it/business-verification/officers.md) > > Identificazione degli amministratori, ruoli e collegamento KYC. > [card] [Screening AML](https://docs.didit.me/it/business-verification/aml.md) > > Controlli AML a livello aziendale e individuale. > [card] [Documenti](https://docs.didit.me/it/business-verification/documents.md) > > Raccolta dei documenti, richieste e verifica OCR. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.