> ## 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) Warnungen & Fehlercodes

> Didit Warncodes für KYB: Unternehmensregister, KYB-Dokumente, Schlüsselpersonen, AML, Telefon, E-Mail, Fragebögen und Geräte- und IP-Analyse.

Die Unternehmensverifizierung (KYB) zeigt Warnungen an dem Funktionselement an, das sie erzeugt hat. Jede Warnung folgt der einheitlichen strukturierten Form, die auf der gesamten Plattform verwendet wird: `feature`, `risk`, `log_type`, `short_description`, `long_description`, optional `additional_data` und `node_id`. So können Sie Prüfaufgaben an das richtige operative Team weiterleiten.

## Übersicht

KYB-Sitzungen geben Warnungen unter drei zentralen Funktions-Tags aus. Diese sind in der V3-Entscheidungsantwort den jeweiligen Funktions-Arrays zugeordnet:

| Funktions-Tag | Schlüssel in der Entscheidungsantwort | Was abgedeckt wird |
| - | - | - |
| `KYB_REGISTRY` | `registry_checks[].warnings[]` | Abfragen bei amtlichen Unternehmensregistern. Aktivstatus, Länderbeschränkungen, ableitbare Eigentümerstruktur, fehlende Datensätze zu Organmitgliedern bzw. UBOs. |
| `KYB_DOCUMENTS` | `document_verifications[].warnings[]` | Gründungsdokumente, Dokumente zur Eigentümerstruktur sowie Adress- und Gesellschafterdokumente, die der Nutzer hochlädt. Dokumentübergreifende Konsistenz, OCR, Metadaten, Manipulation, Alter und Untertyp-Regeln. |
| `KYB_KEY_PEOPLE` | `key_people_checks[].warnings[]` | Personenbezogene Signale zu Geschäftsführern, Organmitgliedern, UBOs oder vom Nutzer angegebenen Parteien, einschließlich PEP- und Sanktionsbefunden, die aus AML und aus der Wiederverwendung zuvor abgelehnter Fälle übernommen werden. |

Derselbe KYB-Workflow kann außerdem die folgenden gemeinsamen Funktionen enthalten. Diese geben Warnungen in eigenen Arrays aus:

| Funktions-Tag | Schlüssel in der Entscheidungsantwort |
| - | - |
| `AML` | `aml_screenings[].warnings[]` |
| `PHONE` | `phone_verifications[].warnings[]` |
| `EMAIL` | `email_verifications[].warnings[]` |
| `QUESTIONNAIRE` | `questionnaire_responses` (Warnungen befinden sich im Sitzungsprotokoll) |
| `LOCATION` | `ip_analyses[].warnings[]` |

## KYB-Warnungen zum Unternehmensregister

Warnungen zum Unternehmensregister verwenden `feature: "KYB_REGISTRY"` und erscheinen in `registry_checks[].warnings[]`.

| Tag | Beschreibung |
| - | - |
| `KYB_COUNTRY_RESTRICTED` | Das Land des Unternehmens liegt außerhalb der für den Workflow konfigurierten erlaubten Länder. |
| `KYB_OFFICERS_DATA_NOT_FOUND` | Daten zu Organmitgliedern sind im Unternehmensregister nicht verfügbar. |
| `KYB_OWNERSHIP_DATA_NOT_FOUND` | Eigentümerdaten sind im Unternehmensregister nicht verfügbar. |
| `KYB_BENEFICIAL_OWNERSHIP_NOT_DERIVABLE` | Die letztlich wirtschaftlich Berechtigten konnten anhand der Daten des Unternehmensregisters nicht ermittelt werden. |
| `KYB_COMPANY_NOT_ACTIVE` | Das Unternehmen ist laut Unternehmensregister nicht aktiv. |
| `KYB_COMPANY_NOT_FROM_REGISTRY` | Das Unternehmen wurde manuell erfasst und konnte nicht anhand eines Unternehmensregisters verifiziert werden. |
| `KYB_REGISTRY_DATA_MISMATCH_WITH_EXPECTED` | Die aus dem Unternehmensregister ermittelte Registernummer des Unternehmens stimmt nicht mit `expected_details.registration_number` überein, die Sie beim Erstellen der Sitzung gesendet haben. |
| `KYB_REGISTRY_DATA_PARTIAL_MATCH_WITH_EXPECTED` | Die aus dem Unternehmensregister ermittelte Registernummer stimmt nur teilweise mit der erwarteten überein, zum Beispiel bei einem Zweigstellen- oder Tochtergesellschaftszusatz. |
| `KYB_COMPANY_VAT_INVALID` | Das amtliche Steuerregister hat keine aktive Registrierung für die USt-IdNr. oder Steuernummer des Unternehmens, oder die USt-IdNr. entspricht nicht den Format- und Prüfziffernregeln ihres Landes. Die konfigurierte `kyb_vat_invalid_action` wird angewendet (Standard: In Prüfung). |
| `KYB_COMPANY_VAT_COULD_NOT_VALIDATE` | Die USt-IdNr. oder Steuernummer konnte nicht validiert werden, weil das amtliche Unternehmensregister vorübergehend nicht verfügbar war. Die konfigurierte `kyb_vat_unverified_action` wird angewendet (Standard: keine Auswirkung). |
| `KYB_COMPANY_VAT_NAME_MISMATCH` | Der beim amtlichen Unternehmensregister für diese Nummer hinterlegte Name weicht vom eingereichten Firmennamen ab. Nur zur Information – die Warnung enthält `registry_name`, `registry_source` und `submitted_name` in `additional_data` sowie `vies_name`, wenn es sich beim Register um VIES handelt. |

Warnungen zur USt-IdNr. gelten überall dort, wo die USt-IdNr. oder Steuernummer des Unternehmens validiert werden kann. Welche Länder und Quellen dabei berücksichtigt werden, finden Sie unter [USt-IdNr.- und Steuernummernvalidierung](https://docs.didit.me/de/business-verification/company-data.md#umsatzsteuer-id--und-steuernummernprüfung).

## KYB-Dokumentwarnungen

Dokumentwarnungen verwenden `feature: "KYB_DOCUMENTS"` und erscheinen unter `document_verifications[].warnings[]`.

| Tag | Beschreibung |
| - | - |
| `KYB_DOCUMENT_MISSING_REQUIRED_FIELD` | Ein Pflichtfeld zum Unternehmen, etwa Firmenname oder Registernummer, wurde im Dokument nicht gefunden. |
| `KYB_DOCUMENT_NAME_MISMATCH` | Der Firmenname im Dokument stimmt nicht mit dem Unternehmensregister überein. |
| `KYB_DOCUMENT_REG_NUMBER_MISMATCH` | Die Registernummer im Dokument stimmt nicht mit dem Unternehmensregister überein. |
| `KYB_DOCUMENT_INCORPORATION_DATE_MISMATCH` | Das Gründungsdatum im Dokument stimmt nicht mit dem Unternehmensregister überein. |
| `KYB_DOCUMENT_ADDRESS_MISMATCH` | Die eingetragene Adresse im Dokument stimmt nicht mit dem Unternehmensregister überein. |
| `KYB_CROSS_DOCUMENT_MISMATCH` | Die Unternehmensdaten weichen zwischen den hochgeladenen Unternehmensdokumenten voneinander ab. |
| `KYB_DOCUMENT_METADATA_MISMATCH` | Die Dokumentsignatur, die Metadaten oder die Dateistruktur deuten auf ein mögliches Problem hin. |
| `KYB_ASSOCIATED_PARTY_MISMATCH` | Geschäftsführer oder Gesellschafter im Dokument stimmen nicht mit dem Unternehmensregister überein. |
| `KYB_DOCUMENT_GRAPHIC_EDITOR` | Das Dokument scheint mit einer Grafikbearbeitungssoftware bearbeitet worden zu sein. |
| `KYB_DOCUMENT_SUSPECTED_MANIPULATION` | Das System hat Anzeichen für eine mögliche Manipulation des Unternehmensdokuments erkannt. |
| `KYB_DOCUMENT_UNPROVEN_TEXT_REPLACEMENT` | Ein Textfeld des Unternehmensdokuments wurde geleert und in einer anderen Schriftart neu eingegeben, und die Datei enthält keinen Nachweis, ob sich der Inhalt geändert hat. Diese Warnung wird auch ausgelöst, wenn eine Datei nicht vollständig geprüft werden konnte. In diesem Fall ist `additional_data.detection_method` auf `analysis_incomplete` gesetzt, weil der ungeprüfte Teil ein solches Feld enthalten könnte. Gesteuert wird sie über `kyb_document_unproven_text_replacement_action` (Standard: Review). Ein Workflow, der niemals eine Prüfung durchführt, verwendet stattdessen seine eigene `kyb_document_tampering_action`, wenn diese auf Decline steht. Andernfalls gilt keine Aktion. |
| `KYB_ADDITIONAL_DATA_NOT_FOUND` | Ein Dokumentfeld konnte nicht verifiziert werden, weil die entsprechenden Daten des Unternehmensregisters nicht verfügbar sind. |
| `KYB_DOCUMENT_EXPIRED` | Das Unternehmensdokument überschreitet das konfigurierte maximale Alter. |
| `KYB_DOCUMENT_UNSUPPORTED_SUBTYPE` | Der hochgeladene Dokumentuntertyp ist für den Workflow deaktiviert. |
| `KYB_DOCUMENT_MAX_ATTEMPTS_EXCEEDED` | Die maximale Anzahl an Upload-Versuchen für Unternehmensdokumente wurde überschritten. |

Bei der Manipulation von Overlay-Text in PDF-Dateien kann `KYB_DOCUMENT_SUSPECTED_MANIPULATION` `additional_data.manipulated_regions` enthalten. Ein Textfeld, das geleert und in einer anderen Schriftart neu eingegeben wurde, löst `KYB_DOCUMENT_UNPROVEN_TEXT_REPLACEMENT` mit derselben Struktur wie `manipulated_regions` aus, niemals jedoch `KYB_DOCUMENT_SUSPECTED_MANIPULATION` allein. Online-Editoren geben auch unveränderten Text neu ein, daher sagt diese Warnung nicht aus, dass sich der Inhalt geändert hat. Löst ein anderes Signal `KYB_DOCUMENT_SUSPECTED_MANIPULATION` für dasselbe Dokument aus, entscheidet die strengere der beiden Aktionen. Die Angaben sind Rechtecke in Seitenkoordinaten, die die vermutlich bearbeiteten Bereiche kennzeichnen. Sie entsprechen den Rechtecken, die unter `document_verifications[].items[].document_metadata.overlay_manipulation.manipulated_regions` zurückgegeben werden.

## KYB-Warnungen zu Schlüsselpersonen

Warnungen zu Schlüsselpersonen verwenden `feature: "KYB_KEY_PEOPLE"` und erscheinen unter `key_people_checks[].warnings[]`. Sie zeigen Probleme auf Personenebene bei Geschäftsführern, leitenden Angestellten, UBOs und vom Benutzer eingereichten Parteien an.

| Tag | Beschreibung |
| - | - |
| `KYB_PREVIOUSLY_DECLINED_INDIVIDUAL` | Eine Person, die mit dem Unternehmen verbunden ist, wurde zuvor in einer anderen Unternehmensverifizierung für dieselbe Anwendung abgelehnt. |
| `KYB_KEY_PEOPLE_MISMATCH_WITH_DOCUMENTS` | Die in der Ansicht für Schlüsselpersonen angegebenen Geschäftsführer oder Gesellschafter stimmen nicht mit den Personen überein, die in den hochgeladenen Unternehmensdokumenten genannt sind. Dies ist der Fall, wenn eine in den Dokumenten genannte Person nie angegeben wurde, ein Name nahezu mit einem anderen übereinstimmt, ein dokumentierter Gesellschafter ohne Eigentümerrolle angegeben wurde oder ein angegebener Eigentumsanteil den Dokumenten widerspricht. Es wird die konfigurierte `kyb_key_people_document_mismatch_action` angewendet (Standard: in Prüfung). |

> [!NOTE]
>
> **PEP- und Sanktionstreffer bei Schlüsselpersonen** werden als übliche AML-Treffer im entsprechenden Element von `aml_screenings[]` gemeldet, nicht als Warnung zu Schlüsselpersonen im KYB-Kontext. Die Prüfung der Schlüsselpersonen überträgt den daraus resultierenden Status `Declined` oder `In Review` auf jede betroffene Partei, sodass das Gesamtergebnis der Schlüsselpersonen das AML-Ergebnis widerspiegelt.

## Warnungen zu gemeinsamen Funktionen

Die folgenden Funktionen können innerhalb eines KYB-Workflows ausgeführt werden. Sie verwenden denselben Warnungskatalog wie die Benutzerverifizierung. Die vollständige Referenz finden Sie auf der Warnungsseite der jeweiligen Funktion.

### AML

`feature: "AML"` in `aml_screenings[].warnings[]`.

| Tag | Beschreibung |
| - | - |
| `POSSIBLE_MATCH_FOUND` | Das AML-Screening hat eine mögliche Übereinstimmung gefunden, die geprüft werden muss. |
| `COULD_NOT_PERFORM_AML_SCREENING` | Didit konnte das AML-Screening nicht durchführen, weil erforderliche Screening-Daten fehlten oder nicht verfügbar waren. |

### Telefon

`feature: "PHONE"` in `phone_verifications[].warnings[]`.

| Tag | Beschreibung |
| - | - |
| `DISPOSABLE_NUMBER_DETECTED` | Bei der Telefonnummer handelt es sich um eine Wegwerfnummer. |
| `VERIFICATION_CODE_ATTEMPTS_EXCEEDED` | Die maximale Anzahl an Versuchen zur Eingabe des Verifizierungscodes wurde überschritten. |
| `VOIP_NUMBER_DETECTED` | Bei der Telefonnummer handelt es sich um eine VoIP-Nummer. |
| `DUPLICATED_PHONE_NUMBER` | Die Telefonnummer wurde in einem anderen Verifizierungsprozess verwendet. |
| `HIGH_RISK_PHONE_NUMBER` | Die Telefonnummer ist mit einem hohen Risiko verbunden. |
| `PHONE_NUMBER_IN_BLOCKLIST` | Die Telefonnummer stimmt mit einem Eintrag in Ihrer Sperrliste überein. |

### E-Mail

`feature: "EMAIL"` in `email_verifications[].warnings[]`.

| Tag | Beschreibung |
| - | - |
| `BREACHED_EMAIL_DETECTED` | Die E-Mail-Adresse taucht in bekannten Datenlecks auf. |
| `DISPOSABLE_EMAIL_DETECTED` | Bei der E-Mail-Adresse handelt es sich um eine Wegwerfadresse. |
| `UNDELIVERABLE_EMAIL_DETECTED` | Die E-Mail-Adresse ist nicht zustellbar. |
| `DUPLICATED_EMAIL` | Die E-Mail-Adresse wurde in einem anderen Verifizierungsprozess verwendet. |
| `EMAIL_IN_BLOCKLIST` | Die E-Mail-Adresse stimmt mit einem Eintrag in Ihrer Sperrliste überein. |
| `EMAIL_CODE_ATTEMPTS_EXCEEDED` | Die maximale Anzahl an Versuchen zur Eingabe des E-Mail-Verifizierungscodes wurde überschritten. |

### Fragebogen

`feature: "QUESTIONNAIRE"`.

| Tag | Beschreibung |
| - | - |
| `CUSTOM_STATUS_RULE_TRIGGERED` | Eine Statusregel des Workflows hat eine Antwort aus dem Fragebogen ausgewertet und den Status der Funktion geändert. |

### Geräte- und IP-Analyse

`feature: "LOCATION"` in `ip_analyses[].warnings[]`.

| Tag | Beschreibung |
| - | - |
| `COUNTRY_FROM_DOCUMENT_DOES_NOT_MATCH_COUNTRY_FROM_IP` | Das Land des Dokuments stimmt nicht mit dem Land der Adresse überein. |
| `PRIVATE_NETWORK_DETECTED` | Es wurde ein Signal für ein privates Netzwerk, ein VPN, einen Proxy oder Tor erkannt. |
| `EXPECTED_IP_ADDRESS_MISMATCH` | Die Adresse stimmt nicht mit der erwarteten Adresse überein, die für die Sitzung angegeben wurde. |
| `IP_ADDRESS_IN_BLOCKLIST` | Die Adresse stimmt mit einem Eintrag in Ihrer Sperrliste überein. |
| `DEVICE_FINGERPRINT_IN_BLOCKLIST` | Der Geräte-Fingerprint stimmt mit einem Eintrag in Ihrer Sperrliste überein. |
| `DUPLICATED_IP_ADDRESS` | Dieselbe Adresse wurde in einer anderen Verifizierung mit anderen `vendor_data` verwendet. |
| `DUPLICATED_DEVICE_FINGERPRINT` | Derselbe Geräte-Fingerprint wurde in einer anderen Verifizierung mit anderen `vendor_data` verwendet. |

## Beispiele

### Register: Unternehmen nicht aktiv

```json theme={null}
{
  "registry_checks": [
    {
      "node_id": "feature_kyb_registry",
      "status": "Declined",
      "warnings": [
        {
          "feature": "KYB_REGISTRY",
          "risk": "KYB_COMPANY_NOT_ACTIVE",
          "log_type": "error",
          "short_description": "Company is not active",
          "long_description": "The company is not active according to the registry.",
          "additional_data": null,
          "node_id": "feature_kyb_registry"
        }
      ]
    }
  ]
}
```

### Dokumente: vermutete Manipulation durch Overlay

```json theme={null}
{
  "document_verifications": [
    {
      "node_id": "feature_kyb_documents",
      "status": "In Review",
      "warnings": [
        {
          "feature": "KYB_DOCUMENTS",
          "risk": "KYB_DOCUMENT_SUSPECTED_MANIPULATION",
          "log_type": "warning",
          "short_description": "Possible document manipulation",
          "long_description": "The system detected signs of possible corporate-document manipulation.",
          "additional_data": {
            "manipulated_regions": [
              { "page": 1, "x": 120, "y": 240, "width": 180, "height": 22, "page_width": 612, "page_height": 792 }
            ]
          },
          "node_id": "feature_kyb_documents"
        }
      ]
    }
  ]
}
```

### Schlüsselpersonen: zuvor abgelehnte Person

```json theme={null}
{
  "key_people_checks": [
    {
      "node_id": "feature_kyb_key_people",
      "status": "In Review",
      "warnings": [
        {
          "feature": "KYB_KEY_PEOPLE",
          "risk": "KYB_PREVIOUSLY_DECLINED_INDIVIDUAL",
          "log_type": "warning",
          "short_description": "Previously declined individual",
          "long_description": "A person associated with the company was previously declined in another business verification for the same application.",
          "additional_data": null,
          "node_id": "feature_kyb_key_people"
        }
      ]
    }
  ]
}
```

## Weiterführende Informationen

> [card] [Antwortschema](https://docs.didit.me/de/business-verification/response-schema.md)
>
> Hier sehen Sie, wo Warnungen in jedem KYB-Funktionsarray erscheinen.

> [card] [Status](https://docs.didit.me/de/business-verification/statuses.md)
>
> Erfahren Sie, wie der Schweregrad einer Warnung dem Verifizierungsstatus zugeordnet wird.

> [card] [Dokumente](https://docs.didit.me/de/business-verification/documents.md)
>
> Prüfen Sie Dokumentgruppen, OCR und das Verhalten beim Kreuzabgleich.

> [card] [Schlüsselpersonen](https://docs.didit.me/de/business-verification/key-people.md)
>
> Verifizierungsablauf für Führungskräfte, UBOs und eingereichte Parteien.

> [card] [AML-Bericht](https://docs.didit.me/de/core-technology/aml-screening/report-aml-screening.md)
>
> Struktur auf Trefferebene für AML-Screenings von Unternehmen und Personen.

> [card] [Referenzdatenmodelle](https://docs.didit.me/de/reference/data-models.md)
>
> Kanonische Strukturen für Warnungen und Funktionsarrays.


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