ملف الموظف: أفراد المنظمة على وظائفهم ومع مديريهم. يملكه نظام ERP عادةً ويعكسه جديرون، بينما تعود التعيينات التي تجري في جديرون في الاتجاه المعاكس.
الموارد
| المورد | الواجهة البرمجية | الصفحات |
|---|---|---|
| الموظفون | إنشاء وقراءة وتعديل وDELETE (= إنهاء الخدمة)، وأرشفة، وإنشاء أو تعديل بالمعرّف الخارجي، وإدراج مجمّع | الموظفون |
المسار المعتاد
- حمّل القوى العاملة مرة واحدة بالإدراج المجمّع (انظر الترحيل المجمّع).
- أرسل التغييرات بـ
PUT /api/v1/employees/by-external/{system}/{externalId}: التعيينات الجديدة في ERP، والتنقلات (currentPosition)، وتغيير المدير (manager). - أنهِ خدمة المغادرين بـ
DELETE /api/v1/employees/{id}: يبقى السجل بالحالةFORMER_EMPLOYEEوتتلقىemployee.offboarded. - اشترك في
employee.*لتتلقى التعيينات التي تجري في جديرون (employee.created) وتغييرات الملف التي يجريها الموظفون بأنفسهم.
قواعد تستحق المعرفة
- لا تحذف الواجهة البرمجية أي شخص نهائيًا أبدًا؛ أرشفه بـ
POST /api/v1/employees/{id}/archive. - الراتب ليس جزءًا من كائن الموظف.
- الوظيفة المكتملة السعة ترفض موظفًا إضافيًا (
409 conflict،position_full).