İçeriğe geç
Banka Entegrasyonu

Banka Entegrasyonu & Otomatik Mutabakat

Banka entegrasyonunun zor kısmı hareketleri çekmek değil, açıklama metnindeki dağınık bilgiyi doğru cariye ve doğru faturaya bağlamaktır. Bu rehberde verinin bankadan hangi kanalla alınacağını (API, MT940, CAMT.053, CSV), eşleştirme motorunun hangi sırayla karar verdiğini ve kısmi, toplu, masraflı ödeme gibi gerçek hayat senaryolarının nasıl çözüldüğünü uygulama örnekleriyle anlatıyoruz.

11 dk okuma 18 soru-cevap 8 ana konu Güncelleme: 26 Temmuz 2026
Kısa Cevap

Banka entegrasyonu, banka hesap hareketlerinizin yazılımınıza otomatik akması ve gelen her havale/EFT'nin doğru cariyi bularak ilgili faturayı kapatmasıdır. İşin iki ayrı katmanı vardır: veriyi alma katmanı — bankanın açık bankacılık/kurumsal API'si, MT940 ekstre dosyası ya da ISO 20022 tarafındaki CAMT.053 — ve anlamlandırma katmanı, yani açıklama metnini ayrıştırıp tutar, fatura numarası, VKN/TCKN ve IBAN üzerinden eşleştiren kural motoru. Şirketlerin çoğu birinci katmanı kurup ikincisini eksik bırakır; sonuç, ekranda akan ama kimseye bağlanmayan hareket listesidir. Doğru kurgulanmış bir mutabakatta işlemlerin büyük bölümü otomatik kapanır, güven eşiğinin altında kalan belirsiz kayıtlar ise otomatik kapatılmaz; tarih, tutar ve aday cari önerisiyle birlikte onay kuyruğuna düşer ve operasyon ekibi tek ekrandan karar verir. Zincirin tamamlanması için banka tarafının muhasebe programı entegrasyonuyla Logo, Mikro veya Netsis tarafına işlenmesi ve e-Fatura API akışıyla ilişkilendirilmesi gerekir: tahsilat, cari kapama ve belge tek hat üzerinde yürüdüğünde ay sonu kapanışı günlerden saatlere iner.

Rehberin Ana Konuları

Banka entegrasyonunu gerçekten otomatik yapan sekiz teknik karar

Veriyi hangi kanaldan aldığınızdan güven eşiğini nereye koyduğunuza kadar, mutabakatın altıncı ayda hâlâ çalışıp çalışmayacağını bu başlıklar belirler.

Veriyi Bankadan Almanın Dört Yolu

Banka verisini yazılıma taşımanın pratikte dört kanalı var. En modern olanı bankanın açık bankacılık/kurumsal API'si: OAuth 2.0 ile yetki verilir, hareketler yapılandırılmış JSON olarak dakikalar içinde düşer. İkincisi SWIFT MT940 (gün sonu ekstresi) ve MT942 (gün içi ara ekstre) dosyalarıdır; çok yaygındır ama açıklama alanı kısıtlı ve serbest metin olduğu için eşleşme oranını aşağı çeker. Üçüncüsü ISO 20022 ailesinden CAMT.053 ve CAMT.054; alanları yapılandırılmış olduğundan ayrıştırması MT940'tan belirgin biçimde temizdir. Dördüncüsü SFTP veya e-posta ile gelen CSV/Excel ekstreleri: hızlı başlatır, uzun vadede kırılgandır. Karar kriteri nettir — gün içi tahsilat görünürlüğü kritikse API, gün sonu kapanışı yetiyorsa dosya tabanlı yöntem. Türkiye'de gerçek tablo genelde karmadır: büyük bankalarda API, küçük ve katılım bankalarında MT940 ile ilerlersiniz.

Eşleştirme Motoru Hangi Sırayla Karar Verir

Sağlam bir mutabakat motoru tek kuralla değil, kademeli bir hiyerarşiyle çalışır. Önce kesin eşleşme denenir: açıklamadaki fatura numarası veya tahsilat referansı ile tutar birebir tutuyorsa kayıt otomatik kapanır. Tutmazsa kural tabanlı ayrıştırma devreye girer; açıklama metninden düzenli ifadelerle sipariş numarası, bayi kodu veya VKN/TCKN çekilir. O da yoksa gönderen unvanı ile cari unvanı arasında bulanık eşleştirme (metin benzerliği) yapılır; "OZKAN GIDA SAN TIC LTD" ile "Özkan Gıda San. ve Tic. Ltd. Şti." bu adımda birleşir. Her aday eşleşme puanlanır: puan güven eşiğinin üstündeyse otomatik kapanır, altındaysa onay kuyruğuna düşer. Eşiği yükseltmek hatayı azaltır ama manuel yükü artırır. Sağlıklı yaklaşım, ilk ay eşiği yüksek tutmak, onay kuyruğunda hangi kararların hep doğru çıktığını ölçmek ve eşiği veriye bakarak kademeli gevşetmektir.

Gerçek Hayat Senaryoları: Kısmi, Toplu ve Eksik Ödeme

Ödemeler ders kitabındaki gibi gelmez ve projeler tam burada tökezler. Bir müşteri beş faturasını tek havaleyle kapatır; motorun açık fatura kümesinde toplamı tutan alt kümeyi bulması gerekir. Bir başkası 48.500 TL'lik faturaya 48.470 TL gönderir çünkü EFT masrafını düşmüştür; burada küçük bir tutar toleransı ve masraf kalemi kuralı işi çözer. Fazla ödeme avansa yazılmalı, iade ve ters kayıt daha önce eşleşmiş tahsilatı geri açmalı, döviz hesabında kur farkı ayrı kaleme düşmelidir. Kısmi ödemede fatura yarı kapalı görünür, kalan bakiye vade takibinde kalır. Edge Bilişim olarak bu projelerde analiz aşamasında son üç ayın gerçek ekstresini alıp kuralları canlıya çıkmadan önce simüle ediyoruz; hangi senaryonun kaç kez geçtiğini görmeden yazılan eşleştirme kuralları ikinci ayda güvenilirliğini kaybediyor.

Veri Tazeliği: Webhook, Polling ve Mükerrer Kayıt

"Anlık akıyor" ifadesi çoğu zaman abartılıdır; bankaların büyük kısmı hareketleri belirli aralıklarla paylaşır. Pratikte iki desen kullanılır: bankanın olay gönderdiği webhook ve sizin periyodik sorgu attığınız polling. Polling'de sorgu sıklığı bankanın kota sınırına göre ayarlanmalı, hata durumunda üstel geri çekilme ile yeniden denenmelidir. Her iki desende de aynı hareketin iki kez işlenmemesi için banka referansı üzerinden tekilleştirme ve idempotency anahtarı şarttır — mükerrer kayıt, mutabakatı bozan en sinsi hatadır ve genelde haftalar sonra fark edilir. Valör ile bloke tutar farkına da dikkat edin: ekstrede görünen tutarla kullanılabilir bakiye aynı olmayabilir. Günlük işlem adedi binleri geçtiğinde çekme, ayrıştırma ve eşleştirme adımlarını kuyruk üzerinden ayırmak, yani ölçeklenebilir bir servis mimarisi kurmak, gecikmeyi öngörülebilir tutar.

Muhasebe, ERP ve e-Fatura Zincirini Kapatmak

Eşleşen tahsilatın yazılımda kapanması yarı yoldur; kaydın muhasebeye de doğru fişle düşmesi gerekir. Logo, Mikro, Netsis veya Paraşüt entegrasyonunda banka hareketi ilgili cari hesaba, komisyon ve masraf ayrı gider hesabına, kur farkı kendi kalemine yazılır; hesap planı eşlemesi baştan tanımlanmazsa mali müşavir her ay elle düzeltmek zorunda kalır. Kurumsal tarafta SAP entegrasyonu senaryosunda mutabakat sonuçları genelde ara katman üzerinden FI modülüne aktarılır ve iki sistemin aynı belge numarasını taşıması sağlanır. Tahsilatın karşılığındaki belge tarafında ise GİB e-Fatura API akışı devreye girer: ödeme geldiğinde fatura durumu güncellenir, tahsil edilmemiş belgeler ayrı listede kalır. Zincir kapandığında "kim ne kadar borçlu" sorusu tek ekrandan yanıtlanır.

POS, Sanal POS ve Alternatif Tahsilat Mutabakatı

Banka hesabına düşen tutar, müşterinin ödediği tutar değildir; kart tahsilatında komisyon kesilmiş, taksitli işlemde hak ediş aylara bölünmüştür. Bu yüzden POS entegrasyonu tarafındaki işlem kaydı ile banka ekstresindeki toplu hak ediş satırının ayrı ayrı tutulup birbirine bağlanması gerekir: bir günün 180 kart işlemi, ertesi gün tek satır olarak yatar. Aynı mantık e-ticaret platformu entegrasyonundaki pazaryeri hak edişleri, QR ve dijital cüzdan ödemeleri ile yemek kartı tahsilatları için de geçerlidir. Bayi ağı olan işletmelerde DBS (Doğrudan Borçlandırma Sistemi) ve toplu tahsilat dosyaları ayrı bir kanal olarak modellenir; bankadan gelen borçlandırma sonucu, siparişin kredi limitini de günceller.

Yetkilendirme, Güvenlik ve KVKK Tarafı

Entegrasyon internet bankacılığı şifrenizle değil, bankanın kurumsal servisine verdiğiniz yetkiyle çalışır. Süreç genelde şöyle ilerler: şubeyle kurumsal API/entegrasyon sözleşmesi imzalanır, test ortamı için kimlik bilgileri üretilir, IP kısıtı ve sertifika tanımlanır, ardından canlı yetki açılır — bu adım bankaya göre birkaç günden birkaç haftaya kadar sürebilir. Teknik tarafta OAuth 2.0 ve mTLS ile kimliklenir, veri aktarımda ve saklamada şifrelenir, erişim rol bazlı sınırlanır ve her sorgu iz kaydına yazılır. Kritik ayrım şudur: hesap bilgisi yetkisi yalnızca okuma sağlar, para transferi için ödeme yetkisi ayrıca tanımlanır — çoğu mutabakat projesinde ödeme yetkisi hiç açılmaz ve bu bilinçli bir güvenlik tercihidir. Kişi verisi içeren açıklama alanları KVKK kapsamında değerlendirilir; saklama süresi ve maskeleme kuralları baştan yazılır.

Yol Haritası, Süre ve Maliyet Aralıkları

Sağlıklı kurulum pilotla başlar: tek banka, tek hesap, bir ay gerçek veriyle paralel çalışma. Bu dönemde ölçülecek üç KPI vardır — otomatik eşleşme oranı, onay kuyruğundaki kayıt sayısı ve hareketin bankadan yazılıma düşme gecikmesi. Süre tarafında tek bankalı, okuma odaklı bir kurulum tipik olarak 3-6 hafta; çok bankalı, ERP ve DBS içeren kapsam 8-16 hafta bandındadır ve bu sürenin önemli kısmı yazılım değil banka yetkilendirmesidir. Maliyette iki kalem ayrışır: bankanın kurumsal servis/abonelik ücreti (hesap ve hacme göre aylık birkaç yüz TL'den birkaç bin TL'ye kadar değişen, kurumsal segmentte kimi zaman ücretsiz bir kalem) ve yazılım geliştirme bedeli. Geliştirme bedelini banka adedi, format çeşitliliği, eşleştirme kurallarının derinliği ve muhasebe/ERP kapsamı belirler. Edge Bilişim olarak bu kurulumları özel yazılım geliştirme sürecinin parçası olarak yürütüyor, eşleştirme kurallarını sizin ekibinizin panelden düzenleyebileceği şekilde dışarı alıyor ve teslimde kaynak kodu Git deposuyla devrediyoruz.

Banka Entegrasyonu & Mutabakat projenizi konuşalım — ihtiyacınızı ücretsiz analiz edelim, aynı gün dönüş yapalım.
WhatsApp
Sıkça Sorulan Sorular

Banka Entegrasyonu ve Otomatik Mutabakat Hakkında Sık Sorulan Sorular

18 gerçek soruya net cevap — aradığınızı yazarak filtreleyin.

Banka entegrasyonu, banka hesap hareketlerinizin işletme yazılımınıza otomatik aktarılması ve gelen ödemelerin ilgili fatura/cari kayıtla eşleştirilmesidir. İki bileşenden oluşur: verinin bankadan alınması (API, MT940, CAMT.053 veya ekstre dosyası) ve alınan hareketin anlamlandırılıp doğru cariye bağlanması. Sadece birincisi kurulursa elinizde yalnızca ekranda akan bir hareket listesi olur; asıl değer ikinci katmandadır.

Yardımcı olalım

Banka Entegrasyonu & Mutabakat konusunda bir projeniz ya da sorununuz mu var?

Edge Bilişim ekibi ihtiyacınızı ücretsiz analiz eder ve projeye özel net bir teklif sunar. Kaynak kodu size teslim edilen, lisans bağımlılığı olmayan çözümler; 200+ proje deneyimi ve 81 ilde uzaktan hizmet.

WhatsApp'tan Yazın Hemen Arayın

[email protected] · İstanbul (81 ile uzaktan hizmet)

Müşteri Yorumları

Müşterilerimiz Bizi Nasıl Değerlendiriyor?

5.0 3 değerlendirme Google Yorumları
5 100%
4 0%
3 0%
2 0%
1 0%
Google'da değerlendirin

Daha fazla yorum için kaydırın