التقنية العقاريةتكامل واجهات برمجة التطبيقات
مرادفات: الربط البرمجي، تكامل الأنظمة، الربط التقني، API
آخر تحديث: 2026-09-25
تعريف موجز
تكامل واجهات برمجة التطبيقات (API) هو ربط أنظمة مختلفة ببعضها عبر واجهات برمجية معيارية تتيح تبادل البيانات وتنفيذ العمليات آلياً دون إدخال يدوي، كربط نظام إدارة الأملاك بمنصة الفوترة الإلكترونية أو ببوابة دفع أو بأنظمة الجهات المنظمة.
نظرة شاملة
تكامل واجهات برمجة التطبيقات (API) هو ربط أنظمة مختلفة ببعضها عبر واجهات برمجية معيارية تتيح تبادل البيانات وتنفيذ العمليات آلياً دون إدخال يدوي، كربط نظام إدارة الأملاك بمنصة الفوترة الإلكترونية أو ببوابة دفع أو بأنظمة الجهات المنظمة.
في السعودية أصبح بعض التكامل إلزامياً: فمرحلة الربط في الفوترة الإلكترونية تلزم المنشآت المشمولة بموجاتها بربط حلولها بمنصة «فاتورة» التابعة لهيئة الزكاة والضريبة والجمارك، بحيث تُعتمد الفواتير الضريبية القياسية من الهيئة قبل مشاركتها مع المشتري، وتُبلَّغ الفواتير المبسطة إليها (الموجة 24 لمن تجاوزت إيراداتهم الخاضعة للضريبة 375,000 ريال بمهلة حتى 30 يونيو 2026، والموجة 25 لمن تجاوزت 187,500 ريال بدءاً من 1 فبراير 2027). كما تُلزم اللائحة التنظيمية للتسويق والإعلانات العقارية لعام 2026 المنصات العقارية الإلكترونية بالربط التقني مع أنظمة الهيئة العامة للعقار، والتحقق من المعلنين عبر النفاذ الوطني الموحد. أما المدفوعات فتتم عبر مزودي خدمات دفع مرخصين من البنك المركزي السعودي يربطون المتجر أو النظام بالشبكات الوطنية مثل «مدى»، لا عبر ربط مباشر مع الشبكة. والمنصات الحكومية مثل «إيجار» تتيح التكامل لمن تنطبق عليه شروطها فقط، لا كواجهات مفتوحة لأي نظام.
كل تكامل يعني انتقال بيانات بين أطراف، فيلزم وفق نظام حماية البيانات الشخصية تحديد الغرض، وحصر البيانات المتبادلة في الحد الأدنى، والتعاقد مع المعالجين بضوابط واضحة، وحماية مفاتيح الوصول. والتكامل الجيد يقلل الأخطاء ويوفر الوقت، أما السيئ فينسخ الأخطاء آلياً بين الأنظمة.
⚖️ الأساس النظامي
يستند التكامل الإلزامي مع منصة «فاتورة» إلى متطلبات الفوترة الإلكترونية لهيئة الزكاة والضريبة والجمارك وقرارات تحديد موجات الربط، ومنها قرار تطبيق الموجة 25 المنشور في جريدة أم القرى. ويستند ربط المنصات العقارية بالهيئة العامة للعقار إلى اللائحة التنظيمية للتسويق والإعلانات العقارية (2026) الصادرة استناداً إلى نظام الوساطة العقارية (م/130 وتاريخ 30/11/1443هـ). ويحكم تبادل البيانات الشخصية بين الأنظمة نظام حماية البيانات الشخصية (م/19 وتاريخ 9/2/1443هـ المعدَّل بالمرسوم الملكي رقم م/148 وتاريخ 5/9/1444هـ).
💡 مثال تطبيقي
شركة إدارة أملاك في جدة تصدر نحو 400 فاتورة شهرياً لأتعاب الإدارة والعمولات، وبلغت إيراداتها الخاضعة للضريبة 2,400,000 ريال، فشملتها إحدى موجات الربط. كان موظفان يعيدان إدخال بيانات الفواتير يدوياً، مع نحو 15 خطأ شهرياً تستلزم إشعارات دائنة. بعد ربط نظام إدارة الأملاك بمنصة «فاتورة» عبر حل متوافق، وربط التحصيل ببوابة دفع لدى مزود مرخص من البنك المركزي، أصبحت الفاتورة تُنشأ وتُعتمد آلياً عند تسجيل الدفعة، وانخفضت الأخطاء إلى خطأين شهرياً، ووفرت الشركة نحو 60 ساعة عمل شهرياً.
⚠️ أخطاء شائعة
- ✗الاعتقاد أنه يمكن ربط نظام المكتب مباشرة بشبكة «مدى»؛ فالمدفوعات تمر عبر مزودي خدمات دفع مرخصين من البنك المركزي السعودي.
- ✗افتراض أن المنصات الحكومية مثل «إيجار» توفر واجهات مفتوحة لأي نظام دون شروط.
- ✗تأجيل الربط مع منصة «فاتورة» حتى آخر مهلة الموجة، فتتعطل الفوترة عند أول خلل.
- ✗تمرير بيانات شخصية زائدة بين الأنظمة المتكاملة دون حاجة أو اتفاقية معالجة.
- ✗حفظ مفاتيح الوصول وكلمات المرور البرمجية داخل الشيفرة أو مشاركتها بين الموظفين.
🌍 فروقات دولية
انتشر التكامل الإلزامي مع أنظمة الفوترة الحكومية في دول عدة؛ فتركيا تعتمد الفاتورة الإلكترونية المرتبطة بإدارة الإيرادات منذ سنوات، ومصر طبقت منظومة الفاتورة الإلكترونية على مراحل، ويتجه الاتحاد الأوروبي إلى الفوترة الإلكترونية الإلزامية في المعاملات بين المنشآت. يتميز النموذج السعودي بنموذج «الاعتماد المسبق» للفواتير القياسية عبر منصة «فاتورة»، وبإلزام المنصات العقارية بالربط مع الجهة المنظمة للقطاع، إضافة إلى هوية رقمية وطنية موحدة («نفاذ») تُستخدم في التحقق.
أسئلة شائعة
ما هو تكامل واجهات برمجة التطبيقات؟▾
هو ربط أنظمة مختلفة عبر واجهات برمجية معيارية لتبادل البيانات وتنفيذ العمليات آلياً دون إدخال يدوي، كربط نظام الأملاك بالفوترة الإلكترونية أو ببوابة الدفع.
هل الربط مع منصة «فاتورة» إلزامي؟▾
نعم للمنشآت التي تشملها موجات مرحلة الربط؛ فالموجة 24 شملت من تجاوزت إيراداتهم الخاضعة للضريبة 375,000 ريال بمهلة حتى 30 يونيو 2026، والموجة 25 تشمل من تجاوزت 187,500 ريال بدءاً من 1 فبراير 2027.
هل يمكن ربط نظام المكتب مباشرة بـ«مدى»؟▾
لا؛ يتم قبول المدفوعات عبر مزودي خدمات دفع أو بوابات مرخصة من البنك المركزي السعودي، وهي التي تتصل بالشبكات الوطنية.
هل تلتزم المنصات العقارية بالربط مع الهيئة العامة للعقار؟▾
نعم، تُلزم لائحة التسويق والإعلانات العقارية لعام 2026 المنصات العقارية الإلكترونية بالربط التقني مع أنظمة الهيئة والتحقق من المعلنين عبر «نفاذ».
ما أهم اعتبارات حماية البيانات في التكامل؟▾
تحديد الغرض، وتبادل الحد الأدنى من البيانات، وإبرام اتفاقيات معالجة مع الأطراف، وحماية مفاتيح الوصول، ومراقبة سجلات الاستخدام وفق نظام حماية البيانات الشخصية.
