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

# نموذج بيانات الشركات: مخطط KYB

> نموذج بيانات الشركة في Didit: السجل، المستفيدون الحقيقيون (UBO)، المسؤولون، المستندات، حالة AML، وتجميعات جلسات KYB. KYB مغلق الحلقة.

توثّق هذه الصفحة كل حقل في كيان الشركة وكيفية تعبئة Didit لكل حقل منها.

## الحقول التعريفية

| الحقل | النوع | الوصف |
| - | - | - |
| `uuid` | UUID | المفتاح الأساسي الذي تعيّنه Didit. ثابت وفريد. |
| `didit_internal_id` | string | معرّف داخلي قابل للقراءة البشرية. |
| `vendor_data` | string | معرّفك للشركة. فريد لكل تطبيق. [اقرأ المزيد](https://docs.didit.me/ar/entities/vendor-data-linking.md). |
| `display_name` | string | اسم مخصص يتجاوز الاسم المعروض في لوحة التحكم. الافتراضي هو `legal_name` أو `vendor_data`. |
| `legal_name` | string | الاسم القانوني المسجّل للشركة، ويُنقل من نتيجة البحث في السجل ضمن آخر جلسة تحقق من الشركات (KYB) مقبولة. |
| `registration_number` | string | رقم التسجيل الرسمي للشركة، ويُنقل من السجل. |
| `country_code` | string (ISO 3166-1 alpha-3) | بلد التأسيس. |

> [!NOTE]
>
> `legal_name` و`registration_number` و`country_code` للقراءة فقط عندما تُشتق من بحث موثّق في السجل. يمكن تجاوزها يدويًا في لوحة التحكم أو عبر `PATCH /v3/businesses/{vendor_data}/`، لكن التجاوزات تُعلَّم في سجل التدقيق.

## الحالة

| الحقل | النوع | القيم | الوصف |
| - | - | - | - |
| `status` | enum | `ACTIVE`, `FLAGGED`, `BLOCKED` | تتحكم في تطبيق القيود على الجلسات والمعاملات المستقبلية. راجع [دورة الحياة](https://docs.didit.me/ar/entities/lifecycle.md). |

## حقول تجميع الجلسات

| الحقل | النوع | الوصف |
| - | - | - |
| `session_count` | int | إجمالي جلسات التحقق من الشركات (KYB) التي أُنشئت لهذه الشركة على الإطلاق |
| `approved_count` | int | الجلسات المنتهية بحالة `Approved` |
| `declined_count` | int | الجلسات المنتهية بحالة `Declined` |
| `in_review_count` | int | الجلسات الحالية في حالة `In Review` |
| `features` | object | حالة التحقق الأحدث للشركة، ضمن المفتاح `KYB` |

### خريطة `features`

```json theme={null}
{
  "KYB": "Approved"
}
```

تحتوي الخريطة على مفتاح واحد، وهو `KYB`، ويحمل حالة أحدث عملية تحقق للشركة: `"Not Finished"` أو `"Approved"` أو `"Declined"` أو `"In Review"` أو `"Resub Requested"`.
لمعرفة حالة كل ميزة KYB على حدة، اقرأ قرار الجلسة.

استخدم خريطة `features` كمسار سريع للتحقق مما إذا كانت الشركة موثّقة بالكامل الآن، دون المرور على جميع الجلسات.

## الطوابع الزمنية للنشاط

| الحقل | النوع | يتم التحديث عند |
| - | - | - |
| `first_session_at` | طابع زمني بتنسيق ISO | إنشاء أول جلسة تحقق من الشركات (KYB) |
| `last_session_at` | طابع زمني بتنسيق ISO | إنشاء أحدث جلسة أو تحديثها |
| `last_activity_at` | طابع زمني بتنسيق ISO | أي تغيير: جلسة، أو معاملة، أو حالة، أو ملف تعريف، أو ملاحظات |
| `created_at` | طابع زمني بتنسيق ISO | إنشاء صف الكيان |
| `updated_at` | طابع زمني بتنسيق ISO | آخر تحديث لصف الكيان |

## البيانات الوصفية

| الحقل | النوع | الوصف |
| - | - | - |
| `metadata` | object (JSON) | بيانات JSON حرة تتحكم بها |
| `tags[]` | array | وسوم تُدار من لوحة التحكم أو عبر API |

## العلاقات (غير مخزّنة في صف الشركة)

| العلاقة | طريقة الوصول |
| - | - |
| جلسات التحقق من الشركات (KYB) | `GET /v3/sessions?vendor_data=<value>` |
| المستخدمون المرتبطون (المسؤولون، والمستفيدون الحقيقيون (UBO)، والمديرون) | تظهر في صفحة تفاصيل الشركة في لوحة التحكم، وتُشتق من آخر جلسة تحقق من الشركات (KYB) مقبولة |
| المعاملات (بصفة مقدّم الطلب أو الطرف المقابل) | صفِّ المعاملات حسب `vendor_data` للشركة |
| المستندات | عبر قرارات جلسات التحقق من الشركات (KYB) |
| نتائج AML | عبر قرارات جلسات التحقق من الشركات (KYB) |

## مثال على الاستجابة

```json theme={null}
{
  "uuid": "f7a9c1b2-4e6d-4f8a-9c5d-2a1b3c4d5e6f",
  "didit_internal_id": "B-2026-00018",
  "vendor_data": "biz-acme",
  "display_name": "Acme Corp",
  "legal_name": "Acme Corporation Limited",
  "registration_number": "12345678",
  "country_code": "GBR",
  "status": "ACTIVE",
  "session_count": 2,
  "approved_count": 1,
  "declined_count": 0,
  "in_review_count": 1,
  "features": {
    "KYB": "Approved"
  },
  "first_session_at": "2025-09-01T12:00:00Z",
  "last_session_at": "2026-04-01T09:00:00Z",
  "last_activity_at": "2026-04-16T10:00:00Z",
  "metadata": { "partner": "Acme Holdings" }
}
```

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

> [card] [العمليات](https://docs.didit.me/ar/entities/businesses/operations.md)
>
> إنشاء الشركة وتحديثها وتغيير حالتها وحذفها.

> [card] [سجل التحقق من الشركات (KYB)](https://docs.didit.me/ar/entities/businesses/kyb-history.md)
>
> استرداد كل جلسة مرتبطة بالشركة.

> [card] [مرجع API](https://docs.didit.me/ar/management-api/businesses/get.md)
>
> مخطط GET /v3/businesses/{vendor_data}/.


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