الربط مع خدمة التزام (MCS Eltezam) — نظرة عامة

الجهة الحكومية في المملكة العربية السعودية لا يكفيها أن تصرف رواتب موظفيها؛ بل عليها أيضاً أن تُبلغ وزارة الخدمة المدنية (MCS) عنهم. من هو كل موظف، وما وظيفته ومرتبته، وكم صُرف له كل شهر، وما مؤهلاته، وما الإجازات التي أخذها، وكيف قُيِّم أداؤه — كل ذلك يجب أن يصل إلى خدمة التزام لجمع البيانات في الوزارة، ويجب أن يصل بأكواد الوزارة نفسها لا بأكواد الجهة.

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

إلى أين تذهب الطلبات

تصل الطلبات إلى التزام عبر قناة التكامل الحكومية (GSB). لذلك يجب أن يكون خادم «نما» على الشبكة التي تصل إلى عنوان الوزارة؛ ولا يوجد اسم مستخدم أو كلمة مرور أو شهادة تُدخل في «نما». والمعرّفات الوحيدة هي رقم الجهة ورقم الجهة الفرعية اللذان تضعهما في الإعدادات.

الترخيص

الربط جزء من موديول التكاملات، ويحتاج إلى الموديول الفرعي في الترخيص integrations-ksa-estidamah-eltezam. ومن دونه لا تظهر شاشات التزام الثلاث.

الشاشات الثلاث

تجد الشاشات الثلاث في قائمة التكاملات (integrations):

الشاشة	مكانها	الغرض منها
إعدادات خدمة التزام (MCS Eltezam Configuration)	الملفات	الاتصال بالوزارة وقواعد قراءة بيانات الموارد البشرية: عنوان الخدمة، وأرقام الجهة، ومجموعة الموظفين، والعمليات التي تُرسل. غالباً إعدادات واحدة لكل جهة. انظر إعداد التزام.
جدول أكواد التزام (MCS Eltezam Code Table)	الملفات	جدول لكل قائمة أكواد من قوائم الوزارة (فئة الوظيفة، الجنسية، النوع، عنصر الراتب، …) يحوّل قيم «نما» إلى أكواد الوزارة. انظر جداول أكواد التزام.
إرسال بيانات التزام (MCS Eltezam Submission)	المستندات	عملية إرسال واحدة: أي الموظفين، وأي فترة، وأي العمليات — وبعد الإرسال: نتيجة كل موظف وسجل الطلبات كاملاً. انظر مستندات الإرسال وطريقة الإرسال.

ما الذي يُرسل: العمليات السبع

كل عملية نوع مستقل من الطلبات لدى الوزارة. وتختار ما يُرسل منها بخانات إرسال … في الإعدادات (ويمكنك تغيير الاختيار في كل مستند إرسال إن شئت).

الخانة	ما الذي تُبلغ عنه	مصدرها
إرسال بيانات الموظف (Send Employee Info)	الهوية، والأسماء، وتاريخ الميلاد، والجنسية، وتواريخ التعيين، والوظيفة الحالية، والحالة، وأرصدة الإجازات	ملف الموظف — طلب واحد لكل موظف
إرسال البيانات التاريخية للموظف (Send Employee Historical Info)	الحركات الوظيفية السابقة برقم القرار وتاريخه	كل مستند «تحديث بيانات الموظف» معتمد في الفترة
إرسال بيانات الوظيفة (Send Job Info)	الوظيفة التي يشغلها الموظف	الدرجة الوظيفية للموظف — طلب واحد لكل موظف
إرسال بيانات مسير الرواتب (Send Payslip Info)	صافي الراتب وكل عنصر من عناصر راتب الشهر	كل سند راتب معتمد في الفترة
إرسال بيانات المؤهلات (Send Qualification Info)	مؤهلات الموظف	جدول المؤهلات في ملف الموظف
إرسال بيانات الإجازات (Send Vacation Info)	الإجازات التي أخذها الموظف	سندات الإجازة المعتمدة التي تبدأ في الفترة
إرسال بيانات تقييم الأداء (Send Appraisal Info)	نتيجة تقييم الأداء وتقديره	كل تقييم موظف معتمد في الفترة

وتفاصيل كل قيمة — من أين تأتي وأي جدول أكواد يحوّلها — موجودة في ما الذي يرسله «نما» إلى التزام.

التواريخ تُرسل بالهجري

كل تاريخ يُرسل إلى الوزارة تاريخاً هجرياً (dd-MM-yyyy)، محوَّلاً بالجدول الهجري في «نما». ولا بد أن يمتد الجدول إلى الوراء بما يكفي لتغطية أقدم تاريخ ميلاد وتاريخ تعيين تُرسله، وإلا حُجزت هذه الطلبات برسالة توضح ذلك.

خطوات العمل باختصار

1. بيانات الموارد البشرية أولاً. تأكد أن لكل موظف كوداً، ورقم هوية أو رقم إقامة، واسماً عربياً وإنجليزياً، وتاريخ ميلاد وتاريخ تعيين، ودرجة وظيفية، ومكان عمل، وإدارة؛ وأن سندات الراتب والإجازة والتقييمات ومستندات تحديث بيانات الموظف التي تريد الإبلاغ عنها معتمدة. وضع الموظفين الذين تُبلغ عنهم في مجموعة موظفين.
2. أنشئ الإعدادات — عنوان الخدمة وأرقام الجهة التي أعطتها لك الوزارة، ومجموعة الموظفين، وعنصر الراتب الأساسي، ونوعي الإجازة، والعمليات التي تُرسل.
3. أنشئ جداول الأكواد دفعة واحدة بالإجراء EACreateEltezamCodeTables، ثم املأ كل جدول من قوائم الأكواد التي تنشرها الوزارة.
4. أنشئ مستند «إرسال بيانات التزام» واعتمده للفترة التي تُبلغ عنها. يمتلئ جدول الموظفين آلياً من المجموعة.
5. أرسله. يتم الإرسال بمسار كيان على مستند الإرسال (مثلاً عند «تأثيرات الحفظ» PostCommit) أو بمهمة مجدولة. اعتماد المستند وحده لا يرسل شيئاً — لا يوجد زر إرسال.
6. اقرأ النتيجة على المستند: كل سطر موظف يظهر عليه نجح أو فشل أو لم يرسل بعد، والصفحة الثانية تعرض كل طلب برقم طلب الوزارة أو الخطأ.
7. صحّح ثم أعد الإرسال. صحّح البيانات أو جداول الأكواد، ثم اضغط إعادة إرسال الموظفين الذين فشل إرسالهم لإرسال الموظفين الذين لم ينجحوا فقط.

وعند حدوث مشكلة، تجد في حل مشكلات التزام الرسائل ومعنى كل منها.