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

# Modèle de données KYB des entreprises : schéma Didit

> Modèle de données KYB de Didit : registre, UBO, dirigeants, statut AML, documents, agrégats de session et transactions liées, en boucle fermée.

Cette page documente chaque champ d'une entité d'entreprise et indique comment Didit renseigne chacun d'eux.

## Identifiants

| Champ | Type | Description |
| - | - | - |
| `uuid` | UUID | Clé primaire attribuée par Didit. Stable et unique. |
| `didit_internal_id` | string | Identifiant interne lisible par un humain. |
| `vendor_data` | string | Votre identifiant de l'entreprise. Unique par application. [En savoir plus](https://docs.didit.me/fr/entities/vendor-data-linking.md). |
| `display_name` | string | Nom affiché dans la console, qui remplace le nom par défaut. Par défaut, `legal_name` ou `vendor_data`. |
| `legal_name` | string | Raison sociale telle qu'enregistrée, reprise depuis la recherche dans le registre de la dernière session de Vérification d'entreprise (KYB) approuvée. |
| `registration_number` | string | Numéro d'immatriculation officiel de la société, repris depuis le registre. |
| `country_code` | string (ISO 3166-1 alpha-3) | Pays de constitution. |

> [!NOTE]
>
> `legal_name`, `registration_number` et `country_code` sont en lecture seule lorsqu'ils proviennent d'une recherche vérifiée dans le registre. Vous pouvez les remplacer manuellement dans la console ou via `PATCH /v3/businesses/{vendor_data}/`, mais chaque remplacement est signalé dans le journal d'audit.

## Statut

| Champ | Type | Valeurs | Description |
| - | - | - | - |
| `status` | enum | `ACTIVE`, `FLAGGED`, `BLOCKED` | Contrôle l'application des règles pour les futures sessions et transactions. Voir [cycle de vie](https://docs.didit.me/fr/entities/lifecycle.md). |

## Champs agrégés des sessions

| Champ | Type | Description |
| - | - | - |
| `session_count` | int | Nombre total de sessions de Vérification d'entreprise (KYB) créées pour cette entreprise |
| `approved_count` | int | Sessions terminées avec `Approved` |
| `declined_count` | int | Sessions terminées avec `Declined` |
| `in_review_count` | int | Sessions actuellement `In Review` |
| `features` | object | Statut de la dernière vérification de l'entreprise, sous la clé `KYB` |

### L'objet `features`

```json theme={null}
{
  "KYB": "Approved"
}
```

L'objet contient une seule clé, `KYB`, avec le statut de la dernière vérification de l'entreprise : `"Not Finished"`, `"Approved"`, `"Declined"`, `"In Review"` ou `"Resub Requested"`.
Pour connaître le statut de chaque fonctionnalité KYB, consultez la décision de la session.

Utilisez l'objet `features` comme moyen rapide de vérifier si une entreprise est entièrement vérifiée à l'instant présent, sans parcourir toutes les sessions.

## Horodatages d'activité

| Champ | Type | Mis à jour lorsque |
| - | - | - |
| `first_session_at` | horodatage ISO | Première session de Vérification d'entreprise (KYB) créée |
| `last_session_at` | horodatage ISO | Dernière session créée ou mise à jour |
| `last_activity_at` | horodatage ISO | Toute modification : session, transaction, statut, profil, notes |
| `created_at` | horodatage ISO | Création de la ligne de l'entité |
| `updated_at` | horodatage ISO | Dernière mise à jour de la ligne de l'entité |

## Métadonnées

| Champ | Type | Description |
| - | - | - |
| `metadata` | object (JSON) | JSON de forme libre que vous contrôlez |
| `tags[]` | array | Étiquettes gérées depuis la console ou l'API |

## Relations (non stockées dans la ligne de l'entreprise)

| Relation | Comment y accéder |
| - | - |
| Sessions de Vérification d'entreprise (KYB) | `GET /v3/sessions?vendor_data=<value>` |
| Utilisateurs liés (dirigeants, bénéficiaires effectifs, administrateurs) | Affichés sur la page de détail de l'entreprise dans la console ; issus de la dernière session de Vérification d'entreprise (KYB) approuvée |
| Transactions (en tant que demandeur ou contrepartie) | Filtrez les transactions par `vendor_data` de l'entreprise |
| Documents | Via les décisions des sessions de Vérification d'entreprise (KYB) |
| Correspondances AML | Via les décisions des sessions de Vérification d'entreprise (KYB) |

## Exemple de réponse

```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" }
}
```

## Étapes suivantes

> [card] [Opérations](https://docs.didit.me/fr/entities/businesses/operations.md)
>
> Créer, mettre à jour, modifier le statut, supprimer.

> [card] [Historique KYB](https://docs.didit.me/fr/entities/businesses/kyb-history.md)
>
> Récupérer chaque session liée à l'entreprise.

> [card] [Référence de l'API](https://docs.didit.me/fr/management-api/businesses/get.md)
>
> Schéma de GET /v3/businesses/{vendor_data}/.


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