دليل تكامل منصة قوى مع أنظمة الموارد البشرية 2026

في الخامس عشر من أبريل 2026، أصدرت وزارة الموارد البشرية والتنمية الاجتماعية قراراً واحداً غيّر المعادلة على كل فريق موارد بشرية في القطاع الخاص: لن يُحتسب أي موظف سعودي في نسبة السعودة ما لم يكن عقده موثقاً إلكترونياً في منصة قوى.

هذا يعني أن نطاقاتك — وكل ما يتوقف عليها من تصاريح عمل وخدمات حكومية — باتت رهينة بمدى قدرة نظامك على التكلم مع منصة قوى.

هذا الدليل يشرح المستويات الثلاثة للتكامل، وتدفق البيانات بين قوى ومدد والتأمينات الاجتماعية ومقيم، وأكثر الأخطاء التقنية شيوعاً التي تُفشل توثيق العقود.

لماذا لم يعد تكامل قوى اختيارياً في 2026

منصة قوى، التي تشغّلها شركة تكامل القابضة تحت مظلة وزارة الموارد البشرية، هي البوابة الرقمية المركزية لسوق العمل السعودي. وإن كانت تُدير عقود العمل وتصاريح العمل وتتبّع السعودة منذ سنوات، فإن أبريل 2026 جعلها المرجع الوحيد لحسابات نطاقات.

الجدول الزمني للامتثال:

• 15 أبريل 2026 — انتهى العمل بالتسجيل في التأمينات الاجتماعية وحده معياراً للسعودة
• 30 أبريل 2026 — يجب توثيق 85% من عقود السعوديين إلكترونياً في قوى
• 30 يونيو 2026 — ترتفع النسبة المطلوبة إلى 90%

الإخفاق في هذه المواعيد يُفضي إلى سلسلة من التداعيات: تراجع فئة النطاق، وتجميد حصص العمالة الوافدة، ووقف إصدار تأشيرات العمل، والحرمان من المناقصات الحكومية، وغرامات إدارية من الوزارة.

الإدخال اليدوي عبر البوابة يؤدي الغرض لمنشأة صغيرة. لكن أي جهة تتجاوز خمسين موظفاً، يصبح التكامل التلقائي هو الطريق الوحيد للاستدامة.

منظومة المنصات الحكومية المترابطة

منصة قوى لا تعمل بمعزل عن غيرها. فهم المنظومة كاملة يمنع تعارض البيانات الذي يُسقط الامتثال في صمت:

القاعدة الذهبية: رقم الراتب في عقد قوى يجب أن يطابق تماماً ما يُحوَّل إلى مدد. فارق ريال واحد يُولّد تنبيه امتثال، ويُفقد الموظف السعودي احتسابه في السعودة لحين حل المشكلة.

المستويات الثلاثة للتكامل

المستوى الأول — البوابة مباشرة (يدوي)

فريق الموارد البشرية يدخل إلى qiwa.sa ويُنشئ العقود ويتابع الحالة يدوياً. صفر تكلفة تقنية، لكن وقت المعالجة يتضاعف مع كل موظف إضافي. صالح فقط لأقل من عشرين موظفاً.

المستوى الثاني — إضافة لنظام ERP

موردو برامج الموارد البشرية المعتمدون (SAP SuccessFactors، Oracle HCM، Zoho People، PalmHR، DocSuite) يوفرون موصلات جاهزة لقوى. الموصل يتولى المصادقة وتنسيق العقود ومزامنة الحالة داخل واجهة نظام الموارد البشرية الحالي. هذا هو أسرع طريق للأتمتة لمن يعمل بالفعل على منظومة موارد بشرية كبرى.

المستوى الثالث — REST API مباشر

للأنظمة المبنية خصيصاً أو أنظمة ERP المحلية أو العمليات التي لا تخدمها الموصلات الجاهزة، التكامل المباشر عبر REST API يمنحك تحكماً كاملاً. وهذا ما يُفصّله هذا الدليل.

تكامل REST API: السير العملي

المتطلبات الأساسية

قبل أول استدعاء للـ API تحتاج إلى:

1. سجل تجاري (CR) نشط ومرتبط بحساب المنشأة في قوى
2. شهادة رقمية من تكامل القابضة — تُصادق نظامك لدى واجهة API قوى (مستقلة عن نفاذ وأبشر)
3. مفوّض مرخّص مسجّل في حساب قوى أعمال
4. بيئة اختبار — قوى توفر بيئة sandbox لاختبار التكامل قبل الإنتاج

تدفق المصادقة

قوى تستخدم OAuth 2.0 بأسلوب client credentials. نظامك يحصل على رمز bearer باستخدام الشهادة الرقمية، ثم يُدرجه في كل استدعاء:

const getQiwaToken = async () => {
  const response = await fetch('https://api.qiwa.sa/oauth/token', {
    method: 'POST',
    headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
    body: new URLSearchParams({
      grant_type: 'client_credentials',
      client_id: process.env.QIWA_CLIENT_ID,
      client_secret: process.env.QIWA_CLIENT_SECRET,
    }),
  });
  const data = await response.json();
  return data.access_token;
};

توليد العقد وإرساله

سير العمل الأساسي عند توظيف موظف جديد:

const submitContract = async (token: string, contractData: ContractPayload) => {
  const response = await fetch('https://api.qiwa.sa/v1/contracts', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${token}`,
      'Content-Type': 'application/json',
      'X-Establishment-ID': process.env.QIWA_ESTABLISHMENT_ID,
    },
    body: JSON.stringify({
      employee_national_id: contractData.nationalId,
      monthly_salary: contractData.salary,
      job_title: contractData.jobTitle,
      contract_start_date: contractData.startDate,
      contract_duration_months: contractData.durationMonths,
      work_location: contractData.workLocation,
    }),
  });
  return response.json();
};

بعد الإرسال، يدخل العقد حالة انتظار قبول الموظف. يجب على الموظف السعودي الدخول إلى حساب قوى أفراد وقبول العقد رقمياً قبل أن يُحتسب في السعودة. نظامك يحتاج إلى استطلاع حالة العقد دورياً أو الاشتراك في أحداث webhook لمتابعة هذه الخطوة.

استطلاع حالة النطاقات

const getNitaqatStatus = async (token: string) => {
  const response = await fetch('https://api.qiwa.sa/v1/establishment/nitaqat', {
    headers: { 'Authorization': `Bearer ${token}` },
  });
  const data = await response.json();
  return {
    band: data.nitaqat_band,         // بلاتيني | أخضر مرتفع | أخضر متوسط | أخضر منخفض | أحمر
    saudizationRate: data.saudi_percentage,
    pendingContracts: data.pending_authentication_count,
  };
};

استطلاع هذه البيانات أسبوعياً، أو عند تغيّر حالة العقود، يمنح لوحة الموارد البشرية لديك صورة حية عن النطاقات دون الحاجة إلى الدخول اليدوي للمنصة.

الأخطاء الأكثر شيوعاً وكيفية تفاديها

1. تعارض الراتب بين قوى ومدد السبب الأكثر شيوعاً لفقدان احتساب السعودة. يجب أن يكون الراتب الشهري الإجمالي في عقد قوى مطابقاً تماماً لما ستعالجه مدد. البدلات والخصومات والمكافآت يجب أن تتطابق مع إعدادات الرواتب بدقة.

2. انتهاء مهلة قبول الموظف قوى تشترط قبول الموظف للعقد — لا يمكن للمنشأة تجاوز هذه الخطوة. العقود التي تبقى معلقة أكثر من ثلاثين يوماً تُلغى عادةً. أتمت إرسال تذكيرات للموظفين (واتساب أو SMS) بعد سبعة أيام وأربعة عشر يوماً من الإرسال.

3. المنشآت المتعددة الشركات التي تمتلك أكثر من سجل تجاري تدير حسابات قوى أعمال منفصلة لكل منشأة. يجب على التكامل توجيه كل عقد إلى معرف المنشأة الصحيح، وإلا تشتّتت حسابات النطاقات عبر كيانات غير مترابطة.

4. فشل شرط تصريح العمل عقود الموظفين الوافدين المُرسلة قبل تفعيل الإقامة أو تصريح العمل في نظام مقيم ستُرفض. أضف فحص حالة مقيم قبل إرسال عقود غير السعوديين.

ربط المنظومة: مزامنة مدد والتأمينات الاجتماعية

بمجرد قبول العقد في قوى، يجب أن يُطلق تكاملك إجراءات تلقائية:

1. دفع بيانات الراتب إلى مدد لتفعيل تغطية حماية الأجور
2. تسجيل الموظف في التأمينات الاجتماعية لحسم الاشتراكات
3. للوافدين، التحقق من حداثة وضع الإقامة في مقيم

التكامل الناجح يُعالج الثلاثة في سير عمل موحد لكل موظف جديد بدلاً من ثلاث مهام يدوية منفصلة. دليل امتثال حماية الأجور (WPS) يُغطي الجانب التقني لمدد بالتفصيل.

للشركات التي تُدير أيضاً الفوترة الإلكترونية مع زاتكا إلى جانب امتثال الموارد البشرية، دليل تكامل الفاتورة الإلكترونية السعودي يُغطي منظومة API الموازية.

ما يوفّره التكامل التلقائي

إدارة قوى يدوياً لشركة من مئتي موظف تستهلك عادةً ما بين خمس عشرة وعشرين ساعة شهرياً من وقت فريق الموارد البشرية: إدخال عقود، ومتابعة حالات، ومطاردة قبول الموظفين، وتصدير تقارير النطاقات. تكامل REST API يُخفّض هذا الوقت إلى أقل من ساعتين — مراقبة استثنائية لا معالجة روتينية.

تكلفة أتمتة سير العمل في السوق السعودي تتبع النمط ذاته عبر كل منصة حكومية: تكلفة التكامل تُسترد في الربع الأول.

هل نظامك جاهز للتكامل مع قوى؟

إن كان فريقك ما زال يدخل عقود قوى يدوياً، فإن نسبة 90% المستهدفة في يونيو 2026 هي آخر تحذير قبل أن تصبح الغرامات منهجية. فئة النطاقات تحمي قدرتك على توظيف الكفاءات الأجنبية والمشاركة في المناقصات وتجديد إقامات الموظفين.

فريقنا بنى تكاملات قوى مع SAP وOracle وأنظمة ERP مخصصة في السوق السعودي. إن أردت تشخيص فجوة الامتثال لديك وخارطة طريق للتكامل، ابدأ المحادثة هنا.