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

# Unternehmensprofile-API: Verifizierte Firmen verfolgen

> Didit: Verifizierte Unternehmen verfolgen mit automatisch erstellten Profilen, Status, Tags und CSV-Import/Export. Ab $2.00 pro Verifizierung.

Didit erstellt automatisch ein Unternehmensprofil für jedes Unternehmen, das Sie verifizieren, und fasst Verifizierungsdaten und Sitzungsverlauf in einer einzigen Entität zusammen. Unternehmensprofile bieten eine einheitliche Sicht auf jedes Unternehmen über alle seine Verifizierungssitzungen hinweg.

> [!NOTE]
>
> Unternehmensprofile sind die KYB-spezifische Ansicht des allgemeineren Modells **Unternehmensentität**. Das vollständige Entitätsmodell mit Vorgängen, der Verknüpfung von Schlüsselpersonen mit Benutzern, der Funktionsweise von Sperrlisten sowie Import und Export finden Sie unter [Übersicht über Unternehmen](https://docs.didit.me/de/entities/businesses/overview.md).

## Was ist ein Unternehmensprofil

Ein Unternehmensprofil wird automatisch erstellt, wenn eine [Unternehmenssitzung](https://docs.didit.me/de/business-verification/overview.md) mit einer `vendor_data`-Kennung eingereicht wird. Existiert bereits ein Profil mit dieser Kennung, wird die neue Sitzung damit verknüpft.

| Feld | Beschreibung |
| - | - |
| **Anbieterdaten** | Ihre eindeutige Kennung für dieses Unternehmen (z. B. `company-123`) |
| **Anzeigename** | Im Konsolenbereich angezeigter Anzeigename |
| **Rechtlicher Name** | Offizieller rechtlicher Name aus dem Unternehmensregister oder aus einer manuellen Eingabe |
| **Registrierungsnummer** | Handelsregister- oder Gründungsnummer des Unternehmens |
| **Land** | Gründungsland (ISO 3166-1 alpha-2) |

## Profilstatus

| Status | Beschreibung |
| - | - |
| `ACTIVE` | Das Unternehmen ist in gutem Zustand: Es wurden keine Probleme erkannt |
| `FLAGGED` | Das Unternehmen erfordert Aufmerksamkeit – prüfen Sie die Ergebnisse oder ausstehende Prüfungen |
| `BLOCKED` | Für das Unternehmen wurden weitere Aktivitäten gesperrt |

Der Status kann manuell in der Konsole, gesammelt für mehrere Profile gleichzeitig oder automatisch auf Basis der Verifizierungsergebnisse geändert werden.

## Sitzungsmetriken

Jedes Profil erfasst Verifizierungsmetriken über alle verknüpften Sitzungen hinweg:

| Metrik | Beschreibung |
| - | - |
| **Gesamtsitzungen** | Anzahl der Verifizierungssitzungen für dieses Unternehmen |
| **Genehmigt** | Sitzungen, die alle Prüfungen bestanden haben |
| **Abgelehnt** | Sitzungen, die eine oder mehrere kritische Prüfungen nicht bestanden haben |
| **In Prüfung** | Sitzungen, die auf eine Prüfung durch einen Prüfer warten |
| **Letzte Sitzung** | Zeitstempel der neuesten Verifizierung |
| **Erste Sitzung** | Zeitstempel der frühesten Verifizierung |
| **Letzte Aktivität** | Zeitstempel einer aktuellen Aktivität (Statusänderung, Sitzungsaktualisierung usw.) |

## Tags

Weisen Sie Unternehmensprofilen Tags zur Kategorisierung und Filterung zu. Tags werden von der Anwendung definiert: Erstellen Sie eigene Tags, die zu Ihrem Workflow passen (z. B. `high-risk`, `vip-client`, `re-verification-needed`).

## Massenoperationen

Verwalten Sie mehrere Unternehmensprofile gleichzeitig:

| Vorgang | Beschreibung |
| - | - |
| **Massenstatusaktualisierung** | Status ausgewählter Profile ändern (oder aller Profile, die den aktuellen Filtern entsprechen) |
| **CSV-Export** | Profildaten als CSV exportieren, mit konfigurierbarer Spaltenauswahl |
| **CSV-Import** | Unternehmensprofile aus einer CSV-Datei importieren, um Profile vor der Verifizierung vorab anzulegen |
| **Massenlöschung** | Ausgewählte Profile und die zugehörigen Daten löschen |

### CSV-Import

So importieren Sie Unternehmensprofile in großer Zahl:

1. Laden Sie die **Importvorlage** aus der Konsole herunter, um das erwartete Spaltenformat zu sehen
2. Füllen Sie die Vorlage mit Ihren Unternehmensdaten aus
3. Laden Sie die Datei hoch. Didit erstellt einen Importauftrag und verarbeitet die Zeilen asynchron.

Prüfen Sie nach Abschluss die Importzusammenfassung mit der Anzahl erstellter, aktualisierter und fehlgeschlagener Zeilen. Fehlgeschlagene Zeilen enthalten genaue Fehlerdetails.

## Prüfungen und Kommentare

Fügen Sie jedem Unternehmensprofil interne Prüfnotizen hinzu. Kommentare sind für alle Teammitglieder mit Zugriff sichtbar und sind Teil des Audit-Logs:

* Notizen mit Freitext hinzufügen
* Teammitglieder per E-Mail erwähnen, um sie zu benachrichtigen
* Den vollständigen Kommentarverlauf mit Autor und Zeitstempel einsehen

## Nächste Schritte

> [card] [Übersicht über die Unternehmensverifizierung](https://docs.didit.me/de/business-verification/overview.md)
>
> So funktionieren Unternehmensverifizierungssitzungen von Anfang bis Ende.

> [card] [Konsolenhandbuch](https://docs.didit.me/de/business-verification/console.md)
>
> Verwaltung von Unternehmensprofilen und Sitzungen in der Business Console.

> [card] [API-Referenz](https://docs.didit.me/de/management-api/businesses/list.md)
>
> API-Endpoints für die Unternehmensverwaltung.


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