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

# Entreprises fournisseurs Didit : dossier KYB persistant

> Didit unifie en un profil persistant l'historique KYB, le registre, les bénéficiaires effectifs, dirigeants, AML, documents et transactions.

Une **entité Business** représente une entité juridique (société, LLC, fonds, fondation, entreprise individuelle, trust) dans toutes les vérifications KYB, transactions et interactions de conformité qu'elle a avec votre plateforme sur Didit.

Comme les entités User, les entités Business sont identifiées par `vendor_data` et regroupent toutes les sessions et transactions liées dans un profil unique.

## Ce qui compose une entité Business

| Catégorie | Champs / objets |
| - | - |
| **Identité** | `vendor_data`, `uuid`, `display_name`, `legal_name`, `registration_number`, `country_code` |
| **Statut** | `ACTIVE`, `FLAGGED`, `BLOCKED` |
| **Agrégats de sessions** | `session_count`, `approved_count`, `declined_count`, `in_review_count`, dictionnaire `features` |
| **Activité** | `first_session_at`, `last_session_at`, `last_activity_at` |
| **Personnes clés** | Mandataires sociaux, dirigeants, UBO et bénéficiaires effectifs liés (chacun peut être lié à une entité User pour le KYC) |
| **Documents** | Certificats de constitution, statuts, registres des actionnaires, justificatifs de domicile (POA), états financiers, documents personnalisés |
| **AML** | Résultats de filtrage au niveau de l'entreprise pour les sanctions, les PEP et la presse négative |
| **Métadonnées** | JSON libre pour vos propres données |

Consultez le [modèle de données Business](https://docs.didit.me/fr/entities/businesses/data-model.md) complet pour les types de champs et les cas particuliers.

## Quand une entité Business est créée

**1. Automatiquement, à partir d'une session de Vérification d'entreprise (KYB)**

Lorsque vous créez une session de Vérification d'entreprise (KYB) avec un `vendor_data` que Didit n'a jamais vu, une entité Business est créée avec le statut `ACTIVE` et liée à cette session.

**2. Explicitement, via POST /v3/businesses/create/**

Créez le Business à l'avance, avant de lancer toute session de Vérification d'entreprise (KYB). Utile pour pré-remplir des métadonnées ou intégrer des entreprises en masse.

**3. Depuis la console**

Votre équipe crée le Business depuis la page Businesses, par exemple lorsqu'elle intègre manuellement une entreprise vérifiée par un processus hors ligne.

## Ce que vous pouvez faire

| Opération | Comment |
| - | - |
| [Lister les entreprises](https://docs.didit.me/fr/entities/businesses/operations.md#lister-les-entreprises) | `GET /v3/businesses/` avec filtres |
| [Obtenir une entreprise](https://docs.didit.me/fr/entities/businesses/operations.md#consulter-une-entreprise) | `GET /v3/businesses/{vendor_data}/` |
| [Créer une entreprise](https://docs.didit.me/fr/entities/businesses/operations.md#créer-une-entreprise) | `POST /v3/businesses/create/` |
| [Mettre à jour le profil](https://docs.didit.me/fr/entities/businesses/operations.md#mettre-à-jour-une-entreprise) | `PATCH /v3/businesses/{vendor_data}/` |
| [Modifier le statut](https://docs.didit.me/fr/entities/businesses/operations.md#changer-le-statut) | `PATCH /v3/businesses/{vendor_data}/update-status/` |
| [Supprimer des entreprises](https://docs.didit.me/fr/entities/businesses/operations.md#supprimer-des-entreprises-par-lot) | `POST /v3/businesses/delete/` (par lot) |
| [Consulter l'historique KYB](https://docs.didit.me/fr/entities/businesses/kyb-history.md) | `GET /v3/sessions?vendor_data=...` |
| [Consulter les transactions](https://docs.didit.me/fr/entities/businesses/transactions.md) | `GET /v3/transactions/?vendor_data=...` |
| [Examiner les personnes clés](https://docs.didit.me/fr/entities/businesses/key-people.md) | Via les décisions des sessions de Vérification d'entreprise (KYB) |
| [Ajouter à la liste de blocage](https://docs.didit.me/fr/entities/businesses/blocklist.md) | Console + API Lists |
| [Importer / exporter](https://docs.didit.me/fr/entities/businesses/import-export.md) | Console uniquement (CSV) |
| [Gérer dans la console](https://docs.didit.me/fr/entities/businesses/console.md) | Parcours complet de l'interface |

## Relations Business ↔ User

Une entité Business est rarement isolée. Pendant la [KYB](https://docs.didit.me/fr/business-verification/overview.md), Didit identifie chaque mandataire social, dirigeant, UBO et bénéficiaire effectif. Chacune de ces personnes peut être liée à une entité User pour un KYC individuel :

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

Lorsqu'un des utilisateurs liés présente un échec de KYC ou une correspondance AML, cela se répercute sur le profil de risque du Business. Consultez [Personnes clés](https://docs.didit.me/fr/entities/businesses/key-people.md) pour le schéma de liaison.

## Entité Business et session d'entreprise

Une **session d'entreprise** correspond à un événement de vérification KYB. Une **entité Business** est le profil durable qui regroupe toutes les sessions.

Un même Business peut avoir de nombreuses sessions de Vérification d'entreprise (KYB) : vérification initiale, nouvelles soumissions, re-KYB périodiques. Le dictionnaire `features` du Business reflète l'état le plus récent de l'ensemble des sessions.

## Étapes suivantes

> [card] [Modèle de données](https://docs.didit.me/fr/entities/businesses/data-model.md)
>
> Chaque champ, type et index.

> [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)
>
> Chaque session de Vérification d'entreprise (KYB) liée à l'entreprise.

> [card] [Personnes clés](https://docs.didit.me/fr/entities/businesses/key-people.md)
>
> Liaison des mandataires sociaux, UBO et dirigeants.

> [card] [Liste de blocage](https://docs.didit.me/fr/entities/businesses/blocklist.md)
>
> Bloquer des entreprises pour les transactions.

> [card] [Console](https://docs.didit.me/fr/entities/businesses/console.md)
>
> Parcours complet de l'interface Businesses.


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