اربط أنظمة أخرى عبر واجهة الموارد البشرية المفتوحة

تتيح واجهة الموارد البشرية المفتوحة لنظام آخر قراءة موظفيك وحضورهم وإجازاتهم ومسيرات الرواتب النهائية، وإرسال البصمات، بمفتاح تنشئه أنت. وتُبلغ ويب هوكس الموارد البشرية ذلك النظام عند وقوع حدث ما.

قبل أن تبدأ

• يجب أن تكون المالك. لا يستطيع المديرون إنشاء المفاتيح، حتى لو امتلكوا كل صلاحيات الموارد البشرية.
• الموارد البشرية مُشغَّلة.

أنشئ مفتاحًا

1. افتح الموارد البشرية ← إعدادات الموارد البشرية، وفي الخدمة الذاتية والفريق اختر واجهة الموارد البشرية المفتوحة.
2. حدد الواجهة المفتوحة مفعّلة واختر حفظ. تعرض الصفحة العنوان الأساسي.
3. تحت إنشاء مفتاح، اكتب لأي غرض (مثل "مكتب الرواتب").
4. تحت الصلاحيات، حدد فقط ما يحتاجه النظام: قراءة الأشخاص، قراءة الحضور، إرسال بصمات، قراءة الإجازات، قراءة الرواتب النهائية، إدارة الويب هوكس.
5. اختر إنشاء المفتاح.
6. انسخ المفتاح الآن وسلّمه للنظام الآخر. يظهر مرة واحدة فقط؛ ولا يحتفظ Kluvan إلا ببصمة مُجزَّأة (hash) منه.

أضف ويب هوك

1. تحت إضافة ويب هوك، اكتب URL نظامك (يجب أن يبدأ بـ https).
2. حدد الأحداث: employee.created وemployee.left وpunch.recorded وleave.approved وpayroll.paid. كلها محددة في البداية.
3. اختر إضافة وانسخ سر التوقيع، الذي يظهر مرة واحدة فقط.
4. راجع التسليمات لترى ما أُرسل وحالته وعدد المحاولات.

معلومات مفيدة

• مفاتيح منفصلة. مفاتيح الموارد البشرية نظام قائم بذاته، منفصل عن أي مفاتيح واجهة برمجية أخرى في Kluvan، ولا تصل إلا إلى بيانات الموارد البشرية لمنشأتك.
• لا يقرأ المفتاح أبدًا البيانات البنكية ولا المستندات ولا البيانات الحيوية. تُرجع قراءة الرواتب النهائية المسيرات المدفوعة فقط، لا المسودات أبدًا، ودون رقم IBAN أو رقم الحساب.
• اختر إلغاء لإيقاف مفتاح فورًا. تعرض القائمة آخر استخدام لكل مفتاح وعدد الاستدعاءات التي أجراها.
• يمكن للمفتاح إجراء 10 استدعاءات في الثانية، مع دفعات قصيرة حتى 60. ويمكن أن تصل الفترة المطلوبة إلى 92 يومًا.
• البصمة المرسلة عبر الواجهة تُضاف كتصحيح باسم المفتاح كمُدخِل لها. أرسل كل بصمة مرة واحدة: البصمة نفسها إذا أُرسلت مرتين تظهر مرتين في كشف الحضور، ويحذف المدير إحداهما.
• تُوقَّع الويب هوكس بالسر (HMAC-SHA256 في الترويسة X-Hr-Signature). يُعاد محاولة التسليم الفاشل لمدة يوم تقريبًا؛ والويب هوك الذي يفشل 20 مرة متتالية يُوقَف حتى تشغّله من جديد.
• لم يُجرَّب بعد على عنوان حقيقي: تسليم الويب هوكس مُختبر داخل بيئة الاختبار الخاصة بنا فقط. اختبره مع نظامك قبل الاعتماد عليه.
• إنشاء المفاتيح وإلغاؤها، وكل بصمة مرسلة، تُسجَّل في سجل النشاط.
• للمطورين، المرجع التقني مرتبط من الصفحة: اقرأ كيفية استدعائها.