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

# AML-Screening: Warnungen & Alert-Codes

> AML-Warncodes wie POSSIBLE_MATCH_FOUND bei Didit verstehen. Schwellenwerte konfigurieren und Verhalten bei fehlenden Daten steuern.

## Übersicht

Das AML-Screening gibt eine kleine Auswahl an Warnungs-Tags im Array `warnings[]` jedes Eintrags in `aml_screenings[]` aus. Die beiden folgenden Tags sind die **einzigen** AML-Warnungen, die Didit erzeugt – alles andere, was Sie bei einem Treffer sehen, ist in den feldeigenen Attributen des Treffers (`risk_view`, `match_score`, `risk_score`, `sanction_matches[]`, …) kodiert und nicht als Warnung dargestellt. Sowohl Workflow-Sitzungen als auch die Standalone-AML-API geben `POSSIBLE_MATCH_FOUND` auf die gleiche Weise aus.

Der im AML-Datensatz zurückgegebene Status (`Approved`, `In Review`, `Declined`) wird aus dem aggregierten `score` und Ihren Schwellenwerten abgeleitet – die Warnungen markieren dieselben Bedingungen, sodass Sie programmatisch darauf reagieren können. Unter [AML-Risiko-Score](https://docs.didit.me/de/core-technology/aml-screening/aml-risk-score.md) erfahren Sie, wie Schwellenwerte dem Status zugeordnet werden.

## Erzeugte Warnungen

| Risiko | Ursache | `log_type` | Wirkt sich auf den Status aus | Empfohlene Behebung |
| - | - | - | - | - |
| `POSSIBLE_MATCH_FOUND` | Der aggregierte `score` ist ungleich null und liegt über dem `aml_score_approve_threshold` (Standardwert `80`) – mindestens ein möglicher Treffer überschreitet Ihr Risikoband. (Die Standalone-AML-API gibt dies auch aus, wenn der Score genau dem Schwellenwert entspricht.) | `warning`; eskaliert zu `error`, wenn der Score auch den `aml_score_review_threshold` (Standardwert `100`) überschreitet. | `In Review`, wenn der Score über dem Genehmigungs-Schwellenwert liegt; `Declined`, wenn er über dem Überprüfungs-Schwellenwert liegt. | Prüfen Sie jeden Treffer in `hits[]`. Verwenden Sie den AML-Hit-Status-Endpoint, um Treffer als `Confirmed Match`, `False Positive` oder `Inconclusive` zu markieren. Aktualisierungen von Treffern lösen einen `data.updated`-Webhook aus, berechnen den AML-Status jedoch nicht neu – legen Sie den endgültigen Status über den AML-Status-Endpoint oder die Überprüfung in der Console fest. |
| `COULD_NOT_PERFORM_AML_SCREENING` | Im KYC-Datensatz fehlen eines oder mehrere der Felder `full_name`, `date_of_birth` oder `issuing_state`. Es wird kein abrechenbarer Screening-Aufruf getätigt. | `warning` | Erzwingt `In Review`. | Füllen Sie die fehlenden Felder im KYC-Datensatz aus. Das AML-Screening wird automatisch erneut ausgeführt, sobald alle drei vorhanden sind – das veraltete Warnungs-Log wird entfernt und es ist kein manuelles erneutes Auslösen erforderlich. |

Warnungen werden mit `feature: "AML"` gespeichert und folgen dem standardmäßigen Aufbau des [Warnungsobjekts](https://docs.didit.me/de/reference/data-models.md#warnungsobjekt).

## Konfigurierbare Einstellungen

AML-Steuerungen pro Workflow-Knoten (werden auch als Optionen in der Standalone-AML-API akzeptiert):

* **`aml_score_approve_threshold`** – Standardwert `80`. Ein Score ungleich null darüber erzeugt `POSSIBLE_MATCH_FOUND` und leitet die AML-Prüfung auf `In Review` weiter. Scores kleiner oder gleich diesem Wert erzeugen in Sitzungs-Workflows **keine** Warnung, unabhängig von der Anzahl der Treffer.
* **`aml_score_review_threshold`** – Standardwert `100`. Ein Score darüber lehnt die AML-Prüfung automatisch ab (mit dem Standardwert von `100` wird dies nie ausgelöst, es sei denn, Sie senken ihn ab).
* **`aml_match_score_threshold`** – Standardwert `93`. Klassifizierung pro Treffer: Treffer mit einem `match_score` darunter beginnen als `False Positive` und werden vom aggregierten Score ausgeschlossen; ab diesem Wert oder darüber beginnen sie als `Unreviewed`.
* **Gewichtungen des Übereinstimmungswerts** – `aml_name_weight` / `aml_dob_weight` / `aml_country_weight`, Standardwerte `60` / `25` / `15` (müssen in Summe 100 ergeben). Siehe [AML-Übereinstimmungswert](https://docs.didit.me/de/core-technology/aml-screening/aml-match-score.md).
* **Laufendes Monitoring** – Wenn aktiviert, screenet AML die Person erneut, sobald sich Datensätze ändern, und gibt den Bericht sowie einen Webhook `status.updated` (Status geändert) oder `data.updated` (Treffer geändert) erneut aus.

> [!NOTE]
>
> Wenn `COULD_NOT_PERFORM_AML_SCREENING` ausgelöst wird, verbleibt die AML-Prüfung auf `In Review`, bis die fehlenden Identitätsfelder bereitgestellt werden. Sobald Didit über den vollständigen Namen, das Geburtsdatum und das Ausstellungsland verfügt, wird das AML-Screening automatisch erneut ausgeführt und die Warnung wird gelöscht – es ist kein manuelles erneutes Auslösen erforderlich.

## Beispiele

### `POSSIBLE_MATCH_FOUND` (Score über dem Genehmigungs-Schwellenwert)

```json theme={null}
{
  "warnings": [
    {
      "feature": "AML",
      "risk": "POSSIBLE_MATCH_FOUND",
      "additional_data": null,
      "log_type": "warning",
      "short_description": "Possible match found in AML screening",
      "long_description": "The Anti-Money Laundering (AML) screening process identified potential matches with watchlists or high-risk databases, requiring further review.",
      "node_id": "aml-1"
    }
  ]
}
```

### `COULD_NOT_PERFORM_AML_SCREENING` (fehlende KYC-Felder)

```json theme={null}
{
  "warnings": [
    {
      "feature": "AML",
      "risk": "COULD_NOT_PERFORM_AML_SCREENING",
      "additional_data": null,
      "log_type": "warning",
      "short_description": "Could not retrieve data from KYC for performing AML Screening",
      "long_description": "The system encountered issues accessing or processing Know Your Customer (KYC) data necessary for conducting the Anti-Money Laundering (AML) screening. please fill the KYC full name, birth date, issuing state and document number to automatically proceed with AML screening.",
      "node_id": "aml-1"
    }
  ]
}
```

## Verwandte Themen

* [AML-Bericht](https://docs.didit.me/de/core-technology/aml-screening/report-aml-screening.md) – vollständiger Aufbau der Antwort, Trefferfelder, Statussemantik
* [AML-Risiko-Score](https://docs.didit.me/de/core-technology/aml-screening/aml-risk-score.md) – wie der aggregierte Score berechnet wird
* [AML-Übereinstimmungswert](https://docs.didit.me/de/core-technology/aml-screening/aml-match-score.md) – Konfidenz pro Treffer
* [Laufende AML-Überwachung](https://docs.didit.me/de/core-technology/aml-screening/continuous-monitoring-aml-screening.md) – Überwachungs-Lebenszyklus
* [Datenmodelle – AML-Screening](https://docs.didit.me/de/reference/data-models.md#aml-screening) – kanonisches Schema, einschließlich des [Warnungsobjekts](https://docs.didit.me/de/reference/data-models.md#warnungsobjekt)

### Warnungstypen


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