> ## 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-скрининга

> Коды предупреждений AML-скрининга в Didit: POSSIBLE_MATCH_FOUND и COULD_NOT_PERFORM_AML_SCREENING. Настройка порогов и повторных проверок.

## Обзор

AML-скрининг формирует небольшой набор тегов предупреждений в массиве `warnings[]` каждого элемента в `aml_screenings[]`. Приведенные ниже два тега — это **единственные** предупреждения AML, которые генерирует Didit; все остальные данные о совпадении закодированы в собственных полях совпадения (`risk_view`, `match_score`, `risk_score`, `sanction_matches[]`, …), а не передаются в виде предупреждений. Как сессии сценариев, так и отдельный AML API генерируют `POSSIBLE_MATCH_FOUND` одинаковым образом.

Статус, возвращаемый в записи AML (`Approved`, `In Review`, `Declined`), вычисляется на основе совокупного значения `score` и настроенных вами порогов; предупреждения отмечают те же условия, позволяя реагировать на них программно. См. раздел [Оценка риска AML](https://docs.didit.me/ru/core-technology/aml-screening/aml-risk-score.md), где описано, как пороги влияют на статус.

## Формируемые предупреждения

| Риск | Причина | `log_type` | Влияние на статус | Рекомендуемые действия |
| - | - | - | - | - |
| `POSSIBLE_MATCH_FOUND` | Совокупный `score` не равен нулю и превышает `aml_score_approve_threshold` (по умолчанию `80`) — по меньшей мере одно потенциальное совпадение превысило ваш диапазон риска. (Отдельный AML API также генерирует его, если оценка в точности равна порогу.) | `warning`; повышается до `error`, когда оценка также превышает `aml_score_review_threshold` (по умолчанию `100`). | `In Review`, если оценка выше порога одобрения; `Declined`, если она выше порога проверки. | Проверьте каждое совпадение в `hits[]`. Используйте endpoint статуса совпадений AML, чтобы пометить совпадения как `Confirmed Match`, `False Positive` или `Inconclusive`. Обновление совпадений отправляет webhook `data.updated`, но не пересчитывает статус AML — установите итоговый статус через endpoint статуса AML или при ручной проверке в панели управления. |
| `COULD_NOT_PERFORM_AML_SCREENING` | В KYC-записи отсутствует одно или несколько полей: `full_name`, `date_of_birth` или `issuing_state`. Тарифицируемый запрос скрининга не выполняется. | `warning` | Принудительно устанавливает статус `In Review`. | Заполните недостающие поля в KYC-записи. AML-скрининг перезапустится автоматически, как только появятся все три поля — устаревшая запись журнала предупреждений будет удалена, и ручной перезапуск не потребуется. |

Предупреждения сохраняются со значением `feature: "AML"` и соответствуют стандартной структуре [объекта предупреждения](https://docs.didit.me/ru/reference/data-models.md#объект-предупреждения).

## Настраиваемые параметры

Параметры управления AML на уровне узла сценария (также принимаются в качестве параметров отдельного AML API):

* **`aml_score_approve_threshold`** — по умолчанию `80`. Ненулевая оценка выше этого значения приводит к генерации `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/ru/core-technology/aml-screening/aml-match-score.md).
* **Постоянный AML-мониторинг** — если функция включена, AML выполняет повторный скрининг субъекта при изменении наборов данных и повторно формирует отчёт, а также отправляет webhook `status.updated` (при изменении статуса) или `data.updated` (при изменении совпадений).

> [!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/ru/core-technology/aml-screening/report-aml-screening.md) — полная структура ответа, поля совпадений, семантика статусов
* [Оценка риска AML](https://docs.didit.me/ru/core-technology/aml-screening/aml-risk-score.md) — как рассчитывается совокупная оценка
* [Оценка совпадения AML](https://docs.didit.me/ru/core-technology/aml-screening/aml-match-score.md) — степень уверенности для каждого совпадения
* [Постоянный AML-мониторинг](https://docs.didit.me/ru/core-technology/aml-screening/continuous-monitoring-aml-screening.md) — жизненный цикл мониторинга
* [Модели данных — AML-скрининг](https://docs.didit.me/ru/reference/data-models.md#aml-скрининг) — каноническая схема, включая [объект предупреждения](https://docs.didit.me/ru/reference/data-models.md#объект-предупреждения)

### Типы предупреждений


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