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

# Schlüsselpersonen im Unternehmen: UBOs & Geschäftsführer

> Verknüpfen Sie UBOs, Geschäftsführer und wirtschaftlich Berechtigte mit einem Didit-Unternehmen. Jede Person durchläuft KYC als Benutzer.

Jedes Unternehmen hat **Schlüsselpersonen**: die natürlichen Personen, die rechtlich für das Unternehmen verantwortlich sind oder es wirtschaftlich besitzen. Didit ermittelt sie während der KYB-Prüfung, und Sie können jede von ihnen mit einer User-Entität für die individuelle KYC verknüpfen.

## Wer als Schlüsselperson gilt

| Rolle | Beschreibung |
| - | - |
| **Geschäftsführer** | Im Register als Geschäftsführer des Unternehmens eingetragen |
| **Beauftragter** | Sekretär, Vertreter oder anderer im Register eingetragener Beauftragter |
| **Gesellschafter** | Im Register eingetragener Gesellschafter (juristische oder natürliche Person) |
| **UBO (Ultimate Beneficial Owner)** | Natürliche Person, die letztlich mindestens 10/25/50 % besitzt oder kontrolliert (Schwellenwert konfigurierbar) |
| **Zeichnungsberechtigter** | Person, die berechtigt ist, im Namen des Unternehmens zu handeln |

Die vollständige Rollenübersicht und die Berechnung der Eigentümerkette finden Sie auf den Seiten [KYB-Beauftragte](https://docs.didit.me/de/business-verification/officers.md) und [Eigentümerstruktur](https://docs.didit.me/de/business-verification/ownership.md).

## Wie Schlüsselpersonen einem Unternehmen zugeordnet werden

**1. Aus dem Register ermittelt**

Während der KYB-Prüfung fragt Didit das Unternehmensregister ab und extrahiert alle eingetragenen Beauftragten und Gesellschafter. Jede Person wird zu einem **Schlüsselpersonen-Eintrag**, der mit der Unternehmensverifizierung (KYB) verknüpft ist.

**2. Vom Nutzer ergänzt (vom Kunden ausgefüllt)**

Workflows können einen Schritt „Schlüsselpersonen“ enthalten, in dem der Unternehmensadministrator Personen hinzufügt, die nicht im Register stehen (z. B. UBOs, die über eine Unternehmenserklärung ermittelt wurden).

**3. Auf dem Unternehmen zusammengeführt**

Die Liste der Schlüsselpersonen des Unternehmens ist die Vereinigung der aus dem Register extrahierten und der vom Nutzer ergänzten Personen, bereinigt um Doppelungen anhand der Identität.

Jede Schlüsselperson hat ein Feld `source`:

* `REGISTRY`: aus einem offiziellen Register extrahiert.
* `USER`: vom Unternehmensadministrator während des KYB-Ablaufs hinzugefügt.

## Eine Schlüsselperson mit einer User-Entität verknüpfen

Wenn für eine Schlüsselperson KYC erforderlich ist (typischerweise für UBOs und Geschäftsführer), kann die Person mit einer User-Entität verknüpft werden:

```mermaid theme={null}
flowchart LR
    B[Business: biz-acme]
    P1[Key Person: Jane Doe, Director]
    P2[Key Person: John Smith, UBO 40%]
    U1[User: user-jane]
    U2[User: user-john]
    P1 --> B
    P2 --> B
    P1 -.linked.-> U1
    P2 -.linked.-> U2
```

Die Verknüpfung wird erstellt, wenn:

* Für die Person eine Benutzerverifizierung (KYC)-Sitzung mit denselben `vendor_data` wie die User-Entität durchgeführt wird.
* Ein Analyst eine Person des Unternehmens manuell einem bestehenden User zuordnet.

Nach der Verknüpfung wird der KYC-Status des Users in der Ansicht der Schlüsselpersonen des Unternehmens übernommen.

## Schlüsselpersonen einsehen

Auf der Detailseite des Unternehmens in der Konsole zeigt der Tab **Schlüsselpersonen** Folgendes an:

* Name, Rolle, Eigentumsanteil in % und Quelle (Register oder vom Nutzer ergänzt) jeder Person
* KYC-Status der verknüpften Users
* AML-Screening-Status je Person
* Zugehörige Dokumente (Ausweis des Geschäftsführers, UBO-Erklärung)

Programmatisch erscheinen Schlüsselpersonen im Array `key_people_checks[]` der Entscheidung der Unternehmensverifizierung (KYB)-Sitzung, das in zwei Bereiche unterteilt ist:

```json theme={null}
"key_people_checks": [
  {
    "status": "Approved",
    "node_id": "feature_kyb_key_people",
    "registry": {
      "officers": [
        { "uuid": "...", "name": "Jane Doe", "role": "director", "kyc_status": "Approved", "kyc_session_url": "..." }
      ],
      "beneficial_owners": [
        { "uuid": "...", "name": "John Smith", "roles": ["ubo"], "ownership_min_shares": 40, "kyc_status": "Pending" }
      ]
    },
    "submitted": {
      "parties": [
        { "uuid": "...", "entity_type": "person", "name": "Alice Chen", "role": "ubo", "ownership_percent": 35.0, "source": "USER", "requires_verification": true, "kyc_session_status": "Not Started", "kyc_session_url": "..." }
      ]
    },
    "ubo_kyc_summary": { "total": 2, "approved": 1, "flagged": 0, "pending": 1 }
  }
]
```

* **`registry.officers` / `registry.beneficial_owners`**: Personen, die bei der Registerprüfung ermittelt wurden.
* **`submitted.parties`**: Personen, die der Unternehmensadministrator während des Schlüsselpersonen-Ablaufs hinzugefügt hat (`source: USER`).
* **`ubo_kyc_summary`**: Gesamtfortschritt des UBO-KYC-Prozesses.

Die alten flachen Arrays `officers[]` und `beneficial_owners[]` bleiben in der Antwort aus Gründen der Abwärtskompatibilität noch eine Version lang erhalten. Neue Integrationen sollten die oben beschriebene Struktur mit zwei Bereichen verwenden. Das vollständige [KYB-Antwortschema](https://docs.didit.me/de/business-verification/response-schema.md#key_people_checks) enthält jedes Feld.

## Gesellschafter, die Unternehmen sind

Ist ein Gesellschafter selbst ein Unternehmen (und keine Person), durchläuft Didit die Eigentümerkette rekursiv, um die letztlich wirtschaftlich Berechtigten zu ermitteln. Unternehmensparteien können optional untergeordnete Sitzungen zur Unternehmensverifizierung (KYB) auslösen.

Ein ausgearbeitetes Beispiel für mehrstufige Eigentümerketten finden Sie unter [Eigentümerstruktur](https://docs.didit.me/de/business-verification/ownership.md).

## Webhooks für Schlüsselpersonen

Änderungen an Schlüsselpersonen werden über die Ereignisse der übergeordneten Sitzung gemeldet:

* `data.updated` (mit `session_kind: "business"`): Sitzungsdaten einschließlich der Schlüsselpersonen wurden aktualisiert.
* `status.updated` (mit `session_kind: "business"`): Der Sitzungsstatus hat sich dadurch geändert.

Die Payloads finden Sie unter [KYB-Webhooks](https://docs.didit.me/de/business-verification/webhooks.md).

## Nächste Schritte

> [card] [Beauftragte](https://docs.didit.me/de/business-verification/officers.md)
>
> Identifizierung von Geschäftsführern und Rollenübersicht.

> [card] [Eigentümerstruktur](https://docs.didit.me/de/business-verification/ownership.md)
>
> UBO, Unternehmensgesellschafter und Berechnung der Eigentümerkette.

> [card] [Ablauf Schlüsselpersonen](https://docs.didit.me/de/business-verification/key-people.md)
>
> Der KYB-Schritt, in dem Schlüsselpersonen erfasst werden.


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