> ## 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 documents KYB : vérification d'entreprise

> Avec Didit, collectez, extrayez par OCR et croisez les documents KYB : statuts, certificats, comptes. Validation au registre, tarification séparée.

La vérification d'entreprise inclut une collecte structurée de documents afin de valider les informations de l'entreprise au-delà de ce qui est disponible dans les registres.

## Tarifs

La collecte de documents KYB coûte **\$0.20 par étape de workflow**, indépendamment du nombre de documents téléversés lors de cette étape. Le retéléversement d'un document dans la même étape n'ajoute pas de frais supplémentaires ; une étape distincte de collecte de documents a son propre coût.

## Groupes de documents

Les documents sont organisés en quatre groupes structurés, chacun représentant une catégorie de preuves nécessaire à la vérification d'entreprise, ainsi qu'un groupe fourre-tout pour tout document que Didit ne peut pas classer :

| Groupe (`document_group`) | Description | Sous-types de documents reconnus |
| - | - | - |
| **Présence légale** (`LEGAL_PRESENCE`) | Documents prouvant l'existence juridique de l'entreprise | `CERTIFICATE_OF_INCORPORATION`, `CERTIFICATE_OF_GOOD_STANDING`, `CERTIFICATE_OF_INCUMBENCY`, `REGISTRY_EXCERPT`, `BUSINESS_LICENSE`, `TAX_REGISTRATION` |
| **Détails de l'entreprise** (`COMPANY_DETAILS`) | Documents décrivant les informations actuelles de l'entreprise | `CONFIRMATION_STATEMENT`, `ANNUAL_RETURN`, `STATEMENT_OF_INFORMATION` |
| **Structure de propriété** (`OWNERSHIP_STRUCTURE`) | Documents prouvant la chaîne de propriété | `SHAREHOLDER_REGISTRY`, `MEMORANDUM_OF_ASSOCIATION`, `ARTICLES_OF_ASSOCIATION` |
| **Autorisation des représentants** (`REPRESENTATIVES_AUTHORIZATION`) | Documents prouvant le pouvoir d'agir au nom de l'entreprise | `DIRECTOR_REGISTRY`, `POWER_OF_ATTORNEY`, `TRUST_AGREEMENT` |
| **Autre** (`OTHER`) | Tout document que Didit ne peut pas classer avec certitude | `UNKNOWN` |

Chaque groupe suit sa progression à l'aide de compteurs propres : `total`, `approved`, `pending`, `declined`, `in_review`, `other` et `missing`. Le statut global des documents de la session d'entreprise agrège l'ensemble des groupes.

## Types de documents

| Catégorie | Exemples |
| - | - |
| **Documents de constitution** | Certificat de constitution, statuts, acte constitutif |
| **Documents de propriété** | Registre des actionnaires, certificats d'actions, déclarations UBO |
| **Justificatifs d'adresse** | Factures de services publics, relevés bancaires ou baux pour l'adresse du siège social |
| **Documents financiers** | Comptes annuels, rapports d'audit, états financiers |
| **Documents fiscaux** | Certificats d'immatriculation fiscale, attestations de conformité fiscale |
| **Documents réglementaires** | Licences, permis, approbations réglementaires |
| **Documents personnalisés** | Tout document supplémentaire requis par votre processus de conformité |

## Flux de traitement des documents

**1. Demandes automatiques**

Selon la configuration de votre workflow, Didit identifie automatiquement les documents nécessaires à la vérification de l'entreprise. Les types de documents requis sont présentés à l'entreprise pour téléversement.

**2. Téléversement**

Les documents sont téléversés via le flux de vérification hébergé, depuis la Business Console, ou depuis votre propre interface avec l'endpoint [téléverser des documents](https://docs.didit.me/fr/sessions-api/kyb-upload-documents.md). Les formats acceptés sont PDF, JPG, JPEG, PNG, TIFF et WebP, ou une archive ZIP de ces fichiers. Les PDF peuvent atteindre 50 Mo et les photos jusqu'à 6 Mo avant compression. Pour un PDF protégé par mot de passe, envoyez le mot de passe dans `document_passwords` lorsque vous téléversez via l'API.

**3. Extraction OCR**

Didit extrait des données structurées des documents téléversés à l'aide de l'OCR :

* Nom de l'entreprise et numéro d'immatriculation à partir des certificats
* Données d'adresse à partir des factures de services publics
* Chiffres financiers à partir des relevés
* Noms et fonctions à partir des registres des actionnaires

**4. Recoupement**

Les données extraites sont recoupées avec :

* Les données du registre issues de la recherche d'entreprise
* Les informations fournies à la création de la session
* Les données provenant des autres documents téléversés

Les incohérences sont signalées pour examen par un analyste.

**5. Examen**

Les analystes examinent les documents téléversés dans la console, vérifient leur authenticité, et approuvent ou rejettent chaque document individuellement.

## Demandes de documents par les analystes

Pendant le processus d'examen, les analystes peuvent demander des documents supplémentaires :

1. Accédez à la session d'entreprise dans la console
2. Cliquez sur **Request document** et indiquez le type de document et sa description
3. L'entreprise est notifiée et peut téléverser le document demandé
4. Le document apparaît dans la session avec le statut **Demandé** jusqu'à son téléversement

Cela permet aux analystes de recueillir des preuves supplémentaires sans rejeter l'ensemble de la session d'entreprise.

## Statuts des documents

Chaque document et la vérification agrégée `document_verifications[]` utilisent le jeu de statuts standard des fonctionnalités KYB :

| Statut | Description |
| - | - |
| `"Not Finished"` | Le document est toujours en cours de traitement (téléversement en cours, OCR en cours d'exécution ou recoupement en attente). |
| `"Approved"` | Le document a été examiné et accepté. |
| `"Declined"` | Le document a été examiné et rejeté. |
| `"In Review"` | Le document nécessite une intervention manuelle d'un analyste. |
| `"Resub Requested"` | Un analyste a demandé un nouvel envoi : l'entreprise doit téléverser de nouveau ce document avant que la session puisse progresser. |

## Résultats de la vérification croisée

Lorsqu'un document est traité, Didit croise les données extraites par OCR avec les **données fournies par l'utilisateur** soumises dans le flux Key People (ainsi que les données confirmées lors de l'examen du registre) et avec les autres documents importés. Le recoupement produit des résultats structurés :

| Catégorie | Description |
| - | - |
| **Champs critiques** | Champs pour lesquels les données du document et les données fournies par l'utilisateur ne correspondent pas. Ils nécessitent un examen par un analyste. Chaque champ affiche la valeur du document, la valeur fournie par l'utilisateur et un score de confiance. |
| **Champs non critiques** | Champs présentant des écarts mineurs ou des différences de format qui ne nécessitent pas forcément d'action (par exemple, des différences d'abréviation dans le nom de l'entreprise). |
| **Recoupement des personnes** | Analyse des personnes mentionnées dans le document et de celles soumises par l'utilisateur, qui signale les personnes manquantes ou supplémentaires. |

Les résultats du recoupement s'affichent dans la [Business Console](https://docs.didit.me/fr/business-verification/console.md), à côté de l'aperçu du document, ce qui permet aux analystes d'identifier clairement ce qui correspond et ce qui requiert leur attention.

## Récupérer les documents via l'API

Les documents sont rattachés à la session de vérification d'entreprise (KYB). Récupérez-les via la décision de session :

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

La réponse contient un tableau `document_verifications[]` : chaque élément possède un `status`, un `node_id`, un tableau `items[]` (chacun avec un `file_url` signé, un `document_group`, un `document_subtype` et un extrait OCR), ainsi que `groups` et `required_groups`. Consultez le [schéma de réponse](https://docs.didit.me/fr/business-verification/response-schema.md#document_verifications) pour connaître la structure complète.

## Étapes suivantes

> [card] [Schéma de réponse](https://docs.didit.me/fr/business-verification/response-schema.md)
>
> Où les documents apparaissent dans le payload.

> [card] [Business console](https://docs.didit.me/fr/business-verification/console.md)
>
> Examiner les documents en tant qu'analyste.


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