ERP'yi muhasebe programına bağlarken dikkat edilecekler
ERP ile muhasebe programını bağlarken hangi verinin hangi yönde aktığı, hata yönetimi ve test ortamı konusunda nelere dikkat ettiğimi anlatıyorum.
Burak Meriç · 10 Ekim 2026 · 3 dk okuma
ERP'yi muhasebe programına bağlamak, günlük işte en çok zaman kazandıran entegrasyonlardan biridir. Aynı zamanda en çok sorun çıkaranlardan biri. Aşağıda, bu tür bir bağlantı kurarken dikkat ettiğim şeyleri yazıyorum.
Önce hangi verinin hangi yönde aktığına karar verin
"İki sistem konuşsun" demek yeterli değil. Her veri için tek bir sistem yönetici olmalı. Benim genelde başladığım tablo şöyle:
| Veri | Hangi sistem yönetir? | Not |
|---|---|---|
| Cari hesap | Muhasebe | ERP okur, yeni cari ERP'den açılacaksa muhasebeye yazılır |
| Sipariş | ERP | Muhasebeye fatura kaydı olarak aktarılır |
| Fatura | Muhasebe | ERP durumu görür |
| Stok | ERP | Muhasebe stok kartını bu veriden besler |
| Tahsilat | Muhasebe | ERP bakiyeyi okur |
Bu tablo her işletmede aynı olmaz, ama bir tablo çıkarmadan başlamak, sonradan "hangi rakam doğru?" tartışmasına yol açar.
Bağlantı yöntemini bilin
Muhasebe programına üç yoldan biriyle bağlanılır:
- API: Program bir arayüz sunuyorsa en temiz yol budur.
- Veri tabanı erişimi: API yoksa ya da yetersizse veri tabanına doğrudan bağlanılır. Güçlüdür ama program güncellemelerinde bozulma riski taşır.
- Dosya aktarımı: Dışa ve içe aktarma dosyalarıyla çalışır. Basittir, ama gecikmeli ve hataya açıktır.
Sisal Halı projesinde Bayt muhasebe ile hem veri tabanı (MSSQL) hem API üzerinden iki yönlü senkron kurduk. Hangi yolun seçileceği, programın ne sunduğuna bağlı.
Aynı kaydın iki kez yazılması: tekrar denemeyi güvenli kılın
Muhasebe entegrasyonlarında en pahalı hata, aynı faturanın ya da hareketin iki kez kaydedilmesidir. Muhasebe API'si sunan sağlayıcıların kendi rehberleri bu konuda aynı şeyi söylüyor:
- Her mantıksal işlem için kalıcı bir anahtar üretin ve isteği göndermeden önce saklayın; aynı anahtarla gelen tekrar istek yeni kayıt açmamalı (Merge, Wafeq).
- Kaynak kayıt numarası ile muhasebedeki kayıt numarasını eşleştiren bir tablo tutun; fatura numarası gibi sabit tanımlayıcıları muhasebe tarafında da saklayın (Orb).
- Olay tabanlı senkron bir olayı kaçırabilir. Bunu yakalamanın yolu, iki sistemi zamanlanmış olarak karşılaştıran bir mutabakattır (Tray).
- Hatalı kaydı atmayın, karantinaya alın ve görünür kılın; sessizce kaybolan kayıt ay sonunda mutabakat sorunu olarak geri döner.
- Kapalı dönem gibi istisnaları otomatik çözmeye çalışmayın. Kapanmış bir döneme kayıt atmak gerektiğinde işlem elle incelemeye gider.
Bunlar yabancı sağlayıcıların dokümanlarıdır; Türkiye'de kullanılan muhasebe programlarının her birinin kendi API ve kısıtları vardır. Ben de bu yüzden her entegrasyona programın gerçekte ne sunduğuna bakarak başlıyorum.
Projelerde en sık karşılaştığım durumlar
- "Rakamlar tutmuyor" şikâyetinin altından çoğu zaman bir tanım farkı çıkıyor. İki sistem aynı şeyi farklı tutuyor: cari kodu, KDV'li ve KDV'siz tutar, iade kaydı.
- Kapalı dönem kuralı entegrasyon tasarlanırken en son hatırlanan şey oluyor. Oysa ay sonunda en çok sorun çıkaran yer orası.
- Canlıya geçişin ilk haftasında muhasebeciyle yan yana oturup aktarımları tek tek kontrol etmek, sonradan günlerce fark aramaktan çok daha kısa sürüyor.
- Muhasebe programı güncellenince tek bir alanın değişmesi aktarımı durdurabiliyor. Her aktarım kayıt altında olduğu için neyin eksik gittiği ertesi gün görülüyor.
Hata yönetimi: sessiz hata en kötü hatadır
Entegrasyon bir gün mutlaka hata verir: ağ kesilir, muhasebe programı güncellenir, bir kayıt eksik gelir. Önemli olan hatanın görünür olması. Kurulumda şunlara dikkat ederim:
- Her aktarım kayıt altına alınır: ne zaman, hangi veri, sonuç ne.
- Başarısız aktarım tekrar denenir; tekrar da başarısızsa biri uyarılır.
- Yarım kalan aktarım (fatura gitti, stok gitmedi) geri alınabilir ya da tamamlanabilir olmalıdır.
- Bir ekran, bekleyen ve hatalı kayıtları gösterir.
Hata sessizce yutulursa, ay sonunda rakamlar tutmadığında nedenini bulmak günler alır.
Gerçek veriye dokunmadan önce kopya ortamda deneyin
Muhasebe verisi geri dönüşü zor bir veridir. Entegrasyonu önce kopya bir firma ya da veri tabanı üzerinde denemek, canlıya geçmeden aktarımın sonucunu muhasebeci ile birlikte kontrol etmek gerekir. Canlıya geçişte ilk günler aktarımları tek tek gözle doğrulamak da işin parçasıdır.
Yetki ve güvenlik
Entegrasyonun kullandığı kullanıcıya yalnızca ihtiyacı olan yetkiyi verin. Şifreleri ve bağlantı bilgilerini kodun içinde değil, güvenli bir yapılandırmada tutun. Özel yazılım hizmetimizde bu bilgiler teslimde yazılı olarak devredilir.
Özet
Önce veriyi ve yönünü belirleyin, bağlantı yöntemini seçin, hatayı görünür kılın ve kopya ortamda deneyin. Bu dört adım, entegrasyonun çalışıp çalışmayacağını ilk haftadan söyler.
Sık sorulan sorular
Muhasebe programımla ERP'nin bağlanıp bağlanmayacağını nasıl anlarım?
Programın bir API'si, veri tabanına erişim imkânı ya da dosya aktarımı sunup sunmadığına bakılır. Önce bu seçeneği kontrol ederim; seçenek yoksa entegrasyon yerine farklı bir yol önerilir.
Entegrasyon sırasında muhasebe verim bozulur mu?
Doğru kurulursa bozulmaz. Bunun için gerçek veriyle çalışmadan önce kopya ortamda denerim ve her aktarımın kaydını tutarım.
Entegrasyon tek yönlü mü olmalı, çift yönlü mü?
Veriye göre değişir. Bazı veriler tek yönlü akmalıdır, ikisi de yazarsa çakışma çıkar. Hangi verinin hangi sistemden yönetileceğini baştan belirlemek gerekir.
Yazar
Burak Meriç
Yazılım geliştirici ve danışman. Bayi portalı, ERP ve otomasyon projeleri geliştiriyor. Yazar sayfası
İlgili yazılar
ERP ve bayi portalı · 10 Ekim 2026
Bayi portalı nedir, hangi işletmelere gerekir?
Bayi portalı; üreticinin ve toptancının bayilerinden siparişi, fiyatı ve stoğu tek ekranda yönettiği sistemdir. Ne zaman gerektiğini anlatıyorum.