Canlı Banka Bağlantısı — Sıfırdan Rehber

Anlaşmalı bankanızla bir sözleşme yaptıysanız, hesap hareketlerini ekstre dosyası indirmeden doğrudan bankadan alabilirsiniz. Sistem yöneticisi bağlantıyı bir kez Ayarlar › Firma Bilgileri › Banka bağlantıları bölümünde kurar; sonra hareketler belirlenen aralıkla (ya da Şimdi çek ile) gelir ve dosyadan içe aktarılanlarla aynı eşleştirmeden geçer. Aynı hareket hem bağlantıdan hem dosyadan gelse bile iki kez yazılmaz.

1. Ne işe yarar, ne yapmaz

Bankadan yalnız okur: hesap listesi, bakiye ve hareketler. Bankaya ödeme emri göndermez, para taşımaz.
Gelen hareketler Banka Hareketleri penceresine düşer ve orada eşleştirilir; makbuzu yine siz (ya da otomatik makbuz ayarı) yazarsınız.
E-posta bildirimlerini okuyan eski banka servisi (mail/PDF ekstre) ayrı bir yoldur ve çalışmaya devam eder.

2. Bağlantı yöntemleri

Yöntem	Ne gerekir	Durum
Türkiye açık bankacılık (ÖHVPS · hesap bilgisi hizmeti)	Bir firma bankaya doğrudan bağlanamaz: lisanslı bir YÖS (ödeme hizmeti sağlayıcısı) aracılığı, banka uygulamasında onaylanmış rıza ve erişim belirteci gerekir.	Standarda göre yazıldı; YÖS sözleşmesiyle etkinleşir.
Türk bankalarının kurumsal hesap hareketleri web servisi (Garanti BBVA, İş Bankası, Yapı Kredi, Akbank, Ziraat, Halkbank, VakıfBank, QNB, DenizBank, Kuveyt Türk)	Şubeyle yapılan ERP entegrasyonu sözleşmesi; web servis kullanıcı adı/parolası, müşteri numarası, sunucunun IP izni (Garanti BBVA'da istemci kimliği/sırrı ve e-şubede üretilen rıza numarası).	Katalogda görünür; servis belgesi bankadan gelince sürücüye işlenir. O zamana kadar durum "Banka sözleşmesi gerekli".
Endonezya Bank Indonesia SNAP (BCA, Bank Mandiri, BNI, BRI)	Bankanın geliştirici portalında kayıt ve kurumsal sözleşme; X-CLIENT-KEY, istemci sırrı, bizim ürettiğimiz RSA anahtar çiftinin açık anahtarı bankaya, X-PARTNER-ID, CHANNEL-ID, hesap numaraları.	İmza ve uçlar standarda göre yazıldı; gerçek bankayla ilk test sözleşmeden sonra.
Simülasyon (test bankası)	Kullanıcı adı `demo`, herhangi bir parola. Gerçek bankaya gitmez; her gün için hep aynı örnek hareketleri üretir.	Kurulum provası ve eğitim için.

3. Kimlik şifreleme anahtarı

Bankanın verdiği parola, istemci sırrı ve özel anahtar veritabanına şifreli yazılır (AES-256-GCM). Şifreleme anahtarı veritabanında değil, sunucunun ortamındadır: HNR_BANKA_KIMLIK_ANAHTARI. Bu kurulumda anahtar Windows'un kullanıcıya bağlı korumasıyla (java\gpt\tls\banka-kimlik.dpapi.xml) saklanır ve Node başlatıcısı açılışta verir. Anahtar yoksa ekranda "Kimlik şifreleme anahtarı tanımlı değil" uyarısı çıkar; kimlik kaydedilemez, bankaya bağlanılamaz. Anahtar değişirse kayıtlı kimlikler çözülemez — ekranda "Şifreleme anahtarı değişmiş" yazar ve kimlik bilgileri yeniden girilir.

4. Bağlantı kurmak — dört adım

Banka ve bağlantı yöntemi: Ayarlar › Firma Bilgileri › Banka bağlantıları › Yeni bağlantı. Listeden bankayı/yöntemi seçin; altında belgenin kaynağı ve Bankadan istenecek bilgiler listesi çıkar — bankaya bu listeyle başvurun.
Kimlik ve bağlantı ayarları: bağlantıya bir ad verin, bankanın verdiği alanları doldurun ve Kaydet ve devam et'e basın. Gizli alanlar (parola, sır, özel anahtar) kaydedildikten sonra bir daha gösterilmez; kutuda "Kayıtlı — değiştirmek için yeni değeri yazın" yazar. Boş bırakırsanız eski değer korunur.
Bağlantı testi: Bağlantıyı test et bankada oturum açar, hesap listesini ve bakiyeleri getirir. Başarılıysa durum "Bağlantı çalışıyor" olur; değilse sebebi yazar (bölüm 7).
Hesap eşleme ve çekim: her banka hesabının yanında HNR'deki kasa/banka hesabını seçin (eşlenmeyen hesap çekilmez; bir HNR hesabı yalnız bir banka hesabına eşlenir). Çekim aralığı 5-60 dakika, ilk çekimde geriye gidilecek gün 0-90. Otomatik çekim açık işaretlenmezse hareketler yalnız Şimdi çek ile gelir. Kaydet ve kapat.

Önce Simülasyon sürücüsüyle bir prova bağlantısı kurun (kullanıcı adı demo): dört adımı, çekimi ve eşleştirmeyi gerçek banka beklemeden görürsünüz. "Örnek hareketler" kutusuna giris|tutar|açıklama|karşı ünvan|vkn satırları yazarak kendi açık faturalarınızla eşleşme deneyebilirsiniz. Provadan sonra bağlantıyı silin.

5. Çekim, mükerrer engeli ve eşleştirme

Her çekim, son başarılı çekimden bir gün öncesinden bugüne kadar olan hareketleri ister (ilk çekimde "geriye gidilecek gün" kadar; tek seferde en çok 31 gün). Örtüşen gün bilerek alınır: aynı hareket banka referansı, tarih, tutar ve yönle tanınır ve mükerrer sayılıp yazılmaz.
Yeni hareketler Banka Hareketleri penceresine "Canlı" kaynağıyla düşer ve hemen eşleştirilir (kesin / öneri / eşleşmedi). Otomatik makbuz canlı çekimde çalışmaz: kesin eşleşmelerin makbuzunu pencereden yazarsınız.
Aynı günün ekstresini sonradan MT940 dosyasıyla da yüklerseniz, banka referansı aynı olan satırlar mükerrer görünür.

6. Otomatik çekim ve bildirimler

Otomatik çekim sunucuda varsayılan kapalıdır; sistem yöneticisi BANKA_CANLI_GOREV=1 ile açar. Açıkken her bağlantı kendi aralığıyla eşitlenir. Hata olursa bekleme süresi her denemede ikiye katlanır (en çok 6 saat); kimlik reddi, sözleşme eksikliği ya da eksik ayar gibi kalıcı hatalarda otomatik deneme durur ve yönetici müdahalesini bekler. Yeni hareket alındığında bağlantıyı kuran yöneticiye Mesajlar'dan "… yeni banka hareketi alındı, … hareket eşleşme bekliyor." mesajı gider; üçüncü ardışık hatada bir kez uyarı gelir. Nabız ekranının Sırada bölümünde hata veren bağlantı ayrıca listelenir.

7. Durumlar ve hata sebepleri

Ekranda	Anlamı ve yapılacak
Yapılandırıldı, test bekliyor	Kaydedildi; Bağlantıyı test et'e basın.
Bağlantı çalışıyor	Son test ya da çekim başarılı.
Banka sözleşmesi gerekli	Bu banka için servis belgesi henüz yok ya da banka servisi açmamış. Bölüm 2'deki listeyle bankaya başvurun.
Kimlik bilgileri reddedildi	Parola/sır/rıza süresi dolmuş ya da yanlış. Yeni değeri girip yeniden test edin. Otomatik deneme bu hatada durur.
Bankaya ulaşılamadı · Banka servisi geçici olarak yanıt vermiyor	Ağ ya da banka tarafında geçici sorun; otomatik çekim artan aralıklarla yeniden dener.
Bağlantı ayarları eksik	Zorunlu alan boş, adres https değil ya da hesap eşlemesi yok. Formu tamamlayın.

8. Canlı sekmesi ve eşitleme günlüğü

Banka Hareketleri › Canlı sekmesi her bağlantının durumunu, son eşitlemeyi, son başarılı çekimi, eşlenen hesap sayısını ve çekim aralığını gösterir; sekme adındaki kırmızı sayı hata veren bağlantı sayısıdır. Yönetici burada Şimdi çek'e basabilir ve Eşitleme günlüğü'nü açabilir: her satırda zaman, sebep (elle / zamanlayıcı / pencere açılınca / bağlantı testi), durum, alınan, yeni, mükerrer, kesin ve öneri sayıları ile varsa hata mesajı durur. Kimlik bilgisi günlüğe hiçbir zaman yazılmaz.

9. Yetki ve güvenlik

Bağlantı kurmak, değiştirmek, silmek, test etmek, Şimdi çek ve günlük: yalnız sistem yöneticisi. Banka izni olan diğer kullanıcılar Canlı sekmesinde yalnız durumu görür.
Kimlik bilgileri API'den hiçbir zaman geri okunmaz; ekranda yalnız "şifreli kayıtlı" rozeti görünür. Şifreli değer başka bir bağlantıya ya da firmaya kopyalanırsa çözülmez.
Banka adresleri yalnız https:// olabilir; bankaya yalnız okuma çağrısı yapılır; her işlem denetim izine (kim, ne zaman, hangi IP) yazılır.

10. Telefonda

Banka Hareketleri penceresinde üçüncü sekme Canlı: bağlantı kartları, durum, son eşitleme ve büyük Şimdi çek düğmesi.
Ayarlar'daki bağlantı formu telefonda adım adım açılır: Banka → Kimlik → Test → Hesaplar.

11. Sık sorulanlar

Soru	Cevap
Kendi internet şubesi parolamı girebilir miyim?	Hayır. Bağlantı, bankanın ERP entegrasyonu için ayrıca verdiği web servis kullanıcısıyla ya da açık bankacılık rızasıyla çalışır. İnternet şubesi parolanızı hiçbir sisteme vermeyin.
Bankam listede var ama durum "Banka sözleşmesi gerekli".	Bankanın servis belgesi henüz sürücüye işlenmedi. Bölüm 2'deki "Bankadan istenecek bilgiler" listesiyle şubenize başvurun; belge gelince sürücü tamamlanır ve bağlantı testi açılır.
Hareketler neden kendiliğinden gelmiyor?	Ya bağlantıda Otomatik çekim açık işaretli değil, ya da sunucuda otomatik çekim görevi kapalı (`BANKA_CANLI_GOREV=1` değil). Canlı sekmesinin üstünde hangisinin geçerli olduğu yazar; bu arada Şimdi çek kullanılabilir.
Bağlantıyı silersem alınmış hareketler ne olur?	Kalır. Silinen yalnız bağlantı ve kayıtlı kimlik bilgileridir; hareketler, eşleşmeler ve yazılmış makbuzlar yerinde durur.

İlgili rehberler: Banka Hareketleri · Finans · Ayarlar · Mobil.