> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sahlfinancial.com/llms.txt
> Use this file to discover all available pages before exploring further.

# المفاهيم

> القضايا والمراجع والبيئات والمستندات والسياسات والفحوص، وأيّها تصل إليه واجهة البرمجة.

| المفهوم | ما هو | عبر واجهة الشركاء v0.2.0 |
| - | - | - |
| القضية (Case) | ملف عميل واحد. تُنشأ عندما يتضمن الاستدعاء `reference`. | تُنشأ بواسطة `extract` و`verify` و`assess` و`eid` |
| المستند (Document) | ملف ترفعه، يُقرأ إلى حقول مع فحوص. يحصل على `document_id` بعد حفظه. | `extract` |
| الحكم (Verdict) | `passed` والفحوص والتنبيهات واكتمال الملف. | `verify`, `assess` |
| التقييم (Assessment) | تحمّل المخاطر والقدرة ومخاطر الامتثال والملاءمة. | `assess` |
| فحص eID | تحقق عن بُعد من هوية عميل كندي. | `eid` |
| السياسة (Policy) | قواعد مساحة العمل وعتباتها لكل استدعاء. | تُطبَّق على كل استدعاء؛ وتُعدَّل في وحدة التحكم |
| الربط (Connection) | حساب بنكي مرتبط بموافقة العميل. | وحدة التحكم فقط |
| النقاط (Score) | من 1000، مع مستوى مخاطر ومبلغ مؤهَّل. | وحدة التحكم فقط |

## المرجع

`reference` هو معرّفك الثابت الخاص بالعميل، من 1 إلى 64 حرفًا من `A-Z a-z 0-9 _ . : -`. عند وجوده يحفظ الاستدعاء قضية في المكان الذي يطّلع عليه موظفوك. وبدونه لا يُخزَّن شيء في مساحة عملك ولا يُرسل أي webhook.

اختر مرجعًا لا يتغير وليس قيمة شخصية. معرّف قاعدة البيانات (`client-0001`, `acct:8812`) مناسب. أما عنوان البريد الإلكتروني فغير مناسب (الرمز `@` غير مسموح، وسيضع بيانات شخصية في سجلاتك وفي webhooks).

## القضية

القضية فريدة لكل مساحة عمل وبيئة ومرجع. ينشئها أول استدعاء يحمل المرجع، وتحدّثها الاستدعاءات اللاحقة:

* يضيف `/extract` مستندًا وحقوله المقروءة وفحوصه.
* يحفظ `/verify` و`/assess` الحكم، ويحفظ `/assess` التقييم أيضًا. وتُربط بالقضية المستندات التي تعيد إرسال `document_id` الخاص بها.
* يحفظ `/eid` طلب eID بحالة معلّق، ويسجّل الاستعلام الدوري (poll) النتيجة.

الاسم المرسل في `subject` يحل محل الاسم المخزَّن. والاستدعاء بلا اسم يُبقي الاسم المخزَّن. وإذا لم يُرسل `subject` يُبنى الاسم من الحقول المقروءة.

الحالة التي عيّنها شخص في وحدة التحكم (`approved`, `refused`) لا يغيّرها حكم جديد أبدًا.

## البيئة

`environment` إما `sandbox` (الافتراضي) أو `production`. المرجع نفسه في البيئتين يمثل قضيتين. انظر [بيئة الاختبار والإنتاج](/ar/sandbox) لمعرفة ما يغيّره الحقل أيضًا.

## المستند والحقول

يُقرأ المستند إلى حقول من مفردات ثابتة من المفاتيح (الأسماء والتواريخ والعنوان والبيانات البنكية وأرقام الكيانات وغيرها). كل قيمة نص. ويُغفل القارئ ما لا يستطيع قراءته. انظر [أنواع المستندات والحقول](/ar/guides/document-types).

## الحكم ودرجة الخطورة

لكل فحص درجة خطورة. `critical` يمنع، و`warning` ينبّه لمراجعة شخص، و`info` للتوثيق. وتكون `passed` صحيحة عندما لا يفشل أي فحص حرج. انظر [التحقق من ملف](/ar/guides/verification).

## السياسة

يعمل كل استدعاء وفق سياسة مساحة عملك لنوع العميل (`kyc` أو `kyb`) وللبيئة. يمكن لمفتاح في الطلب أن يضيف فحوصًا، لكنه لا يستطيع إيقاف فحص تقفله السياسة. ويُدرج المفتاح المرفوض في `policy.overrides_refused` ولا يُعد خطأ. وتحدد السياسة العتبات (بالأيام) والأقفال والمستندات المطلوبة ومدى صرامة نطاقات المخاطر. وتُعدَّل في **Settings, KYC policy** في وحدة التحكم.

## أنواع العملاء

| `kind` | المستند الذي يثبت العميل | البيانات المطلوبة |
| - | - | - |
| `individual` | هوية حكومية بصورة | 26، إضافة إلى مجموعات "أحدهما أو الآخر" |
| `corporation`, `charitable_org` | النظام الأساسي أو سجل تجاري | 21 |
| `partnership` | عقد الشراكة أو سجل تجاري | 21 |
| `trust` | عقد الاستئمان (Trust deed) | 17 |
| `estate` | إثبات الوصية أو رسائل الإدارة | 21 |

## ما لا تفعله واجهة البرمجة

* لا تتخذ القرار. تُرجع الفحوص والحكم، وسياستك هي التي تحدد ما يجب فعله.
* لا تُرجع درجة ثقة لكل حقل.
* ليست فيها نقطة نهاية للربط البنكي ولا نقاط من 1000. هذه منتجات في وحدة التحكم.
* ليست فيها نقطة نهاية للدفعات ولا مفتاح idempotency.


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