Luca kullanan bir mali müşavirlik ofisiyseniz, ay başında her firma için tek tek yaptığınız fatura sorgulama ve kontrol işini bir yazılım robotu yapabilir; bu robot bir ofiste bugün kullanımda. Luca’ya veri gönderen bir firmaysanız, kayıtlarınızı Luca’nın kabul ettiği Excel dosyalarına otomatik çeviriyoruz. Her iki durumda da Luca’nız yerinde kalır.
Bir mali müşavirlik ofisinde kullanımda olan Luca fatura robotumuz, seçilen firmaların e-Arşiv, e-Fatura, e-SMM ve UTTS kayıtlarını tarar, her firma için muhasebeleşen ve muhasebeleşmeyen fatura sayısını tek tabloda gösterir, PDF’leri klasörlere dağıtır.
Luca için herkese açık, dokümante ve sürümlenmiş bir geliştirici API’si bulamadık. Üreticinin 2026 fiyat listesinde web servis API kalemi yalnızca Luca Koza için var (Koza Rest API Paketi); Mali Müşavir Paketi ve Luca Net için böyle bir kalem göremedik. Kapsamı üreticiden teyit edilir; bu sayfa belgelenmiş dosya aktarım yollarını esas alır: Luca’nın kabul ettiği Excel formatında otomatik aktarım kuruyoruz.
Luca’daki TÜRMOB Servis Entegrasyon Anahtarı bir entegrasyon API’si değildir. TÜRMOB e-Birlik portalından oluşturulur ve Luca’yı TÜRMOB servislerine bağlar: VKN/TCKN ile cari bilgi sorgulama ve geçmiş dönemler için Ba/Bs mutabakatı gibi (Form Ba-Bs, Eylül 2024 döneminden itibaren verilmiyor).
Muhasebe fişi aktarımı Excel üzerinden, toplu yapılır; gerçek zamanlı değildir. Zorunlu alanlar Fiş No, Fiş Tarihi, Hesap Kodu, Borç ve Alacak; dosyadaki her hesap kodunun Luca’da açılmış olması gerekir.
Projenin en kırılgan noktası teknik değil muhasebesel: hesap kodu eşleştirmesi. Bu eşleme firmanın kendi hesap planına göre kurulur ve yanlış kurulduğunda aktarım başarılı görünür ama kayıtlar yanlış hesaba düşer.
Mali müşavir ofisleri için: kullanımda olan Luca fatura robotu
Luca ile ilgili aramaların önemli kısmı mali müşavirlik ofislerinden geliyor ve sorun çoğu zaman aynı: her ay, her mükellef için aynı ekranlara girip aynı listeleri açmak. Bu işi yapan bir yazılım robotunu bir mali müşavirlik ofisi için geliştirdik ve ofis bugün kullanıyor.
Robot, ofisin seçtiği firmalar için e-Arşiv, e-Fatura, e-SMM ve UTTS kayıtlarını tek çalıştırmada tarıyor. Sonunda her firmanın kaç faturasının muhasebeleştiğini, kaçının beklediğini tek tabloda gösteriyor ve fatura PDF’lerini firma, kaynak, alış ve satış ayrımıyla klasörlere koyuyor. Belirlenen gün ve saatte kendiliğinden başlıyor.
Luca’ya ofis çalışanının kendi kullanıcısıyla giriliyor; giriş ve doğrulama kodunu çalışan kendisi yapıyor, robot bunu atlatmaya çalışmıyor. Asıl işi ofisin kendi bilgisayarında çalışan masaüstü ajanı yapıyor ve giriş bilgileri o bilgisayardan çıkmıyor; dışarıya giden şey, ajanın bir sunucuda barınan sonuç paneline yüklediği tarama sonuçları. Robot Luca’nın resmi bir API’si üzerinden değil, ofisin zaten kullandığı ekranlar üzerinden çalışıyor; Luca ekranları değiştiğinde bakım gerektirebilir ve bunu baştan söylüyoruz.
Faturaların muhasebeleştirilmesi ve mizanın hesap planı kurallarıyla kontrol edilmesi sonraki aşama olarak geliştiriliyor. Sistemi, örnek verilerle çalışırken online görüşmede gösterebiliyoruz.
Robotun çalıştırma sonrası tablosu. Firma adları ve sayılar örnek veridir; ekran düzeni kullanımdaki uygulamayla aynı. Luca adı üreticisine aittir, bayisi değiliz.
Luca genelde sizde değil, mali müşavirinizde
Luca’nın TÜRMOB çatısı altında mali müşavirlere yönelik konumlanmasının doğal sonucu şu: programı kullanan taraf çoğu zaman firmanın kendisi değil, mali müşaviri. Firma kendi ticari işini başka bir programda ya da kendi sisteminde yürütüyor, ay sonunda ise belgeler bir şekilde müşavire ulaşıyor.
Bu “bir şekilde” kısmı entegrasyonun asıl konusu. Tipik durumda veri akışı şöyle işler: firmanın ön muhasebesinden ya da üretim tarafından çıkan kayıtlar Excel’e dökülüyor, e-postayla gönderiliyor, müşavir ofisinde bir kişi bunları Luca’ya girilebilir hâle getiriyor. Ayın ilk haftası bu işle geçiyor ve her ay baştan yapılıyor.
Dolayısıyla bu sayfada anlattığımız iş, iki taraf arasındaki bu manuel hattın otomatikleştirilmesi. Kimin hangi veriyi hangi formatta üreteceği, hangi tarafta hangi kontrolün yapılacağı ve hatalı kaydın kime döneceği — proje aslında bunların yazılı hâle getirilmesinden ibaret.
Bu yüzden ilk görüşmede sorduğumuz soru teknik değil: Luca sizde mi, müşavirinizde mi ve karşı tarafla nasıl bir çalışma düzeniniz var. Cevap, projenin kime teslim edileceğini ve dosyanın hangi tarafta üretileceğini belirliyor.
TÜRMOB Servis Anahtarı bir entegrasyon API’si değildir
Bu bölümü sayfanın başına yakın koyuyoruz çünkü en çok yanlış beklentiyi bu konu yaratıyor. Cümle genellikle şöyle geliyor: “Bizde API Key var, oradan bağlanırsınız.” Anahtar gerçekten var; ama yaptığı iş sanılandan tamamen farklı.
Luca’daki TÜRMOB Servis Anahtarı, TÜRMOB e-Birlik portalından — ebirlik.turmob.org.tr adresinden — Entegrasyon Anahtarı olarak oluşturuluyor. Programa girildiği yer de belli: Yönetici bölümünde Diğer İşlemler, oradan SM/SMMM Bilgileri, ardından Kurum Şifre Bilgileri sekmesindeki TÜRMOB Servis Entegrasyon Anahtarı alanı.
Bu anahtar, Luca’nın TÜRMOB servislerine bağlanması içindir: VKN veya TCKN ile cari bilgi sorgulamak ve geçmiş dönemler için Ba/Bs formlarını TÜRMOB Ba/Bs Mutabakat Sistemi’ne göndermek gibi. Form Ba-Bs, 565 Sıra No.lu VUK Genel Tebliği ile Eylül 2024 döneminden itibaren kaldırıldı. Aynı sekmede GİB’in yeni e-Beyan sistemi için ayrı bir “GİB Servis API KEY” alanı da var; müşterinin kastettiği anahtar bazen budur. İkisi de Luca’ya dışarıdan muhasebe kaydı yazmak için verilmiş genel amaçlı bir entegrasyon anahtarı değildir.
Bu ayrım projenin fizibilitesini doğrudan etkilediği için ilk görüşmede netleştiriyoruz. Anahtarın varlığı, Luca’ya üçüncü taraf bağlantısı açan bir API bulunduğu anlamına gelmiyor. Bunu baştan söylemek, iki tarafın da haftalarını kurtarıyor.
Luca’ya veri girmenin belgelenmiş yolları
Dışarıdaki bir yazılımın Luca’ya veri göndermesinin belgelenmiş yolu dosya aktarımı. Luca’nın kendi bağlantıları da var: destek sitesine göre bazı bankalarda açık bankacılıkla banka hareketlerini çekme, LucaNetOne kayıtlarını muhasebeleştirme ve GİB e-Arşiv faturalarını sorgulama. Bunlar Luca’nın kendi ekranlarıdır, üçüncü taraf yazılıma açık bir arayüz değildir; kurulumunuzda hangilerinin aktif olduğu keşifte kontrol edilir.
Dosya aktarımı bir kısıt ve saklamıyoruz; ama öngörülebilir bir kısıt. Dosya formatı belliyse üretilen dosya test edilebilir, arşivlenebilir ve aktarım öncesi gözle kontrol edilebilir. Servis tabanlı entegrasyonlarda kaybettiğiniz “ne gönderdiğimizi görebilme” imkânı burada elinizde kalıyor.
Aşağıdaki tablo aktarım yollarını ve her birinin hangi iş için olduğunu topluyor. Bunlar aynı işi yapan alternatifler değil; hangisinin kullanılacağı verinin ne olduğuna ve nereden geldiğine göre değişiyor.
Luca tarafında belgelenmiş veri aktarım yolları. Sizin kurulumunuzda hangilerinin aktif olduğu keşif aşamasında birlikte kontrol edilir.
Yol
Format
Ne için kullanılır
Excel Veri Aktarımı
Excel
Muhasebe fişlerinin toplu aktarımı; aynı fiş numarası ve tarihi taşıyan satırlar tek fişte birleşir
Excel Fatura Aktarımı
CSV
Fatura verisinin aktarılması; fiş aktarımından ayrı bir ekrandan yürür. Luca’nın 2021 tarihli destek belgesi dosya için 400 satır ve 15 sütun sınırı yazıyor, güncel durum kurulumda teyit edilir
Banka Aktarımı
Dosya (Excel ya da CSV; Luca’nın 2021 tarihli destek belgesi CSV kaydı istiyor, biçim kurulumda teyit edilir)
Banka hareketlerinin aktarılması — Muhasebe bölümünde Banka İşlemleri altındaki Banka Aktarımı ekranı. Destek sitesine göre bazı bankalarda (ör. Halkbank) açık bankacılıkla hareketleri doğrudan çeken Banka Servisleri ekranı da var
Akıllı Entegrasyon Noktası
Portal üzerinden
TÜRMOB-Luca e-Belge portalında oluşan alış ve satış faturalarının Luca Muhasebe tarafında muhasebeleştirilmesi
Muhasebe fişi aktarımı: toplu çalışır, gerçek zamanlı değil
Muhasebe fişleri Luca’ya Excel Veri Aktarımı ekranından toplu olarak giriyor: şablon indirilir, doldurulur, yüklenir ve fişler ekrandan kesilir. Aynı fiş numarası ve tarihi taşıyan satırlar tek fişte birleşiyor; bu yüzden numaralandırma kuralı baştan yazılır.
Anlamı şu: Luca tarafına yazma işi toplu çalışır, gerçek zamanlı değil. “Sahada kayıt oluştuğu anda Luca’ya düşsün” beklentisiyle gelen firmalara dürüst cevabımız, bunun bu üründe böyle çalışmadığı oluyor. Bunun yerine kuracağımız şey, kayıtları biriktiren ve düzenli aralıklarla parti hâlinde aktaran bir akış.
Zorunlu alanlar ve dosya disiplini
Fiş aktarım dosyasında bulunması gereken asgari küme belli. Bu alanlar eksikse aktarım baştan reddedilir — ki bu aslında iyi haber, çünkü sessiz başarısızlıktan iyidir.
Fiş No — Aynı fişe ait satırların birlikte gruplanmasını sağlar; numaralandırma kuralı baştan yazılı hâle getirilir
Fiş Tarihi — Dönem kapanışıyla çakışmaması için tarih kuralları ayrıca tanımlanır
Hesap Kodu — Projenin en kırılgan kalemi; bir sonraki bölümün tamamı buna ayrıldı
Borç ve Alacak — Parti içindeki denge kontrolü aktarımdan önce bizim tarafımızda yapılır, Luca’ya dengesiz dosya gönderilmez
Parti sınırına göre tasarım
Kaynak sistemde oluşan kayıtlar bir kuyrukta toplanıyor, dönem ve fiş türüne göre gruplanıyor ve her grup ayrı bir dosya olarak üretiliyor. Dosyalar sıralı işleniyor, her aktarımın sonucu kayıt altına alınıyor.
Kritik nokta mükerrer kayıt. Bir parti yarıda kaldığında ya da aktarım tekrarlandığında aynı fişin iki kez düşmemesi gerekiyor. Bunu, hangi kaydın hangi partide gittiğini tutan bir izleme katmanıyla çözüyoruz — böylece yeniden deneme güvenli hâle geliyor.
Kayıtlar kuyruğa alınır; dönem ve fiş türüne göre gruplanır ve sıralı işlenir
Her partinin sonucu kayıt altına alınır — hangi fiş hangi dosyada gitti, izlenebilir kalır
Yarıda kalan parti tekrarlandığında aynı fişin ikinci kez düşmesi engellenir
Aktarım öncesi dosya gözle kontrol edilebilir; gönderilen şey görünmez değil
Başarısız kayıtlar sessizce yutulmaz; sebebiyle birlikte listelenir ve yeniden denenebilir
Hesap kodu eşleştirmesi: projenin gerçekten zor kısmı burası
Luca entegrasyonlarında teknik iş aslında sade: dosya üret, doğrula, aktar. Projeyi zorlaştıran şey muhasebesel. Aktarılan her satırın hangi hesap koduna düşeceği, firmanın kendi hesap planına göre belirlenir ve bu plan her firmada farklıdır.
Buradaki risk türü, yazılım hatalarından farklı ve daha sinsi: yanlış eşleme aktarımı durdurmaz. Dosya kabul edilir, aktarım başarılı görünür, sayılar tutar — ama kayıtlar yanlış hesaba düşer. Fark genellikle aylar sonra, mizan bakılırken ya da beyanname hazırlanırken ortaya çıkar ve o noktada geriye dönük düzeltme herkes için pahalı bir iş olur.
Bu yüzden eşleme tablosunu projenin teknik değil, mutabakat kalemi olarak ele alıyoruz. Tabloyu firmanın mali müşaviriyle birlikte kuruyoruz; kimin hangi hesabı onayladığı yazılı kalıyor. Eşlemeyi kodun içine gömmüyoruz — yönetilebilir bir tabloda tutuyoruz ki hesap planı değiştiğinde geliştirici çağırmanız gerekmesin.
Eşleme tablosu firmanın mali müşaviriyle birlikte kurulur ve onay yazılı kalır
Eşleme kodun içine gömülmez; müşavirin ya da firmanın güncelleyebileceği bir tabloda tutulur
Eşlemesi bulunmayan bir kayıt sessizce varsayılan bir hesaba atılmaz — aktarımdan önce durdurulur ve sorumlusuna bildirilir
Hesap planı değişikliklerinde eşleme tablosu güncellenir, kod değişmez
İlk ay aktarımları mizan üzerinden karşılıklı kontrol edilir; sonraki aylar bu kontrole göre kalibre edilir
Bulut üründe okuma ile yazma: bu sayfada zor olan taraf okuma
Diğer muhasebe programlarında bu bölüm genellikle şöyle yazılır: okuma kolay ve düşük riskli, yazma dikkat ister. Luca’da denklem tersine dönüyor ve bunu ayrıca anlatmaya değer.
Luca bulut bir ürün ve belgeler bulut ortamda saklanıyor. Bulut bir üründe doğrudan veritabanı erişimi zaten söz konusu olmaz; bu, üreticinin özel bir yasağı değil, mimarinin doğal sonucu. Bu yüzden Luca’dan veri almanın iki yolu kalıyor. Birincisi, ofis çalışanının kendi kullanıcısıyla Luca ekranları üzerinden çalışan bir robot; sayfanın başındaki fatura robotu böyle çalışıyor ve Luca ekranları değiştiğinde bakım ister. İkincisi, veriyi Luca’ya gitmeden önce kendi tarafınızda tutmak; raporlama ihtiyacı sürekliyse bu yol daha sağlam.
Okuma — ekran robotu ya da veriyi kendi tarafınızda tutmak
Fatura kontrolü gibi Luca ekranlarında zaten duran bilgiler için robot kullanılabilir. Sürekli raporlama ve analiz ihtiyacında ise önerdiğimiz yol, her rapor için veriyi Luca’dan geri çekmek değil; veriyi zaten ürettiğiniz yerde tutmak. Yani ön muhasebe, üretim veya satış tarafında oluşan kayıt, Luca’ya gönderilmeden önce sizin kontrolünüzdeki bir yapıda da saklanıyor.
Bunun sonucu şu: yönetim raporlarınız Luca’ya bağımlı olmuyor. Aynı veri hem muhasebeye gidiyor hem sizde kalıyor; panelde gördüğünüz sayıyla müşavire gönderilen dosya aynı kaynaktan üretildiği için de aralarında fark oluşmuyor.
Yazma — belgelenmiş aktarım ekranlarının dışına çıkmıyoruz
Yazma tarafında izlediğimiz tek yol, Luca’nın kabul ettiği formatta dosya üretmek ve belgelenmiş aktarım ekranlarını kullanmak. Bunun dışında bir yol arayıp müşteri verisiyle deneme yapmıyoruz.
Bu yaklaşımın bir bedeli var ve onu da açık söylüyoruz: yazma toplu çalışıyor, anlık değil. Ama muhasebe akışının doğası zaten dönemsel — belgeler zaten toplu muhasebeleşiyor. Gerçek zamanlılık ihtiyacı varsa o ihtiyacı Luca tarafında değil, sizin kendi sisteminizde karşılıyoruz.
Bulut üründe sürüm değişikliği: zamanlamaya siz karar vermiyorsunuz
Kurulu programlarda yükseltme sizin kararınızdır: planlarsınız, test edersiniz, uygun zamanda geçersiniz. Bulut üründe böyle bir imkân yok. Ekran değişir, alan eklenir, bir doğrulama sıkılaşır — ve bunu genellikle değiştikten sonra fark edersiniz.
Luca tarafında entegrasyonu ilgilendiren yüzey iki başlıkta toplanıyor. Birincisi kabul edilen dosya düzeni: beklenen sütunlarda veya biçimde bir değişiklik, ürettiğiniz dosyanın reddedilmesine yol açabilir. İkincisi aktarım ekranlarının akışı: adımların yeri veya adı değiştiğinde, o akışa bağlı yazılmış bir otomasyon takılabilir.
Bu belirsizliğe karşı tasarım tercihimiz şu: dosya biçimini yapılandırma tarafında tutuyoruz, kodun içine gömmüyoruz. Sütun düzeni değiştiğinde yapılması gereken şey kod değişikliği değil, tanım güncellemesi oluyor. Ayrıca aktarım sonuçlarını izlediğimiz için reddedilen bir dosya sessizce kaybolmuyor; ilk partide fark ediliyor.
Dürüst sınır: bulut tarafındaki bir değişikliği önceden haber alamayız ve bunu taahhüt etmiyoruz. Yapabileceğimiz şey, değişiklik olduğunda tepki süresini kısaltmak. Teslimden sonra 15 gün boyunca hata düzeltme ücretsiz; Luca ekranlarındaki değişiklikleri izlemek ve aktarımı düzenli doğrulamak ise süreye bağlı bir bakım hizmeti olarak ayrıca sözleşmeye girer.
Mali müşavirlik ofisleri ve yazılım firmaları için teknik hat
Bu sayfayı okuyanların önemli bir kısmı muhasebe kaydı ürettiren firma değil, o kaydı Luca’ya işleyen ofis. Sizin tarafınızdaki tablo tanıdık: onlarca mükellef, her birinden farklı formatta gelen dosyalar ve ayın ilk haftasında bunları tek tek elle düzenleyen bir ekip.
Buradaki iş yükü kişi eklenerek çözülmüyor, çünkü sorun hacim değil çeşitlilik. Her müşterinin dosyası farklı geliyor ve her biri ayrı bir düzenleme emeği istiyor. Bizim üstlendiğimiz şey tam olarak bu çeşitliliği tek bir standarda indiren katman: kaynak ne olursa olsun, Luca’nın kabul ettiği dosyayı üreten ve aktarımı izlenebilir kılan yazılım.
Aynı ihtiyaç, müşterisine ön muhasebe veya üretim yazılımı satan firmalarda da var. Ürününüz güzel çalışıyor ama müşterinin muhasebe tarafına bağlanması gerektiğinde her seferinde özel iş çıkıyor. O bağlantıyı bir kez düzgün kurup çoklayabileceğiniz hâle getirmek, bizim yaptığımız iş.
Mükellef ilişkisi ve mali sorumluluk sizde kalır; biz yalnızca dosya üretimi ve aktarım tarafındaki yazılımı yazarız
Farklı müşterilerden gelen farklı formatlar tek bir standarda indirilir; her müşteri için ayrı emek harcanmaz
Eşleme tabloları sizin yönetebileceğiniz şekilde bırakılır — her hesap planı değişikliğinde bize dönmeniz gerekmez
Ürününüze Luca aktarımı ekleyecekseniz, bu bağlantı tekrar kullanılabilir bir katman olarak kurulur
Ne yapılacağı ve kaça yapılacağı keşif sonrası yazılı olarak belirlenir; mükelleflerinize verdiğiniz sözün arkasında belirsiz bir maliyet durmaz
Bu programın üstüne ne kurulur?
Programınız yerinde kalır. Aşağıdaki çözümler onun karşılamadığı süreci tamamlar ve kaydı programın resmi arayüzü üzerinden işler.
Robot, ofisin seçtiği mükelleflerin faturalarını tarayıp muhasebeleşmeyenleri firma bazında sayıyor ve PDF’leri klasörlere ayırıyor. Çalışan, listeyi tek tek açmak yerine tablodaki eksikle başlıyor.
Fabrikadan mali müşavire otomatik fiş akışı
Üretim ve ön muhasebe tarafında oluşan kayıtlar, Luca’nın şablonuna uygun Excel dosyalarına dönüştürülüp düzenli aralıklarla müşavire iletiliyor. Amaç, ayın ilk haftasında dosyaları elle düzenleme işini ortadan kaldırmak.
E-ticaret satışlarının dönemsel muhasebeleşmesi
Web ve pazaryeri satışları günlük olarak toplanıp dönemsel fiş dosyasına dönüştürülüyor. Aktarım öncesi dosya gözle kontrol edilebildiği için ne gönderildiği kayıt altında kalıyor.
Banka hareketlerinin düzenli akışa bağlanması
Bankadan alınan hareket dosyaları standart bir biçime çevrilip Banka Aktarımı ekranına uygun hâle getiriliyor. Aynı hareketin iki kez işlenmesi izleme katmanıyla engelleniyor.
Çok mükellefli ofiste format standardizasyonu
Farklı müşterilerden farklı düzende gelen dosyalar tek bir akışta toplanıp aynı standarda indiriliyor. Yeni müşteri eklendiğinde yapılan iş, kod yazmak değil tanım girmek oluyor.
Ön muhasebe yazılımına Luca aktarım modülü
Kendi ürününü satan yazılım firmasının müşterilerine sunacağı Luca aktarımı, tekrar kullanılabilir tek bir katman olarak kuruluyor. Her müşteri için sıfırdan özel geliştirme yapılmıyor.
Referans iş birliği
Entegrasyon tarafında yeni bir hat kuruyoruz ve ilk projeleri referans iş birliğiyle yürütüyoruz: projenin sonunda ölçülebilir sonuçları vaka çalışması olarak yayımlamamıza ve sizi referans göstermemize izin veren firmalara özel koşul uyguluyoruz. Karşılığında alacağınız şey standart bir paket değil, süreçlerinize göre yazılmış bir sistem — ve geliştiren ekibe doğrudan erişim.
Şehriniz fark etmez
Türkiye'nin neresinde olursanız olun süreç aynı başlar: keşif online yapılır, geliştirme uzaktan yürür. Sahada yapılması gereken bir adım varsa (depo ölçümü, cihaz kurulumu, açılış sayımı gibi) ziyaret planı teklifte baştan yazılır.
Sık sorulan sorular
Luca için hazır, çalışan bir sisteminiz var mı?
Var. Bir mali müşavirlik ofisinde kullanımda olan Luca fatura robotumuz, seçilen firmaların e-Arşiv, e-Fatura, e-SMM ve UTTS kayıtlarını tarıyor, muhasebeleşen ve muhasebeleşmeyen fatura sayısını firma bazında gösteriyor ve PDF’leri klasörlere dağıtıyor. Muhasebeleştirme ve mizan kontrolü sonraki aşama olarak geliştiriliyor. Sistemi örnek verilerle online görüşmede gösterebiliyoruz; ofisinizin akışına göre uyarlanır.
Luca’nın API’si var mı, REST ile bağlanabiliyor musunuz?
Herkese açık, dokümante ve sürümlenmiş bir geliştirici API’sini bulamadık. Üreticinin 2026 fiyat listesinde API kalemi yalnızca Luca Koza tarafında var (“Luca Koza Web Servis API Uygulaması”; ürün sayfasında Koza Rest API Paketi olarak anılıyor). Mali Müşavir Paketi ve Luca Net bölümlerinde böyle bir kalem göremedik; kapsamı ve koşulları üreticiden teyit edilir. Kapsamı önceden göremediğimiz bir servis üzerinden “Luca REST API ile entegre ediyoruz” cümlesini kurmuyoruz. Yaptığımız işin doğru tarifi şu: Luca’nın kabul ettiği Excel formatında dosyayı otomatik üretiyor, doğruluyor ve belgelenmiş aktarım ekranları üzerinden akıtıyoruz. Bu bir kısıt ama öngörülebilir bir kısıt — üretilen dosya test edilebilir, arşivlenebilir ve gönderilmeden önce gözle kontrol edilebilir.
Bizde TÜRMOB Servis Anahtarı var, oradan bağlanamaz mısınız?
Hayır, çünkü o anahtar başka bir iş için. TÜRMOB Servis Entegrasyon Anahtarı, TÜRMOB e-Birlik portalından oluşturulur; VKN ya da TCKN ile cari bilgi sorgulamaya ve Ba/Bs formlarını TÜRMOB Ba/Bs Mutabakat Sistemi’ne göndermeye yarar. Luca’da girildiği yer Yönetici bölümünde Diğer İşlemler, ardından SM/SMMM Bilgileri ve Kurum Şifre Bilgileri sekmesidir; aynı sekmedeki “GİB Servis API KEY” alanı ise GİB e-Beyan sistemi içindir. İkisi de Luca’ya dışarıdan muhasebe kaydı yazmak için verilmiş genel amaçlı bir anahtar değildir. Bu, Luca tarafında tipik bir yanlış anlama ve fizibiliteyi doğrudan etkilediği için ilk görüşmede netleştiriyoruz.
Kayıtlar Luca’ya anında düşebilir mi?
Düşmez ve bunu baştan söylüyoruz. Fiş aktarımı Excel Veri Aktarımı ekranından, dosya yüklenip fiş kesilerek toplu yapılıyor. Yani yazma tarafı toplu çalışıyor, gerçek zamanlı değil. Kurduğumuz akış, kayıtları biriktirip parti hâlinde aktarmak üzerine kurulu: kuyruk, parti bölme, sıralı işleme ve mükerrer kayıt koruması. Gerçek zamanlı görünürlük ihtiyacınız varsa bunu Luca tarafında değil, sizin kendi sisteminizde çözüyoruz — veri zaten orada oluşuyor.
Aktarım dosyasında hangi alanlar zorunlu?
Muhasebe fişi aktarımında asgari küme belli: Fiş No, Fiş Tarihi, Hesap Kodu, Borç ve Alacak. Fiş No aynı fişe ait satırların gruplanmasını sağladığı için numaralandırma kuralını baştan yazılı hâle getiriyoruz. Borç ve Alacak dengesini Luca’ya göndermeden önce kendi tarafımızda kontrol ediyoruz; dengesiz dosya gönderilmiyor. Fatura aktarımı ve banka aktarımı ayrı ekranlardan yürüdüğü için onların dosya düzeni de ayrıca tanımlanıyor.
Kayıtların yanlış hesaba düşme riski var mı?
Projenin en kritik sorusu bu. Riskin kaynağı yazılım değil, hesap kodu eşleştirmesi: aktarılan her satırın hangi hesaba düşeceği firmanın kendi hesap planına göre belirlenir. Yanlış eşleme aktarımı durdurmaz — dosya kabul edilir, sayılar tutar ama kayıt yanlış hesaba gider ve bu genellikle aylar sonra mizanda fark edilir. Bu yüzden eşleme tablosunu mali müşavirle birlikte kuruyor, onayı yazılı tutuyor ve eşlemesi bulunmayan bir kaydı varsayılan bir hesaba atmak yerine aktarımdan önce durdurup sorumlusuna bildiriyoruz.
Bulut bir üründe yükseltmenin zamanlamasına siz karar vermiyorsunuz, dolayısıyla bu ihtimali yok saymıyoruz. Entegrasyonu ilgilendiren iki yüzey var: kabul edilen dosya düzeni ve aktarım ekranlarının akışı. Bu belirsizliğe karşı dosya biçimini yapılandırma tarafında tutuyoruz, kodun içine gömmüyoruz — sütun düzeni değiştiğinde yapılan iş kod değişikliği değil tanım güncellemesi oluyor. Ayrıca aktarım sonuçları izlendiği için reddedilen dosya sessizce kaybolmuyor, ilk partide fark ediliyor. Değişikliği önceden haber alabileceğimizi ise taahhüt etmiyoruz.
TÜRMOB veya Luca bayisi misiniz, ne kadar sürer?
TÜRMOB’la ya da Luca’yla bayilik, çözüm ortaklığı veya iş ortaklığı ilişkimiz bulunmuyor; bağımsız bir yazılım geliştiricisiyiz ve mali müşavirlik mesleğine ait hiçbir alana girmiyoruz. Süreye gelince: bu üründe entegrasyonun eforu projeye başlamadan kesin olarak söylenemez, çünkü üreticinin yayımladığı herkese açık bir geliştirici dokümantasyonu bulamadık; Luca Koza için listelenen ücretli web servis seçeneğinin kapsamı da ancak üreticiden teyit edilebiliyor. Bu yüzden işe keşif adımıyla başlıyoruz — Luca kimin elinde, hangi Luca ürünü kullanılıyor, hangi aktarım ekranları kullanılacak, hesap planı ne durumda ve dosya hangi tarafta üretilecek. Takvim ve sabit fiyat bu tespitten sonra veriliyor. Teslimi izleyen 15 gün hata düzeltme ücretsizdir.
Firmamız İskenderun’da, müşavirimiz Mersin’de. Nasıl yürür?
Bu tam da yerinde çalıştığımız hat: Mersin, Tarsus, Adana, Hatay, İskenderun ve Osmaniye’de hem firmanın hem müşavirin tarafında keşfi yerinde yapabiliyoruz. Luca aktarımı dosya üzerinden yürüdüğü için sonrası neredeyse tamamen uzaktan ilerler; iki tarafın aynı şehirde olması gerekmez. Türkiye’nin diğer illerindeki firma-müşavir çiftleriyle baştan sona online çalışıyoruz; firmanın üretim tarafında saha kurulumu gerekirse yalnızca o adım için seyahat planlanır.
Hangi programı kullandığınızı, sahada hangi verinin elle girildiğini ve neyi otomatikleştirmek istediğinizi anlatın. İlk görüşmede teknik olarak mümkün olup olmadığını ve hangi yöntemle yapılacağını netleştiriyoruz.
Bu sayfada adı geçen ürün ve markalar ilgili firmaların tescilli ticari markalarıdır. D'Cloud Software bağımsız bir yazılım geliştiricisidir; anılan firmaların yetkili bayisi, çözüm ortağı veya iş ortağı değildir. Entegrasyon hizmeti, ürünlerin kendi belgelenmiş arayüzleri ve veri erişim yöntemleri üzerinden sunulur.
