> ## 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スクリーニングの警告とアラートコード

> DiditのAML警告コードPOSSIBLE_MATCH_FOUNDとCOULD_NOT_PERFORM_AML_SCREENINGを解説。しきい値の設定と、KYCデータ不足時の再実行の動作も紹介します。

## 概要

AMLスクリーニングは、`aml_screenings[]`の各エントリーにある`warnings[]`配列に、少数の警告タグを出力します。以下の2つのタグが、Diditが生成するAML警告の**すべて**です。ヒットに表示されるそれ以外の情報は、警告としてではなく、ヒット自体のフィールド（`risk_view`、`match_score`、`risk_score`、`sanction_matches[]`、…）に格納されます。ワークフローのセッションとスタンドアロンのAML APIは、どちらも同じ方法で`POSSIBLE_MATCH_FOUND`を出力します。

AMLレコードで返されるステータス（`Approved`、`In Review`、`Declined`）は、`score`の集計値と設定したしきい値から決まります。警告タグは同じ条件を示すため、プログラムからそれらに対応できます。しきい値とステータスの対応については、[AMLリスクスコア](https://docs.didit.me/ja/core-technology/aml-screening/aml-risk-score.md)を参照してください。

## 生成される警告

| リスク | 原因 | `log_type` | ステータスへの影響 | 推奨される対処 |
| - | - | - | - | - |
| `POSSIBLE_MATCH_FOUND` | 集計`score`が0ではなく、`aml_score_approve_threshold`（デフォルト`80`）を超えています。つまり、一致の可能性があるヒットのうち少なくとも1件が、設定したリスク帯域を超えています。（スタンドアロンのAML APIでは、スコアがしきい値とちょうど等しい場合にも出力されます。） | `warning`。スコアが`aml_score_review_threshold`（デフォルト`100`）も超える場合は`error`に引き上げられます。 | スコアが承認しきい値を超える場合は`In Review`、レビューしきい値を超える場合は`Declined`になります。 | `hits[]`の各ヒットを確認します。AMLヒットステータスのエンドポイントを使用して、ヒットを`Confirmed Match`、`False Positive`、`Inconclusive`のいずれかとしてマークします。ヒットを更新すると`data.updated` Webhookが送信されますが、AMLステータスは再計算されません。最終的なステータスは、AMLステータスのエンドポイントまたはコンソールでのレビューで設定してください。 |
| `COULD_NOT_PERFORM_AML_SCREENING` | KYCレコードに`full_name`、`date_of_birth`、`issuing_state`のいずれか1つ以上がありません。課金対象のスクリーニング呼び出しは行われません。 | `warning` | 強制的に`In Review`になります。 | KYCレコードの不足しているフィールドを入力します。3つすべてが揃うとAMLは自動的に再実行され、古い警告ログは削除されるため、手動での再トリガーは不要です。 |

警告は`feature: "AML"`を指定して保存され、標準の[警告オブジェクト](https://docs.didit.me/ja/reference/data-models.md#警告オブジェクト)の形式に従います。

## 設定可能な項目

ワークフローノードごとのAML制御（スタンドアロンのAML APIのオプションとしても指定できます）:

* **`aml_score_approve_threshold`**: デフォルト`80`。これを超える0以外のスコアは`POSSIBLE_MATCH_FOUND`を生成し、AMLチェックを`In Review`に振り分けます。これ以下のスコアでは、ヒット数に関係なく、セッションのワークフローで警告は生成**されません**。
* **`aml_score_review_threshold`**: デフォルト`100`。これを超えるスコアはAMLチェックを自動的に却下します（デフォルトの`100`のままでは、値を下げるまでこれが発動することはありません）。
* **`aml_match_score_threshold`**: デフォルト`93`。ヒットごとの分類に使われます。`match_score`がこれ未満のヒットは`False Positive`として開始し、集計スコアから除外されます。これ以上のヒットは`Unreviewed`として開始します。
* **一致スコアの重み**: `aml_name_weight` / `aml_dob_weight` / `aml_country_weight`、デフォルトはそれぞれ`60` / `25` / `15`です（合計が100である必要があります）。[AML一致スコア](https://docs.didit.me/ja/core-technology/aml-screening/aml-match-score.md)を参照してください。
* **継続的なモニタリング**: 有効にすると、データセットの変更に応じてAMLが対象者を再スクリーニングし、レポートに加えて`status.updated`（ステータスが変わった場合）または`data.updated`（ヒットが変わった場合）のWebhookを再度送信します。

> [!NOTE]
>
> `COULD_NOT_PERFORM_AML_SCREENING`が発生すると、不足している本人情報のフィールドが提供されるまで、AMLチェックは`In Review`のままになります。Diditが氏名、生年月日、発行州を取得すると、AMLは自動的に再実行され、警告は解消されます。手動での再トリガーはありません。

## 例

### `POSSIBLE_MATCH_FOUND` (スコアが承認しきい値を超える場合)

```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` (KYCフィールドが不足している場合)

```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"
    }
  ]
}
```

## 関連情報

* [AMLレポート](https://docs.didit.me/ja/core-technology/aml-screening/report-aml-screening.md): レスポンスの全体構造、ヒットのフィールド、ステータスの意味
* [AMLリスクスコア](https://docs.didit.me/ja/core-technology/aml-screening/aml-risk-score.md): 集計スコアの計算方法
* [AML一致スコア](https://docs.didit.me/ja/core-technology/aml-screening/aml-match-score.md): ヒットごとの信頼度
* [継続的なAMLモニタリング](https://docs.didit.me/ja/core-technology/aml-screening/continuous-monitoring-aml-screening.md): モニタリングのライフサイクル
* [データモデル: AMLスクリーニング](https://docs.didit.me/ja/reference/data-models.md#amlスクリーニング): [警告オブジェクト](https://docs.didit.me/ja/reference/data-models.md#警告オブジェクト)を含む正規スキーマ

### 警告の種類


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