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

# API Profili aziendali: tracciare le aziende verificate

> Didit: traccia aziende verificate con profili automatici, stati, tag, azioni in blocco, import/export CSV. Da $2.00 per verifica.

Didit crea automaticamente un profilo aziendale per ogni azienda che verifichi, aggregando i dati di verifica e la cronologia delle sessioni in un'unica entità. I profili aziendali offrono una vista unificata di ciascuna azienda in tutte le sue sessioni di verifica.

> [!NOTE]
>
> I profili aziendali sono la parte specifica per KYB del modello più generale **Business entity**. Per il modello completo delle entità, incluse le operazioni, il collegamento delle persone chiave agli utenti, il funzionamento della blocklist e l'importazione ed esportazione, consulta [Panoramica delle aziende](https://docs.didit.me/it/entities/businesses/overview.md).

## Che cos'è un profilo aziendale

Un profilo aziendale viene creato automaticamente quando una [sessione aziendale](https://docs.didit.me/it/business-verification/overview.md) viene inviata con un identificativo `vendor_data`. Se esiste già un profilo con quell'identificativo, la nuova sessione viene collegata a quel profilo.

| Campo | Descrizione |
| - | - |
| **Dati del fornitore** | Il tuo identificativo univoco per questa azienda (ad esempio `company-123`) |
| **Nome visualizzato** | Nome visualizzato nella console |
| **Ragione sociale** | Ragione sociale ufficiale, ricavata dal registro o inserita manualmente |
| **Numero di registrazione** | Numero di registrazione o di costituzione della società |
| **Paese** | Paese di costituzione (ISO 3166-1 alpha-2) |

## Stati del profilo

| Stato | Descrizione |
| - | - |
| `ACTIVE` | L'azienda è in regola: non sono stati rilevati problemi |
| `FLAGGED` | L'azienda richiede attenzione: i risultati devono essere esaminati oppure ci sono controlli in sospeso |
| `BLOCKED` | L'azienda è stata bloccata e non può più svolgere attività |

Lo stato può essere modificato manualmente dalla console, in blocco oppure automaticamente in base ai risultati della verifica.

## Metriche di sessione

Ogni profilo tiene traccia delle metriche di verifica di tutte le sessioni collegate:

| Metrica | Descrizione |
| - | - |
| **Sessioni totali** | Numero di sessioni di verifica per questa azienda |
| **Approvate** | Sessioni che hanno superato tutti i controlli |
| **Rifiutate** | Sessioni che non hanno superato uno o più controlli critici |
| **In revisione** | Sessioni in attesa di revisione da parte di un analista |
| **Ultima sessione** | Data e ora della verifica più recente |
| **Prima sessione** | Data e ora della verifica più risalente |
| **Ultima attività** | Data e ora di qualsiasi attività recente (modifica dello stato, aggiornamento della sessione e così via) |

## Tag

Applica tag ai profili aziendali per categorizzarli e filtrarli. I tag sono definiti dall'applicazione: crea tag personalizzati adatti al tuo flusso di lavoro (ad esempio `high-risk`, `vip-client`, `re-verification-needed`).

## Operazioni in blocco

Gestisci più profili aziendali contemporaneamente:

| Operazione | Descrizione |
| - | - |
| **Aggiornamento di stato in blocco** | Modifica lo stato dei profili selezionati (oppure di tutti i profili che corrispondono ai filtri attuali) |
| **Esportazione CSV** | Esporta i dati dei profili in CSV, con selezione configurabile delle colonne |
| **Importazione CSV** | Importa profili aziendali da un file CSV per crearli in anticipo, prima della verifica |
| **Eliminazione in blocco** | Rimuove i profili selezionati e i relativi dati associati |

### Importazione CSV

Per importare profili aziendali in blocco:

1. Scarica il **modello di importazione** dalla console per vedere il formato previsto delle colonne
2. Compila il modello con i dati delle tue aziende
3. Carica il file: Didit crea un processo di importazione ed elabora le righe in modo asincrono

Al termine, controlla il riepilogo dell'importazione per il numero di righe create, aggiornate e non riuscite. Le righe non riuscite riportano i dettagli specifici dell'errore.

## Revisioni e commenti

Aggiungi note di revisione interne a qualsiasi profilo aziendale. I commenti sono visibili a tutti i membri del team con accesso e fanno parte della traccia di audit:

* Aggiungi note con testo libero
* Menziona i membri del team tramite email per notificarli
* Visualizza la cronologia completa dei commenti con autore e data e ora

## Prossimi passi

> [card] [Panoramica della verifica aziendale](https://docs.didit.me/it/business-verification/overview.md)
>
> Come funzionano dall'inizio alla fine le sessioni di verifica aziendale.

> [card] [Guida alla console](https://docs.didit.me/it/business-verification/console.md)
>
> Gestione dei profili aziendali e delle sessioni nella Business Console.

> [card] [Riferimento API](https://docs.didit.me/it/management-api/businesses/list.md)
>
> Endpoint API per la gestione delle aziende.


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