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

# Document AI: Datenextraktion aus individuellen Dokumenten

> Mit Didit bis zu 3 benutzerdefinierte Dokumente erfassen, Felder per KI extrahieren und mit anderen Schritten sowie Regeln abgleichen.

Mit Document AI können Sie Dokumente erfassen, die in keine feste Vorlage passen – wie Kapitalnachweise, Gehaltsabrechnungen, Nachweise zur Herkunft des Vermögens, Steuerbescheide und vieles mehr – und genau die Felder extrahieren, die **Sie** festlegen. Sie konfigurieren den auf dem Bildschirm angezeigten Titel und die Beschreibung jedes Dokuments (automatisch in jede Verifizierungssprache übersetzt) sowie die Liste der auszulesenden Datenpunkte. Die KI von Didit extrahiert diese Felder, gleicht sie optional mit anderen Verifizierungsschritten ab und wendet Ihre Regeln an, um einen Status zu ermitteln.

Document AI-Integrations-Prompt
        Prompt in die Zwischenablage kopieren



      
      

\<pre>

\`# Goal
Integrate Didit Document AI (configurable multi-document upload + AI field extraction + cross-checks) into your app.

\# Setup (Business Console or POST /v3/workflows/)
Add the DOCUMENT_AI feature to your workflow and configure:
\- document_ai_documents: up to 3 documents. Each has { document_key, title, description, fields[] }.
Each field is { key, name, instruction, type: "text" | "number" | "date", required, is_full_name }.
title and description are auto-translated into every verification language on save.
\- is_full_name: optional boolean on a field. Marks the field whose value is compared automatically against the
verified subject: on a person (KYC) workflow the document holder's full name (the ID-verification name, or the
session's expected details), and on a business (KYB) workflow the verified company name (the registry-matched
company, or the session's expected company name). A low match below document_ai_name_match_score_threshold
triggers document_ai_name_mismatch_action. At most one field per document may set it, and it is optional — a
document may mark none (no name check runs).
\- Basic rules (per-risk action DECLINE | REVIEW | NO_ACTION): document_ai_unreadable_document_action,
document_ai_missing_required_fields_action, document_ai_document_tampering_action,
document_ai_name_mismatch_action, document_ai_unsupported_file_action, document_ai_max_attempts_exceeded_action.
\- document_ai_name_match_score_threshold (0-100), document_ai_max_retry_attempts (2-5).
\- status_rules[]: custom rules on any extracted field. Reference an extracted field as document_ai.<field_key>
and cross-reference other steps with value_type:"field" (e.g. document_ai.account_holder equals kyc.full_name).

\# Flow
1\. Create a session — POST /v3/session/ with { workflow_id, vendor_data, callback }. See /sessions-api/create-session.
2\. Open session.url for the user (or mount the Web/Mobile SDK). The user uploads each configured document.
3\. The user uploads documents to POST /v3/document-ai/documents/ (handled by the hosted flow/SDK):
multipart/form-data with { document_key, document, locale? }, Session-Token auth.
Response: { valid?, next_step, document_ai_status, uploaded_document_keys[], required_document_keys[] }.
The step completes once every configured document_key is uploaded.
4\. Fetch the decision — GET /v3/session/{sessionId}/decision/ or subscribe to session.status.updated.

\# Decision surface
DOCUMENT_AI appears in the decision features[] array as { feature: "DOCUMENT_AI", node_id }.
Per-document statuses combine via precedence Declined > In Review > Approved.

\# See also
\- Report: /core-technology/document-ai/report-document-ai
\- Rules & warnings: /core-technology/document-ai/warnings-document-ai
\- Configure in the console: /console/workflows
\- Standalone API (server-to-server, no hosted UI): POST /v3/document-ai/ — /standalone-apis/document-ai`

\</pre>



      
      

Einfügen in

> [!NOTE]
>
> Haben Sie das Dokument bereits auf Ihrem Server? Rufen Sie die [Document AI API](https://docs.didit.me/de/standalone-apis/document-ai.md) direkt auf: Senden Sie die Datei zusammen mit Ihren Felddefinitionen in einer einzigen `POST /v3/document-ai/`-Anfrage und erhalten Sie die extrahierten Felder, den Namensabgleich und den Status synchron zurück, ganz ohne gehosteten Ablauf. \$0.20 pro Dokument.## So funktioniert es**1. Dokumente und Felder konfigurieren**Im Workflow-Builder definieren Sie bis zu **3 Dokumente**. Für jedes Dokument legen Sie Folgendes fest:| Einstellung | Beschreibung |
| - | - |
| **Titel & Beschreibung** | Wird dem Benutzer auf dem Upload-Bildschirm angezeigt. Einmalig eingegeben und **automatisch übersetzt** in jede Verifizierungssprache. |
| **Zu extrahierende Felder** | Eine Liste typisierter Felder – jeweils mit einem Namen, einer Extraktionsanweisung für die KI, einem Typ (`text`, `number`, `date`), einer Kennzeichnung als Pflichtfeld und einer optionalen Markierung für den **vollständigen Namen**. |
| **Namensfeld** | Optional können Sie ein Textfeld pro Dokument als den abzugleichenden Namen markieren. In einem Personen-Workflow (KYC) ist dies der **vollständige Name**, der mit der verifizierten Identität abgeglichen wird; in einem Unternehmens-Workflow (KYB) ist es der **Unternehmensname**, der mit dem verifizierten Unternehmen abgeglichen wird. `document_ai_name_mismatch_action` bestimmt, was bei einer Nichtübereinstimmung geschieht. Optional – lassen Sie das Feld leer, um die Namensprüfung für dieses Dokument zu überspringen. |Starten Sie mit einer [Vorlage](#starter-vorlagen) oder erstellen Sie alles von Grund auf neu.**2. Der Benutzer lädt Dokumente hoch**Der Benutzer lädt eine Datei pro konfiguriertem Dokument hoch (PDF oder Bild). Jeder Upload wird unabhängig verarbeitet; der Schritt ist abgeschlossen, sobald jedes erforderliche Dokument bereitgestellt wurde.**3. KI-Extraktion**Didit rendert jedes Dokument und führt ein Vision-Sprachmodell mit einem Schema aus, das auf Ihren Felddefinitionen basiert. Extrahierte Werte werden typisiert zurückgegeben (Zahlen als Zahlen, Daten als `YYYY-MM-DD`) und pro Dokument gespeichert. Es werden PDF-/EXIF-Forensikprüfungen durchgeführt, um Manipulationen zu erkennen.**4. Abgleich & Regeln**Extrahierte Felder können mit anderen Schritten abgeglichen werden – beispielsweise der Name des Dokumenteninhabers mit dem verifizierten Ausweis oder beliebige Felder mit Fragebogenantworten – sowie mit Ihren **grundlegenden Regeln** und **benutzerdefinierten Statusregeln**. Die resultierenden Status pro Dokument werden zum Funktionsstatus zusammengeführt.## Starter-VorlagenWenn Sie einen Document AI-Knoten hinzufügen, können Sie mit einer vorgefertigten Vorlage beginnen, die Titel, Beschreibung und typisierte Felder bereits vorab ausfüllt. Anschließend lässt sich alles individuell anpassen.| Vorlage | Typische Felder |
| - | - |
| **Kapitalnachweis** | Kontoinhaber, Guthaben, Währung, Auszugsdatum |
| **Einkommensnachweis (Gehaltsabrechnung)** | Arbeitgeber, Mitarbeitername, Brutto-/Nettogehalt, Abrechnungszeitraum |
| **Herkunft des Vermögens** | Herkunftsart, Betrag, Datum, Institut |
| **Steuerdokument** | Name des Steuerpflichtigen, Steuerjahr, deklariertes Einkommen, Steuernummer |## Abgleich mit anderen SchrittenDocument AI-Felder sind als `document_ai.<field_key>` adressierbar und können mithilfe einer benutzerdefinierten Statusregel mit `value_type: "field"` mit Feldern aus anderen abgeschlossenen Schritten verglichen werden. Zum Beispiel:- `document_ai.account_holder` **gleich** `kyc.full_name` – der Dokumenteninhaber stimmt mit der verifizierten Identität überein.
- `document_ai.balance` **greater\_than** `50000` – hohe Guthaben zur Prüfung markieren.Übereinstimmende Regeln fließen nach der Plattform-Rangfolge **Abgelehnt > In Prüfung > Genehmigt** in die Entscheidung ein, sodass eine Regel den Schweregrad zwar erhöhen, aber niemals einen strengeren, risikobasierten Status überschreiben kann. Siehe [Regeln und Warnungen](https://docs.didit.me/de/core-technology/document-ai/warnings-document-ai.md).## Dokumentanforderungen| Anforderung | Detail |
| - | - |
| **Dokumente pro Schritt** | Bis zu 3, jeweils unabhängig voneinander konfiguriert |
| **Unterstützte Formate** | PDF, JPG, JPEG, PNG, TIFF, WebP |
| **Seiten** | Mehrseitige PDFs werden unterstützt |
| **Qualität** | Originaldokument oder hochwertiger Scan; keine digitale Bearbeitung oder Manipulation |> [!NOTE]
>
> Document AI liest unstrukturierten Text aus, was zu einer Latenz von einigen Sekunden pro Dokument führt. Webhooks werden erst ausgelöst, wenn der gesamte Workflow-Schritt abgeschlossen ist – fragen Sie den Entscheidungs-Endpoint in diesem Zeitraum nicht häufiger als alle 5 s ab.


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