Cronologia KYB aziendale: sessioni e report

Ogni sessione di Verifica aziendale (KYB) avviata da un’azienda resta collegata in modo permanente all’entità aziendale. Puoi recuperare la cronologia completa, esaminare i dati del registro delle imprese e i riscontri AML di ogni sessione, avviare una nuova verifica e generare report PDF per gli audit.

Elencare tutte le sessioni di Verifica aziendale (KYB) di un’azienda

Filtra l’elenco delle sessioni per vendor_data:

curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=biz-acme" \
  --data-urlencode "page_size=50"

La risposta include ogni sessione di Verifica aziendale (KYB), indipendentemente dallo stato.

Comprendere le funzionalità KYB

Una sessione KYB esegue queste funzionalità, e ciascuna ha un proprio stato nella decisione della sessione:

Funzionalità	Cosa copre
`KYB_REGISTRY`	Ricerca nel registro delle imprese: esistenza, stato, verifica incrociata dell’identità
`AML`	Screening AML a livello aziendale (sanzioni, notizie negative, watchlist)
`KYB_DOCUMENTS`	Raccolta dei documenti e incrocio dei dati tramite OCR
`KYB_KEY_PEOPLE`	Amministratori, UBO, titolari effettivi: identificazione e KYC facoltativo

La mappa features dell’entità aziendale contiene solo lo stato più recente della verifica aziendale:

"features": {
  "KYB": "Approved"
}

Consulta Stati delle funzionalità KYB per il riferimento completo.

Ispezionare una singola sessione di Verifica aziendale (KYB)

curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"

La decisione KYB include:

Dati del registro delle imprese (ragione sociale, numero di registrazione, stato, data di costituzione, indirizzi)
Amministratori e UBO estratti dal registro
Assetto proprietario (tabella dei soci, percentuali di titolarità effettiva)
Risultati AML aziendali (riscontri, punteggi)
AML individuale per ogni UBO e amministratore
Risultati dei documenti con estratti OCR
Codici motivo della decisione

Consulta Schema della risposta KYB per il payload completo.

Avviare una nuova verifica

Il re-KYB annuale, i controlli basati su trigger e i flussi di rimedio iniziano tutti con una nuova sessione:

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "wf_kyb_annual",
    "vendor_data": "biz-acme"
  }'

La nuova sessione viene collegata all’entità aziendale esistente e aggiorna la mappa features al completamento.

Reinvio o nuova sessione di Verifica aziendale (KYB)

Scenario	Da usare
La ricerca nel registro richiede un nome aziendale corretto	Reinvio: l’analista modifica i dati e ripete la ricerca nel registro
È richiesto all’azienda un documento aggiuntivo	Reinvio: l’azienda carica il documento mancante
Re-KYB annuale o basato su trigger	Crea una nuova sessione

Esportare un report KYB

Genera un PDF completo per qualsiasi sessione di Verifica aziendale (KYB):

curl https://verification.didit.me/v3/session/{session_id}/generate-pdf/ \
  -H "x-api-key: YOUR_API_KEY" \
  -o kyb-report.pdf

Il PDF include dati del registro delle imprese, assetto proprietario, riscontri AML, immagini dei documenti, stato KYC degli amministratori e una pagina di copertina con il motivo della decisione.

Condividere una sessione di Verifica aziendale (KYB)

Per i flussi con consorzi o partner:

POST /v3/session/{session_id}/share/: genera un token condivisibile.
POST /v3/session/import-shared/: importa la sessione lato ricevente.

Monitoraggio continuo

Le entità aziendali con modalità di monitoraggio continuo ricevono scansioni AML periodiche. Quando viene rilevato un nuovo riscontro su sanzioni o notizie negative, lo screening AML aziendale viene aggiornato; leggilo in aml_screenings[] nella decisione della sessione. Configura il monitoraggio continuo nella console in Workflows → [KYB workflow] → AML → Ongoing monitoring.

Prossimi passi

Panoramica KYB

Come funzionano le sessioni di Verifica aziendale (KYB) dall’inizio alla fine.

Risposta KYB

Riferimento completo del payload della decisione.

Persone chiave

Amministratori, UBO e utenti collegati.

Ultima modifica il 7 novembre 2026

Panoramica

Prezzi

Workflow e verifica

Revisione e operazioni

Entità (utenti e aziende)

Impostazioni e personalizzazione

Sicurezza e compliance

Didit Academy

Risorse

Cronologia KYB aziendale: sessioni e report

Elencare tutte le sessioni di Verifica aziendale (KYB) di un’azienda

Comprendere le funzionalità KYB

Ispezionare una singola sessione di Verifica aziendale (KYB)

Avviare una nuova verifica

Reinvio o nuova sessione di Verifica aziendale (KYB)

Esportare un report KYB

Condividere una sessione di Verifica aziendale (KYB)

Monitoraggio continuo

Prossimi passi

Panoramica KYB

Risposta KYB

Persone chiave

​Elencare tutte le sessioni di Verifica aziendale (KYB) di un’azienda

​Comprendere le funzionalità KYB

​Ispezionare una singola sessione di Verifica aziendale (KYB)

​Avviare una nuova verifica

​Reinvio o nuova sessione di Verifica aziendale (KYB)

​Esportare un report KYB

​Condividere una sessione di Verifica aziendale (KYB)

​Monitoraggio continuo

​Prossimi passi

Panoramica KYB

Risposta KYB

Persone chiave

Elencare tutte le sessioni di Verifica aziendale (KYB) di un’azienda

Comprendere le funzionalità KYB

Ispezionare una singola sessione di Verifica aziendale (KYB)

Avviare una nuova verifica

Reinvio o nuova sessione di Verifica aziendale (KYB)

Esportare un report KYB

Condividere una sessione di Verifica aziendale (KYB)

Monitoraggio continuo

Prossimi passi