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

# Unternehmensverifizierung (KYB) Dokumente-API

> Didit erfasst und prüft Unternehmensdokumente per OCR. Registerabgleich, Preise getrennt vom Registerabruf. Zertifikate, Satzungen, Abschlüsse.

Die Unternehmensverifizierung (KYB) umfasst die strukturierte Erfassung von Dokumenten, um Unternehmensinformationen über das hinaus zu validieren, was in Registern verfügbar ist.

## Preise

Die Dokumentenerfassung für KYB kostet **\$0.20 pro Workflow-Schritt**, unabhängig davon, wie viele Dokumente in diesem Schritt hochgeladen werden. Das erneute Hochladen eines Dokuments im selben Schritt verursacht keine zusätzliche Gebühr. Ein separater Schritt zur Dokumentenerfassung hat dagegen seine eigene Gebühr.

## Dokumentgruppen

Dokumente sind in vier strukturierte Gruppen eingeteilt. Jede Gruppe steht für eine Kategorie von Nachweisen, die für die Unternehmensverifizierung benötigt werden. Dazu kommt eine Sammelgruppe für alles, was Didit nicht klassifizieren kann:

| Gruppe (`document_group`) | Beschreibung | Erkannte Dokumentuntertypen |
| - | - | - |
| **Rechtliche Existenz** (`LEGAL_PRESENCE`) | Dokumente, die belegen, dass das Unternehmen rechtlich besteht | `CERTIFICATE_OF_INCORPORATION`, `CERTIFICATE_OF_GOOD_STANDING`, `CERTIFICATE_OF_INCUMBENCY`, `REGISTRY_EXCERPT`, `BUSINESS_LICENSE`, `TAX_REGISTRATION` |
| **Unternehmensdaten** (`COMPANY_DETAILS`) | Dokumente, die die aktuellen Angaben des Unternehmens beschreiben | `CONFIRMATION_STATEMENT`, `ANNUAL_RETURN`, `STATEMENT_OF_INFORMATION` |
| **Eigentumsstruktur** (`OWNERSHIP_STRUCTURE`) | Dokumente, die die Eigentümerkette belegen | `SHAREHOLDER_REGISTRY`, `MEMORANDUM_OF_ASSOCIATION`, `ARTICLES_OF_ASSOCIATION` |
| **Vertreterermächtigung** (`REPRESENTATIVES_AUTHORIZATION`) | Dokumente, die die Befugnis belegen, im Namen des Unternehmens zu handeln | `DIRECTOR_REGISTRY`, `POWER_OF_ATTORNEY`, `TRUST_AGREEMENT` |
| **Andere** (`OTHER`) | Alles, was Didit nicht sicher klassifizieren kann | `UNKNOWN` |

Jede Gruppe verfolgt ihren Fortschritt mit eigenen Zählern: `total`, `approved`, `pending`, `declined`, `in_review`, `other` und `missing`. Der Gesamtstatus der Dokumente in der Unternehmenssitzung fasst alle Gruppen zusammen.

## Dokumenttypen

| Kategorie | Beispiele |
| - | - |
| **Gründungsdokumente** | Gründungsurkunde, Satzung, Memorandum of Association |
| **Eigentumsdokumente** | Gesellschafterliste, Anteilsbescheinigungen, UBO-Erklärungen |
| **Adressdokumente** | Versorgungsrechnungen, Kontoauszüge oder Mietverträge für die eingetragene Adresse |
| **Finanzdokumente** | Jahresabschlüsse, Prüfberichte, Finanzberichte |
| **Steuerdokumente** | Steuerliche Registrierungsbescheinigungen, Steuerkonformitätsbescheinigungen |
| **Regulatorische Dokumente** | Lizenzen, Genehmigungen, behördliche Zulassungen |
| **Benutzerdefinierte Dokumente** | Alle zusätzlichen Dokumente, die Ihr Compliance-Prozess verlangt |

## Dokument-Workflow

**1. Automatische Anfragen**

Auf Grundlage Ihrer Workflow-Konfiguration ermittelt Didit automatisch, welche Dokumente für die Unternehmensverifizierung benötigt werden. Die erforderlichen Dokumenttypen werden dem Unternehmen zum Hochladen angezeigt.

**2. Hochladen**

Dokumente werden über den gehosteten Verifizierungsablauf, über die Business Console oder über Ihr eigenes Frontend mit dem [Endpoint zum Hochladen von Dokumenten](https://docs.didit.me/de/sessions-api/kyb-upload-documents.md) hochgeladen. Akzeptierte Formate sind PDF, JPG, JPEG, PNG, TIFF und WebP oder ein ZIP-Archiv mit diesen Dateien. PDFs dürfen bis zu 50 MB groß sein, Fotos bis zu 6 MB vor der Komprimierung. Bei einer passwortgeschützten PDF übermitteln Sie das Passwort in `document_passwords`, wenn Sie über die API hochladen.

**3. OCR-Extraktion**

Didit extrahiert mithilfe von OCR strukturierte Daten aus hochgeladenen Dokumenten:

* Unternehmensname und Registernummer aus Zertifikaten
* Adressdaten aus Versorgungsrechnungen
* Finanzkennzahlen aus Aufstellungen
* Namen und Rollen aus Gesellschafterlisten

**4. Gegenprüfung**

Die extrahierten Daten werden mit Folgendem abgeglichen:

* Registerdaten aus der Unternehmensabfrage
* Bei der Sitzungserstellung angegebenen Informationen
* Daten aus anderen hochgeladenen Dokumenten

Abweichungen werden zur Prüfung durch Analysten markiert.

**5. Prüfung**

Analysten prüfen hochgeladene Dokumente in der Konsole, verifizieren deren Echtheit und genehmigen oder lehnen jedes Dokument einzeln ab.

## Dokumentenanfragen von Analysten

Während des Prüfprozesses können Analysten zusätzliche Dokumente anfordern:

1. Navigieren Sie in der Konsole zur Unternehmenssitzung.
2. Klicken Sie auf **Dokument anfordern** und geben Sie den Dokumenttyp und eine Beschreibung an.
3. Das Unternehmen wird benachrichtigt und kann das angeforderte Dokument hochladen.
4. Das Dokument erscheint in der Sitzung mit dem Status **Angefragt**, bis es hochgeladen wurde.

So können Analysten zusätzliche Nachweise einholen, ohne die gesamte Unternehmenssitzung abzulehnen.

## Dokumentstatus

Jedes Dokument und die aggregierte Prüfung `document_verifications[]` verwenden den Standard-Statussatz für KYB-Funktionen:

| Status | Beschreibung |
| - | - |
| `"Not Finished"` | Das Dokument wird noch verarbeitet (Upload läuft, OCR läuft oder Gegenprüfung steht aus). |
| `"Approved"` | Das Dokument wurde geprüft und akzeptiert. |
| `"Declined"` | Das Dokument wurde geprüft und abgelehnt. |
| `"In Review"` | Das Dokument erfordert eine manuelle Prüfung durch einen Analysten. |
| `"Resub Requested"` | Der Analyst hat eine erneute Einreichung angefordert: Das Unternehmen muss dieses Dokument erneut hochladen, bevor die Sitzung fortgesetzt werden kann. |

## Ergebnisse der Kreuzprüfung

Wenn ein Dokument verarbeitet wird, gleicht Didit die per OCR extrahierten Daten mit den **vom Benutzer bereitgestellten Daten** ab, die im Ablauf für Schlüsselpersonen übermittelt wurden (sowie mit Daten, die bei der Registerprüfung bestätigt wurden), und zusätzlich mit weiteren hochgeladenen Dokumenten. Die Kreuzprüfung liefert strukturierte Ergebnisse:

| Kategorie | Beschreibung |
| - | - |
| **Kritische Felder** | Felder, in denen die Dokumentdaten und die vom Benutzer bereitgestellten Daten nicht übereinstimmen. Sie erfordern eine manuelle Prüfung durch einen Analysten. Jedes Feld zeigt den Dokumentwert, den vom Benutzer bereitgestellten Wert und einen Konfidenzwert. |
| **Nicht kritische Felder** | Felder mit geringfügigen Abweichungen oder Formatunterschieden, die möglicherweise keine Maßnahme erfordern (z. B. Abkürzungsunterschiede im Firmennamen). |
| **Personenüberschneidung** | Analyse der im Dokument genannten Personen im Vergleich zu den vom Benutzer übermittelten Personen. Zeigt fehlende oder zusätzliche Personen auf. |

Die Ergebnisse der Kreuzprüfung werden in der [Business Console](https://docs.didit.me/de/business-verification/console.md) zusammen mit der Dokumentvorschau angezeigt. Analysten erhalten so einen klaren Überblick darüber, was übereinstimmt und was Aufmerksamkeit erfordert.

## Dokumente über die API abrufen

Dokumente sind an die Sitzung der Unternehmensverifizierung (KYB) angehängt. Rufen Sie sie über die Entscheidung der Sitzung ab:

```bash theme={null}
curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"
```

Die Antwort enthält ein Array `document_verifications[]`. Jedes Element hat einen `status`, eine `node_id`, `items[]` (jeweils mit einer signierten `file_url`, einer `document_group`, einem `document_subtype` und einem OCR-Auszug), `groups` und `required_groups`. Die vollständige Struktur finden Sie im [Antwortschema](https://docs.didit.me/de/business-verification/response-schema.md#document_verifications).

## Nächste Schritte

> [card] [Antwortschema](https://docs.didit.me/de/business-verification/response-schema.md)
>
> Wo Dokumente in der Payload erscheinen.

> [card] [Business Console](https://docs.didit.me/de/business-verification/console.md)
>
> Dokumente als Analyst prüfen.


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