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

# Modello dati aziendale KYB: schema

> Modello dati aziendale di Didit: registro, titolari effettivi, amministratori, stato AML, documenti e sessioni KYB. KYB a ciclo chiuso.

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ù](https://docs.didit.me/it/entities/vendor-data-linking.md). |
| `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. |

> [!NOTE]
>
> `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](https://docs.didit.me/it/entities/lifecycle.md). |

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

```json theme={null}
{
  "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

```json theme={null}
{
  "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

> [card] [Operazioni](https://docs.didit.me/it/entities/businesses/operations.md)
>
> Crea, aggiorna, modifica lo stato, elimina.

> [card] [Storico KYB](https://docs.didit.me/it/entities/businesses/kyb-history.md)
>
> Recupera ogni sessione collegata all'azienda.

> [card] [Riferimento API](https://docs.didit.me/it/management-api/businesses/get.md)
>
> Schema di GET /v3/businesses/{vendor_data}/.


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