Mali Müşavir Logo ve Luca Entegrasyonu Nasıl Yapılır?

Apartman veya site yönetiminde mali müşavir Logo/Luca entegrasyonu yapmak; yönetim yazılımındaki gelir-gider verilerini, fiş ve fatura kayıtlarını mali müşavirinizin kullandığı muhasebe programına otomatik olarak aktarmak anlamına gelir. Bu entegrasyon sayesinde aynı veriyi iki kez girmekten kurtulur, hata riskini düşürür ve mali müşavirinizle gerçek zamanlı uyum içinde çalışırsınız.

Mali Müşavir Entegrasyonu Neden Bu Kadar Önemli?

Türkiye'deki apartman ve site yönetimleri, 634 sayılı Kat Mülkiyeti Kanunu'nun öngördüğü hesap tutma ve raporlama yükümlülüklerini yerine getirmek zorundadır. Bu yükümlülük çoğu zaman hem yöneticinin hem de mali müşavirin aynı muhasebe verisiyle ayrı ayrı çalışmasına yol açar: yönetici kendi programına gider kaydeder, mali müşavir de aynı faturayı kendi muhasebe sistemine tekrar girmek durumunda kalır.

Bu çift girişin yarattığı sorunlar yalnızca zaman kaybıyla sınırlı değildir. İki sistem arasında tutarsızlık oluşabilir; yıl sonu hesaplarında rakamlar uyuşmaz ve denetim süreçleri uzar. Daha da önemlisi, gecikme tazminatı hesaplamaları, banka mutabakatları ve bütçe takibi hatalı verilere dayanarak yapılırsa yasal yükümlülükler yerine getirilmemiş sayılabilir.

Mali müşavir entegrasyonu bu döngüyü kırmanın tek kalıcı yoludur. Yönetim yazılımınızda oluşturulan her fiş, fatura veya ödeme kaydı otomatik olarak Logo ya da Luca tarafında muhasebe kaydına dönüşür. Mali müşaviriniz sıfırdan veri girmek yerine gelen kayıtları doğrular, gerekirse düzeltir ve raporlamaya odaklanır. Bu da yönetim maliyetlerini düşürür, hata payını minimize eder ve iki taraf arasındaki güveni artırır.

Türkiye'de en yaygın kullanılan muhasebe yazılımları Logo (Go3, Tiger3, Go Plus) ve Luca'dır. Her ikisi de API entegrasyonuna ve XML/CSV aktarımına olanak tanıyan modern mimarilere sahiptir. Doğru yapılandırılmış bir apartman yönetim yazılımı, bu kanallar aracılığıyla her iki sistemle de sorunsuz çalışabilir.

Entegrasyon Öncesi Hazırlık: Hesap Planı ve Veri Eşleme

Entegrasyon sürecinin başarısı büyük ölçüde hazırlık aşamasına bağlıdır. Yönetim yazılımınızdaki gelir ve gider kategorilerinin, mali müşavirinizin kullandığı muhasebe programındaki hesap planıyla birebir eşleştirilmesi gerekir. Bu adım atlanırsa ya da yüzeysel yapılırsa, aktarılan veriler muhasebe tarafında yanlış hesaplara düşer ve sonradan elle düzeltilmesi gerekir; bu da entegrasyonun sağladığı kazanımı büyük ölçüde ortadan kaldırır.

Hazırlık sürecinde ilk yapmanız gereken şey, mali müşavirinizden aktif hesap planını istemektir. Logo'da bu plan "Hesap Planı Listesi" menüsünden, Luca'da ise "Muhasebe Ayarları" bölümünden alınabilir. Elinizde bu liste varken, yönetim yazılımınızdaki her gelir türünü (aidat, bağış, kira, faiz vb.) ve gider türünü (temizlik, güvenlik, elektrik, bakım, yönetici ücreti vb.) karşılık gelen hesap koduyla eşleştirirsiniz.

Özellikle dikkat edilmesi gereken nokta, bazı apartman gelir türlerinin muhasebe standartlarında farklı sınıflandırılmasıdır. Örneğin avans niteliğindeki aidat ödemeleri ile gerçekleşmiş giderlere katılım payları aynı hesapta izlenmez. Mali müşavirinizin bu ayrımı nasıl kurguladığını öğrenmeden eşleme yapmak ilerleyen dönemlerde bilanço sorunlarına yol açabilir.

Hazırlık aşamasında oluşturulması gereken ikinci liste, muhatap (cari hesap) eşleme tablosudur. Yönetim yazılımınızdaki her tedarikçi, her kat maliki ve her kiracı, muhasebe sisteminde bir cari hesaba karşılık gelmelidir. Bu eşleme tamamlanmadan veri aktarımı yapıldığında, karşı taraf bilgileri eksik olan fişler oluşur ve muhasebe kaydı tamamlanamaz.

Logo Muhasebe Entegrasyonu: Adım Adım Kurulum

Logo muhasebe programlarıyla entegrasyon iki farklı yöntemle gerçekleştirilebilir: Logo'nun kendi API altyapısı üzerinden doğrudan entegrasyon veya XML/CSV dosya aktarımı yoluyla toplu veri gönderimi. Modern apartman yönetim yazılımları her iki yöntemi de destekleyebilmektedir; ancak günlük kullanımda API tabanlı entegrasyon çok daha pratik sonuçlar verir çünkü veriler gerçek zamanlı veya belirlenen aralıklarla otomatik iletilir.

API entegrasyonu için önce Logo sisteminde bir "Servis Kullanıcısı" tanımlanması gerekir. Bu kullanıcı, apartman yönetim yazılımının Logo'ya bağlanmak için kullanacağı kimlik bilgilerini taşır. Logo Go3 veya Tiger3 kullanıyorsanız, sistem yöneticinizden ya da mali müşavirinizden bu kullanıcıyı tanımlamasını isteyin; yetki kapsamını yalnızca fiş oluşturma ve cari hesap sorgulamayla sınırlı tutun, gereksiz yetkiler vermeyin.

Apartman yönetim yazılımı tarafında ise "Muhasebe Entegrasyonu" veya "Logo Bağlantısı" menüsüne girerek sunucu adresi, port, kullanıcı adı ve şifre bilgilerini girersiniz. Bağlantı testi yaparak iletişimin sağlandığını onayladıktan sonra hesap eşleme tablosunu sisteme yüklersiniz. Bu aşamada her gider/gelir kategorisi için hangi Logo hesap kodunun kullanılacağını tanımlarsınız.

İlk deneme aktarımını az sayıda kayıtla yapmanız önerilir: örneğin tek bir ayın aidat tahsilatlarını Logo'ya gönderin ve mali müşavirinizden fişlerin doğru hesaplara düşüp düşmediğini kontrol etmesini isteyin. Doğrulama tamamlandıktan sonra geçmiş dönem verilerini toplu olarak aktarabilir, ardından otomatik senkronizasyonu devreye alabilirsiniz.

Luca Entegrasyonu: Farklılıklar ve Dikkat Edilecek Noktalar

Luca, bulut tabanlı mimarisiyle Logo'dan farklı bir entegrasyon deneyimi sunar. Logo sunucu tabanlı çalışır ve genellikle yerel ağ ya da VPN üzerinden erişilirken, Luca tamamen internet üzerinden çalışan SaaS bir platform olduğundan entegrasyon doğrudan HTTPS API'leri aracılığıyla gerçekleştirilir. Bu durum özellikle küçük ve orta ölçekli apartman yönetimleri için kurulum kolaylığı sağlar: sunucu yapılandırması veya özel ağ kurulumu gerektirmez.

Luca entegrasyonu için önce Luca hesabınızda bir API anahtarı oluşturmanız gerekir. Bu anahtarı "Geliştirici Ayarları" veya "Entegrasyonlar" menüsünden elde edebilirsiniz. Anahtarı apartman yönetim yazılımınızın Luca bağlantı ekranına girdikten sonra şirket/işletme kodunuzu da tanımlamanız gerekir; Luca'da her muhasebe firması müşterisi ayrı bir işletme kodu altında tutulur, bu nedenle mali müşaviriniz size kendi Luca hesabındaki sizin işletmenize ait kodu iletmelidir.

Luca'da hesap eşleme prensibi Logo'dan farklı değildir; ancak Luca'nın hesap planı yapısı bazı özel kodlamalar içerebilir. Özellikle KDV hesapları ve stopaj hesapları konusunda mali müşavirinizle tek tek konuşmanız ve hangi işlem türünün hangi vergi koduna tabi olduğunu netleştirmeniz gerekir. Apartman giderlerinin büyük bölümü KDV'ye tabi hizmet alımlarından oluştuğundan, KDV ayrıştırmasının doğru yapılandırılması kritik önem taşır.

Luca'nın bir avantajı, aktarılan fişleri mali müşavirin gerçek zamanlı görebilmesi ve onay süreçlerini dijital ortamda yönetebilmesidir. Yönetim yazılımından gönderilen her kayıt "Bekleyen Fişler" kuyruğuna düşer; mali müşavir inceleyip onayladıktan sonra muhasebe defterine işlenir. Bu akış, yönetici ve mali müşavir arasındaki denetim sorumluluğunu netleştirir.

Veri Aktarımı: Hangi Kayıtlar Entegrasyon Kapsamında?

Mali müşavir entegrasyonunun kapsamı, yönetim yazılımındaki hangi modüllerin muhasebe tarafına yansıtılacağına göre belirlenir. Genellikle entegrasyon şu kayıt türlerini kapsar: aidat tahsilatları, gider faturaları, banka hareketleri, kasa işlemleri ve fatura ödemeleri. Bu beş başlık doğru entegre edildiğinde, yönetim yazılımındaki tüm mali hareketler muhasebe programında karşılıklı fiş oluşturur.

Aidat tahsilatları entegrasyonun en yoğun veri kaynağını oluşturur. Her kat malikinin ödediği aidat, yönetim yazılımında otomatik olarak bir tahsilat fişine dönüştürülür; bu fiş Logo veya Luca'ya aktarıldığında ilgili kat malikinin cari hesabına borç kapatma kaydı olarak düşer. Gecikmiş aidat ödemeleriyle birlikte gelen gecikme tazminatları da ayrı bir satır olarak aktarılmalıdır; çünkü tazminat tutarı muhasebede faiz geliri olarak farklı bir hesapta izlenir.

Gider faturaları, elektrik, su, doğalgaz, temizlik, güvenlik ve bakım hizmetleri gibi kalemleri kapsar. Bu faturalar yönetim yazılımına girildiğinde satıcının cari hesabına borç, ilgili gider hesabına alacak kaydı oluşturulur. Ödeme yapıldığında ise banka veya kasa hesabından satıcı cari hesabına mahsuplaşma kaydı düşer. Entegrasyon bu üç adımın hepsini otomatik olarak muhasebe programına yansıtabilmelidir.

Banka hareketleri entegrasyonu, özellikle çok binalı veya çok hesaplı sitelerde büyük kolaylık sağlar. Yönetim yazılımına bağlı banka hesaplarındaki her hareket (virman, EFT, havale, otomatik ödeme) muhasebe programındaki banka hesabı kartıyla eşleştirilir. Bu sayede ay sonu banka mutabakatı sıfır fark verecek şekilde kapanır; elle mutabakat süreci ya tamamen ortadan kalkar ya da birkaç dakikaya iner.

Entegrasyon Sürecindeki Sık Karşılaşılan Sorunlar ve Çözümleri

Entegrasyon projelerinde en sık karşılaşılan sorun, hesap eşleme tablolarındaki eksiklik veya yanlış eşlemedir. Yönetim yazılımında tanımlı bir gider kategorisi için muhasebe hesabı eşlenmemişse, o kayıt aktarım sırasında hata verir veya "eşleşmeyen kayıtlar" kuyruğuna düşer. Bu sorunun çözümü basittir: eşleme tablosunu açın, hatasız düşmeyen kategorileri tespit edin ve mali müşavirinizle birlikte doğru hesap kodlarını tanımlayın.

İkinci yaygın sorun, cari hesap uyuşmazlıklarıdır. Yönetim yazılımında "Ahmet Yılmaz" olarak kayıtlı bir kat maliki, muhasebe programında "A. Yılmaz" veya farklı bir vergi numarasıyla kayıtlı olabilir. Bu durumda sistem otomatik eşleşme yapamaz ve kaydı bekletmeye alır. Çözüm için her iki taraftaki cari liste dışa aktarılır, Excel'de karşılaştırılır ve uyuşmayan satırlar elle düzeltilir; ardından güncellenmiş eşleme tablosu sisteme yüklenir.

Bağlantı sorunları, özellikle Logo gibi sunucu tabanlı sistemlerde zaman zaman ortaya çıkabilir. Logo sunucusu güncelleme aldığında veya servis kullanıcısı şifresi değiştiğinde, apartman yönetim yazılımı bağlantıyı kuramaz. Bu sorunu önlemek için entegrasyon bağlantı bilgilerini yönetim yazılımınızdaki "Entegrasyon Ayarları" bölümünde her Logo güncellemesinden sonra yenilemeniz önerilir.

KDV ve stopaj hesaplamalarındaki farklılıklar da önemli bir hata kaynağıdır. Apartman yönetiminde bazı ödemeler (örneğin mesleki hizmet alımları) stopaja tabi iken diğerleri değildir. Yönetim yazılımı faturaya stopaj kesip kesmediğini doğru şekilde işaretlemezse, muhasebe tarafında yanlış stopaj hesabına kayıt düşer. Mali müşavirinizle hangi gider türlerinin stopaj gerektirdiğini sisteme önceden tanımlamak bu hatayı önler.

Entegrasyon Sonrası İş Akışı: Aylık Rutin Nasıl Değişir?

Entegrasyon devreye girdikten sonra aylık iş akışınız köklü biçimde değişir. Eskiden hem siz hem mali müşaviriniz aynı fatura ve makbuzlarla ayrı ayrı ilgilenirken, artık tek bir veri girişi her iki tarafın sistemini de günceller. Bu dönüşümün pratikte nasıl işlediğini somut bir senaryo üzerinden görmek süreci daha iyi anlamanızı sağlar.

Ay başında aidatlar sisteme tanımlı ödeme planına göre otomatik olarak tahakkuk eder. Kat malikleri ödeme yaptıkça — banka havalesiyle, kapıda nakit olarak veya EFT yoluyla — bu ödemeler yönetim yazılımına girilir ya da banka entegrasyonu varsa otomatik olarak çekilir. Her tahsilat anında bir muhasebe fişi oluşturulur ve Logo/Luca'ya gönderilir. Mali müşaviriniz, gün içinde veya ertesi sabah Luca arayüzünden ya da Logo'dan bu fişleri görebilir; toplu onay vererek deftere işler.

Ay ortasında ya da sonunda gelen faturalar (elektrik, temizlik, güvenlik şirketi faturası, asansör bakım faturası vb.) yönetim yazılımına girildiği anda muhasebe tarafında borç kaydı oluşur. Ödeme yapıldığında banka hareketi bu borca mahsup edilir. Ay kapanışında mali müşavirinizin yapması gereken iş yalnızca olası tutarsızlıkları gözden geçirmek ve KDV beyannamesi için gerekli dökümleri almaktır.

Bu yeni akış hem yöneticinin hem de mali müşavirin aylık iş yükünü önemli ölçüde azaltır. Öte yandan bazı sorumluluklar değişmez: yönetici her harcamayı fatura/belgeyle desteklemek zorundadır, mali müşavir gelen kayıtları kör onaylamak yerine denetim gözüyle incelemelidir. Entegrasyon bir denetim mekanizması değil, bir verimlilik aracıdır.

Entegrasyon İçin Doğru Yazılımı Seçmek

Piyasada çok sayıda apartman ve site yönetim yazılımı bulunmaktadır; ancak hepsinin Logo veya Luca entegrasyonu sunduğunu varsaymak hatalı olur. Bir yazılımı değerlendirirken sormanız gereken teknik sorular, yüzeysel tanıtım materyallerinden çok daha önemlidir. "Entegrasyon var mı?" sorusu yeterli değildir; "Hangi Logo sürümleriyle test edilmiş?", "API tabanlı mı yoksa sadece CSV aktarımı mı?" ve "Hesap eşleme tablosunu ben mi oluşturuyorum yoksa yazılım standart bir şablon mı sunuyor?" sorularının yanıtlarını almanız gerekir.

Logo entegrasyonu açısından dikkat edilmesi gereken bir nokta, Logo'nun farklı sürümlerinin (Go, Go3, Tiger, Tiger3) API yapısının birbiriyle tam uyumlu olmayabileceğidir. Mali müşaviriniz hangi Logo sürümünü kullanıyorsa, değerlendirdiğiniz yönetim yazılımının o sürümle test edilmiş ve onaylanmış olduğunu teyit etmeniz gerekir. Aksi hâlde entegrasyon belgesi olmasına rağmen uyumsuzluk sorunlarıyla karşılaşabilirsiniz.

Luca entegrasyonu için durum biraz daha standart görünse de dikkat edilmesi gereken nokta, Luca'nın zaman zaman API yapısını güncellemesidir. Bu güncellemeler bazen mevcut entegrasyon bağlantılarını bozabilir. Yönetim yazılımı sağlayıcısının Luca güncellemelerini takip edip etmediğini, API değişikliği olduğunda müşterilerini bilgilendirip bilgilendirmediğini sormak uzun vadeli güvence açısından değerlidir.

Bunların yanı sıra, entegrasyon desteğinin yazılımın standart paketi kapsamında mı yoksa ek ücretli bir modül olarak mı sunulduğunu da netleştirmelisiniz. Bazı sağlayıcılar temel yazılımı makul bir fiyatla satarken muhasebe entegrasyonunu ayrı bir abonelikle sunar. Yıllık toplam maliyeti hesaplarken bu kalemler mutlaka göz önünde bulundurulmalıdır. Apartman muhasebe programı seçiminde entegrasyon kapsamını karşılaştırmak, uzun vadede gereksiz ek masrafların önüne geçer.

Entegrasyon Sürecinin Zaman ve Maliyet Tablosu

Entegrasyon projesinin ne kadar süreceği ve ne kadara mal olacağı, yönetilen binanın büyüklüğüne, mevcut veri kalitesine ve seçilen yazılıma göre önemli ölçüde farklılaşır. Aşağıdaki tablo, ortalama bir apartman veya site yönetimi için tipik aşamaları ve süreleri özetlemektedir.

Toplam proje süresi genellikle 8–15 iş günü arasında tamamlanır. Geçmiş dönem verilerinin aktarılıp aktarılmayacağı kararı bu süreyi doğrudan etkiler; mevcut yılın başından itibaren veri aktarımı yapılması çoğu zaman yeterlidir, önceki yıllar için aktarım yalnızca karşılaştırmalı raporlama ihtiyacı varsa değer taşır.

Maliyet açısından bakıldığında, entegrasyon kurulumu için yazılım sağlayıcısının talep ettiği kurulum ücreti (genellikle tek seferlik) ile devam eden aylık abonelik veya bakım bedeli iki ana kalem oluşturur. Mali müşavirinizin entegrasyon hazırlığı için harcadığı süre de ek bir maliyet olarak değerlendirilmelidir; bu nedenle bazı mali müşavirler entegrasyon kurulumu için ayrıca danışmanlık faturası kesmektedir. Bu maliyeti peşinen netleştirmek sürpriz harcamaların önüne geçer.

Yasal Uyumluluk: Entegrasyon KMK Yükümlülüklerini Nasıl Karşılar?

634 sayılı Kat Mülkiyeti Kanunu, yöneticilere hesap tutma ve raporlama konusunda açık yükümlülükler getirmektedir. Yönetici, her takvim yılı sonu itibarıyla kat maliklerine gelir-gider hesabını sunmak ve bir sonraki yılın tahmini bütçesini hazırlamak zorundadır. Bu raporların gerçeği yansıtmaması ya da belgelenememesi, yöneticiye karşı dava açılmasına zemin hazırlayabilir.

Mali müşavir entegrasyonu bu yasal çerçeveyi güçlendiren bir araçtır. Muhasebe programına düşen her kayıt belgelenmiş ve iz bırakmış olur; silme ya da değiştirme işlemleri de günlük kayıt olarak tutulur. Bu şeffaflık, kat malikleri arasında hesap itirazı çıktığında yöneticinin lehine işleyen güçlü bir belge zinciri oluşturur.

Öte yandan gecikme tazminatı konusunda da dikkatli olmak gerekir. Kanun kapsamında geciken aidat ödemeleri için aylık yüzde beş gecikme tazminatı uygulanır. Bu tazminatın doğru hesaplanması ve muhasebe kaydına yansıtılması hem kat malikiyle ilişkide hem de yasal takip süreçlerinde önem taşır. Entegrasyon kurulumu sırasında gecikme tazminatı hesaplama mantığının muhasebe tarafında nasıl işleneceğini mali müşavirinizle netleştirmeniz gerekir. Uydurma madde numaralarına dayanmak yerine avukatınıza danışmanız önerilir; bu makale genel bilgi niteliğindedir.

İcra ve ihtar süreçleri başlatıldığında, muhasebe programındaki düzgün kayıtlar icra müdürlüğüne sunulabilecek belgeler arasında yer alır. Logo veya Luca'dan alınan cari hesap ekstre ve bakiye raporları, borcun miktarını ve vadesini net olarak ortaya koyduğundan hukuki sürecin hızlanmasına katkı sağlar. Apartman yönetim programı seçiminde bu tür raporlara destek verilip verilmediğini kontrol etmek yerinde olacaktır.

Son olarak, toplu konut ve rezidans gibi büyük ölçekli yapılarda entegrasyonun önemi daha da artar. Yüzlerce bağımsız bölüme ait aidat ve gider verilerini manuel olarak iki sistemde tutmak hem pratik olarak imkânsızdır hem de hata riskini kabul edilemez düzeye çıkarır. Bu yapılar için rezidans yönetim sistemi çözümlerinin entegrasyon kapasitesini özellikle değerlendirmeniz gerekir.

• Hesap planı eşlemesini mali müşavirinizle birlikte hazırlayın; tek taraflı yapmayın.
• Cari hesap listesini her iki sistemde de standartlaştırın (vergi numarası veya TC kimlik no üzerinden eşleyin).
• KDV ve stopaj ayarlarını entegrasyondan önce netleştirin; sonradan düzeltmek veri bütünlüğünü bozar.
• İlk aktarımı az sayıda kayıtla yapın; mali müşavirin onayından sonra toplu aktarıma geçin.
• Bağlantı bilgilerini (API anahtarı, şifre) güvenli bir yerde saklayın; her Logo güncellemesinden sonra kontrol edin.
• Otomatik senkronizasyon devredeyken bile aylık mutabakat rutinini koruyun; sistem hataları fark edilmeden birikmemeli.
• Entegrasyon kapsamı dışında kalan nadir işlemler (bağış, avans, özel tahsilat) için elle fiş girişi prosedürü oluşturun.

Sık Sorulan Sorular