ما الذي يرسله «نما» إلى التزام

عاجلاً أو آجلاً سيتصل عميل ليقول: «الوزارة تقول إن رقم وظيفة الموظف 1045 خطأ — من أين يأتي به نما؟». هذه الصفحة تجيب عن هذا السؤال لكل قيمة مهمة. فكل عملية أدناه تذكر ما ترسله والحقل في «نما» الذي يقف وراءه. والقيم التي تُترجم بجدول أكواد يُذكر اسم جدولها؛ أما كيف يختار الجدول نفسه الكود فتجده في جداول أكواد التزام.

قيم مشتركة بين كل العمليات

القيمة لدى الوزارة	مصدرها
رقم الموظف (Employee ID)	كود الموظف
رقم الهوية الوطنية	رقم الهوية الوطنية للموظف. وإن كان فارغاً يُرسل رقم الإقامة بدلاً منه
رقم الجهة الفرعية	رقم الجهة الفرعية في الإعدادات (في كل العمليات عدا بيانات الموظف)
رقم الوظيفة	رقم الوظيفة من حقل بالموظف في الإعدادات ← وإلا الرقم بمكتب العمل للموظف ← وإلا كود الدرجة الوظيفية
فئة الوظيفة، المسمى الوظيفي، سلسلة الفئة، نوع التوظيف، المرتبة	جداول JobClassCode وJobNameCode وJobCatChain وEmploymentTypeCode وRankCode، مطابَقة على الدرجة الوظيفية للموظف. ويُرسل الاسم العربي للدرجة مع كود المسمى الوظيفي
كود المسمى الفعلي للوظيفة	كود المسمى الفعلي للوظيفة من حقل بالموظف ← وإلا جدول JobNameCode
رقم / اسم جهة الوظيفة	رقم / اسم الجهة الحكومية من حقل بالموظف ← وإلا رقم / اسم الجهة الحكومية في الإعدادات
رقم / اسم الإدارة الفعلية	رقم / اسم الإدارة الفعلية من حقل بالموظف ← وإلا كود / الاسم العربي لـإدارة الموظف ← وإلا الجهة
الموقع	جدول LocationCode، مطابَقاً على مكان العمل للموظف ← وإلا كود الموقع الافتراضي في الإعدادات
تاريخ أول مرتبة	تاريخ أول مرتبة من حقل بالموظف ← وإلا تاريخ التعيين
الراتب الأساسي	قيمة استحقاق عنصر الراتب الأساسي في آخر سند راتب معتمد للموظف في الفترة

بيانات الموظف (Employee Info)

طلب واحد لكل موظف، يصف الشخص وحالته الحالية.

• الأسماء تأتي من الاسم العربي (Name1) والإنجليزي (Name2)، مقسَّمة عند المسافات إلى الاسم الأول والثاني والثالث والأخير. الكلمتان تصبحان اسماً أول وأخيراً، والثلاث تصبح أول وثانياً وأخيراً، وما زاد على الكلمة الرابعة يبقى في الاسم الأخير.
• تاريخ الميلاد والنوع والجنسية والديانة والحالة الاجتماعية من ملف الموظف، مترجمة بجداول Gender وNationalityCode وReligion وMaritalStatus. والحالة الصحية وفصيلة الدم من جدولي HealthStatus وBloodType. والجوال والبريد الإلكتروني من بيانات الاتصال.
• تاريخ التعيين الحكومي وتاريخ التعيين بالجهة كلاهما تاريخ تعيين الموظف.
• حالة الموظف هي حالة الموظف في «نما»، مترجمة بجدول EmployeeStatusCode.
• الرصيد المتبقي من الإجازة الاعتيادية والاضطرارية هو الرصيد المتبقي للموظف من نوعي الإجازة في الإعدادات، في تاريخ مستند الإرسال.
• كود الحركة من جدول TransactionCode.
• IsActive قيمتها Yes ما دام الموظف ليس له تاريخ نهاية خدمة. وبمجرد تحديد تاريخ نهاية الخدمة تصبح No ويُضاف جزء إنهاء الخدمة بالتاريخ وسبب إنهاء من جدول TerminationReasonCode.

البيانات التاريخية للموظف (Employee Historical Info)

طلب لـكل مستند «تحديث بيانات الموظف» معتمد للموظف في الفترة. كود المستند هو رقم القرار، وتاريخه هو تاريخ القرار وتاريخ بداية الحركة، وملاحظاته هي وصف الحركة. وحين ينقل المستند الموظف إلى درجة وظيفية أخرى، تُرسل أكواد الوظيفة لتلك الدرجة الجديدة.

بيانات الوظيفة (Job Info)

طلب واحد لكل موظف عن الوظيفة التي يشغلها. رقم الوظيفة (Job Position Code) هو كود الدرجة الوظيفية للموظف — رقمك الخاص المكوّن من تسعة أحرف، لا كوداً من الوزارة — مكمَّلاً بأصفار على اليسار. وتاريخ بداية الوظيفة هو تاريخ التعيين. وحالة الوظيفة وكود حركة الوظيفة هما الكودان الافتراضيان في جدولي PositionStatus وJobTransactionCode. وللموظف الذي له تاريخ نهاية خدمة، يُرسل هذا التاريخ تاريخاً لنهاية الوظيفة وتاريخاً لشغورها.

بيانات مسير الرواتب (Payslip Info)

طلب لـكل سند راتب معتمد للموظف في الفترة. يحمل المرتب النهائي، وتاريخ السند تاريخاً للصرف، والشهر والسنة بالهجري والميلادي، وعنصراً لكل سطر في الراتب:

• كود العنصر من جدول ElementCode، مطابَقاً على مفرد الراتب في السطر، والاسم العربي للمفرد؛
• المبلغ — الاستحقاق للبند المستحق، والاستقطاع للبند المستقطع — يُرسل رقماً موجباً ويُصنَّف Paid أو Deduction؛
• مجموعة الصرف من جدول ConsolidationSetID، مطابَقة على الصرفية في سند الراتب.

السطور ذات المبلغ صفر لا تُرسل. ويحمل المسير الواحد حتى 100 عنصر.

بيانات المؤهلات (Qualification Info)

طلب واحد لكل موظف يضم كل سطر في جدول المؤهلات في ملف الموظف، عبر جداول QualificationCode وMajorCode (التخصص) وUniversityCode (جهة التخرج) وEduGrade (التقدير). والسطر الذي له تاريخ تخرج يُرسل مكتملاً، والذي ليس له تاريخ يُرسل قيد الدراسة. والموظف الذي ليس له مؤهلات يُتخطى.

بيانات الإجازات (Vacation Info)

طلب واحد لكل موظف يضم سندات الأجازة المعتمدة التي يقع تاريخ بدايتها في الفترة: كود السند (رقماً للإجازة ورقماً للقرار)، وتاريخ البداية، وتاريخ العودة، وعدد الأيام، وكود الإجازة من جدول VacationCode مطابَقاً على نوع الأجازة. والموظف الذي ليس له إجازات في الفترة يُتخطى.

بيانات تقييم الأداء (Appraisal Info)

طلب لـكل تقييم موظف معتمد في الفترة: كود التقييم رقماً له، وتاريخا بداية ونهاية فترة الرواتب (أو تاريخ التقييم إن لم تكن له فترة رواتب)، ونوع التقييم من جدول AppraisalTypeCode مطابَقاً على نوع التقييم، والنسبة النهائية مقرَّبة إلى رقم صحيح، والتقدير من حدود جدول RatingCode.

أي المستندات تُعدّ «داخل الفترة»

بيانات الموظف وبيانات الوظيفة وبيانات المؤهلات تصف الموظف كما هو اليوم دائماً، فلا تتأثر بالفترة. أما العمليات الأربع الأخرى فلا تلتقط إلا المستندات المعتمدة، وتختارها بحسب الفترة في مستند الإرسال:

الفترة في مستند الإرسال	سندات الراتب والتقييمات	سندات الأجازة ومستندات تحديث بيانات الموظف
فترة الرواتب مملوءة	مستندات تلك الفترة	ما يقع بين من تاريخ وإلى تاريخ، إن وُجدا
سنة الرواتب مملوءة (بلا فترة)	مستندات فترات تلك السنة، مضيَّقة بمن تاريخ / إلى تاريخ إن وُجدا	ما يقع بين من تاريخ / إلى تاريخ، وإلا بين بداية سنة الرواتب ونهايتها
من تاريخ / إلى تاريخ فقط	تاريخ المستند داخل المدى	تاريخ المستند (تاريخ البداية في الإجازات) داخل المدى
لا شيء	تاريخ الموظف كله	تاريخ الموظف كله

الإبلاغ عن شهر واحد

حين تُبلغ عن شهر رواتب واحد بـفترة الرواتب، املأ من تاريخ وإلى تاريخ بالشهر نفسه أيضاً. ففترة الرواتب تضيّق سندات الراتب والتقييمات؛ أما التاريخان فهما ما يضيّق الإجازات والتحديثات التاريخية — ومن دونهما ترسل هاتان العمليتان تاريخ الموظف كله.