اربط نظامك مع نظام الموارد البشرية عبر API آمن

واجهات API جاهزة لربط الأنظمة المحاسبية وأنظمة الرواتب والتقارير مع بيانات الموظفين، السندات، النفقات، والرواتب. كل توكن مرتبط بشركة ومستأجر محدد لضمان عزل البيانات بالكامل.

ابدأ الربط عرض المسارات

مثال طلب سريع

استخدم Bearer Token الصادر من لوحة التحكم.

curl -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Accept: application/json" \ https://hr.almutawir.sa/api/v1/hr/employees

طريقة الربط في 4 خطوات

كل مستأجر ينشئ توكن خاص به من لوحة التحكم، ثم يستخدمه في نظامه الخارجي.

1. إنشاء التوكن

ادخل لوحة التحكم
افتح صفحة تكامل API
اختر الصلاحيات المطلوبة
انسخ التوكن فورًا لأنه يظهر مرة واحدة فقط

2. المصادقة

أرسل التوكن داخل Header
الصيغة: Authorization: Bearer TOKEN
كل توكن مرتبط بشركة ومستأجر
يمكن إيقاف التوكن أو إعادة توليده

3. سحب البيانات

سحب بيانات الموظفين
سحب السندات العامة وسندات الموظفين
سحب النفقات والرواتب
استخدام الفلاتر والتقسيم الصفحي

4. دمج النظام الخارجي

ربط النظام المحاسبي
إعداد مزامنة دورية
معالجة صفحات النتائج
تسجيل آخر مزامنة

لا تضع التوكن داخل الواجهة الأمامية أو JavaScript عام. يجب استخدامه من الخادم الخلفي فقط.

المصادقة Authentication

كل الطلبات المحمية تحتاج Header باسم Authorization.

Authorization: Bearer YOUR_API_TOKEN
Accept: application/json

curl -s \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json" \
"https://hr.almutawir.sa/api/v1/company"

مسارات API المتاحة

المسارات التالية جاهزة للربط مع الأنظمة الخارجية.

الطريقة	المسار	الوصف	أهم الفلاتر
GET	/api/v1/health	اختبار حالة API	-
GET	/api/v1/company	بيانات الشركة/المستأجر المرتبطة بالتوكن	-
GET	/api/v1/hr/employees	قائمة الموظفين	search, status, department, iqama_expiring, iqama_expired, per_page
GET	/api/v1/hr/employees/{id}	تفاصيل موظف مع مستنداته	-
GET	/api/v1/accounting/summary	ملخص مالي وتشغيلي	-
GET	/api/v1/accounting/vouchers	السندات العامة وسندات الموظفين	party_type, type, status, from, to, per_page
GET	/api/v1/accounting/expenses	النفقات	status, category, from, to, per_page
GET	/api/v1/accounting/payrolls	مسيرات الرواتب	status, month, per_page

أهم المتغيرات والحقول

هذه أكثر الحقول استخدامًا عند الربط مع الأنظمة المحاسبية وأنظمة الموارد البشرية.

الموظفون

id: رقم الموظف الداخلي
employee_no: رقم الموظف
full_name: اسم الموظف
iqama_number: رقم الإقامة
iqama_expiry_date: تاريخ انتهاء الإقامة
job_title: المسمى الوظيفي
department: القسم
status: حالة الموظف

السندات

voucher_no: رقم السند
type: receipt أو payment
party_type: general أو employee
amount: مبلغ السند
voucher_date: تاريخ السند
status: حالة السند
payment_method: طريقة الدفع

النفقات

expense_number: رقم النفقة
title: عنوان النفقة
category: التصنيف
amount: المبلغ
expense_date: تاريخ النفقة
status: pending أو approved أو rejected
vendor_name: المورد

الرواتب

month: شهر المسير
title: عنوان المسير
status: draft أو approved أو paid
total_amount: إجمالي المسير
payment_date: تاريخ الدفع
items: بنود الموظفين داخل المسير

أمثلة عملية

نماذج جاهزة يمكن لفريق التقنية استخدامها مباشرة.

سحب أول 10 موظفين

curl -s \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json" \
"https://hr.almutawir.sa/api/v1/hr/employees?per_page=10"

بحث عن موظف

curl -s \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json" \
"https://hr.almutawir.sa/api/v1/hr/employees?search=محمد"

سندات الموظفين المعتمدة

curl -s \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json" \
"https://hr.almutawir.sa/api/v1/accounting/vouchers?party_type=employee&status=approved"

ملخص محاسبي

curl -s \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json" \
"https://hr.almutawir.sa/api/v1/accounting/summary"

شكل الاستجابة

كل الاستجابات ترجع بصيغة JSON لتسهيل الربط.

{
  "success": true,
  "data": {
    "current_page": 1,
    "data": [
      {
        "id": 68,
        "employee_no": "EMP-001",
        "full_name": "اسم الموظف",
        "iqama_number": "0000000000",
        "job_title": "محاسب",
        "department": "المالية",
        "status": "active"
      }
    ],
    "per_page": 10,
    "total": 1
  }
}

جميع النتائج تكون معزولة حسب الشركة أو المستأجر المرتبط بالتوكن. النظام الخارجي لا يستطيع الوصول لبيانات شركة أخرى.