فتح الشواغر: طرح وظيفة للتوظيف. الشاغر جولة توظيف واحدة على وظيفة (مقعد)، لها مسار طلبات خاص بها.
الموارد
| المورد | الواجهة البرمجية | الصفحات |
|---|---|---|
| الشواغر | قراءة، وفتح (إنشاء)، وإغلاق | الشواغر |
| الوظائف | المقعد الذي عليه الشاغر؛ وتتبع حقول التوظيف فيه الشاغر | الوظائف |
المسار المعتاد
- افتح وظيفة للتوظيف:
POST /api/v1/openingsمع{ "position": { "externalSystem": "oracle-hcm", "externalId": "POS-2207" }, "hiringPathway": "INTERNAL_FIRST" }. - ينشره جديرون في صفحة الوظائف حسب مساره (داخليًا أولًا ثم خارجيًا، أو خارجيًا مباشرةً).
- أغلقه بـ
POST /api/v1/openings/{id}/closeعند شغل المقعد أو إلغائه. - اشترك في
opening.*(وفيposition.updated، الذي يُطلق أيضًا عند فتح التوظيف أو إغلاقه).
قواعد تستحق المعرفة
- الفتح والإغلاق يتطلبان
recruitment.hiring.open، كما في التطبيق. - لا يمكن فتح شاغر ثانٍ لوظيفة لها شاغر
OPEN(409 conflict،already_open). - لا يمكن فتح وظيفة مؤرشفة (
409 conflict،position_archived). - أرشفة الوظيفة تغلق توظيفها وشواغرها المفتوحة.