> ## 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-API: UBOs & Geschäftsführer im KYB

> Didit verifiziert wirtschaftlich Berechtigte, Gesellschafter und Geschäftsführer per KYB-Flow. Ab $2.00 pro Verifizierung, ohne Verträge.

**Schlüsselpersonen** ist das einheitliche Modell von Didit für jede natürliche Person und juristische Person, die mit dem Unternehmen verbunden ist, das Sie verifizieren: wirtschaftlich Berechtigte (UBOs), Gesellschafter (natürliche und juristische Personen), Geschäftsführer, Vertreter und weitere Funktionsträger. Ein einziger Ablauf für Schlüsselpersonen deckt alles ab, mit rollenabhängiger Verteilung der Verifizierung und einer vollständigen Gegenüberstellung der aus dem Register stammenden und vom Benutzer eingereichten Beteiligten.

> [!NOTE]
>
> Die Unternehmensansicht der Schlüsselpersonen, also wie Funktionsträger und UBOs über Sitzungen hinweg zusammengeführt werden, finden Sie unter [Unternehmen → Schlüsselpersonen](https://docs.didit.me/de/entities/businesses/key-people.md).

## Wie es funktioniert

**1. Registervorausfüllung (optional)**

Wenn der Workflow die Registervorausfüllung aktiviert, wird der Bildschirm für Schlüsselpersonen mit den verfügbaren UBOs, Gesellschaftern und Funktionsträgern vorausgefüllt, die aus der Registerprüfung extrahiert wurden.
Der Endbenutzer kann Beteiligte vor der Einreichung bearbeiten, hinzufügen oder entfernen, auch wenn die Angaben zur Eigentümerstruktur noch ausstehen.
Bereits erhaltene Funktionsträger bleiben verfügbar, während der Bericht zur Eigentümerstruktur erstellt wird.
Vor der Einreichung füllen verspätete Ergebnisse nicht bearbeitete Felder und ergänzen fehlende Personen, ohne vorgenommene Änderungen zu ersetzen oder entfernte Beteiligte wiederherzustellen.
Ein geöffneter Editor bleibt unverändert; die zusätzliche Vorausfüllung wird angewendet, nachdem der Antragsteller ihn geschlossen hat.
Ist die Registervorausfüllung deaktiviert, geben Antragsteller die Personen selbst ein, und verspätete Ergebnisse füllen dieses Formular nicht.
Registerdaten, die nach der Einreichung eintreffen, bleiben Teil der Registerbelege, ändern jedoch nicht die eingereichte Liste der Beteiligten und erzeugen keine zusätzlichen untergeordneten Verifizierungssitzungen automatisch.

**2. Einreichung über den gehosteten Ablauf**

Der Endbenutzer reicht die endgültige Liste der Schlüsselpersonen über den gehosteten Verifizierungsablauf ein. Standardmäßig müssen Sie diesen Schritt nicht selbst aufrufen. Er findet innerhalb des KYB-Ablaufs statt, dessen URL Sie aus [Sitzung erstellen](https://docs.didit.me/de/sessions-api/create-session.md) übermittelt haben.
Wenn Sie stattdessen Ihr eigenes Frontend verwenden möchten, nutzen Sie die Endpoints [Entwurf der Beteiligten](https://docs.didit.me/de/sessions-api/kyb-create-party-draft.md) und [Beteiligte einreichen](https://docs.didit.me/de/sessions-api/kyb-submit-parties.md).

**3. Rollenabhängiges Routing der Verifizierung**

Für jeden eingereichten Beteiligten prüft Didit die konfigurierten Verifizierungseinstellungen der Rolle:

* Wendet den Schwellenwert für die Eigentümerstruktur aus dem Workflow an. UBOs und Gesellschafter unterhalb des konfigurierten Prozentsatzes benötigen keine individuelle Verifizierung.
* Berücksichtigt das Flag „Verifizierung überspringen“, das der Endbenutzer gesetzt hat, sofern die Rolle das Überspringen erlaubt.
* Erzeugt eine untergeordnete Sitzung für die Benutzerverifizierung (KYC) für Personen, die eine KYC-Prüfung benötigen.
* Erzeugt eine untergeordnete KYB-Teilsitzung für UBOs in Form juristischer Personen, wenn verschachteltes KYB im Workflow aktiviert ist.

**4. Statusverlauf**

Der Status der Funktion **Schlüsselpersonen** lautet `Awaiting User`, solange eine erforderliche untergeordnete Sitzung noch läuft. Wenn alle untergeordneten Sitzungen abgeschlossen sind, wird der Status anhand der Ergebnisse zu `Approved`, `Declined` oder `In Review` zusammengefasst.

## Erfasste Rollen

Schlüsselpersonen können eine oder mehrere der folgenden Rollen haben. Eine Person kann auch mehrere Rollen gleichzeitig innehaben, zum Beispiel Geschäftsführer **und** Gesellschafter. Die vollständige Taxonomie:

| Kategorie | Rollen |
| - | - |
| **Eigentümerstruktur** | `ubo`, `shareholder`, `beneficiary`, `settlor`, `protector`, `investor` |
| **Governance / Vertretung** | `director`, `non_executive_director`, `chairman`, `secretary`, `representative`, `authorized_signatory`, `trustee`, `company_officer`, `founder`, `legal_advisor`, `other` |

Jede Rolle lässt sich im Workflow einzeln konfigurieren: aktiviert oder deaktiviert, für KYC erforderlich oder optional, einem bestimmten KYC-Workflow zugeordnet und optional überspringbar. Die Details zur Verteilung der Verifizierung finden Sie unter [Eigentümerstruktur](https://docs.didit.me/de/business-verification/ownership.md).

## Pro Schlüsselperson erfasste Daten

Der gehostete Ablauf fragt einen Standardsatz von Feldern sowie zusätzliche, im Workflow konfigurierte benutzerdefinierte Felder ab. Die vollständige Liste finden Sie unter [Eigentümerstruktur → Erfasste Felder](https://docs.didit.me/de/business-verification/ownership.md#erfasste-daten-zu-jeder-schlüsselperson).

## Registerbestätigung

Vor dem Schritt Schlüsselpersonen prüft der Endbenutzer die aus der Registerprüfung extrahierten Unternehmensdaten und bearbeitet optional beliebige Felder. Der gehostete Ablauf speichert anschließend:

* Die **Registerdetails**, die Didit aus der Registerprüfung normalisiert hat (`registry_data`).
* Die **vom Benutzer bestätigten Daten** (`user_provided_data`) mit einem Zeitstempel, der festhält, wann der Benutzer bestätigt hat.
* Eine zusammengeführte kanonische Ansicht der Unternehmensfelder auf oberster Ebene. Sie enthält die vom Benutzer bestätigten Werte, sofern vorhanden, andernfalls die Registerwerte.

Das vollständige Modell finden Sie unter [Unternehmensdaten → Register- vs. vom Benutzer bereitgestellte Daten](https://docs.didit.me/de/business-verification/company-data.md#registerdaten-im-vergleich-zu-vom-benutzer-angegebenen-daten).

## Struktur in der Entscheidungsantwort

Nach der Einreichung erscheinen die erfassten Schlüsselpersonen in der KYB-Entscheidung unter `key_people_checks[]`. Sie sind in zwei Bereiche aufgeteilt: **registry** (was der Anbieter offengelegt hat) und **submitted** (was der Unternehmensadministrator im Ablauf bestätigt hat). Zusätzlich enthält die Antwort ein `ubo_kyc_summary`, das den Fortschritt der UBO-KYC-Prüfungen zusammenfasst. Die vollständige Referenz finden Sie unter [key\_people\_checks-Referenz](https://docs.didit.me/de/business-verification/response-schema.md#key_people_checks).

## Verhalten bei erneuter Einreichung

* **Schlüsselpersonen** und **Registerprüfung** können nicht direkt erneut eingereicht werden. Um eine bestimmte Person erneut zu verifizieren, reichen Sie die untergeordnete KYC-Sitzung dieser Person erneut ein.
* Wenn eine untergeordnete KYC-Sitzung erneut eingereicht wird, kehrt der Status der übergeordneten Funktion „Schlüsselpersonen“ automatisch zu `Awaiting User` zurück.
* Wenn die erneut eingereichte untergeordnete Sitzung abgeschlossen ist, wird der übergeordnete Status anhand aller Status der untergeordneten Sitzungen neu zusammengefasst.
* Eine untergeordnete Sitzung, die gelöscht wurde oder abgelaufen ist, bevor die Person sie gestartet hat, kann nicht erneut eingereicht werden. [Erzeugen Sie den Beteiligten neu](https://docs.didit.me/de/sessions-api/regenerate-kyb-party.md), um einen neuen Link für denselben Beteiligten auszustellen.

## Wie lange der Verifizierungslink einer Schlüsselperson gültig ist

Die untergeordnete KYC-Sitzung einer Schlüsselperson richtet sich nach der Sitzungsablaufzeit des KYC-Workflows, der für ihre Rolle konfiguriert ist, und nicht nach der des KYB-Workflows. Ordnen Sie einer Rolle einen KYC-Workflow zu, der vier Wochen erlaubt, dann bleibt der Link dieser Person vier Wochen nutzbar, auch wenn die KYB-Sitzung früher abläuft.

Der Wert ist eine Einstellung pro Workflow, von 1 Stunde bis 4 Wochen (`session_expiration_time`, in Sekunden), unter *Workflows → \[KYC-Workflow] → Einstellungen*.

Die Ablaufzeit bestimmt, was Sie mit der Partei tun können. Ein Link, der abgelaufen ist, bevor die Person mit der Verifizierung begonnen hat, wie etwa ein Link zu einer gelöschten Sitzung, kann mit [Regenerate Key People KYC Session](https://docs.didit.me/de/sessions-api/regenerate-kyb-party.md) neu ausgestellt werden. Gelöschte Sitzungen qualifizieren sich auch dann, wenn die Person die Verifizierung bereits begonnen oder abgeschlossen hatte. Für importierte Sitzungen gilt dies nicht aufgrund des Ablaufs; sie müssen gelöscht worden sein. Eine Sitzung, die nicht gelöscht wurde und die die Person bereits begonnen hatte, qualifiziert sich nicht über den Ablauf.

## Konfigurationsoptionen

Das gesamte Verhalten von Key People wird pro Workflow in der Business Console konfiguriert:

| Einstellung | Was sie steuert |
| - | - |
| **Registerdaten vorausfüllen** | Das Formular für Key People mit Registerdaten vorausfüllen |
| **Zusätzliche Felder – Personen** | Benutzerdefinierte Felder, die für jede Person als Partei erfasst werden |
| **Zusätzliche Felder – Unternehmen** | Benutzerdefinierte Felder, die für jede Unternehmenspartei erfasst werden |
| **UBO-Eigentumsschwelle** | Mindestprozentsatz der Beteiligung, ab dem eine Person als UBO eingestuft wird |
| **Aktionärs-Eigentumsschwelle** | Mindestprozentsatz der Beteiligung, ab dem eine Person als Aktionär eingestuft wird |
| **Einstellungen pro Rolle** | Für jede Rolle: aktiviert/deaktiviert, KYC erforderlich, zu verwendender KYC-Workflow, überspringbar |
| **Verschachteltes KYB für Unternehmens-UBOs** | Wenn aktiviert, starten Unternehmens-UBOs ihre eigene untergeordnete KYB-Sitzung |
| **Verifizierte Personen wiederverwenden** | Siehe [Verifizierte Personen über KYB-Prüfungen hinweg wiederverwenden](#verifizierte-personen-über-kyb-prüfungen-hinweg-wiederverwenden) weiter unten |
| **Parteien per E-Mail benachrichtigen** | Jeder Schlüsselperson wird automatisch ihr Verifizierungslink per E-Mail gesendet |

Konfigurieren Sie dies unter *Workflows → \[KYB-Workflow] → Key People* in der Konsole.

## Verifizierte Personen über KYB-Prüfungen hinweg wiederverwenden

Wenn **Verifizierte Personen wiederverwenden** für einen Workflow aktiviert ist (Standardeinstellung), muss eine Schlüsselperson bei jeder neuen KYB-Prüfung, in der sie auftaucht, nicht erneut KYC durchlaufen. Didit sucht nach einem bestehenden genehmigten KYC aus einer früheren KYB-Prüfung und verknüpft es mit der neuen Partei, statt eine neue untergeordnete KYC-Sitzung zu starten.

> [!NOTE]
>
> Dies ist ein eigenständiger Mechanismus gegenüber [Wiederverwendbares KYC](https://docs.didit.me/de/core-technology/reusable-kyc/overview.md). Dort kann ein *Endbenutzer* eine abgeschlossene Sitzung freiwillig über ein Freigabe- oder Importtoken in getrennten, mit Didit integrierten Anwendungen weiterverwenden. Die KYB-Wiederverwendungseinstellung auf dieser Seite ist automatisch, workflow-gesteuert und auf Schlüsselpersonen innerhalb einer einzelnen Anwendung beschränkt. Sie benötigt kein Freigabetoken und keine Aktion des Endbenutzers.

**Abgleich.** Ein möglicher Treffer wird ermittelt, indem der vollständige Name der übermittelten Person (ohne Berücksichtigung von Groß- und Kleinschreibung, mit entfernten Leerzeichen am Rand) mit Schlüsselpersonen aus den anderen KYB-Prüfungen der Anwendung verglichen wird. Ein weiteres Abgleichsmerkmal gibt es nicht: Eine Übereinstimmung bei Dokumentnummer, E-Mail oder Telefonnummer ist weder erforderlich noch wird sie geprüft. Ein Name mit anderer Schreibweise, einem zweiten Vornamen oder einer Transliteration führt nicht zu einer Übereinstimmung. In seltenen Fällen könnten zwei verschiedene Personen mit gleichem Namen übereinstimmen. Berücksichtigen Sie dies bei der Auswertung Ihrer Key-People-Ergebnisse.

**Geltungsbereich.** Der Abgleich umfasst alle anderen KYB-Prüfungen derselben *Anwendung*, nicht nur die aktuelle KYB-Prüfung und nicht andere Anwendungen Ihrer Organisation. Eine Person, die bei Unternehmen A als UBO verifiziert wurde, kann übereinstimmen, wenn sie später bei Unternehmen B als Geschäftsführer auftaucht, sofern beide Prüfungen unter derselben Anwendung laufen.

**Zulässige Status.** Nur das jeweils neueste **Genehmigt**-KYC einer Partei ist für die Wiederverwendung zulässig. Ein **Abgelehnt**-KYC für diesen Namen blockiert die Wiederverwendung vollständig: Die Partei wird markiert, und es wird ein neues KYC angefordert, statt auf das abgelehnte zurückzugreifen. Ein KYC, das noch **In Prüfung** ist, wird nie als Kandidat berücksichtigt.

**Aufbewahrung.** Der Abgleich berücksichtigt nur KYC-Sitzungen, die ungefähr im vergangenen Jahr erstellt wurden und noch nicht gelöscht wurden. Liegt die einzige passende Sitzung außerhalb dieses Zeitraums oder hat die Person bzw. Organisation sie gelöscht, findet die Prüfung keinen zulässigen Treffer und fordert stillschweigend ein neues KYC an. Sie schlägt nie fehl und blockiert nie die Einreichung von Key People.

**Abrechnung.** Ein wiederverwendetes KYC wird nicht erneut abgerechnet. Die Verknüpfung einer bereits genehmigten Sitzung mit der neuen Partei verursacht keine zusätzlichen Kosten. Sie werden nur einmal abgerechnet, und zwar für das ursprüngliche KYC.

```txt Example theme={null}
Company A: Jane Doe submitted as UBO, KYC approved.
Company B (same application): Jane Doe submitted as a director.
"Reuse verified individuals" is enabled, so Company B's Key People
check links Jane's existing approved KYC instead of requesting a
new one - free, and instantly Approved for that party.
```

## Nächste Schritte

> [card] [Eigentümerstruktur](https://docs.didit.me/de/business-verification/ownership.md)
>
> Erfasste Felder, benutzerdefinierte Daten und Abgleich von Registerdaten mit den eingereichten Daten.

> [card] [Organe und Vertreter](https://docs.didit.me/de/business-verification/officers.md)
>
> Governance-Rollen innerhalb des Key-People-Modells.

> [card] [Antwortschema](https://docs.didit.me/de/business-verification/response-schema.md#key_people_checks)
>
> Feldweise Referenz zu `key_people_checks[]`.


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