قائمة طلبات الموظفين — مرجع واجهة البرمجة API
GET /requests — صندوق الطلبات: كل طلب قدّمه موظف مع نوعه وحالته والقيم المُدخلة في النموذج.
المعاملات
-
updated_since
الصفوف التي تغيّرت منذ هذا الوقت بصيغة ISO-8601 فقط. استخدم meta.server_time من التشغيل السابق ناقص دقيقتين. بدون فرق توقيت يُقرأ بتوقيت الرياض.
-
pagination
أرسل cursor للتصفح بالمؤشر (موصى به لكل مزامنة).
-
cursor
قيمة meta.next_cursor من الصفحة السابقة. القيمة null تعني آخر صفحة.
-
per_page
عدد الصفوف في الصفحة. الافتراضي 50 والحد الأقصى 200.
-
include_deleted
أعد الصفوف المحذوفة أيضاً (يكون deleted_at معبّأً) لتحذفها من نظامك.
-
employee_id
هذا الموظف فقط.
-
status
0 قيد الانتظار، 1 معتمد، 2 مرفوض، 3 ملغى.
-
type
رمز نوع الطلب.
صفحات أخرى في المرجع
-
حضور موظف واحد
GET /reports/attendance/v1/oneEmployee — تقرير الحضور الكامل لموظف واحد بين تاريخين: كل تسجيل دخول وخروج، التأخير، الخروج المبكر، الوقت الإضافي، الغياب وأيام الإجازة.
-
حضور جميع الموظفين
GET /reports/attendance/v1/list — تقرير الحضور لجميع الموظفين النشطين، أو لفرع أو قسم واحد، صفحة بصفحة. يحمل كل موظف إجماليات الفترة والصفوف اليومية.
-
ملف الموظف
GET /employees/v1/profile/{employee_id} — ملف موظف واحد: الاسم والجوال والمسمى الوظيفي وتاريخ الالتحاق والفرع والقسم، مع البيانات الشخصية كالجنسية وتاريخ الميلاد ونهاية العقد.
-
إضافة موظف جديد
POST /employees/create — يضيف موظفاً مع بنود راتبه وفرعه وقسمه. تصل الموظف دعوة تحميل تطبيق بصمتك برسالة نصية.
-
أنواع بنود الراتب
معرّفات الأنواع التي تُرسل في مصفوفة salaries عند إضافة موظف.
-
اختبار الاتصال
GET /ping — يتحقق من مفتاح API ويعيد الحساب التابع له وصلاحياته وقيود الفروع والأقسام. استخدمه لزر «اختبار الاتصال».
-
قائمة الموظفين
GET /employees — موظفو الحساب صفحة بصفحة مع المزامنة التزايدية. يعيد GET /employees/{id} موظفاً واحداً بالشكل نفسه.
-
إنشاء موظف أو تحديثه
POST /employees — ينشئ موظفاً، أو يحدّث الموظف المطابق لـ external_id، فلا يتكرر الموظف عند إعادة الطلب. يحدّث PATCH /employees/{id} بمعرّف بصمتك وبالحقول نفسها.
-
قائمة الأقسام والفروع
GET /departments — أقسام الحساب. يعيد GET /locations الفروع بالطريقة نفسها، ويقبل كلاهما /{id} لصف واحد.
-
قائمة سجلات الحضور
GET /attendance — صف لكل موظف لكل وردية في اليوم، مع وقتي الدخول والخروج وساعات العمل والتأخير والخروج المبكر والوقت الإضافي.
-
كتابة الدخول والخروج
POST /attendance — ينشئ سجل حضور اليوم أو يصحّح الموجود. يُعاد حساب التأخير والخروج المبكر والإضافي حسب وردية الموظف. يصحّح PATCH /attendance/{id} سجلاً بمعرّفه.
-
قائمة أيام الغياب
GET /absences — صف لكل يوم وردية بدون تسجيل دخول: الغياب بدون عذر وأيام الراحة وأيام الإجازة المعتمدة.
-
قائمة الإجازات
GET /leave — طلبات الإجازة مع نوعها وتواريخها وأيامها وحالتها. يعيد GET /leave/grants الإجازات التي سجّلتها الموارد البشرية مباشرة بالشكل نفسه.
-
أرصدة الإجازات
GET /leave/balances — رصيد الإجازة السنوية لكل موظف محسوباً كما يظهر في ملف الموظف، مع صافي الأيام لكل نوع إجازة.
-
قائمة مسيرات الرواتب
GET /payrolls — مسيرات الرواتب مع فترتها وحالتها وأوقات الرفع والاعتماد والدفع.
-
قائمة قسائم الرواتب
GET /payslips — قسيمة لكل موظف في كل مسير: الأساسي والسكن والإضافات والاستقطاعات والصافي.
-
الاشتراك في الإشعارات اللحظية
POST /webhooks — يسجّل رابطاً يستدعيه بصمتك عند تغيّر موظف أو سجل حضور أو إجازة أو مسير رواتب. يُعاد سر التوقيع مرة واحدة.