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

# KYB-Datenmodell für Unternehmen: Schema

> Didit-Datenmodell für Unternehmen: Registerdaten, UBOs, Geschäftsführer, AML-Status, Dokumente, KYB-Aggregate, Transaktionen.

Diese Seite dokumentiert jedes Feld einer Business-Entität und wie Didit die einzelnen Felder befüllt.

## Identitätsfelder

| Feld | Typ | Beschreibung |
| - | - | - |
| `uuid` | UUID | Von Didit vergebener Primärschlüssel. Stabil und eindeutig. |
| `didit_internal_id` | string | Für Menschen lesbare interne Kennung. |
| `vendor_data` | string | Ihre Kennung für das Unternehmen. Pro Anwendung eindeutig. [Weiterlesen](https://docs.didit.me/de/entities/vendor-data-linking.md). |
| `display_name` | string | Überschreibt den in der Konsole angezeigten Namen. Standardwert ist `legal_name` oder `vendor_data`. |
| `legal_name` | string | Rechtlicher Firmenname laut Eintragung: aus der Registerabfrage der neuesten genehmigten Unternehmensverifizierung (KYB)-Sitzung übernommen. |
| `registration_number` | string | Offizielle Registernummer des Unternehmens, aus dem Register übernommen. |
| `country_code` | string (ISO 3166-1 alpha-3) | Land der Gründung. |

> [!NOTE]
>
> `legal_name`, `registration_number` und `country_code` sind schreibgeschützt, wenn sie aus einer verifizierten Registerabfrage stammen. Sie können manuell in der Konsole oder über `PATCH /v3/businesses/{vendor_data}/` überschrieben werden; Überschreibungen werden jedoch im Audit-Log markiert.

## Status

| Feld | Typ | Werte | Beschreibung |
| - | - | - | - |
| `status` | enum | `ACTIVE`, `FLAGGED`, `BLOCKED` | Steuert die Durchsetzungsmaßnahmen für künftige Sitzungen und Transaktionen. Siehe [Lebenszyklus](https://docs.didit.me/de/entities/lifecycle.md). |

## Aggregierte Sitzungsfelder

| Feld | Typ | Beschreibung |
| - | - | - |
| `session_count` | int | Gesamtzahl aller jemals für dieses Unternehmen erstellten Unternehmensverifizierung (KYB)-Sitzungen |
| `approved_count` | int | Mit `Approved` abgeschlossene Sitzungen |
| `declined_count` | int | Mit `Declined` abgeschlossene Sitzungen |
| `in_review_count` | int | Aktuell `In Review` befindliche Sitzungen |
| `features` | object | Status der neuesten Unternehmensverifizierung unter dem Schlüssel `KYB` |

### Die `features`-Map

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

Die Map enthält einen Schlüssel, `KYB`, mit dem Status der neuesten Unternehmensverifizierung: `"Not Finished"`, `"Approved"`, `"Declined"`, `"In Review"` oder `"Resub Requested"`.
Den Status der einzelnen KYB-Funktionen entnehmen Sie der Sitzungsentscheidung.

Verwenden Sie die `features`-Map als schnellen Weg, um zu prüfen, ob ein Unternehmen aktuell vollständig verifiziert ist, ohne alle Sitzungen durchzugehen.

## Aktivitätszeitstempel

| Feld | Typ | Aktualisiert bei |
| - | - | - |
| `first_session_at` | ISO-Zeitstempel | Erste Unternehmensverifizierung (KYB)-Sitzung wurde erstellt |
| `last_session_at` | ISO-Zeitstempel | Neueste Sitzung wurde erstellt oder aktualisiert |
| `last_activity_at` | ISO-Zeitstempel | Jede Änderung: Sitzung, Transaktion, Status, Profil, Notizen |
| `created_at` | ISO-Zeitstempel | Entitätszeile wurde erstellt |
| `updated_at` | ISO-Zeitstempel | Entitätszeile wurde zuletzt aktualisiert |

## Metadaten

| Feld | Typ | Beschreibung |
| - | - | - |
| `metadata` | object (JSON) | Freiform-JSON, das Sie verwalten |
| `tags[]` | array | Über Konsole/API verwaltete Tags |

## Relationen (nicht in der Unternehmenszeile gespeichert)

| Relation | So greifen Sie darauf zu |
| - | - |
| Sitzungen zur Unternehmensverifizierung (KYB) | `GET /v3/sessions?vendor_data=<value>` |
| Verknüpfte Benutzer (Verantwortliche, UBOs, Geschäftsführer) | Auf der Detailseite des Unternehmens in der Konsole angezeigt; abgeleitet aus der neuesten genehmigten Unternehmensverifizierung (KYB)-Sitzung |
| Transaktionen (als Antragsteller oder Gegenpartei) | Transaktionen nach `vendor_data` des Unternehmens filtern |
| Dokumente | Über Entscheidungen der Unternehmensverifizierung (KYB)-Sitzungen |
| AML-Treffer | Über Entscheidungen der Unternehmensverifizierung (KYB)-Sitzungen |

## Beispielantwort

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

## Nächste Schritte

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

> [card] [KYB-Verlauf](https://docs.didit.me/de/entities/businesses/kyb-history.md)
>
> Alle mit dem Unternehmen verknüpften Sitzungen abrufen.

> [card] [API-Referenz](https://docs.didit.me/de/management-api/businesses/get.md)
>
> Schema für GET /v3/businesses/{vendor_data}/.


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