İçindekiler · 8 bölüm
Kısaca:
- Dia, Nebim, Odoo, Workcube gibi programlar için Finstant'ın hazır (native) aktarımı yoktur; bağlantı Finstant API ya da DLL ile kurulur.
- Finstant tüm bankalardaki bakiye, hesap ve POS hareketlerini tek formatta verir. Bu veriyi programınıza yazan bağlantıyı genellikle programın iş ortağı ya da şirketinizin yazılım ekibi kurar.
- Finstant API, Finstant Banka Hesap Yönetimi ile birlikte en az 50 hesapla verilir. Daha az hesapta tüm bankalardaki hareketler tek Excel dosyasıyla programa alınabilir.
Logo ya da Netsis kullanmıyorsanız "banka hareketlerim programa nasıl gelecek?" sorusunun cevabı genelde API'dir. Bu yazıda hazır entegrasyonu olmayan bir muhasebe ya da ERP programına banka hareketlerinin API ile nasıl aktarıldığını, bağlantıyı kurmadan önce neleri netleştirmeniz gerektiğini ve hangi durumda Excel'in yeterli olduğunu anlatıyoruz.
Hazır entegrasyon ile API bağlantısı arasındaki fark
Hazır (native) entegrasyon: Aktarımı Finstant kendisi yapar. Logo Go, Tiger, J-Platform, Bulut ERP, T/J/N-Series ve Netsis'te durum budur; hareketler ara yazılım olmadan doğrudan programa düşer. Ayrıntılar Logo ve Netsis sayfalarında.
API bağlantısı: Finstant, bankalardan toplanan veriyi tek bir yapıda sunar. Bu veriyi alıp programınıza kayıt olarak yazan adım, programınız tarafında kurulan bağlantıdır. SAP ve Mikro'da da aktarım bu yolla yapılır; Dia, Nebim, Odoo, Workcube ve benzeri programlar için de aynı yol geçerlidir.
API ile aktarım adım adım
1. Bankaları bağlayın. Banka hesaplarınız Finstant'a her bankanın kendi yetkilendirme akışıyla bağlanır. Banka şifreniz Finstant'a verilmez ve Finstant'ta saklanmaz.
2. Veriyi tek formattan alın. Her bankanın ekstre biçimi farklıdır. Finstant bakiye, hesap hareketi ve POS hareketlerini tüm bankalar için aynı yapıda verir; bağlantı banka banka ayrı ayrı yazılmaz.
3. Eşleştirme kurallarını belirleyin. Hangi banka hesabının programdaki hangi banka hesap koduna, hangi hareketin hangi cari karta gideceğini önceden tanımlayın. Eşleştirmede genellikle IBAN, vergi kimlik numarası ve açıklama alanındaki fatura ya da sipariş numarası kullanılır.
4. Programa yazın. Bağlantı, programınızın dışarıdan veri alma yolunu kullanarak hareketleri banka fişi ya da tahsilat kaydı olarak oluşturur.
5. Mükerrer kaydı önleyin. Her hareketin tekil bir kimliği saklanır; aynı hareket ikinci kez yazılmaz. Bağlantı yeniden çalıştığında yalnız yeni hareketler aktarılır.
6. Zamanlayın ve izleyin. Bağlantı belirli aralıklarla çalışır. Eşleşmeyen hareketler (ör. cari kartı bulunamayan bir tahsilat) bir listede toplanır ve elle tamamlanır.
Tahsilatların cari hesaplara otomatik eşleştirilmesi için tahsilat–cari eşleştirme rehberimize bakabilirsiniz.
API ile hangi veriler gelir?
| Veri | İçerik |
|---|---|
| Bakiye | Tüm bankalardaki TL ve döviz hesaplarının bakiyesi; firma, banka, hesap türü ve döviz cinsine göre toplamlar |
| Hesap hareketleri | Tarih, tutar, açıklama ve işlem tipi (EFT, havale, çek, POS, masraf gibi) |
| POS hareketleri | Tüm bankalardaki üye iş yerlerinin işlemleri; her işlemin brüt tutarı, komisyonu, bloke bilgisi ve net tutarı |
Bu veriler tüm bankalar için aynı yapıda geldiği için bağlantı bir kez yazılır; yeni bir banka eklendiğinde programınız tarafında değişiklik gerekmez. Gelen tahsilatların açıklamadaki koda ve gönderen IBAN'a göre cari hesaplarla nasıl eşleştirileceği havale ve EFT'lerin açıklamaya göre otomatik eşleştirilmesi yazımızda.
Kendi ERP sistemini yazan şirketler için: tüm bankalar tek API
Kendi ERP'sini ya da finans yazılımını geliştiren şirketler için en büyük iş, her bankayla ayrı bağlantı kurmak ve her bankanın farklı veri biçimini ayrı ayrı yorumlamaktır. Tüm bankaları tek API'de toplayan bir hesap bilgisi sağlayıcısıyla bu iş tek bağlantıya iner. Sağlayıcı seçerken şunları sorun:
| Soru | Neden önemli |
|---|---|
| Hangi bankalar bağlı; kamu, özel ve katılım bankaları dahil mi? | Eksik banka, o bankanın verisi için ayrı bir yol kurmak demektir |
| Veri modeli tüm bankalarda aynı mı? | Aynı değilse bağlantı yine banka banka yazılır |
| POS hareketleri API'de var mı? | Komisyon, bloke ve net tutar olmadan POS mutabakatı ayrıca yapılır |
| Veri ne sıklıkla güncelleniyor? | Tahsilatın cariye işlenme süresini belirler |
| Her hareketin tekil bir kimliği var mı? | Mükerrer kaydı önlemenin yolu budur |
| Hacim sınırı var mı? | Yüksek hacimde size ayrılmış bir ortam gerekebilir |
| Yasal statüsü ne? | Hesap bilgisi hizmeti 6493 sayılı Kanun kapsamında TCMB iznine tabidir |
| Banka şifresi isteniyor mu? | Güvenli bir yapıda istenmez |
Finstant'ta:
- Tek yapı, 32 banka: Türkiye'deki 32 bankadaki bakiye, hesap ve POS hareketleri tek yapıda gelir; yeni bir banka eklendiğinde sizin tarafınızda değişiklik gerekmez.
- API ya da DLL: Bağlantı Finstant API ya da DLL ile kurulur.
- Hacim: Public cloud lisansı yıllık 600.000 hesap ve POS hareketine kadardır; daha yüksek hacimde size ayrılmış private cloud kurulur.
- Lisans: Finstant API, Finstant Banka Hesap Yönetimi ile birlikte en az 50 hesapla verilir; banka, firma ve kullanıcı sayısı fiyatı değiştirmez.
- Güvenlik ve yasal durum: Banka şifreniz Finstant'ta saklanmaz. Finstant, Finstant Ödeme Kuruluşu A.Ş. tarafından sunulur; 6493 sayılı Kanun kapsamında ödeme kuruluşu faaliyet izni başvurusu Türkiye Cumhuriyet Merkez Bankası nezdinde devam etmektedir.
Programa göre durum
| Program | Aktarım yolu |
|---|---|
| Logo Go, Tiger, J-Platform, Bulut ERP, T/J/N-Series | Native (doğrudan) |
| Netsis | Native (doğrudan) |
| SAP | Finstant API; yüksek hacimde private cloud. SAP Business One ve S/4HANA için otomatik aktarım hazırlanıyor |
| Mikro | Finstant API veya DLL. Otomatik aktarım hazırlanıyor |
| Dia, Nebim, Odoo, Workcube ve diğerleri | Finstant API veya DLL ya da Excel |
Dia, Nebim, Odoo ve Workcube gibi programların çoğu dış sistemlerden veri almak için bir API, web servisi ya da içe aktarma aracı sunar. Hangisinin sizin sürümünüzde ve lisansınızda açık olduğunu programınızın iş ortağı ya da destek ekibi söyler. Bağlantıyı kurmadan önce bu bilgiyi almak, işin süresini ve maliyetini doğrudan belirler.
Hangi yol size uygun?
- API: 50 ve üzeri hesabınız varsa, günde çok sayıda hareket oluşuyorsa ya da birden fazla şirketi aynı yapıda yönetiyorsanız.
- Excel: Hesap sayınız azsa ya da bağlantı kurulana kadar hızlı başlamak istiyorsanız. Tüm bankalardaki hareketler Finstant'ta tek listede filtrelenip Excel'e alınır; programınızın içe aktarma ekranıyla yüklenir. Her bankadan ayrı dosya indirmek gerekmez.
İki yöntemin dosya tarafındaki farkları için MT940 mı API mi yazımıza, programa göre genel durum için muhasebe programına banka hareketi aktarımı rehberine bakabilirsiniz.
Başlamadan önce kontrol listesi
- Programınızın dışarıdan veri alma yolu (API, web servisi ya da içe aktarma) sizin sürümünüzde açık mı?
- Banka hesap kodlarınız ve cari kartlarınızda IBAN ve vergi kimlik numarası dolu mu?
- Bağlantıyı kim kuracak: programın iş ortağı mı, şirket içi yazılım ekibi mi?
- Kaç hesabınız var (IBAN ve POS üye iş yeri)? Lisans bu sayıya göre belirlenir.
Lisans
Lisans, görmek istediğiniz banka hesabı (IBAN) ve POS üye iş yeri sayısına göre belirlenir. Banka, firma ve kullanıcı sayısı fiyatı değiştirmez; kurulum ücreti yoktur. Finstant API, Finstant Banka Hesap Yönetimi ile birlikte en az 50 hesapla verilir. Ayrıntılar lisanslama sayfasında; hesap sayınıza göre fiyatı 1 dakikada görebilirsiniz.


