حضور موظف واحد — مرجع واجهة البرمجة API
GET /reports/attendance/v1/oneEmployee — تقرير الحضور الكامل لموظف واحد بين تاريخين: كل تسجيل دخول وخروج، التأخير، الخروج المبكر، الوقت الإضافي، الغياب وأيام الإجازة.
المعاملات
-
employee_id (مطلوب)
معرّف الموظف في بصمتك.
-
from (مطلوب)
أول يوم في التقرير (YYYY-MM-DD).
-
to (مطلوب)
آخر يوم في التقرير، مشمولاً (YYYY-MM-DD).
ملاحظات
- تجمع report نوعين من الصفوف مرتبة حسب اليوم. الصف الذي فيه checkin سجل حضور. والصف الذي فيه value بدون checkin صف غياب: status بقيمة 0 غياب بدون عذر، 1 يوم راحة، 2 يوم إجازة.
- late و early و overtime و work_hrs بالدقائق. type ترتيب الوردية في اليوم (1 للوردية الأولى). checkin_org و checkout_org الوقت الدقيق بنظام 24 ساعة.
- الإجماليات في employee تغطي الفترة المطلوبة. يحتاج الرمز صلاحية قراءة التقارير وأن يكون مسموحاً له برؤية فرع الموظف وقسمه.
صفحات أخرى في المرجع
-
حضور جميع الموظفين
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 /requests — صندوق الطلبات: كل طلب قدّمه موظف مع نوعه وحالته والقيم المُدخلة في النموذج.
-
قائمة مسيرات الرواتب
GET /payrolls — مسيرات الرواتب مع فترتها وحالتها وأوقات الرفع والاعتماد والدفع.
-
قائمة قسائم الرواتب
GET /payslips — قسيمة لكل موظف في كل مسير: الأساسي والسكن والإضافات والاستقطاعات والصافي.
-
الاشتراك في الإشعارات اللحظية
POST /webhooks — يسجّل رابطاً يستدعيه بصمتك عند تغيّر موظف أو سجل حضور أو إجازة أو مسير رواتب. يُعاد سر التوقيع مرة واحدة.