İçereği Atla

Odoo 19 Community: Banka ödemelerini faturalarla otomatik eşleştirme – açık kaynaklı Bank Statement Matcher'ımız

14 Eylül 2026 yazan
Odoo 19 Community: Banka ödemelerini faturalarla otomatik eşleştirme – açık kaynaklı Bank Statement Matcher'ımız
Alexander Biringer | Biricon IT Services GmbH

Banka hesap özetlerini Odoo'ya aktarmak yalnızca ilk adımdır. Asıl fayda, bir banka hareketi doğru satış faturasıyla, tedarikçi faturasıyla, alacak dekontuyla veya ödemeyle güvenilir biçimde eşleştirilebildiğinde ortaya çıkar.

Odoo 19 Community'de tam da bu noktada kullanıcı arayüzünde kullanışlı bir imkân eksik. Bu nedenle içe aktarılan banka satırları önce banka ara hesabında kalır ve sonraki işlemler için açık bir muhasebe kalemiyle eşleştirilmesi gerekir.

Bu yüzden kendi Odoo 19 Community kurulumumuz için Bank Statement Matcher'ı geliştirdik. Bu sorun yalnızca bizi ilgilendirmediği için modülü özgür AGPL-3 lisansı altında GitHub'da ücretsiz olarak sunuyoruz.

GitHub'daki projeye git:

Odoo 19 Bank Statement Matcher

Banka hesap özeti aktarımından doğru faturaya

Daha önce yayımladığımız Odoo 19 Bank Statement Import projesiyle Odoo 19 Community'ye çeşitli banka hesap özeti biçimleri okutulabilir. Bunlar arasında CAMT.053, CAMT.054, OFX ve SWIFT MT940 de bulunur.

Yeni Bank Statement Matcher, bu içe aktarmayı bir sonraki belirleyici iş adımıyla tamamlar:

İçe aktarılan hangi banka hareketi hangi açık kaleme aittir?

Modül açık alacakları ve borçları tarar, olası eşleşmeleri değerlendirir ve kullanıcılara belirli bir eşleştirmenin neden önerildiğini gösterir. Öneri incelenebilir, onaylanabilir, düzeltilebilir veya elle yapılan bir seçimle değiştirilebilir.

Böylece Odoo 19 Community için uçtan uca bir iş akışı ortaya çıkar:

  1. Banka hesap özetini içe aktarma

  2. olası eşleştirmeleri belirleme

  3. Önerileri toplu olarak inceleme

  4. net eşleşmeleri onaylama

  5. belirsiz durumları elle işleme

Odoo 19 Bank Statement Matcher neler yapabilir

Modül, muhasebede pratik kullanım için geliştirildi. Diğer işlevlerin yanı sıra şunları destekler:

  • Uygun faturaları, tedarikçi faturalarını, alacak dekontlarını ve ödemeleri arama

  • bir banka satırı oluşturulurken eşleştirme önerilerinin otomatik olarak belirlenmesi

  • kullanılan eşleştirme kuralının ve güvenilirliğinin anlaşılır biçimde gösterilmesi

  • daha sonraki bir zamanda yeniden arama

  • tekil eşleştirme veya birden fazla banka satırının birlikte işlenmesi

  • hiçbir öneri uymadığında açık bir kalemin elle seçilmesi

  • daha önce yapılmış bir eşleştirmenin geri alınması

  • keyfi karar vermeden, birden fazla eşdeğer eşleşmenin tespit edilmesi

  • henüz açık bir muhasebe kalemi bulunmayan tekliflere veya siparişlere ilişkin uyarılar

  • OCA banka hesap özeti aktarımından eşleştirme görünümüne isteğe bağlı doğrudan geçiş

  • İngilizce kaynak kodu için Almanca çeviri

Merkezi genel bakışa Odoo'da Muhasebe → Muhasebe → Banka satırı eşleştirmesi yolundan ulaşılabilir. Burada henüz açık olan banka satırları birlikte aranabilir ve işlenebilir.

Kara kutu yerine izlenebilir eşleştirme

Finansal verilerde rastgele herhangi bir eşleşme önermek yeterli değildir. Kullanıcılar, bir banka hareketinin neden belirli bir belgeyle eşleşmesi gerektiğini görebilmelidir.

Bank Statement Matcher bu nedenle açıkça tanımlanmış kurallar ve farklı güven düzeyleriyle çalışır:

GüvenKuralAnlamı
100ReferansAçıklama metninde bir belge numarası, ödeme referansı veya kaynak referansı bulundu.
80İş ortağı ve tutarİş ortağı ve açık tutar uyuşuyor.
60Benzersiz tutarTutar yalnızca tek bir açık kalemle tam olarak uyuşuyor.
30İş ortağıİş ortağı uyuşuyor, ancak tutar uyuşmuyor; bu yalnızca bir ipucudur.

Her yevmiye defteri için, net bir önerinin toplu işlemle hangi güven düzeyinden itibaren onaylanabileceği belirlenebilir. Daha zayıf eşleşmeler görünür kalır, ancak tek tek incelenmeli ve onaylanmalıdır.

Burada önemli olan: Modül arka planda gözetimsiz kayıt yapmaz. Öneriler oluşturur. Eşleştirme ancak kullanıcının bilinçli bir eylemiyle gerçekleşir – tek tek veya kontrollü toplu işlemle.

Zor banka referansları da dikkate alınır

Bankalar ödeme referanslarını her zaman tek tip bir biçimde iletmez. Bir fatura numarası adlarla, rakamlarla veya başka bilgilerle birleşmiş olabilir. Ayırıcı karakterler eksik olabilir veya özgün belgedekinden farklı gösterilebilir.

Bu nedenle Matcher karşılaştırma değerlerini normalleştirir ve harfler ile rakamlar arasındaki geçişleri de dikkate alır. Böylece referanslar, banka metninde diğer içeriklere doğrudan eklenmiş olsalar bile tanınabilir.

Arama bilinçli olarak Odoo belgesinden banka metnine doğru yapılır. Bu sayede açıklama metnindeki kısa, genel rakam dizilerinin çok sayıda uygunsuz eşleşmeye yol açması önlenir.

Kurallar belirli bir bankayla, belirli bir ülkeyle ya da sabit bir numara şemasıyla sınırlı değildir. Bu, modülü diğer Odoo 19 Community kurulumları için de ilgi çekici kılar.

Yeniden aramanın neden önemli olduğu

Her banka ödemesi daha içe aktarma sırasında eşleştirilemez. Pratikte bir ödeme, ilgili fatura Odoo'da oluşturulmadan veya kaydedilmeden önce gelebilir. Bir tedarikçi faturası veya alacak dekontu da ancak daha sonra girilebilir.

Bu nedenle banka satırları “Yeniden ara” ile daha sonraki bir zamanda tekrar kontrol edilebilir. Uygun açık kalem mevcut olur olmaz, daha önce eşleştirilemeyen bir banka hareketi net bir eşleşmeye dönüşebilir.

Banka metni örneğin henüz faturası ve dolayısıyla açık kalemi bulunmayan bir teklifi veya siparişi belirtiyorsa, modül yararlı bir uyarı verir. Yalnızca “eşleşme yok” göstermek yerine, belki önce faturanın oluşturulması gerektiğine dikkat çeker.

Güvenlik önceliklidir

Yanlış bir otomatik eşleştirme, muhasebede açık bir banka satırından daha fazla iş çıkarabilir. Bank Statement Matcher bu nedenle bilinçli olarak temkinli tasarlanmıştır:

  • Eşit puanlı eşleşmeler keyfi olarak çözülmez.

  • Zayıf öneriler gösterilir, ancak toplu işlemle onaylanmaz.

  • Eşleştirmeden önce açık kalemin hâlâ kullanılabilir olup olmadığı yeniden kontrol edilir.

  • Bu arada başka bir kullanıcı tarafından kapatılmış bir kalem tekrar işlenmez.

  • Her banka satırı kendi veritabanı kayıt noktası (savepoint) içinde işlenir.

  • Bir banka satırındaki hata, diğer tüm satırların işlenmesini engellemez.

  • Geçerli bir kayıt tarihi olmayan eksik eski veriler güvenlik gereği dışarıda bırakılır.

Böylece modül, otomasyonu zaman kazandırdığı yerde destekler ve veri durumunun yeterince net olmadığı yerde elle karar verilmesini ister.

Bank Statement Import ile birlikte çalışma

Depo iki modülden oluşur:

ModülGörev
account_statement_matcherAsıl arama, değerlendirme, kontrol ve eşleştirmeyi sağlar. Yalnızca Odoo modülü account gerektirir.
account_statement_matcher_import_ocaOCA banka hesap özeti aktarımına isteğe bağlı köprü. Bir içe aktarmadan sonra, yeni içe aktarılan satırlarla birlikte doğrudan eşleştirme görünümü açılır.

İsteğe bağlı köprü, hem Matcher hem de OCA modülü account_statement_import_file mevcut olduğunda otomatik olarak kurulur. Böylece banka hesap özeti aktarımı ve ardından gelen eşleştirme doğrudan birbirine geçer.

Desteklenen banka biçimlerinin içe aktarılması hakkında daha fazla bilgiyi şu yazımızda bulabilirsiniz:

Odoo 19 Bank Statement Import – Odoo Community için geliştirdiğimiz eklentiler

Odoo 19 Community'de kurulum

Kurulum, olağan bir Odoo ek modülünde olduğu gibi yapılır:

  1. Modül klasörlerini yapılandırılmış bir Odoo addons yoluna kopyalayın.

  2. Odoo'daki uygulama listesini güncelleyin.

  3. Bank Statement Matcher modülünü kurun.

  4. Her banka yevmiye defteri için içe aktarma sırasında önerilerin aranıp aranmayacağını belirleyin.

  5. Kontrollü toplu eşleştirme için istenen asgari değeri seçin.

Modül Odoo 19.0 Community için geliştirildi ve test edildi. Başka Odoo sürümleriyle kullanmadan önce, özellikle iç muhasebe ve mutabakat işlevlerindeki değişiklikler kontrol edilmelidir.

Muhasebe alanındaki her eklentide olduğu gibi, kurulumu önce kendi veritabanınızın bir kopyası ve tipik banka hesap özetleriyle bir test ortamında denemenizi öneririz.

Odoo Community için ücretsiz ve açık kaynak

Biricon IT Services GmbH olarak çözümleri önce kendi işletmemizdeki somut gereksinimler için geliştiriyoruz. Bundan genel olarak kullanılabilir bir modül çıkarsa, onu tek bir kurulumun içinde saklamak istemiyoruz.

Odoo 19 Bank Statement Matcher bu nedenle ücretsiz bir açık kaynak projesi olarak sunulmaktadır. Kaynak kodu incelenebilir, denetlenebilir, uyarlanabilir ve AGPL-3 lisansı çerçevesinde geliştirilmeye devam edilebilir.

Amacımız mümkün olduğunca çok kayıt kararını körü körüne otomatikleştirmek değil. Tekrarlayan işi azaltmak ve aynı zamanda finansal eşleştirmelerin izlenebilir ve denetlenebilir kalmasını sağlamak istiyoruz.

Biz anlamlı açık kaynak geliştirmeyi şöyle anlıyoruz: Gerçek bir sorunu çözmek, çözümü şeffaf biçimde belgelemek ve ardından topluluğun kullanımına sunmak.

Proje, kaynak kodu ve katkı

Kaynak kodunun tamamı, kurulum notları ve teknik belgeler GitHub'da mevcuttur:

Odoo 19 Bank Statement Matcher'ı GitHub'da aç

Pratik deneyimlere, hata raporlarına, iyileştirme önerilerine ve Odoo Community'den gelen katkılara açığız.

Ücretsiz. İzlenebilir. Açık kaynak. Odoo 19 Community için.