> ## 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. اضبط الحدود وسلوك إعادة الفحص عند غياب بيانات KYC.

## نظرة عامة

يُصدر فحص AML مجموعة صغيرة من وسوم التحذير في مصفوفة `warnings[]` لكل إدخال في `aml_screenings[]`. الوسمان أدناه هما تحذيرا AML **الوحيدان** اللذان تصدرهما Didit — فكل شيء آخر تراه في أي نتيجة مطابقة يتم ترميزه في حقول النتيجة نفسها (`risk_view`، و`match_score`، و`risk_score`، و`sanction_matches[]`، …) بدلاً من أن يكون تحذيراً. يُصدر كل من جلسات سير العمل والـ API المستقل لـ AML التحذير `POSSIBLE_MATCH_FOUND` بالطريقة نفسها.

الحالة المُرجعة في سجل AML (`Approved`، و`In Review`، و`Declined`) مشتقة من `score` الإجمالي وحدودك — وتحدد التحذيرات الشروط نفسها لتتمكن من التفاعل معها برمجياً. راجع [درجة مخاطر AML](https://docs.didit.me/ar/core-technology/aml-screening/aml-risk-score.md) لمعرفة كيفية تعيين الحدود إلى الحالة.

## التحذيرات الصادرة

| المخاطر | السبب | `log_type` | يؤثر على الحالة | المعالجة الموصى بها |
| - | - | - | - | - |
| `POSSIBLE_MATCH_FOUND` | الـ `score` الإجمالي غير صفري ويتجاوز `aml_score_approve_threshold` (الافتراضي `80`) — توجد نتيجة مطابقة محتملة واحدة على الأقل تتجاوز نطاق المخاطر الخاص بك. (يُصدره أيضاً الـ API المستقل لـ AML عندما تكون الدرجة مساوية للحد تماماً). | `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/ar/reference/data-models.md#كائن-التحذير).

## الإعدادات القابلة للتهيئة

عناصر التحكم في AML لكل عقدة في سير العمل (مقبولة أيضاً كخيارات في الـ API المستقل لـ AML):

* **`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/ar/core-technology/aml-screening/aml-match-score.md).
* **المراقبة المستمرة** — عند تفعيلها، يُعيد 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/ar/core-technology/aml-screening/report-aml-screening.md) — شكل الاستجابة الكامل، حقول نتائج المطابقة، دلالات الحالة
* [درجة مخاطر AML](https://docs.didit.me/ar/core-technology/aml-screening/aml-risk-score.md) — كيفية حساب الدرجة الإجمالية
* [درجة تطابق AML](https://docs.didit.me/ar/core-technology/aml-screening/aml-match-score.md) — درجة الثقة لكل نتيجة مطابقة
* [مراقبة AML المستمرة](https://docs.didit.me/ar/core-technology/aml-screening/continuous-monitoring-aml-screening.md) — دورة حياة المراقبة
* [نماذج البيانات — فحص AML](https://docs.didit.me/ar/reference/data-models.md#فحص-aml) — المخطط المعتمد، بما في ذلك [كائن التحذير](https://docs.didit.me/ar/reference/data-models.md#كائن-التحذير)

### أنواع التحذيرات


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