Modello dati aziendale KYB: schema

Questa pagina documenta ogni campo di un’entità Azienda e spiega come Didit valorizza ciascuno di essi.

Campi di identità

Campo	Tipo	Descrizione
`uuid`	UUID	Chiave primaria assegnata da Didit. Stabile e univoca.
`didit_internal_id`	string	Identificativo interno leggibile.
`vendor_data`	string	Il tuo identificativo per l’azienda. Univoco per applicazione. Scopri di più.
`display_name`	string	Nome alternativo mostrato nella console. Per impostazione predefinita corrisponde a `legal_name` o `vendor_data`.
`legal_name`	string	Ragione sociale registrata, riportata dall’ultima verifica aziendale (KYB) approvata, tramite la ricerca nel registro.
`registration_number`	string	Numero ufficiale di registrazione dell’azienda, riportato dal registro.
`country_code`	string (ISO 3166-1 alpha-3)	Paese di costituzione.

legal_name, registration_number e country_code sono di sola lettura quando derivano da una ricerca nel registro verificata. Possono essere sovrascritti manualmente nella console o tramite PATCH /v3/businesses/{vendor_data}/, ma le sovrascritture vengono segnalate nel registro di audit.

Stato

Campo	Tipo	Valori	Descrizione
`status`	enum	`ACTIVE`, `FLAGGED`, `BLOCKED`	Controlla l’applicazione delle regole per le sessioni e le transazioni future. Vedi ciclo di vita.

Campi aggregati delle sessioni

Campo	Tipo	Descrizione
`session_count`	int	Totale delle sessioni di verifica aziendale (KYB) mai create per questa azienda
`approved_count`	int	Sessioni concluse con `Approved`
`declined_count`	int	Sessioni concluse con `Declined`
`in_review_count`	int	Sessioni attualmente `In Review`
`features`	object	Stato dell’ultima verifica dell’azienda, sotto la chiave `KYB`

La mappa `features`

{
  "KYB": "Approved"
}

La mappa contiene una sola chiave, KYB, con lo stato dell’ultima verifica dell’azienda: "Not Finished", "Approved", "Declined", "In Review" o "Resub Requested". Per lo stato di ciascuna singola funzionalità KYB, consulta la decisione della sessione. Usa la mappa features come percorso rapido per verificare se un’azienda è completamente verificata in questo momento, senza scorrere tutte le sessioni.

Timestamp di attività

Campo	Tipo	Aggiornato quando
`first_session_at`	timestamp ISO	È stata creata la prima sessione di verifica aziendale (KYB)
`last_session_at`	timestamp ISO	È stata creata o aggiornata la sessione più recente
`last_activity_at`	timestamp ISO	Qualsiasi modifica: sessione, transazione, stato, profilo, note
`created_at`	timestamp ISO	È stata creata la riga dell’entità
`updated_at`	timestamp ISO	La riga dell’entità è stata aggiornata l’ultima volta

Metadati

Campo	Tipo	Descrizione
`metadata`	object (JSON)	JSON libero, gestito da te
`tags[]`	array	Tag gestiti dalla console e dalle API

Relazioni (non memorizzate nella riga dell’azienda)

Relazione	Come accedervi
Sessioni di verifica aziendale (KYB)	`GET /v3/sessions?vendor_data=<value>`
Utenti collegati (responsabili, titolari effettivi, amministratori)	Visualizzati nella pagina di dettaglio dell’azienda nella console; derivati dall’ultima verifica aziendale (KYB) approvata
Transazioni (come richiedente o controparte)	Filtra le transazioni per `vendor_data` dell’azienda
Documenti	Tramite le decisioni delle sessioni di verifica aziendale (KYB)
Riscontri AML	Tramite le decisioni delle sessioni di verifica aziendale (KYB)

Esempio di risposta

{
  "uuid": "f7a9c1b2-4e6d-4f8a-9c5d-2a1b3c4d5e6f",
  "didit_internal_id": "B-2026-00018",
  "vendor_data": "biz-acme",
  "display_name": "Acme Corp",
  "legal_name": "Acme Corporation Limited",
  "registration_number": "12345678",
  "country_code": "GBR",
  "status": "ACTIVE",
  "session_count": 2,
  "approved_count": 1,
  "declined_count": 0,
  "in_review_count": 1,
  "features": {
    "KYB": "Approved"
  },
  "first_session_at": "2025-09-01T12:00:00Z",
  "last_session_at": "2026-04-01T09:00:00Z",
  "last_activity_at": "2026-04-16T10:00:00Z",
  "metadata": { "partner": "Acme Holdings" }
}

Passaggi successivi

Operazioni

Crea, aggiorna, modifica lo stato, elimina.

Storico KYB

Recupera ogni sessione collegata all’azienda.

Riferimento API

Schema di GET /v3/businesses//.

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

Modello dati aziendale KYB: schema

Campi di identità

Stato

Campi aggregati delle sessioni

La mappa `features`

Timestamp di attività

Metadati

Relazioni (non memorizzate nella riga dell’azienda)

Esempio di risposta

Passaggi successivi

Operazioni

Storico KYB

Riferimento API

​Campi di identità

​Stato

​Campi aggregati delle sessioni

​La mappa features

​Timestamp di attività

​Metadati

​Relazioni (non memorizzate nella riga dell’azienda)

​Esempio di risposta

​Passaggi successivi

Operazioni

Storico KYB

Riferimento API

Campi di identità

Stato

Campi aggregati delle sessioni

La mappa `features`

Timestamp di attività

Metadati

Relazioni (non memorizzate nella riga dell’azienda)

Esempio di risposta

Passaggi successivi