الربط مع منصة إيجار: ما تُخطئ فيه أنظمة إدارة الأملاك

ابحث عن «الربط مع منصة إيجار API» وستجد مقالات تسرد نقاط نهاية أنيقة: POST /contracts/register وGET /contracts/{ref}/payments وPOST /disputes/file. تبدو كأنها توثيق رسمي. وهي لا تستشهد بأي مصدر، لأنه لا يوجد مصدر عام تستشهد به أصلاً.

شبكة إيجار — الشبكة الإلكترونية التي تنظّم كل عقد إيجار في المملكة — لا تنشر بوابة مطورين. لا صفحة تسجيل، ولا مفتاح تجريبي، ولا ملف OpenAPI تُنزّله بعد الظهر. حساب المنصة الرسمي يجيب عن السؤال مباشرة: من يرغب في الربط بين إيجار ومنصة أخرى عبر API، يُراسل keyaccounts@nhc.sa. هذا هو المسار المنشور بأكمله.

الأمر أهم مما يبدو. إن كنت تبني أو تشتري نظام إدارة أملاك للسوق السعودي، فإن نموذج الوصول هو ما يُشكّل المعمارية، لا العكس. الفرق التي تفترض «سنستدعي الـ API ببساطة» تبني نظاماً ينهار افتراضه الأساسي عند مراجعة العقد، بعد ستة أشهر من البدء.

الحجم الذي يجعل هذا سوقاً حقيقياً

سجّلت شبكة إيجار أكثر من 10 ملايين عقد إيجاري منذ إطلاقها، بمعدل يومي يقارب 19 ألف عقد. التوزيع: 8.3 ملايين عقد سكني (82.3%) مقابل 1.7 مليون عقد تجاري (17.6%). ومنذ بداية 2024 وحدها وُثّق أكثر من 1.5 مليون عقد — منها 1.2 مليون سكني و283 ألف تجاري.

هذه هي الأرقام التي يبيع مقابلها مزوّد نظام إدارة الأملاك. محفظة من 500 وحدة تُولّد نحو 40 تسجيلاً و30 تجديداً شهرياً، كل واحد منها جلسة متعددة الخطوات على البوابة ينفّذها موظف يدوياً — بينما البيانات نفسها موجودة أصلاً في نظام الشركة. العمل حقيقي. السؤال الوحيد هو كيف تربطه.

لا توجد واجهة عامة لإيجار — صمّم على هذا الأساس

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

تترتب على ذلك ثلاث نتائج، كل واحدة منها قرار معماري:

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

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

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

الموقف التخطيطي الصادق: افترض من 8 إلى 16 أسبوعاً بين أول تواصل وبين بيانات اعتماد عاملة، وابنِ النظام بحيث يُقدّم قيمة مع وجود إنسان في الحلقة طوال تلك المدة.

القاعدة التصميمية: إيجار هي السجل المرجعي

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

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

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

type LeaseState =
  | { kind: "draft"; localId: string }
  | { kind: "submitted"; localId: string; submittedAt: Date }
  | { kind: "awaiting_parties"; localId: string; ejarRef: string }
  | { kind: "registered"; localId: string; ejarRef: string; startsOn: Date; endsOn: Date }
  | { kind: "terminated"; localId: string; ejarRef: string; terminatedOn: Date };
 
function canIssueRentInvoice(lease: LeaseState): boolean {
  // العقد المسجّل في إيجار وحده هو أداة قانونية قابلة للفوترة.
  return lease.kind === "registered";
}

حالة awaiting_parties هي التي تنساها الفرق. التسجيل ليس استدعاءً ذرياً واحداً — يُدخل العقد، ثم تصل رسائل SMS للمؤجر والمستأجر ليطّلعا عليه ويوثّقاه إلكترونياً، وعندها فقط يكتمل التوثيق. آلة الحالات لديك يجب أن تصمد أمام عقد يبقى معلّقاً أياماً لأن مستأجراً لم يفتح رسالة نصية. اجعلها حالة صريحة، واعرضها في الواجهة، وامنح فريق العمليات إجراء تذكير. لا تُخفِها خلف مؤشر تحميل.

أنظمة 2026 التي تكسر منطق التجديد لديك

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

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

الإيجار في الرياض مجمّد. بدأ تجميد لخمس سنوات على أسعار الإيجار السكنية والتجارية داخل النطاق العمراني لمدينة الرياض اعتباراً من 25 سبتمبر 2025 ويمتد حتى 24 سبتمبر 2030. القيمة الإيجارية السارية في ذلك التاريخ مُلزمة للعقود الجديدة والقائمة معاً. شروط الزيادة الموجودة في عقود قائمة بتاريخ 25 سبتمبر 2025 تبقى نافذة؛ أما العقود المبرمة بعد ذلك التاريخ فلا يجوز أن تتضمن زيادات تصاعدية خلال فترة التجميد. ولا يجوز أن تتجاوز قيمة الإيجار من الباطن قيمة العقد الأصلي. ولمجلس إدارة الهيئة العامة للعقار توسيع الإجراءات لمدن أخرى بموافقة مجلس الشؤون الاقتصادية والتنمية — لذا فترميز «الرياض» كحالة خاصة داخل الشيفرة فخ صيانة. اجعلها جدول سياسات مفهرساً بالمنطقة مع نطاق تاريخ سريان.

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

والعقوبات ليست رمزية. مخالفات أنظمة التجميد والتجديد تصل غراماتها إلى ما يعادل أجرة اثني عشر شهراً للعقار، إضافة إلى إلزام بالتصحيح وتعويض المتضررين، مع مهلة اعتراض مدتها 30 يوماً. وبشكل منفصل، منشأة الوساطة التي لا توثّق العقود تواجه — بحسب نظام مكاتب العقار — غرامة تصل إلى 25,000 ريال، أو إغلاق المكتب مدة لا تتجاوز سنة، أو إلغاء الترخيص. وهناك حافز للمُبلّغين: يحصل المُبلّغ على ما يصل إلى 20% من الغرامات المُحصّلة. أي أن المستأجر السابق الغاضب لدى عميلك لديه سبب مالي للإبلاغ عن تجديد مخالف.

هذا هو شكل القاعدة التي يحتاجها المجدول فعلياً:

interface RenewalPolicy {
  region: string;              // "riyadh_urban", "makkah", ...
  effectiveFrom: Date;
  effectiveTo: Date | null;
  escalationAllowed: boolean;  // false داخل نافذة تجميد الإيجار
  noticeDays: number;          // 60 يوماً على مستوى المملكة اليوم
}
 
function renewalNoticeDeadline(endsOn: Date, policy: RenewalPolicy): Date {
  const d = new Date(endsOn);
  d.setDate(d.getDate() - policy.noticeDays);
  return d;   // نبّه العمليات هنا، لا في تاريخ الانتهاء
}

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

ثلاثة سجلات، دفعة إيجار واحدة

هنا يقع عمل التكامل الحقيقي، وهو الجزء الذي تتجاوزه عروض المزوّدين.

شهر إيجار واحد لوحدة واحدة يوجد في ثلاثة أنظمة منفصلة لا يتحدث بعضها إلى بعض:

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

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

المطابقة الليلية هنا ليست ميزة إضافية. هي المنتج نفسه:

type Drift =
  | { code: "contract_without_invoice"; ejarRef: string; period: string }
  | { code: "invoice_without_contract"; invoiceId: string }
  | { code: "invoice_on_terminated_lease"; invoiceId: string; ejarRef: string }
  | { code: "cash_unapplied"; paymentRef: string; amountHalalas: number }
  | { code: "amount_mismatch"; ejarRef: string; contractHalalas: number; invoicedHalalas: number };
 
function reconcile(
  contracts: RegisteredContract[],
  invoices: TaxInvoice[],
  payments: BankPayment[]
): Drift[] {
  const byRef = new Map(contracts.map((c) => [c.ejarRef, c]));
  const drifts: Drift[] = [];
 
  for (const inv of invoices) {
    const contract = inv.ejarRef ? byRef.get(inv.ejarRef) : undefined;
    if (!contract) {
      drifts.push({ code: "invoice_without_contract", invoiceId: inv.id });
      continue;
    }
    if (contract.terminatedOn && inv.issuedOn > contract.terminatedOn) {
      drifts.push({ code: "invoice_on_terminated_lease", invoiceId: inv.id, ejarRef: contract.ejarRef });
    }
    // قارن بالهللات. لا بالأعداد العشرية أبداً.
    if (inv.totalExVatHalalas !== contract.periodRentHalalas) {
      drifts.push({
        code: "amount_mismatch",
        ejarRef: contract.ejarRef,
        contractHalalas: contract.periodRentHalalas,
        invoicedHalalas: inv.totalExVatHalalas,
      });
    }
  }
 
  const applied = new Set(payments.filter((p) => p.invoiceId).map((p) => p.paymentRef));
  for (const p of payments) {
    if (!applied.has(p.paymentRef)) {
      drifts.push({ code: "cash_unapplied", paymentRef: p.paymentRef, amountHalalas: p.amountHalalas });
    }
  }
 
  return drifts;
}

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

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

ماذا تبني قبل أن تحصل على بيانات الاعتماد

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

• آلة الحالات. مسودة، مُرسل، بانتظار الأطراف، مسجّل، مُنهى — بطوابع زمنية وسجل أحداث لا يقبل التعديل. هذا هو الجزء الذي سيتصل به الـ API دون تغيير.
• قائمة عمل المشغّل. بدلاً من استدعاء API، أصدر مهمة تحمل الحمولة الدقيقة التي يحتاج الموظف لصقها في البوابة، وألزمه بتسجيل رقم عقد إيجار العائد. أنت تجمع بذلك مجموعة بيانات الاختبار لمحوّلك المستقبلي مجاناً.
• كشف الانحراف. المطابقة مع العقود المُصدَّرة من إيجار تعمل اليوم، عبر ملف CSV، بلا أي واجهة برمجية. وهي أيضاً أقوى ما يمكنك عرضه على عميل محتمل، لأنها تجد مالاً.
• واجهة المحوّل. عرّف EjarGateway كواجهة بتطبيق يدوي الآن وتطبيق شبكي لاحقاً. بقية النظام لن تعرف أبداً أيهما تُخاطب.
• بنية الهوية. التوثيق عبر نفاذ والتحقق من الهوية شرطان مسبقان في منظومة الحكومة السعودية كلها — راجع دليلنا إلى يقين ونفاذ وواثق. ابنِها مرة واحدة، واستخدمها مع كل منصة تلمسها بعدها.

لهذا الترتيب خاصية مفيدة: إن تأخرت اتفاقية التكامل أكثر من المتوقع، أو رُفضت، يبقى المنتج عاملاً. أما إن بنيت على أساس الـ API أولاً ولم تصل بيانات الاعتماد، فلن يكون لديك شيء.

الخطر الحقيقي هو عدم الامتثال الصامت

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

هذا هو التحوّل الذي يستحق إجراؤه في تحديد نطاق المشروع. الربط مع إيجار يُوصَف عادة كتوفير في الإدخال اليدوي. قيمته الفعلية أنه أداة رقابة امتثال — الشيء الذي يُخبر عميلك كل صباح أيّ من عقوده الخمسمئة خارج التطابق حالياً مع الشبكة أو الهيئة أو البنك. أتمتة الكتابة هي النصف الرخيص. إثبات أن الدفاتر متطابقة هو النصف الذي يُجدَّد الاشتراك من أجله.

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

المصادر

• واس — شبكة إيجار تُسجّل أكثر من 10 ملايين عقد إيجاري
• الهيئة العامة للعقار — منصة إيجار
• إيجار — التكامل الرقمي بين شبكة إيجار ومنصات التسويق العقاري
• King & Spalding — ضوابط الإيجار والتجديد التلقائي في السعودية
• شورى — توثيق عقد الإيجار الإلكتروني عبر منصة إيجار وغرامة عدم التوثيق
• المنصة الوطنية — التكامل الرقمي مع المنصات العقارية