يقرأ نارفن الرواتب الشهرية المعتمدة من ZenHR إلى سجل الرواتب لديه، فرعًا فرعًا: الراتب الأساسي والدخل الإضافي والاستقطاعات والصافي والأجر الخاضع للتأمينات. ويسجّل الدخول عبر تطبيق OAuth ينشئه مسؤول ZenHR لديك، ولا يقرأ شيئًا حتى يفعّل سجل الرواتب شخص يملك صلاحية الرواتب، ولا يكتب في ZenHR أبدًا.
ماذا يقرأ نارفن من ZenHR؟
كل فرع في ZenHR شركة بالنسبة إلى نارفن. ولكل فرع يقرأ عملته ودولته، وقائمة موظفيه، وقائمة رواتب واحدة لكل شهر.
| حقل سجل الرواتب | من ZenHR |
|---|---|
| رمز الموظف واسمه | الرقم الوظيفي (وإلا فالمعرّف الداخلي في ZenHR) والاسم المختصر بالإنجليزية أو العربية |
| تاريخا الالتحاق والمغادرة | تاريخا التعيين وانتهاء الخدمة في قائمة الموظفين |
| الراتب الأساسي | الراتب الأساسي قبل أي خصم للغياب |
| البدلات الأخرى | صافي الدخل فوق الراتب الأساسي |
| الاستقطاعات | صافي الاستقطاعات مضافًا إليه مبلغ الغياب، حتى يساوي كل سطر صافيه |
| صافي الراتب | إجمالي الراتب |
| الأجر الخاضع للتأمينات الاجتماعية | راتب الضمان الاجتماعي في نظام الفرع |
لا تُحمّل إلا الرواتب التي حالتها معتمدة أو مرسلة إلى الموظف. أما الحالات الأخرى فتُعدّ بأسمائها في تنبيه المزامنة، وكذلك السجلات بعملة غير عملة الفرع، والسجلات التي لا تتطابق مجاميعها، وهذه تحتفظ بإجمالي ZenHR نفسه.
لماذا يحتاج ZenHR إلى تطبيق خاص بكم؟
تسجّل واجهة ZenHR الدخول عبر تطبيق OAuth ينشئه كل عميل داخل حسابه في ZenHR. فالتطبيق ملككم: ينشئه المسؤول لديكم، ويختار صلاحياته، ويستطيع حذفه. ويطلب نارفن ثلاث صلاحيات قراءة: الفروع والموظفين والمعلومات المالية.
تُدخل اسم التطبيق ومعرّفه (UID) وسرّه في نموذج الربط، ثم تسجّل الدخول إلى ZenHR للسماح به. ويُختم المعرّف والسر مع الاتصال ولا يُستخدمان إلا لتسجيل الدخول وتجديد الوصول، ولا يُعرضان مرة أخرى ولا يُكتبان في أي سجل. وإعادة الربط لاحقًا تطلبهما من جديد.
من يفعّل الرواتب، ومن يراها؟
اتصال ZenHR الجديد لا يقرأ شيئًا حتى يُفعَّل سجل الرواتب من بطاقته. ولا يفعّله إلا شخص يدير الاتصالات ويملك صلاحية تفاصيل الرواتب لكل شركات الاتصال، ويُسجَّل التغيير في سجل التدقيق. وبعدها لا يرى أسطر الفرع إلا من يملك صلاحية تفاصيل الرواتب له، وتذكر التنبيهات الأشهر ولا تذكر الأشخاص أبدًا.
أي الأشهر تُقرأ، وكم مرة؟
تقرأ المزامنة الأولى آخر 12 شهرًا، وتعيد المزامنات التالية القراءة من الشهر السابق لآخر مزامنة، فيُلتقط الراتب الذي اعتُمد متأخرًا. ويسمح ZenHR بخمسة عشر طلبًا كل 4 ثوانٍ في بيئة الإنتاج، وينتظر نارفن حين يطلب منه ZenHR الإبطاء. ويناسب الرواتب غالبًا جدول يومي أو أسبوعي بتوقيتك.
وكل شهر يقرؤه الاتصال يستبدل ما حمّله هذا الاتصال سابقًا فقط. أما الشهر المستورد من ملف رواتب، أو الذي حمّله اتصال آخر، فيبقى، وتنبّه المزامنة بذلك الشهر.
ما الذي لا يفعله الاتصال؟
- لا يكتب في ZenHR أبدًا.
- لا يفصل السكن والنقل والعمل الإضافي عن الدخل الإضافي، لأن سجل الراتب في ZenHR لا يحملها منفصلة.
- لا يقرأ اشتراكات صاحب العمل، ولا حصة الموظف في الضمان الاجتماعي، ولا القسم أو الجنسية أو الحسابات البنكية.
- لا يقرأ شيئًا إذا لم يكن للتطبيق صلاحية الرواتب، وتذكر المزامنة حينها الصلاحية التي يجب إضافتها.
كيف تربط ZenHR؟
- أنشئ التطبيق في ZenHRيفتح مسؤول في ZenHR بصلاحيات المسؤول العام الصفحة /en/oauth/applications على عنوان ZenHR لديكم، ويضيف تطبيقًا جديدًا بعنوان إعادة التوجيه الذي يعرضه نموذج الربط في نارفن، ومستوى الوصول Company، وصلاحيات قراءة الفروع والموظفين والمعلومات المالية.
- أضف الاتصالاختر عنوان ZenHR لديكم، app.zenhr.com أو sa.zenhr.com، وأدخل اسم التطبيق ومعرّفه وسرّه.
- سجّل الدخول واختر الفروعسجّل الدخول إلى ZenHR للسماح بالتطبيق، ثم اربط كل فرع بشركته في نارفن. ويجب أن تطابق عملة الفرع عملة شركته.
- فعّل سجل الرواتبمن بطاقة الاتصال، بواسطة شخص يملك صلاحية تفاصيل الرواتب لكل الشركات المرتبطة.
- شغّل المزامنة الأولى وقارن شهرًاقارن شهرًا لكل فرع برواتب ZenHR، واقرأ التنبيهات عن الحالات والمجاميع.
أسئلة شائعة
هل يصبح كل فرع شركة منفصلة؟
نعم. يرتبط كل فرع في ZenHR بشركته في نارفن، بعملته الخاصة.
لماذا تنقص بعض الرواتب؟
لا تُحمّل إلا الرواتب المعتمدة أو المرسلة إلى الموظف. أما غيرها، والسجلات بعملة أخرى، فتُعدّ في تنبيهات المزامنة.
هل نستطيع سحب وصول نارفن من ZenHR؟
نعم. التطبيق في حسابكم في ZenHR، فيستطيع المسؤول حذفه في أي وقت، وعندها تتوقف المزامنات حتى يعيد أحدهم الربط.
مراجع رسمية وأولية، قُرئت في التاريخ المذكور. الأنظمة تتغير، فتحقق من الجهة المختصة أو مستشارك قبل التصرف.
- ZenHR: ZenHR APIs Documentation (OAuth applications, scopes, base URLs and rate limits) (قُرئ في 9 أكتوبر 2026)