Přejít na obsah

Odoo 19 Community: Automatické přiřazování bankovních plateb k fakturám – náš open-source Bank Statement Matcher

14. září 2026 od
Odoo 19 Community: Automatické přiřazování bankovních plateb k fakturám – náš open-source Bank Statement Matcher
Alexander Biringer | Biricon IT Services GmbH

Import bankovních výpisů do Odoo je jen prvním krokem. Skutečný užitek vzniká teprve tehdy, když lze bankovní pohyb spolehlivě přiřadit ke správné vystavené faktuře, faktuře dodavatele, dobropisu nebo platbě.

Právě zde chybí Odoo 19 Community pohodlná možnost v uživatelském rozhraní. Importované bankovní řádky proto zpočátku zůstávají na přechodném bankovním účtu a pro další zpracování je nutné je přiřadit k otevřené účetní položce.

Pro naši vlastní instalaci Odoo 19 Community jsme proto vyvinuli Bank Statement Matcher. Protože se tento problém netýká jen nás, poskytujeme modul zdarma na GitHubu pod svobodnou licencí AGPL-3.

K projektu na GitHubu:

Odoo 19 Bank Statement Matcher

Od importu bankovního výpisu ke správné faktuře

S naším již zveřejněným projektem Odoo 19 Bank Statement Import lze do Odoo 19 Community načítat různé formáty bankovních výpisů. Patří mezi ně mimo jiné CAMT.053, CAMT.054, OFX a SWIFT MT940.

Nový Bank Statement Matcher doplňuje tento import o další rozhodující pracovní krok:

Který importovaný bankovní pohyb patří ke které otevřené položce?

Modul prohledává otevřené pohledávky a závazky, vyhodnocuje možné shody a uživatelům ukazuje, proč se určité přiřazení navrhuje. Návrh lze zkontrolovat, potvrdit, opravit nebo nahradit ruční volbou.

Pro Odoo 19 Community tak vzniká ucelený pracovní postup:

  1. Importovat bankovní výpis

  2. zjistit možná přiřazení

  3. zkontrolovat návrhy hromadně

  4. převzít jednoznačné shody

  5. nejasné případy zpracovat ručně

Co Odoo 19 Bank Statement Matcher umí

Modul byl vyvinut pro praktické použití v účetnictví. Podporuje mimo jiné tyto funkce:

  • Vyhledávání vhodných faktur, faktur dodavatelů, dobropisů a plateb

  • automatické zjišťování návrhů přiřazení při vytvoření bankovního řádku

  • srozumitelné zobrazení použitého pravidla přiřazení a jeho spolehlivosti

  • opětovné vyhledávání v pozdější době

  • jednotlivé přiřazení nebo společné zpracování více bankovních řádků

  • ruční výběr otevřené položky, pokud žádný návrh nevyhovuje

  • zrušení již provedeného přiřazení

  • rozpoznání více rovnocenných shod bez svévolného rozhodnutí

  • upozornění na nabídky nebo objednávky, k nimž dosud neexistuje otevřená účetní položka

  • volitelné přímé předání z importu bankovních výpisů OCA do zobrazení přiřazení

  • německý překlad při anglickém zdrojovém textu

Centrální přehled je v Odoo dostupný pod Účetnictví → Účetnictví → Přiřazení bankovních řádků. Tam lze společně prohledávat a zpracovávat dosud otevřené bankovní řádky.

Dohledatelné přiřazení místo černé skříňky

U finančních dat nestačí navrhnout jen nějakou shodu. Uživatelé musí být schopni poznat, proč má bankovní pohyb odpovídat určitému dokladu.

Bank Statement Matcher proto pracuje s jasně definovanými pravidly a různými stupni důvěry:

DůvěraPravidloVýznam
100ReferenceV textu platby bylo nalezeno číslo dokladu, platební reference nebo reference původu.
80Partner a částkaObchodní partner a otevřená částka se shodují.
60Jednoznačná částkaČástka přesně odpovídá pouze jediné otevřené položce.
30PartnerPartner souhlasí, částka však nikoli; jde jen o upozornění.

U každého deníku lze nastavit, od jakého stupně důvěry smí být jednoznačný návrh převzat hromadnou akcí. Slabší shody zůstávají viditelné, ale musí se zkontrolovat a potvrdit jednotlivě.

Důležité je přitom: Modul neúčtuje bez dozoru na pozadí. Vytváří návrhy. K přiřazení dojde teprve vědomou akcí uživatele – jednotlivě nebo prostřednictvím řízeného hromadného zpracování.

Zohledňují se i obtížné bankovní reference

Banky nepřenášejí platební reference vždy v jednotné podobě. Číslo faktury může být spojeno se jmény, číslicemi nebo jinými údaji. Oddělovače mohou chybět nebo být zobrazeny jinak než v původním dokladu.

Matcher proto normalizuje porovnávané hodnoty a zohledňuje i přechody mezi písmeny a číslicemi. Reference tak lze rozpoznat například i tehdy, když byly v textu banky připojeny přímo k jinému obsahu.

Vyhledávání záměrně probíhá od dokladu Odoo k textu banky. Tím se zabraňuje tomu, aby krátké, obecné řady číslic z textu platby vedly k velkému počtu nevhodných shod.

Pravidla nejsou omezena ani na konkrétní banku, ani na konkrétní zemi či pevně dané číslovací schéma. Díky tomu je modul zajímavý i pro další instalace Odoo 19 Community.

Proč je opětovné vyhledávání důležité

Ne každou bankovní platbu lze přiřadit již při importu. V praxi může platba dorazit dříve, než byla příslušná faktura v Odoo vytvořena nebo zaúčtována. I faktura dodavatele nebo dobropis mohou být zadány až později.

Bankovní řádky lze proto později znovu zkontrolovat pomocí „Vyhledat znovu“. Jakmile je k dispozici odpovídající otevřená položka, může se z dříve nepřiřaditelného bankovního pohybu stát jednoznačná shoda.

Pokud text banky uvádí například nabídku nebo objednávku, k níž dosud neexistuje faktura, a tedy ani otevřená položka, poskytne modul užitečné upozornění. Místo pouhého zobrazení „žádná shoda“ upozorní, že je možná nejprve nutné vytvořit fakturu.

Bezpečnost má přednost

Chybné automatické přiřazení může v účetnictví způsobit více práce než otevřený bankovní řádek. Bank Statement Matcher byl proto záměrně navržen opatrně:

  • Stejně hodnocené shody se nerozhodují svévolně.

  • Slabé návrhy se zobrazují, ale hromadnou akcí se nepřebírají.

  • Před přiřazením se znovu zkontroluje, zda je otevřená položka stále k dispozici.

  • Položka, kterou mezitím vyrovnal jiný uživatel, se nezpracovává znovu.

  • Každý bankovní řádek se zpracovává v rámci vlastního záchytného bodu databáze (savepoint).

  • Chyba u jednoho bankovního řádku nebrání zpracování všech ostatních řádků.

  • Neúplná stará data bez platného data účtování se pro jistotu vylučují.

Modul tak podporuje automatizaci tam, kde šetří čas, a vyžaduje ruční rozhodnutí tam, kde není situace dat dostatečně jednoznačná.

Souhra s naším Bank Statement Import

Repozitář se skládá ze dvou modulů:

ModulÚkol
account_statement_matcherPoskytuje vlastní vyhledávání, vyhodnocení, kontrolu a přiřazení. Vyžaduje pouze modul Odoo account.
account_statement_matcher_import_ocaVolitelný most k importu bankovních výpisů OCA. Po importu se přímo otevře zobrazení přiřazení s nově importovanými řádky.

Volitelný most se nainstaluje automaticky, pokud je k dispozici jak Matcher, tak modul OCA account_statement_import_file. Import bankovního výpisu a následné přiřazení do sebe tak přímo zapadají.

Více o importu podporovaných bankovních formátů najdete v našem příspěvku:

Odoo 19 Bank Statement Import – naše rozšíření pro Odoo Community

Instalace v Odoo 19 Community

Instalace probíhá jako u běžného doplňkového modulu Odoo:

  1. Zkopírovat složky modulů do nakonfigurované cesty doplňků Odoo (addons path).

  2. Aktualizovat seznam aplikací v Odoo.

  3. Nainstalovat modul Bank Statement Matcher.

  4. U každého bankovního deníku nastavit, zda se mají při importu vyhledávat návrhy.

  5. Zvolit požadovanou minimální hodnotu pro řízené hromadné přiřazení.

Modul byl vyvinut a otestován pro Odoo 19.0 Community. Před nasazením s jinými verzemi Odoo je třeba zejména zkontrolovat změny interních účetních a odsouhlasovacích funkcí.

Jako u každého rozšíření v oblasti účetnictví doporučujeme instalaci nejprve vyzkoušet v testovacím prostředí s kopií vlastní databáze a typickými bankovními výpisy.

Zdarma a open source pro komunitu Odoo

My ve společnosti Biricon IT Services GmbH vyvíjíme řešení nejprve pro konkrétní požadavky z našeho vlastního provozu. Pokud z toho vznikne obecně použitelný modul, nechceme jej ukrývat v jediné instalaci.

Odoo 19 Bank Statement Matcher je proto k dispozici zdarma jako open-source projekt. Zdrojový kód lze prohlížet, kontrolovat, upravovat a v rámci licence AGPL-3 dále rozvíjet.

Naším cílem není co nejvíce účetních rozhodnutí slepě automatizovat. Chceme omezit opakující se práci a zároveň zajistit, aby finanční přiřazení zůstala dohledatelná a kontrolovatelná.

Tak rozumíme smysluplnému open-source vývoji: vyřešit skutečný problém, řešení transparentně zdokumentovat a poté je zpřístupnit komunitě.

Projekt, zdrojový kód a spolupráce

Kompletní zdrojový kód, pokyny k instalaci a technická dokumentace jsou k dispozici na GitHubu:

Otevřít Odoo 19 Bank Statement Matcher na GitHubu

Těšíme se na zkušenosti z praxe, hlášení chyb, návrhy na vylepšení a příspěvky od komunity Odoo.

Zdarma. Dohledatelné. Open source. Pro Odoo 19 Community.