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

# Vendor-Unternehmen: Persistenter KYB-Datensatz

> Didit-Unternehmensprofile bündeln KYB-Historie, Registerdaten, wirtschaftlich Berechtigte, AML und Transaktionen in einem Profil.

Ein **Unternehmens-Entität** repräsentiert eine juristische Person (Unternehmen, GmbH, Fonds, Stiftung, Einzelunternehmen, Treuhandvermögen) über alle KYB-Verifizierungen, Transaktionen und Compliance-Interaktionen hinweg, die sie mit Ihrer Plattform auf Didit hat.

Ähnlich wie Benutzer-Entitäten werden Unternehmens-Entitäten über `vendor_data` identifiziert und fassen alle verknüpften Sitzungen und Transaktionen in einem einzigen Profil zusammen.

## Was zu einem Unternehmen gehört

| Kategorie | Felder / Objekte |
| - | - |
| **Identität** | `vendor_data`, `uuid`, `display_name`, `legal_name`, `registration_number`, `country_code` |
| **Status** | `ACTIVE`, `FLAGGED`, `BLOCKED` |
| **Sitzungsaggregate** | `session_count`, `approved_count`, `declined_count`, `in_review_count`, `features`-Map |
| **Aktivität** | `first_session_at`, `last_session_at`, `last_activity_at` |
| **Schlüsselpersonen** | Verknüpfte Funktionsträger, Geschäftsführer, UBOs, wirtschaftlich Berechtigte (jede Person kann für KYC mit einer Benutzer-Entität verknüpft werden) |
| **Dokumente** | Gründungsurkunden, Satzung, Gesellschafterlisten, POA, Jahresabschlüsse, benutzerdefinierte Dokumente |
| **Geldwäscheprüfung** | Ergebnisse der Prüfungen auf Sanktionen, PEPs und negative Medienberichte auf Unternehmensebene |
| **Metadaten** | Beliebiges JSON für Ihre eigenen Daten |

Die vollständige [Datenmodell-Referenz für Unternehmen](https://docs.didit.me/de/entities/businesses/data-model.md) mit Feldtypen und Sonderfällen finden Sie hier.

## Wann ein Unternehmen angelegt wird

**1. Automatisch aus einer Sitzung zur Unternehmensverifizierung (KYB)**

Wenn Sie eine Sitzung zur Unternehmensverifizierung (KYB) mit einem `vendor_data`-Wert anlegen, den Didit noch nie gesehen hat, wird eine Unternehmens-Entität im Status `ACTIVE` erstellt und mit dieser Sitzung verknüpft.

**2. Explizit über POST /v3/businesses/create/**

Legen Sie das Unternehmen vorab an, bevor Sie eine Sitzung zur Unternehmensverifizierung (KYB) durchführen. Das ist nützlich, um Metadaten vorab zu hinterlegen oder Unternehmen gesammelt zu onboarden.

**3. Über die Konsole**

Ihr Team legt das Unternehmen auf der Seite Unternehmen an, zum Beispiel wenn Sie ein Unternehmen manuell onboarden, das über einen Offline-Prozess verifiziert wurde.

## Was Sie tun können

| Vorgang | Vorgehen |
| - | - |
| [Unternehmen auflisten](https://docs.didit.me/de/entities/businesses/operations.md#unternehmen-auflisten) | `GET /v3/businesses/` mit Filtern |
| [Unternehmen abrufen](https://docs.didit.me/de/entities/businesses/operations.md#ein-unternehmen-abrufen) | `GET /v3/businesses/{vendor_data}/` |
| [Unternehmen anlegen](https://docs.didit.me/de/entities/businesses/operations.md#ein-unternehmen-anlegen) | `POST /v3/businesses/create/` |
| [Profil aktualisieren](https://docs.didit.me/de/entities/businesses/operations.md#ein-unternehmen-aktualisieren) | `PATCH /v3/businesses/{vendor_data}/` |
| [Status ändern](https://docs.didit.me/de/entities/businesses/operations.md#status-ändern) | `PATCH /v3/businesses/{vendor_data}/update-status/` |
| [Unternehmen löschen](https://docs.didit.me/de/entities/businesses/operations.md#unternehmen-löschen-batch) | `POST /v3/businesses/delete/` (Batch) |
| [KYB-Verlauf prüfen](https://docs.didit.me/de/entities/businesses/kyb-history.md) | `GET /v3/sessions?vendor_data=...` |
| [Transaktionen prüfen](https://docs.didit.me/de/entities/businesses/transactions.md) | `GET /v3/transactions/?vendor_data=...` |
| [Schlüsselpersonen prüfen](https://docs.didit.me/de/entities/businesses/key-people.md) | Über die Entscheidungen der Sitzung zur Unternehmensverifizierung (KYB) |
| [Zur Sperrliste hinzufügen](https://docs.didit.me/de/entities/businesses/blocklist.md) | Konsole und Lists API |
| [Importieren / exportieren](https://docs.didit.me/de/entities/businesses/import-export.md) | Nur über die Konsole (CSV) |
| [In der Konsole verwalten](https://docs.didit.me/de/entities/businesses/console.md) | Vollständige Anleitung zur Oberfläche |

## Unternehmen ↔ Benutzer-Beziehungen

Eine Unternehmens-Entität steht selten für sich allein. Während der [KYB](https://docs.didit.me/de/business-verification/overview.md) identifiziert Didit jeden Funktionsträger, Geschäftsführer, UBO und wirtschaftlich Berechtigten. Jede dieser Personen kann für individuelles KYC mit einer Benutzer-Entität verknüpft werden:

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

Wenn eine der verknüpften Benutzer-Entitäten eine fehlgeschlagene KYC-Prüfung oder einen AML-Treffer aufweist, wirkt sich das auf das Risikoprofil des Unternehmens aus. Das Verknüpfungsmuster finden Sie unter [Schlüsselpersonen](https://docs.didit.me/de/entities/businesses/key-people.md).

## Unternehmen und Unternehmenssitzung

Eine **Unternehmenssitzung** ist ein einzelner KYB-Verifizierungsvorgang. Eine **Unternehmens-Entität** ist das dauerhafte Profil, das alle Sitzungen zusammenfasst.

Ein Unternehmen kann viele Sitzungen zur Unternehmensverifizierung (KYB) haben, etwa die Erstverifizierung, erneute Einreichungen und regelmäßige erneute KYB. Die `features`-Map des Unternehmens spiegelt den neuesten Stand über alle Sitzungen hinweg wider.

## Nächste Schritte

> [card] [Datenmodell](https://docs.didit.me/de/entities/businesses/data-model.md)
>
> Jedes Feld, jeder Typ und jeder Index.

> [card] [Vorgänge](https://docs.didit.me/de/entities/businesses/operations.md)
>
> Anlegen, aktualisieren, Status ändern, löschen.

> [card] [KYB-Verlauf](https://docs.didit.me/de/entities/businesses/kyb-history.md)
>
> Jede Sitzung zur Unternehmensverifizierung (KYB), die dem Unternehmen zugeordnet ist.

> [card] [Schlüsselpersonen](https://docs.didit.me/de/entities/businesses/key-people.md)
>
> Verknüpfung von Funktionsträgern, UBOs und Geschäftsführern.

> [card] [Sperrliste](https://docs.didit.me/de/entities/businesses/blocklist.md)
>
> Unternehmen von Transaktionen ausschließen.

> [card] [Konsole](https://docs.didit.me/de/entities/businesses/console.md)
>
> Vollständige Anleitung zur Unternehmensoberfläche in der Konsole.


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