> ## 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، ومُشغّلاتها من SIGNATURE_DECLINED إلى SIGNATURE_DOCUMENT_CHANGED والقواعد التي تتحكم بها.

تُصدِر خطوة [التوقيع الإلكتروني](https://docs.didit.me/ar/core-technology/electronic-signature/overview.md) تحذيراً عندما يتعذر على الموقّع التوقيع أو يرفضه: كأن يرفض التوقيع، أو تنفد الرموز لديه، أو يتعذر مطابقته مع هوية تم التحقق منها، أو لم يعد المستند يطابق ما عُرض عليه. يُوقف كل تحذير توقيع ذلك الموقّع، وبالتالي لا يُصدَر أي مستند موقّع له. ويعود إليك تحديد أثر التحذير على القرار.

## نظرة عامة

يظهر التحذير في مكانين:

* في عنصر الموقّع داخل `signatures[]`، على شكل `{ "code": "SIGNATURE_DECLINED", "node_id": "feature_signature" }` داخل `warnings[]`. راجع [تقرير التوقيع الإلكتروني](https://docs.didit.me/ar/core-technology/electronic-signature/report-electronic-signature.md).
* في نشاط الجلسة، موسوماً بالميزة `SIGNATURE`، مع عنوانه ووصفه. تعرضه لوحة التحكم في تبويب **التوقيع** الخاص بالجلسة، ويشير `additional_data.signature_id` إلى الموقّع.

يرتبط كل رمز بقاعدة. يمكنك تعيين القاعدة إلى `DECLINE` أو `REVIEW` أو `NO_ACTION` لكل خطوة في سير العمل، من تبويب **القواعد** في لوحة التحكم أو في [الإعدادات](https://docs.didit.me/ar/management-api/workflows/feature-configs.md#التوقيع-الإلكتروني) الخاصة بالخطوة. تحدد القاعدة `verdict` للموقّع (`Declined` أو `In Review` أو `Approved`) ودرجة خطورة التحذير (`error` أو `warning` أو `information`). وتُطبّق قواعد الحالة المخصصة في الخطوة بعد ذلك.

> [!WARNING]
>
> تحدد القاعدة القرار، وليس ما إذا كانت المستندات موقّعة أم لا. يتيح الخيار `NO_ACTION` لسير العمل الاستمرار، لكن الموقّع لم يوقّع بعد. تحقّق من أن `status` هو `signed` قبل الاعتماد على التوقيع.

## التحذيرات الناتجة

| الرمز | متى يُصدَر | القاعدة والإعداد الافتراضي |
| - | - | - |
| `SIGNATURE_DECLINED` | رفض الموقّع التوقيع. لا تُصدَر نسخة موقّعة ولا يُحتسب أي رسم. | `signature_declined_action`، الافتراضي `REVIEW` |
| `SIGNATURE_OTP_FAILED` | أدخل الموقّع 3 رموز خاطئة، أو طلب أكثر من 5 رموز. | `signature_otp_failed_action`، الافتراضي `DECLINE` |
| `SIGNATURE_NAME_MISMATCH` | KYB: الاسم المصرّح به للشخص الرئيسي لا يطابق اسمه الذي تم التحقق منه، مع تجاهل حالة الأحرف والمسافات. | `signature_name_mismatch_action`، الافتراضي `DECLINE` |
| `SIGNATURE_IDENTITY_NOT_VERIFIED` | ليس لدى الموقّع عملية تحقق من الهوية مقبولة تتضمن اسماً، أو أن فحص الحيوية في جلسته غير مقبول، أو تغيّر التحقق من الهوية بعد أن بدأ الموقّع. | `signature_identity_not_verified_action`، الافتراضي `DECLINE` |
| `SIGNATURE_DOCUMENT_CHANGED` | لم يعد المستند يطابق قيمة SHA-256 المسجلة عند عرضه على الموقّع. | `signature_document_changed_action`، الافتراضي `DECLINE` |

تُجرى عمليات التحقق من الهوية والاسم عندما يطلب الموقّع رمزه ومرة أخرى عند إدخاله، لذا تظهر هذه التحذيرات عند هذه النقطة بدلاً من وقت فتح الخطوة.

## يمكن إعادة فتح حالات الرفض

يُعدّ `SIGNATURE_DECLINED` التحذير الوحيد الذي يمكن للموقّع التراجع عنه. طالما أن رابط التوقيع صالح، يمكن للموقّع الذي رفض التوقيع إعادة فتح الخطوة والتوقيع. تؤدي إعادة الفتح إلى مسح تحذير الموقّع وقراءته وموافقته على كل مستند، بحيث يطّلع على المستندات مرة أخرى. يختفي التحذير من نشاط الجلسة بمجرد ألا يظل أي موقّع في الخطوة رافضاً للتوقيع. لا تعيد إعادة الفتح تعيين محاولات الرموز لديه. أما التحذيرات الأخرى فتكون نهائية لذلك الموقّع.

## المشكلات التي تظهر للموقّع

تؤدي هذه المشكلات إلى إيقاف الموقّع دون إصدار تحذير. وتوضح له واجهة المسار ما حدث.

| الحالة | ما يحدث |
| - | - |
| انتهاء صلاحية رابط التوقيع | يتعذر فتح الخطوة أو إكمالها بعد `expires_at`. يظل الرابط صالحاً لمدة `signature_link_validity_days` بدءاً من وقت إنشاء الجلسة. |
| انتهاء صلاحية الرمز | تظل الرموز صالحة لمدة 5 دقائق. ويطلب الموقّع رمزاً جديداً. |
| طُلب رمز جديد في وقت مبكر جداً | ينتظر الموقّع 60 ثانية بين كل طلب رمز وآخر. |
| عدم وجود وسيلة تواصل تم التحقق منها | يُرسل الرمز فقط إلى بريد إلكتروني أو رقم هاتف تم التحقق منه مسبقاً في الجلسة. أضف التحقق من البريد الإلكتروني أو التحقق من رقم الهاتف قبل خطوة التوقيع. |
| حقل مطلوب فارغ | يتعذر على الموقّع إنهاء المستند حتى تصبح لكل حقل مطلوب فيه قيمة. توضح واجهة المسار عدد الحقول المتبقية وتنتقل مباشرة إلى أول حقل منها. |
| رُفضت قيمة الحقل | تُرفض أي قيمة تنتهك [التحقق من صحة](https://docs.didit.me/ar/core-technology/electronic-signature/overview.md#التحقق-من-الصحة) الحقل الخاص بها، كأن تكون طويلة جداً أو ليست رقماً، وتوضح واجهة المسار سبب ذلك. |
| التطبيق قديم جداً بالنسبة للحقول | يتعذر على إصدار SDK أصلي لا يدعم الحقول عرض مستند يحتوي على حقول، وتُظهر الخطوة خطأً. تظل المستندات التي لا تحتوي على حقول تعمل دون مشكلة. راجع [تجربة التوقيع](https://docs.didit.me/ar/core-technology/electronic-signature/overview.md#تجربة-التوقيع). |

## مثال

```json theme={null}
{
  "signatures": [
    {
      "id": "0e6c2a8e-6c2f-4b8e-9a51-3f2f6a7d9b10",
      "node_id": "feature_signature",
      "status": "declined",
      "verdict": "In Review",
      "warnings": [
        { "code": "SIGNATURE_DECLINED", "node_id": "feature_signature" }
      ],
      "declined_at": "2026-11-03T10:41:40.320Z",
      "declined_action": "REVIEW",
      "signed_at": null,
      "certificate": null,
      "timestamp": null,
      "evidence_file": null
    }
  ]
}
```

يُظهر المثال الحقول التي تتغير فقط. وتظل جميع الحقول الأخرى في [كائن التوقيع](https://docs.didit.me/ar/core-technology/electronic-signature/report-electronic-signature.md#كائن-التوقيع) موجودة.

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

تتبع درجة خطورة كل تحذير القاعدة التي تحددها. وتندرج درجات الخطورة تحت ثلاث فئات:

## ذات صلة

* [نظرة عامة على التوقيع الإلكتروني](https://docs.didit.me/ar/core-technology/electronic-signature/overview.md)
* [تقرير التوقيع الإلكتروني](https://docs.didit.me/ar/core-technology/electronic-signature/report-electronic-signature.md)
* [إعدادات ميزات سير العمل](https://docs.didit.me/ar/management-api/workflows/feature-configs.md#التوقيع-الإلكتروني)


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