Unternehmensverifizierung (KYB) Warnungen & Fehlercodes

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.

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

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

{
  "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

{
  "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

{
  "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

Antwortschema

Hier sehen Sie, wo Warnungen in jedem KYB-Funktionsarray erscheinen.

Status

Erfahren Sie, wie der Schweregrad einer Warnung dem Verifizierungsstatus zugeordnet wird.

Dokumente

Prüfen Sie Dokumentgruppen, OCR und das Verhalten beim Kreuzabgleich.

Schlüsselpersonen

Verifizierungsablauf für Führungskräfte, UBOs und eingereichte Parteien.

AML-Bericht

Struktur auf Trefferebene für AML-Screenings von Unternehmen und Personen.

Referenzdatenmodelle

Kanonische Strukturen für Warnungen und Funktionsarrays.

Erste Schritte

Funktionen

Unternehmensprofile

Referenz

Konsole

Unternehmensverifizierung (KYB) Warnungen & Fehlercodes

Übersicht

KYB-Warnungen zum Unternehmensregister

KYB-Dokumentwarnungen

KYB-Warnungen zu Schlüsselpersonen

Warnungen zu gemeinsamen Funktionen

AML

Telefon

E-Mail

Fragebogen

Geräte- und IP-Analyse

Beispiele

Register: Unternehmen nicht aktiv

Dokumente: vermutete Manipulation durch Overlay

Schlüsselpersonen: zuvor abgelehnte Person

Weiterführende Informationen

Antwortschema

Status

Dokumente

Schlüsselpersonen

AML-Bericht

Referenzdatenmodelle

​Übersicht

​KYB-Warnungen zum Unternehmensregister

​KYB-Dokumentwarnungen

​KYB-Warnungen zu Schlüsselpersonen

​Warnungen zu gemeinsamen Funktionen

​AML

​Telefon

​E-Mail

​Fragebogen

​Geräte- und IP-Analyse

​Beispiele

​Register: Unternehmen nicht aktiv

​Dokumente: vermutete Manipulation durch Overlay

​Schlüsselpersonen: zuvor abgelehnte Person

​Weiterführende Informationen

Antwortschema

Status

Dokumente

Schlüsselpersonen

AML-Bericht

Referenzdatenmodelle

Übersicht

KYB-Warnungen zum Unternehmensregister

KYB-Dokumentwarnungen

KYB-Warnungen zu Schlüsselpersonen

Warnungen zu gemeinsamen Funktionen

AML

Telefon

E-Mail

Fragebogen

Geräte- und IP-Analyse

Beispiele

Register: Unternehmen nicht aktiv

Dokumente: vermutete Manipulation durch Overlay

Schlüsselpersonen: zuvor abgelehnte Person

Weiterführende Informationen