Emlak TeknolojisiAPI Entegrasyonu
Eş Anlamlılar: Sistem Entegrasyonu، API Bağlantısı، Teknik Entegrasyon
Son güncelleme: 2026-09-25
Kısa Tanım
API (uygulama programlama arayüzü) entegrasyonu, farklı sistemlerin standart programlama arayüzleri üzerinden birbirine bağlanarak manuel giriş olmadan otomatik veri alışverişi ve işlem yapmasıdır.
Genel Bakış
API (uygulama programlama arayüzü) entegrasyonu, farklı sistemlerin standart programlama arayüzleri üzerinden birbirine bağlanarak manuel giriş olmadan otomatik veri alışverişi ve işlem yapmasıdır. Örneğin bir mülk yönetim sistemi e-fatura platformuna, bir ödeme geçidine veya düzenleyici kurumların sistemlerine bağlanabilir.
Suudi Arabistan'da bazı entegrasyonlar artık zorunludur. E-faturanın entegrasyon aşaması, dalgalarına dahil edilen işletmelerin çözümlerini ZATCA'nın Fatoora platformuna bağlamasını gerektirir; böylece standart vergi faturaları alıcıyla paylaşılmadan önce ZATCA tarafından onaylanır (clearance) ve basitleştirilmiş faturalar ZATCA'ya raporlanır (24. dalga KDV'ye tabi geliri 375.000 SAR'ı aşan işletmeleri 30 Haziran 2026 son tarihiyle kapsadı; 25. dalga 187.500 SAR'ı aşanları 1 Şubat 2027'den itibaren kapsar). REGA'nın 2026 Emlak Pazarlama ve İlan Yönetmeliği, çevrimiçi emlak platformlarını REGA sistemleriyle teknik entegrasyona ve ilan verenleri Ulusal Tek Oturum Açma (Nafath) ile doğrulamaya zorlar. Ödemeler, bir mağazayı veya sistemi mada gibi ulusal ağlara bağlayan Suudi Merkez Bankası (SAMA) lisanslı ödeme hizmeti sağlayıcıları aracılığıyla yapılır; ağa doğrudan bağlantı kurulmaz. Ejar gibi devlet platformları entegrasyonu yalnızca şartlarını karşılayanlara sunar; her sisteme açık arayüzler değildir.
Her entegrasyon taraflar arasında veri aktarımı demektir; bu nedenle Kişisel Verilerin Korunması Kanunu uyarınca amaç belirlenmeli, paylaşılan veri asgari düzeyde tutulmalı, veri işleyenler açık sözleşme şartlarıyla bağlanmalı ve erişim anahtarları korunmalıdır. İyi entegrasyon hataları azaltır ve zaman kazandırır; kötü entegrasyon ise hataları sistemler arasında otomatik olarak kopyalar.
⚖️ Yasal Dayanak
Fatoora platformuyla zorunlu entegrasyon, ZATCA'nın e-fatura gerekliliklerine ve Ümmü'l-Kurâ Resmî Gazetesi'nde yayımlanan 25. dalga kararı dahil entegrasyon dalgalarını belirleyen kararlara dayanır. Emlak platformlarının REGA ile entegrasyonu, Emlak Aracılık Kanunu'na (30/11/1443H tarihli M/130) dayanılarak çıkarılan 2026 Emlak Pazarlama ve İlan Yönetmeliği'ne dayanır. Sistemler arasında kişisel veri alışverişi Kişisel Verilerin Korunması Kanunu'na (9/2/1443H tarihli M/19, 5/9/1444H tarihli M/148 sayılı Kraliyet Kararnamesi ile değişik) tabidir.
💡 Pratik Örnek
Cidde'deki bir mülk yönetim şirketi yönetim ücretleri ve komisyonlar için ayda yaklaşık 400 fatura düzenler ve 2.400.000 SAR'lık KDV'ye tabi geliri onu bir entegrasyon dalgasına dahil etmiştir. İki çalışan fatura verilerini manuel olarak yeniden giriyordu ve ayda yaklaşık 15 hata alacak dekontu gerektiriyordu. Mülk yönetim sistemini uyumlu bir çözümle Fatoora platformuna bağladıktan ve tahsilatı SAMA lisanslı bir sağlayıcının ödeme geçidine bağladıktan sonra, her fatura ödeme kaydedildiğinde otomatik olarak oluşturulup onaylanır; hatalar ayda ikiye düşer ve şirket ayda yaklaşık 60 iş saati kazanır.
⚠️ Yaygın Hatalar
- ✗Bir ofis sisteminin mada ağına doğrudan bağlanabileceğine inanmak; ödemeler Suudi Merkez Bankası lisanslı ödeme hizmeti sağlayıcılarından geçer.
- ✗Ejar gibi devlet platformlarının her sisteme şartsız açık arayüzler sunduğunu varsaymak.
- ✗Fatoora entegrasyonunu dalga son tarihine bırakmak; ilk aksaklıkta faturalama durur.
- ✗Entegre sistemler arasında gereksiz yere veya veri işleme sözleşmesi olmadan fazla kişisel veri aktarmak.
- ✗Erişim anahtarlarını ve API sırlarını kodun içinde saklamak veya çalışanlar arasında paylaşmak.
🌍 Uluslararası Farklılıklar
Devlet faturalama sistemleriyle zorunlu entegrasyon yaygınlaşmıştır: Türkiye yıllardır Gelir İdaresi'ne bağlı e-fatura kullanmaktadır, Mısır e-faturayı aşamalı olarak uygulamıştır ve Avrupa Birliği işletmeler arası işlemlerde zorunlu e-faturaya yönelmektedir. Suudi modeli, standart faturaların Fatoora platformu üzerinden önceden onaylanması (clearance), emlak platformlarının sektör düzenleyicisiyle entegrasyonunun zorunlu tutulması ve doğrulamada kullanılan birleşik ulusal dijital kimlik (Nafath) ile öne çıkar.
Sıkça Sorulan Sorular
API entegrasyonu nedir?▾
Mülk sistemini e-faturaya veya ödeme geçidine bağlamak gibi, farklı sistemlerin standart programlama arayüzleri üzerinden manuel giriş olmadan otomatik veri alışverişi ve işlem yapacak şekilde bağlanmasıdır.
Fatoora platformuyla entegrasyon zorunlu mu?▾
Entegrasyon aşaması dalgalarına dahil edilen işletmeler için evet: 24. dalga KDV'ye tabi geliri 375.000 SAR'ı aşanları 30 Haziran 2026 son tarihiyle kapsadı; 25. dalga 187.500 SAR'ı aşanları 1 Şubat 2027'den itibaren kapsar.
Bir ofis sistemi doğrudan mada'ya bağlanabilir mi?▾
Hayır. Ödemeler, ulusal ağlara bağlanan Suudi Merkez Bankası lisanslı ödeme hizmeti sağlayıcıları veya ödeme geçitleri aracılığıyla kabul edilir.
Emlak platformları REGA ile entegre olmak zorunda mı?▾
Evet. 2026 Pazarlama ve İlan Yönetmeliği, çevrimiçi emlak platformlarının REGA sistemleriyle teknik entegrasyonunu ve ilan verenlerin Nafath ile doğrulanmasını şart koşar.
Entegrasyonda temel veri koruma hususları nelerdir?▾
Kişisel Verilerin Korunması Kanunu uyarınca amacı belirlemek, asgari veri paylaşmak, taraflarla veri işleme sözleşmeleri yapmak, erişim anahtarlarını korumak ve kullanım kayıtlarını izlemek.
