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

# Documenti KYB: API per la verifica aziendale

> Con Didit raccogli, estrai via OCR e incrocia i documenti KYB: certificati, statuti, bilanci. Validazione sul registro imprese. Prezzi separati.

La verifica aziendale include una raccolta strutturata di documenti per convalidare le informazioni sull'azienda oltre a quanto disponibile nei registri.

## Prezzi

La raccolta dei documenti KYB costa **\$0.20 per passaggio del workflow**, indipendentemente dal numero di documenti caricati in quel passaggio. Ricaricare un documento nello stesso passaggio non comporta un'ulteriore commissione; un passaggio separato di raccolta documenti ha un proprio addebito.

## Gruppi di documenti

I documenti sono organizzati in quattro gruppi strutturati, ognuno dei quali rappresenta una categoria di prove necessarie per la verifica aziendale, più un gruppo generico per tutto ciò che Didit non riesce a classificare:

| Gruppo (`document_group`) | Descrizione | Sottotipi di documento riconosciuti |
| - | - | - |
| **Presenza legale** (`LEGAL_PRESENCE`) | Documenti che attestano l'esistenza legale dell'azienda | `CERTIFICATE_OF_INCORPORATION`, `CERTIFICATE_OF_GOOD_STANDING`, `CERTIFICATE_OF_INCUMBENCY`, `REGISTRY_EXCERPT`, `BUSINESS_LICENSE`, `TAX_REGISTRATION` |
| **Dettagli dell'azienda** (`COMPANY_DETAILS`) | Documenti che descrivono i dati attuali dell'azienda | `CONFIRMATION_STATEMENT`, `ANNUAL_RETURN`, `STATEMENT_OF_INFORMATION` |
| **Struttura proprietaria** (`OWNERSHIP_STRUCTURE`) | Documenti che attestano la catena di proprietà | `SHAREHOLDER_REGISTRY`, `MEMORANDUM_OF_ASSOCIATION`, `ARTICLES_OF_ASSOCIATION` |
| **Autorizzazione dei rappresentanti** (`REPRESENTATIVES_AUTHORIZATION`) | Documenti che attestano il potere di agire per conto dell'azienda | `DIRECTOR_REGISTRY`, `POWER_OF_ATTORNEY`, `TRUST_AGREEMENT` |
| **Altro** (`OTHER`) | Qualsiasi documento che Didit non riesce a classificare con sicurezza | `UNKNOWN` |

Ogni gruppo tiene traccia del proprio avanzamento con contatori specifici: `total`, `approved`, `pending`, `declined`, `in_review`, `other` e `missing`. Lo stato complessivo dei documenti della sessione aziendale è l'aggregazione di tutti i gruppi.

## Tipi di documento

| Categoria | Esempi |
| - | - |
| **Documenti di costituzione** | Certificato di costituzione, statuto, atto costitutivo |
| **Documenti di proprietà** | Libro dei soci, certificati azionari, dichiarazioni dei titolari effettivi (UBO) |
| **Documenti di indirizzo** | Bollette delle utenze, estratti conto bancari o contratti di locazione per la sede legale |
| **Documenti finanziari** | Bilanci d'esercizio, relazioni di revisione, rendiconti finanziari |
| **Documenti fiscali** | Certificati di iscrizione fiscale, certificati di conformità fiscale |
| **Documenti normativi** | Licenze, permessi, autorizzazioni regolamentari |
| **Documenti personalizzati** | Qualsiasi documento aggiuntivo richiesto dal tuo processo di compliance |

## Workflow dei documenti

**1. Richieste automatiche**

In base alla configurazione del tuo workflow, Didit identifica automaticamente quali documenti sono necessari per la verifica aziendale. I tipi di documento richiesti vengono presentati all'azienda per il caricamento.

**2. Caricamento**

I documenti vengono caricati tramite il flusso di verifica ospitato, nella Business Console oppure dal tuo front end con l'endpoint [caricamento dei documenti](https://docs.didit.me/it/sessions-api/kyb-upload-documents.md). I formati accettati sono PDF, JPG, JPEG, PNG, TIFF e WebP, oppure un archivio ZIP che li contiene. I PDF possono arrivare fino a 50 MB e le foto fino a 6 MB prima della compressione. Per un PDF protetto da password, invia la password in `document_passwords` quando carichi il documento tramite API.

**3. Estrazione OCR**

Didit estrae dati strutturati dai documenti caricati tramite OCR:

* Nome dell'azienda e numero di registrazione dai certificati
* Dati dell'indirizzo dalle bollette delle utenze
* Dati finanziari dai rendiconti
* Nomi e ruoli dai libri dei soci

**4. Verifica incrociata**

I dati estratti vengono confrontati con:

* Dati del registro provenienti dalla ricerca dell'azienda
* Informazioni fornite alla creazione della sessione
* Dati di altri documenti caricati

Le incoerenze vengono segnalate per la revisione da parte dell'analista.

**5. Revisione**

Gli analisti esaminano i documenti caricati nella console, ne verificano l'autenticità e approvano o rifiutano ciascun documento singolarmente.

## Richieste di documenti da parte degli analisti

Durante il processo di revisione, gli analisti possono richiedere documenti aggiuntivi:

1. Vai alla sessione aziendale nella console
2. Fai clic su **Request document** e specifica il tipo di documento e la descrizione
3. L'azienda riceve una notifica e può caricare il documento richiesto
4. Il documento compare nella sessione con lo stato **Requested** finché non viene caricato

Questo permette agli analisti di raccogliere prove aggiuntive senza rifiutare l'intera sessione aziendale.

## Stati dei documenti

Ogni documento e il controllo aggregato `document_verifications[]` utilizzano il set standard di stati della funzionalità KYB:

| Stato | Descrizione |
| - | - |
| `"Not Finished"` | Il documento è ancora in elaborazione (caricamento in corso, OCR in esecuzione o in attesa del controllo incrociato). |
| `"Approved"` | Il documento è stato esaminato e accettato. |
| `"Declined"` | Il documento è stato esaminato e rifiutato. |
| `"In Review"` | Il documento richiede l'intervento manuale di un analista. |
| `"Resub Requested"` | L'analista ha richiesto un nuovo invio: l'azienda deve ricaricare questo documento prima che la sessione possa procedere. |

## Risultati del confronto incrociato

Quando un documento viene elaborato, Didit confronta i dati estratti tramite OCR con i **dati forniti dall'utente** inseriti nel flusso Persone chiave (e con eventuali dati confermati durante la revisione del registro), oltre che con altri documenti caricati. Il confronto produce risultati strutturati:

| Categoria | Descrizione |
| - | - |
| **Campi critici** | Campi in cui i dati del documento e i dati forniti dall'utente non corrispondono: richiedono la revisione dell'analista. Ogni campo mostra il valore del documento, il valore fornito dall'utente e un punteggio di affidabilità. |
| **Campi non critici** | Campi con discrepanze minori o differenze di formattazione che potrebbero non richiedere alcuna azione (ad esempio differenze di abbreviazione nel nome dell'azienda). |
| **Sovrapposizione di persone** | Analisi delle persone menzionate nel documento rispetto alle persone inserite dall'utente: evidenzia le persone mancanti o aggiuntive. |

I risultati del confronto incrociato vengono visualizzati nella [Business Console](https://docs.didit.me/it/business-verification/console.md) accanto all'anteprima del documento, offrendo agli analisti una visione chiara di ciò che corrisponde e di ciò che richiede attenzione.

## Recupero dei documenti tramite API

I documenti sono allegati alla sessione di Verifica aziendale (KYB). Recuperali tramite la decisione della sessione:

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

La risposta include un array `document_verifications[]`: ogni elemento ha un `status`, un `node_id`, `items[]` (ciascuno con un `file_url` firmato, un `document_group`, un `document_subtype` e un estratto OCR), `groups` e `required_groups`. Consulta lo [schema della risposta](https://docs.didit.me/it/business-verification/response-schema.md#document_verifications) per la struttura completa.

## Passaggi successivi

> [card] [Schema della risposta](https://docs.didit.me/it/business-verification/response-schema.md)
>
> Dove compaiono i documenti nel payload.

> [card] [Business console](https://docs.didit.me/it/business-verification/console.md)
>
> Revisione dei documenti in qualità di analista.


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