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

# الأشخاص الرئيسيون: المستفيدون الحقيقيون والمسؤولون

> اربط المستفيدين الحقيقيين والمسؤولين والمديرين بكيان شركة في Didit. يُجري كل شخص KYC كمستخدم. KYB متكامل على منصة واحدة.

لكل كيان شركة أشخاص رئيسيون، وهم الأشخاص الطبيعيون المسؤولون قانونيًا عن الشركة أو المالكون المستفيدون منها. يحددهم Didit أثناء التحقق من الشركات (KYB)، ويتيح لك ربط كل منهم بكيان مستخدم لإجراء التحقق من المستخدمين (KYC) بشكل فردي.

## من يُعدّ من الأشخاص الرئيسيين

| الدور | الوصف |
| - | - |
| **مدير** | مذكور في السجل بصفته مديرًا للشركة |
| **مسؤول** | أمين السر أو الممثل أو أي مسؤول مسجَّل آخر |
| **مساهم** | مساهم مسجَّل (شركة أو فرد) |
| **UBO (المستفيد الحقيقي النهائي)** | الفرد الذي يملك أو يسيطر في نهاية المطاف على 10/25/50%+ (الحد قابل للضبط) |
| **المفوّض بالتوقيع** | الشخص المخوّل بالتصرف نيابةً عن الشركة |

راجع صفحتي [مسؤولو KYB](https://docs.didit.me/ar/business-verification/officers.md) و[الملكية](https://docs.didit.me/ar/business-verification/ownership.md) للاطلاع على التصنيف الكامل للأدوار وحساب سلسلة الملكية.

## كيف يرتبط الأشخاص الرئيسيون بالشركة

**1. تم التعرف عليهم من السجل**

أثناء التحقق من الشركات (KYB)، يستعلم Didit عن سجل الشركات ويستخرج جميع المسؤولين والمساهمين المدرجين. يصبح كل شخص **سجلًا للشخص الرئيسي** مرتبطًا بجلسة التحقق من الشركات (KYB).

**2. يضيفه المستخدم (يملؤه العميل)**

يمكن أن تتضمن سير العمل خطوة "الأشخاص الرئيسيون" يضيف فيها مسؤول الشركة أشخاصًا غير موجودين في السجل (مثل UBO المحددين بإقرار الشركة).

**3. مجمّعة في كيان الشركة**

قائمة الأشخاص الرئيسيين في الشركة هي اتحاد الأطراف المستخرجة من السجل والأطراف التي أضافها المستخدم، مع إزالة التكرار حسب الهوية.

لكل شخص رئيسي حقل `source`:

* `REGISTRY`: مستخرج من سجل رسمي.
* `USER`: أضافه مسؤول الشركة أثناء تدفق KYB.

## ربط شخص رئيسي بكيان مستخدم

عندما يكون التحقق من المستخدمين (KYC) مطلوبًا لشخص رئيسي (عادةً UBO والمديرون)، يمكن ربط الطرف بكيان مستخدم:

```mermaid theme={null}
flowchart LR
    B[Business: biz-acme]
    P1[Key Person: Jane Doe, Director]
    P2[Key Person: John Smith, UBO 40%]
    U1[User: user-jane]
    U2[User: user-john]
    P1 --> B
    P2 --> B
    P1 -.linked.-> U1
    P2 -.linked.-> U2
```

يُنشأ الربط عندما:

* تُجرى جلسة التحقق من المستخدمين (KYC) للطرف باستخدام `vendor_data` نفسه المستخدم في كيان المستخدم.
* يربط محلل يدويًا طرفًا تجاريًا بمستخدم موجود.

بعد الربط، تنتقل حالة KYC للمستخدم إلى عرض الأشخاص الرئيسيين في الشركة.

## استعراض الأشخاص الرئيسيين

من صفحة تفاصيل الشركة في وحدة التحكم، تعرض علامة التبويب **الأشخاص الرئيسيون** ما يلي:

* اسم كل طرف ودوره ونسبة ملكيته ومصدره (السجل مقابل ما أضافه المستخدم)
* حالة KYC للمستخدمين المرتبطين
* حالة فحص AML لكل شخص
* المستندات المرتبطة (هوية المدير وإقرار UBO)

برمجيًا، تظهر بيانات الأشخاص الرئيسيين داخل المصفوفة `key_people_checks[]` في قرار جلسة التحقق من الشركات (KYB)، مقسمة إلى مجموعتين:

```json theme={null}
"key_people_checks": [
  {
    "status": "Approved",
    "node_id": "feature_kyb_key_people",
    "registry": {
      "officers": [
        { "uuid": "...", "name": "Jane Doe", "role": "director", "kyc_status": "Approved", "kyc_session_url": "..." }
      ],
      "beneficial_owners": [
        { "uuid": "...", "name": "John Smith", "roles": ["ubo"], "ownership_min_shares": 40, "kyc_status": "Pending" }
      ]
    },
    "submitted": {
      "parties": [
        { "uuid": "...", "entity_type": "person", "name": "Alice Chen", "role": "ubo", "ownership_percent": 35.0, "source": "USER", "requires_verification": true, "kyc_session_status": "Not Started", "kyc_session_url": "..." }
      ]
    },
    "ubo_kyc_summary": { "total": 2, "approved": 1, "flagged": 0, "pending": 1 }
  }
]
```

* **`registry.officers` / `registry.beneficial_owners`**: المسؤولون والمستفيدون الحقيقيون الذين تم اكتشافهم عبر فحص السجل.
* **`submitted.parties`**: أطراف أضافها مسؤول الشركة أثناء تدفق الأشخاص الرئيسيين (`source: USER`).
* **`ubo_kyc_summary`**: ملخص تجميعي لتقدم KYC الخاص بـ UBO.

ستظل المصفوفتان القديمتان المسطحتان `officers[]` و`beneficial_owners[]` موجودتين في الاستجابة لإصدار إضافي واحد فقط بغرض التوافق مع الإصدارات السابقة. ينبغي للتكاملات الجديدة استخدام البنية ذات المجموعتين أعلاه. راجع [مخطط استجابة KYB الكامل](https://docs.didit.me/ar/business-verification/response-schema.md#key_people_checks) لكل حقل.

## المساهمون من الشركات

عندما يكون المساهم شركةً بحد ذاتها (لا شخصًا)، يستكشف Didit سلسلة الملكية بشكل متكرر لتحديد المستفيدين الحقيقيين النهائيين. يمكن للأطراف من الشركات اختياريًا أن تُطلق جلسات تحقق من الشركات (KYB) فرعية.

راجع [هيكل الملكية](https://docs.didit.me/ar/business-verification/ownership.md) للاطلاع على مثال تطبيقي لسلاسل الملكية متعددة المستويات.

## webhook الخاصة بالأشخاص الرئيسيين

تظهر التغييرات على الأشخاص الرئيسيين عبر أحداث الجلسة الأم:

* `data.updated` (مع `session_kind: "business"`): تم تحديث بيانات الجلسة بما في ذلك الأشخاص الرئيسيون.
* `status.updated` (مع `session_kind: "business"`): تغيّرت حالة الجلسة نتيجةً لذلك.

راجع [webhook الخاصة بـ KYB](https://docs.didit.me/ar/business-verification/webhooks.md) للاطلاع على payload.

## الخطوات التالية

> [card] [المسؤولون](https://docs.didit.me/ar/business-verification/officers.md)
>
> تحديد المديرين وتصنيف الأدوار.

> [card] [الملكية](https://docs.didit.me/ar/business-verification/ownership.md)
>
> UBO ومساهمو الشركات وحساب سلسلة الملكية.

> [card] [تدفق الأشخاص الرئيسيين](https://docs.didit.me/ar/business-verification/key-people.md)
>
> خطوة KYB التي تجمع الأشخاص الرئيسيين.


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