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

# Document AI: استخراج بيانات المستندات المخصصة

> تتيح لك Didit جمع حتى 3 مستندات مخصصة، واستخراج الحقول التي تحددها بدقة باستخدام الذكاء الاصطناعي، ثم مطابقتها مع الخطوات الأخرى وقواعدك الخاصة.

يتيح لك Document AI جمع المستندات التي لا تتبع قالباً ثابتاً — مثل إثبات الأموال، وقسائم الراتب، وخطابات مصدر الثروة، والبيانات الضريبية، وأي مستندات أخرى — واستخراج الحقول التي تحددها **أنت** بدقة. يمكنك تكوين عنوان كل مستند ووصفه اللذين يظهران على الشاشة (تتم ترجمتهما تلقائياً إلى كل لغة من لغات التحقق) وقائمة نقاط البيانات المراد قراءتها. يستخرج الذكاء الاصطناعي في Didit تلك الحقول، ويطابقها اختيارياً مع خطوات التحقق الأخرى، ويطبق قواعدك لتحديد الحالة.

موجه تكامل Document AI
        نسخ الموجّه إلى الحافظة



      
      

\<pre>

\`# Goal
Integrate Didit Document AI (configurable multi-document upload + AI field extraction + cross-checks) into your app.

\# Setup (Business Console or POST /v3/workflows/)
Add the DOCUMENT_AI feature to your workflow and configure:
\- document_ai_documents: up to 3 documents. Each has { document_key, title, description, fields[] }.
Each field is { key, name, instruction, type: "text" | "number" | "date", required, is_full_name }.
title and description are auto-translated into every verification language on save.
\- is_full_name: optional boolean on a field. Marks the field whose value is compared automatically against the
verified subject: on a person (KYC) workflow the document holder's full name (the ID-verification name, or the
session's expected details), and on a business (KYB) workflow the verified company name (the registry-matched
company, or the session's expected company name). A low match below document_ai_name_match_score_threshold
triggers document_ai_name_mismatch_action. At most one field per document may set it, and it is optional — a
document may mark none (no name check runs).
\- Basic rules (per-risk action DECLINE | REVIEW | NO_ACTION): document_ai_unreadable_document_action,
document_ai_missing_required_fields_action, document_ai_document_tampering_action,
document_ai_name_mismatch_action, document_ai_unsupported_file_action, document_ai_max_attempts_exceeded_action.
\- document_ai_name_match_score_threshold (0-100), document_ai_max_retry_attempts (2-5).
\- status_rules[]: custom rules on any extracted field. Reference an extracted field as document_ai.<field_key>
and cross-reference other steps with value_type:"field" (e.g. document_ai.account_holder equals kyc.full_name).

\# Flow
1\. Create a session — POST /v3/session/ with { workflow_id, vendor_data, callback }. See /sessions-api/create-session.
2\. Open session.url for the user (or mount the Web/Mobile SDK). The user uploads each configured document.
3\. The user uploads documents to POST /v3/document-ai/documents/ (handled by the hosted flow/SDK):
multipart/form-data with { document_key, document, locale? }, Session-Token auth.
Response: { valid?, next_step, document_ai_status, uploaded_document_keys[], required_document_keys[] }.
The step completes once every configured document_key is uploaded.
4\. Fetch the decision — GET /v3/session/{sessionId}/decision/ or subscribe to session.status.updated.

\# Decision surface
DOCUMENT_AI appears in the decision features[] array as { feature: "DOCUMENT_AI", node_id }.
Per-document statuses combine via precedence Declined > In Review > Approved.

\# See also
\- Report: /core-technology/document-ai/report-document-ai
\- Rules & warnings: /core-technology/document-ai/warnings-document-ai
\- Configure in the console: /console/workflows
\- Standalone API (server-to-server, no hosted UI): POST /v3/document-ai/ — /standalone-apis/document-ai`

\</pre>



      
      

الصق في

> [!NOTE]
>
> هل المستند متوفر بالفعل على خادمك؟ يمكنك استدعاء [Document AI API](https://docs.didit.me/ar/standalone-apis/document-ai.md) مباشرة: أرسل الملف مع تعريفات الحقول الخاصة بك في طلب `POST /v3/document-ai/` واحد، وستتلقى الحقول المستخرجة ومطابقة الاسم والحالة بشكل متزامن، دون الحاجة إلى مسار مستضاف. بسعر \$0.20 لكل مستند.## كيف يعمل**1. تكوين المستندات والحقول**في أداة إنشاء سير العمل، يمكنك تحديد ما يصل إلى **3 مستندات**. وتحدد لكل مستند:| الإعداد | الوصف |
| - | - |
| **العنوان والوصف** | يظهران للمستخدم على شاشة الرفع. يتم إدخالهما مرة واحدة و**تتم ترجمتهما تلقائياً** إلى كل لغة من لغات التحقق. |
| **الحقول المراد استخراجها** | قائمة بالحقول محددة النوع — يحتوي كل منها على اسم، وتعليمات استخراج للذكاء الاصطناعي، ونوع (`text`، أو `number`، أو `date`)، وعلامة الإلزامية، وعلامة **الاسم الكامل** الاختيارية. |
| **حقل الاسم** | حدد اختيارياً حقل نصي واحد لكل مستند ليكون الاسم المطلوب مطابقته. في سير عمل الأفراد (KYC)، يكون هذا هو **الاسم الكامل**، وتتم مقارنته بالهوية المتحقق منها؛ وفي سير عمل الشركات (KYB)، يكون **اسم الشركة**، وتتم مقارنته بالشركة المتحقق منها. يحدد `document_ai_name_mismatch_action` الإجراء المتبع عند عدم التطابق. هذا الخيار اختياري — اتركه غير محدد لتخطي التحقق من الاسم لهذا المستند. |ابدأ من [قالب](#قوالب-البدء) أو أنشئ الإعدادات من الصفر.**2. يرفع المستخدم المستندات**يرفع المستخدم ملفاً واحداً لكل مستند تم تكوينه (بصيغة PDF أو صورة). تتم معالجة كل عملية رفع بشكل مستقل؛ وتكتمل الخطوة بمجرد تقديم كل المستندات المطلوبة.**3. استخراج البيانات بالذكاء الاصطناعي**يعرض Didit كل مستند ويشغّل نموذجاً للرؤية واللغة مع مخطط مبني على تعريفات الحقول الخاصة بك. تُعاد القيم المستخرجة محددة النوع (الأرقام كأرقام، والتواريخ بتنسيق `YYYY-MM-DD`) ويتم تخزينها لكل مستند. كما يتم تشغيل التحليل الجنائي لملفات PDF/EXIF لاكتشاف التلاعب.**4. المطابقة المرجعية والقواعد**يمكن مطابقة الحقول المستخرجة مرجعياً مع خطوات أخرى — على سبيل المثال، مطابقة اسم صاحب المستند مع الهوية المتحقق منها، أو أي حقل مع إجابات الاستبيان — ومقارنتها بـ **القواعد الأساسية** و**قواعد الحالة المخصصة**. وتُدمج حالات كل مستند الناتجة لتكوين حالة الميزة الإجمالية.## قوالب البدءعند إضافة عقدة Document AI، يمكنك البدء من قالب جاهز يملأ مسبقاً العنوان والوصف والحقول محددة النوع. يمكنك تخصيص أي عنصر بعد ذلك.| القالب | الحقول النموذجية |
| - | - |
| **إثبات الأموال** | صاحب الحساب، الرصيد، العملة، تاريخ كشف الحساب |
| **إثبات الدخل (قسيمة الراتب)** | صاحب العمل، اسم الموظف، الراتب الإجمالي/الصافي، فترة الدفع |
| **مصدر الثروة** | نوع المصدر، المبلغ، التاريخ، المؤسسة |
| **مستند ضريبي** | اسم دافع الضرائب، السنة الضريبية، الدخل المعلن، الرقم الضريبي |## المطابقة المرجعية مع الخطوات الأخرىيمكن الوصول إلى حقول Document AI بصيغة `document_ai.<field_key>` ويمكن مقارنتها بحقول من خطوات مكتملة أخرى باستخدام قاعدة حالة مخصصة مع `value_type: "field"`. على سبيل المثال:- `document_ai.account_holder` **يساوي** `kyc.full_name` — صاحب المستند يطابق الهوية المتحقق منها.
- `document_ai.balance` **greater\_than** `50000` — وضع علامة على الأرصدة المرتفعة لمراجعتها.تندمج قواعد المطابقة في القرار وفقاً لأسبقية المنصة **مرفوضة > قيد المراجعة > مقبولة**، وبالتالي يمكن للقاعدة رفع مستوى الخطورة ولكن لا يمكنها أبداً تجاوز حالة أشد صرامة مدفوعة بالمخاطر. راجع [القواعد والتحذيرات](https://docs.didit.me/ar/core-technology/document-ai/warnings-document-ai.md).## متطلبات المستندات| المتطلب | التفاصيل |
| - | - |
| **المستندات لكل خطوة** | ما يصل إلى 3 مستندات، يتم تكوين كل منها بشكل مستقل |
| **التنسيقات المدعومة** | PDF، JPG، JPEG، PNG، TIFF، WebP |
| **الصفحات** | دعم ملفات PDF متعددة الصفحات |
| **الجودة** | مستند أصلي أو مسح ضوئي عالي الجودة؛ دون تعديل رقمي أو تلاعب |> [!NOTE]
>
> يجري Document AI قراءة للنصوص غير المنظمة، وهو ما يضيف بضع ثوانٍ من وقت الاستجابة لكل مستند. لا يتم إرسال webhook إلا عند اكتمال خطوة سير العمل بالكامل — لا تقم بإجراء استقصاء لـ endpoint الخاص بالقرار بمعدل أسرع من مرة كل 5 ثوانٍ خلال هذه الفترة.


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