← Belgeler / Kılavuzlar
Banka bağlantıları
Açık bankacılık (open banking) aracılığıyla bir banka bağlayın, hesaplarını eşleştirin, bir içe aktarım şablonu seçin ve işlem kayıtlarını deftere eşitleyin.
Bu kılavuz, bir bankaya canlı bağlantı kurma (PSD2 açık bankacılık) sürecini ele almaktadır: nasıl bağlanılacağını, banka hesaplarının yevmiye defterine (ledger) nasıl bağlanacağını, her eşitlemenin bir içe aktarım şablonu (import template) aracılığıyla nasıl iş ortakları (partner) oluşturacağını, faturaları eşleştireceğini ve masrafları kaydedeceğini ve eşitlemenin neleri döndürdüğünü açıklar. API ayrıntıları Banka ve ödeme içe aktarımları bölümündedir. Canlı bağlantı yerine ekstrak dosyaları kullanmak için Banka ekstrelerini içe aktarma (camt.053) bölümüne bakın.
1. Bankayı bağlama
Banka → Bağlantılar (Bank → Connections) altında ülkeyi seçin ve Bankaları göster (Show banks) düğmesine basın. Bankanızı ve hesap sahibi türünü (kurumsal veya bireysel) seçtikten sonra Bağlan (Connect) düğmesine basın. Bankanın kendi izin (consent) sayfasına yönlendirilirsiniz; burada oturum açıp erişimi onaylayın. Banka sizi yeniden Nordlet'a yönlendirir. Bağlantı, izin son kullanma tarihiyle birlikte listede görünür. İzinler banka tarafından süreli olarak verilir (genellikle 90 veya 180 gündür); süresi dolduğunda yeniden bağlanın.
Banka listesi, Nordlet örneği (instance) için yapılandırılmış açık bankacılık sağlayıcısından gelir. Ülkede hiç banka görünmüyorsa, sağlayıcı henüz o ülkeyi desteklemiyordur.
2. Banka hesaplarını bağlama
Bağlantı altında, bankanın sunduğu her hesap IBAN ve para birimiyle birlikte listelenir. Her biri için yevmiye defterinden mevcut bir banka hesabı seçin veya Yeni banka hesabı oluştur (Create a new bank account) seçeneğini kullanın, isteğe bağlı olarak eşitlemenin başlatılacağı tarihi belirleyin ve Bağla (Link) düğmesine basın. Yalnızca bağlanan hesaplar eşitlenir. Başlangıç tarihi belirtilmezse ilk eşitleme son 90 günü getirir.
3. İçe aktarım şablonunu oluşturma
Banka → İçe aktarım şablonları (Bank → Import templates) altında Yeni içe aktarım şablonu (New import template) düğmesine basın, tür olarak Banka bağlantısı (Bank connection) seçin ve bir ad verin. Satırlar, banka akışının (feed) işlem başına döndürdüğü özniteliklerdir. Dosyada zorunlu (Required in file) kutusu eksiksiz görünüm için tutulmaktadır; canlı akışlar buna göre doğrulanmaz.
Yevmiye hesabı (Ledger account). Düz tutar satırı transaction_amount.amount ve kural satırları bir yevmiye hesabına atanabilir. Atanan bir satırdan üretilen her eşitlenen işlem hemen kaydedilir ve yevmiye kaydıyla eşleşmiş olarak işaretlenir. Kural satırları, işlemleri banka işlem koduna veya yönüne göre seçer:
| Satır | Seçtiği | Tipik hesap |
|---|---|---|
| Banka masrafları (CHRG kodu) | kod ailesi CHRG olan işlemler |
banka masrafı gideri (standart hesap planında 6800) |
| Faiz (INTR kodu) | INTR kod ailesi |
faiz geliri veya gideri |
| Vergiler (TAXE kodu) | TAXE kod ailesi |
vergi ödemeleri |
| Diğer çıkan para | diğer tüm borç hareketleri | ödemelerin alış faturalarıyla eşleşmesi için "Kaydedilmedi" (Not posted) bırakın |
| Diğer giren para | diğer tüm alacak hareketleri | tahsilatların satış faturalarıyla eşleşmesi için "Kaydedilmedi" (Not posted) bırakın |
transaction_amount.amount |
hiçbir kuralın seçmediği her işlem | genellikle "Kaydedilmedi" (Not posted) |
Bir işlem, eşleştiği ilk satırın hesabına kaydedilir: önce kod ailesine, ardından yönüne ve son olarak düz tutar satırına bakılır. Kod, bankanın bank_transaction_code alanından gelir; herhangi bir kod göndermeyen bankalar, kod satırlarının eşleşmesiz kalmasına neden olur.
Eksik müşterileri / tedarikçileri oluşturma. Gelen parayı gönderen bilinmeyen her müşteri için bir müşteri kaydı oluşturmak üzere debtor.name satırında Eksik müşterileri oluştur (Create missing customers) seçeneğini işaretleyin. Giden paranın alıcısı olan bilinmeyen her tedarikçi için creditor.name satırında Eksik tedarikçileri oluştur (Create missing suppliers) seçeneğini işaretleyin. İş ortakları; IBAN (debtor_account.iban / creditor_account.iban, iş ortaklarının banka hesaplarında saklanır) ve ardından tam ada göre tanınır. Adıyla bulunan bir iş ortağına IBAN bilgisi eklenir. Yeni bir iş ortağı, adı bir tüzel kişilik ibaresi (UAB, MB, SIA, GmbH, Ltd, …) içeriyorsa şirket, aksi takdirde gerçek kişidir.
Banka için iş ortağı oluşturma. Bunu Banka masrafları kural satırında işaretleyin. Eşitleme, bağlı bankanın adıyla bir tedarikçi oluşturur ve yevmiye kaydındaki her masrafı bu iş ortağıyla kaydeder.
Faturaları bu alanla bağlama. Bunu remittance_information veya reference_number satırında işaretleyin. Açıklama metni veya referansı, açık kesilmiş bir satış faturasının (gelen para) veya kayıtlı bir alış faturasının (giden para) numarasını içeren her yeni işlem o faturayla eşleştirilir ve ödeme kaydedilir. Ödemeyi yapan kişi, kayıtlı bir IBAN veya tam iş ortağı adı/kodu ile bilinen bir iş ortağıysa, faturanın o iş ortağına ait olması gerekir. Bilinmeyen bir ödeyiciden gelen ödeme, yalnızca kalan bakiye ile eşleştiğinde ve fatura numarası seri önekini içerdiğinde eşleştirilir. Kalan bakiyeden büyük bir ödeme hiçbir zaman eşleştirilmez. Bu kontrollerden geçmeyen işlemler, manuel olarak eşleştirmeniz için eşleşmemiş durumda kalır. Eşleşmeyen gelen ödemeler için avans faturası oluştur (Create advance invoices for unmatched incoming payments) seçeneği, bilinen bir iş ortağından gelen eşleşmemiş bir tahsilatı; ödeme tarihinde, belirtilen KDV oranında veya seçilen katalog kaleminde düzenlenen bir avans faturasına dönüştürür. Bunun çalışması için Eksik müşterileri oluştur (Create missing customers) seçeneğinin aktif ve iş ortağının bilinir olması gerekir.
Şablonu kaydedin.
4. Şablonu uygulama ve zamanlamayı seçme
Banka → Bağlantılar (Bank → Connections) sayfasına dönün; burada bağlanan her hesap için bir şablon seçimi ve zamanlama seçimi bulunur. Şablonu seçin, Manuel eşitle (Sync manually), Günlük eşitle (Sync daily), Haftalık eşitle (Sync weekly) veya Aylık eşitle (Sync monthly) seçeneklerinden birini belirleyin ve Uygula (Apply) düğmesine basın. Şablonu olmayan bağlı bir hesap da eşitlenir, ancak yalnızca işlemler kaydedilir; hiçbir kayıt oluşturulmaz, eşleştirilmez veya borç/alacak kaydedilmez.
Günlük, haftalık veya aylık zamanlama ile API hesabı kendi kendine eşitler: saatte bir, son eşitlemesi periyodundan (24 saat, 7 gün veya 30 gün) daha eski olan hesapları arar ve bunları tam olarak Şimdi eşitle (Sync now) seçeneğinde olduğu gibi eşitler, ardından şablonu çalıştırır. Zamanlanmış bir eşitleme, manuel eşitleme gibi kullanım kotasından düşer (getirilen her 10 işlem = bir istek). Banka eşitlemeyi reddederse (örneğin izin süresinin dolması nedeniyle), bağlantı hata iletisiyle işaretlenir ve siz yeniden bağlanana kadar atlanır.
5. Eşitleme
Bağlantı üzerindeki Şimdi eşitle (Sync now) düğmesine basın. Nordlet, bağlı her hesap için yeni deftere kaydedilmiş (booked) işlemleri getirir; bekleyen (pending) işlemler, banka bunları deftere işleyene kadar atlanır. İşlemler getirilir (son eşitlemeden bu yana, sonradan yapılan kayıtların kaçırılmaması için bir haftalık örtüşmeyle), bankanın giriş referansıyla tanınarak bir kez kaydedilir ve ardından hesabın şablonu çalıştırılır. Sonuç satırı, kaç işlemin içe aktarıldığını ve kaçının zaten mevcut olduğunu bildirir. API aracılığıyla yapılan eşitleme ayrıca; kaydedilen hareket sayısını, oluşturulan iş ortaklarını, bağlanan ve oluşturulan faturaları, eşleşen ödemeleri ve eşleştirilemeyen ödemeler için uyarıları döndürür.
Eşitlemeler, API üzerinden (bank/feeds/sync) bir zamanlamaya göre tetiklenebilir; getirilen her 10 işlem bir API isteği olarak sayılır.
6. Sonrasında nereye bakılmalı?
- Banka → İşlemler (Bank → Transactions) - hesap bazlı sekmelerle birlikte eşitlenen tüm işlemler; eşleşenler ilgili faturaya veya yevmiye kaydına bağlantı sağlar.
- Faturalar (Invoices) - eşleşmeyen tahsilatlar için oluşturulan avans faturaları.
- İş ortakları (Partners) - banka hesapları altında IBAN bilgileriyle birlikte oluşturulan müşteri ve tedarikçiler.
- Yevmiye defteri → Yevmiye (Ledger → Journal) - masraflar (iş ortağı olarak banka ile), faiz, vergiler ve ödemeler için yapılan kayıtlar.
Bağlantı çalışmayı durdurduğunda
Başarısız olan bir eşitleme, bağlantıyı bankanın hata mesajıyla işaretler. Süresi dolmuş izin yaygın bir nedendir: aynı banka için Bağlan (Connect) düğmesine tekrar basıp erişimi onaylayın; bağlı hesaplar ve şablonları korunur. Bağlantıyı kes (Disconnect) seçeneği, bağlantıyı ve hesap bağlantılarını kaldırır, ancak halihazırda kaydedilmiş olan işlemleri silmez.