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

# Aziende fornitrici: record KYB persistente

> Le aziende fornitrici su Didit unificano KYB, registro, titolari effettivi, AML, documenti e transazioni in un unico profilo persistente.

Un'**entità aziendale** rappresenta un'entità giuridica (società, LLC, fondo, fondazione, ditta individuale, trust) in tutte le verifiche KYB, transazioni e interazioni di compliance che intrattiene con la tua piattaforma su Didit.

Come le entità utente, le entità aziendali sono identificate da `vendor_data` e aggregano tutte le sessioni e le transazioni collegate in un unico profilo.

## Cosa contiene un'azienda

| Categoria | Campi / oggetti |
| - | - |
| **Identità** | `vendor_data`, `uuid`, `display_name`, `legal_name`, `registration_number`, `country_code` |
| **Stato** | `ACTIVE`, `FLAGGED`, `BLOCKED` |
| **Aggregati delle sessioni** | `session_count`, `approved_count`, `declined_count`, `in_review_count`, mappa `features` |
| **Attività** | `first_session_at`, `last_session_at`, `last_activity_at` |
| **Persone chiave** | Responsabili, amministratori, UBO e titolari effettivi collegati (ciascuno può essere collegato a un'entità utente per il KYC) |
| **Documenti** | Certificati di costituzione, statuto, registri dei soci, procura (POA), bilanci, documenti personalizzati |
| **AML** | Risultati dello screening a livello aziendale su sanzioni / PEP / notizie negative |
| **Metadati** | JSON libero per i tuoi dati |

Consulta il [modello dati dell'azienda](https://docs.didit.me/it/entities/businesses/data-model.md) completo per i tipi di campo e i casi limite.

## Quando viene creata un'azienda

**1. Automaticamente, da una sessione di Verifica aziendale (KYB)**

Quando crei una sessione di Verifica aziendale (KYB) con un `vendor_data` che Didit non ha mai visto, viene creata un'entità aziendale con stato `ACTIVE` e collegata a quella sessione.

**2. Esplicitamente, tramite POST /v3/businesses/create/**

Crea in anticipo l'azienda prima di avviare una sessione di Verifica aziendale (KYB). Utile per inserire metadati iniziali o per l'onboarding in blocco di aziende.

**3. Dalla console**

Il tuo team crea l'azienda dalla pagina Aziende, ad esempio quando esegue manualmente l'onboarding di un'azienda verificata con un processo offline.

## Cosa puoi fare

| Operazione | Come |
| - | - |
| [Elenca le aziende](https://docs.didit.me/it/entities/businesses/operations.md#elenco-delle-aziende) | `GET /v3/businesses/` con filtri |
| [Recupera un'azienda](https://docs.didit.me/it/entities/businesses/operations.md#recupero-di-un’azienda) | `GET /v3/businesses/{vendor_data}/` |
| [Crea un'azienda](https://docs.didit.me/it/entities/businesses/operations.md#creazione-di-un’azienda) | `POST /v3/businesses/create/` |
| [Aggiorna il profilo](https://docs.didit.me/it/entities/businesses/operations.md#aggiornamento-di-un’azienda) | `PATCH /v3/businesses/{vendor_data}/` |
| [Modifica lo stato](https://docs.didit.me/it/entities/businesses/operations.md#modifica-dello-stato) | `PATCH /v3/businesses/{vendor_data}/update-status/` |
| [Elimina aziende](https://docs.didit.me/it/entities/businesses/operations.md#eliminazione-di-aziende-batch) | `POST /v3/businesses/delete/` (in batch) |
| [Consulta lo storico KYB](https://docs.didit.me/it/entities/businesses/kyb-history.md) | `GET /v3/sessions?vendor_data=...` |
| [Consulta le transazioni](https://docs.didit.me/it/entities/businesses/transactions.md) | `GET /v3/transactions/?vendor_data=...` |
| [Esamina le persone chiave](https://docs.didit.me/it/entities/businesses/key-people.md) | Tramite le decisioni delle sessioni di Verifica aziendale (KYB) |
| [Aggiungi alla blocklist](https://docs.didit.me/it/entities/businesses/blocklist.md) | Console + Lists API |
| [Importa / esporta](https://docs.didit.me/it/entities/businesses/import-export.md) | Solo console (CSV) |
| [Gestisci nella console](https://docs.didit.me/it/entities/businesses/console.md) | Guida completa all'interfaccia |

## Azienda ↔ utente

Un'entità aziendale raramente esiste da sola. Durante la [KYB](https://docs.didit.me/it/business-verification/overview.md), Didit identifica ogni responsabile, amministratore, UBO e titolare effettivo. Ciascuna di queste persone può essere collegata a un'entità utente per il KYC individuale:

```mermaid theme={null}
flowchart LR
    B[Business: biz-acme]
    U1[User: jane-doe<br/>Director]
    U2[User: john-smith<br/>UBO 40%]
    U3[User: alice-chen<br/>UBO 35%]
    U1 --> B
    U2 --> B
    U3 --> B
```

Quando uno degli utenti collegati ha una verifica KYC non riuscita o un riscontro AML, questo si propaga al profilo di rischio dell'azienda. Consulta [Persone chiave](https://docs.didit.me/it/entities/businesses/key-people.md) per lo schema di collegamento.

## Azienda e sessione aziendale

Una **sessione aziendale** è un singolo evento di verifica KYB. Un'**entità aziendale** è il profilo persistente che aggrega tutte le sessioni.

Una singola azienda può avere molte sessioni di Verifica aziendale (KYB): verifica iniziale, invii successivi, re-KYB periodici. La mappa `features` dell'azienda riflette lo stato più recente di tutte le sessioni.

## Prossimi passi

> [card] [Modello dei dati](https://docs.didit.me/it/entities/businesses/data-model.md)
>
> Ogni campo, tipo e indice.

> [card] [Operazioni](https://docs.didit.me/it/entities/businesses/operations.md)
>
> Creazione, aggiornamento, modifica dello stato ed eliminazione.

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

> [card] [Persone chiave](https://docs.didit.me/it/entities/businesses/key-people.md)
>
> Collegamento di responsabili, UBO e amministratori.

> [card] [Blocklist](https://docs.didit.me/it/entities/businesses/blocklist.md)
>
> Blocco delle aziende dalle transazioni.

> [card] [Console](https://docs.didit.me/it/entities/businesses/console.md)
>
> Guida completa all'interfaccia delle aziende.


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