saudi-hr

name	saudi-hr
description	واجهات الموارد البشرية والتوظيف السعودية -- مصدر ومدد وقوى ومساند
version	1.0.0
author	Mousa Abu Mazin
license	MIT
platforms	["linux","macos"]
prerequisites	{"commands":["curl"],"env_vars":["MASDR_TOKEN","QIWA_TOKEN","MUSANED_TOKEN","BANK_WPS_TOKEN"]}
metadata	{"hermes":{"tags":["saudi","hr","employment","masdr","mudad","qiwa","musaned","gosi","wps"]}}

الموارد البشرية والتوظيف في السعودية

تنبيه: استخدم بيانات اختبار فقط. لا تستخدم هويات وطنية حقيقية أو توكنات دفع حية أثناء التجربة. استخدم بيئة الاختبار (sandbox) دائماً. احذف السجلات بعد الانتهاء.

دليل التكامل مع منصات التوظيف والموارد البشرية الحكومية في المملكة العربية السعودية.

---

نظرة عامة على المنصات

المنصة	الجهة	الوظيفة الرئيسية	المستخدمون
مصدر (Masdr)	التأمينات الاجتماعية (GOSI)	التحقق من التوظيف والرواتب	الشركات والبنوك
مدد (Mudad)	وزارة الموارد البشرية	حماية الأجور (WPS)	أصحاب العمل والبنوك
قوى (Qiwa)	وزارة الموارد البشرية	إدارة القوى العاملة	14.5 مليون مستخدم
مساند (Musaned)	وزارة الموارد البشرية	استقدام العمالة المنزلية	الأفراد ومكاتب الاستقدام

---

مصدر (Masdr by GOSI)

بوابة المطورين: https://portal.masdr.sa

مصدر هي منصة التأمينات الاجتماعية لتوفير خدمات التحقق من بيانات التوظيف والرواتب.

الخدمات المتاحة

1. مُفيد -- الاستعلام عن الفرد (Mufeed - Individual)

الاستعلام عن بيانات التوظيف والتأمينات لشخص محدد.

curl -X POST "https://api.masdr.sa/v1/mufeed/individual" \
  -H "Authorization: Bearer ${MASDR_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "idNumber": "1000000000",
    "idType": "NIN"
  }'

الاستجابة تشمل: حالة التوظيف، اسم صاحب العمل، تاريخ الالتحاق، الراتب المسجل.

2. مُفيد -- الاستعلام عن المنشأة (Mufeed - Establishment)

curl -X POST "https://api.masdr.sa/v1/mufeed/establishment" \
  -H "Authorization: Bearer ${MASDR_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "establishmentNumber": "700000000"
  }'

الاستجابة تشمل: بيانات المنشأة، عدد الموظفين، حالة الاشتراك.

3. أكيد -- التحقق من التوظيف والراتب (Akeed)

curl -X POST "https://api.masdr.sa/v1/akeed/verify" \
  -H "Authorization: Bearer ${MASDR_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "idNumber": "1000000000",
    "employerNumber": "700000000",
    "salaryRange": {
      "min": 5000,
      "max": 15000
    }
  }'

الاستجابة: تأكيد أو نفي (true/false) دون كشف البيانات الفعلية.

4. أملي -- مزامنة الموارد البشرية (Amaly)

مزامنة بيانات الموارد البشرية بين أنظمة الشركات والتأمينات الاجتماعية.

curl -X POST "https://api.masdr.sa/v1/amaly/sync" \
  -H "Authorization: Bearer ${MASDR_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "establishmentNumber": "700000000",
    "employees": [
      {
        "idNumber": "1000000000",
        "salary": 8000,
        "startDate": "2024-01-01"
      }
    ]
  }'

---

بديل في حال عدم توفر الخدمة

إذا كانت واجهة مسدر غير متاحة، تحقق من حالة الخدمة عبر البوابة: masdr.gosi.gov.sa

مدد (Mudad) -- حماية الأجور

نظام حماية الأجور (WPS) الذي يضمن دفع الرواتب في موعدها.

آلية العمل

1. صاحب العمل يرفع ملف الرواتب عبر مدد
2. البنك يستلم الطلب عبر WPS API
3. يتم تحويل الرواتب وإبلاغ وزارة الموارد البشرية

WPS API (مثال: البنك العربي الوطني)

بوابة المطورين: https://developer.anb.com.sa/apis/api/WPS

curl -X POST "https://api.anb.com.sa/wps/v1/salary-file" \
  -H "Authorization: Bearer ${BANK_WPS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "employerId": "700000000",
    "month": "2025-03",
    "totalAmount": 150000,
    "employeeCount": 15,
    "payments": [
      {
        "employeeId": "1000000000",
        "bankCode": "10",
        "iban": "SA0000000000000000000000",
        "amount": 10000
      }
    ]
  }'

---

قوى (Qiwa) -- إدارة القوى العاملة

الموقع: https://qiwa.sa

منصة شاملة لإدارة القوى العاملة تخدم أكثر من 14.5 مليون مستخدم.

الخدمات الرئيسية

• التأشيرات: إصدار وإدارة تأشيرات العمل
• العقود: إدارة عقود العمل الإلكترونية
• نقل الخدمات: نقل الكفالة بين المنشآت
• تغيير المهنة: تعديل المسمى الوظيفي
• نطاقات: متابعة تصنيف المنشأة في برنامج نطاقات

مثال: الاستعلام عن عقد عمل

curl -X GET "https://api.qiwa.sa/v1/contracts/{contractId}" \
  -H "Authorization: Bearer ${QIWA_TOKEN}" \
  -H "Content-Type: application/json"

---

مساند (Musaned) -- استقدام العمالة المنزلية

الموقع: https://musaned.com.sa

الخدمات

• طلب استقدام عمالة منزلية
• متابعة حالة الطلب
• التعاقد مع مكاتب الاستقدام
• إدارة عقود العمالة المنزلية

curl -X GET "https://api.musaned.com.sa/v1/requests/{requestId}" \
  -H "Authorization: Bearer ${MUSANED_TOKEN}" \
  -H "Content-Type: application/json"

---

عرض النتيجة

نتيجة الاستعلام
المنصة: {{ platform }}
النوع: {{ queryType }}
الحالة: {{ status }}
التفاصيل: {{ details }}

---

متى تستخدم

استخدم هذه المهارة عندما يسأل المستخدم عن:

• التحقق من التوظيف أو الراتب في السعودية
• بيانات التأمينات الاجتماعية (GOSI) أو مصدر (Masdr)
• نظام حماية الأجور (WPS) أو مدد (Mudad)
• إدارة القوى العاملة أو قوى (Qiwa)
• استقدام العمالة المنزلية أو مساند (Musaned)
• نطاقات أو عقود العمل الإلكترونية
• Saudi employment verification or payroll APIs

---

المراجع

• بوابة مصدر: https://portal.masdr.sa
• مدد: https://mudad.com.sa
• قوى: https://qiwa.sa
• مساند: https://musaned.com.sa
• ANB WPS API: https://developer.anb.com.sa/apis/api/WPS
• التأمينات الاجتماعية: https://www.gosi.gov.sa