Siirry sisältöön

Odoo 19 Community: pankkimaksujen automaattinen kohdistus laskuihin – avoimen lähdekoodin Bank Statement Matcher

14. syyskuuta 2026 kirjoittanut
Odoo 19 Community: pankkimaksujen automaattinen kohdistus laskuihin – avoimen lähdekoodin Bank Statement Matcher
Alexander Biringer | Biricon IT Services GmbH

Tiliotteiden tuonti Odooon on vasta ensimmäinen askel. Todellinen hyöty syntyy vasta, kun pankkitapahtuma voidaan luotettavasti kohdistaa oikeaan myyntilaskuun, ostolaskuun, hyvityslaskuun tai maksuun.

Juuri tässä kohdassa Odoo 19 Communityn käyttöliittymästä puuttuu kätevä mahdollisuus. Tuodut pankkirivit jäävät siksi aluksi pankin välitilille, ja ne on jatkokäsittelyä varten kohdistettava avoimeen kirjausriviin.

Siksi kehitimme omaa Odoo 19 Community -asennustamme varten Bank Statement Matcherin. Koska tämä ongelma ei koske vain meitä, tarjoamme moduulin ilmaiseksi GitHubissa vapaalla AGPL-3-lisenssillä.

Projektiin GitHubissa:

Odoo 19 Bank Statement Matcher

Tiliotteen tuonnista oikeaan laskuun

Jo julkaisemallamme projektilla Odoo 19 Bank Statement Import voidaan lukea eri tiliotemuotoja Odoo 19 Communityyn. Näitä ovat muun muassa CAMT.053, CAMT.054, OFX ja SWIFT MT940.

Uusi Bank Statement Matcher täydentää tätä tuontia seuraavalla ratkaisevalla työvaiheella:

Mikä tuotu pankkitapahtuma kuuluu mihinkin avoimeen erään?

Moduuli käy läpi avoimet saamiset ja velat, arvioi mahdolliset osumat ja näyttää käyttäjille, miksi tiettyä kohdistusta ehdotetaan. Ehdotuksen voi tarkistaa, vahvistaa, korjata tai korvata manuaalisella valinnalla.

Näin Odoo 19 Communitylle syntyy katkeamaton työnkulku:

  1. Tuo tiliote

  2. selvitä mahdolliset kohdistukset

  3. tarkista ehdotukset yhdessä

  4. hyväksy yksiselitteiset osumat

  5. käsittele epäselvät tapaukset manuaalisesti

Mitä Odoo 19 Bank Statement Matcher osaa

Moduuli on kehitetty käytännön kirjanpitotyöhön. Se tukee muun muassa seuraavia toimintoja:

  • sopivien laskujen, ostolaskujen, hyvityslaskujen ja maksujen haku

  • kohdistusehdotusten automaattinen selvitys pankkirivin luomisen yhteydessä

  • käytetyn kohdistussäännön ja sen varmuuden ymmärrettävä näyttö

  • uusi haku myöhemmässä vaiheessa

  • yksittäinen kohdistus tai useiden pankkirivien yhteiskäsittely

  • avoimen erän manuaalinen valinta, jos mikään ehdotus ei sovi

  • jo tehdyn kohdistuksen peruutus

  • useiden yhtä hyvien osumien tunnistus ilman mielivaltaista päätöstä

  • huomautukset tarjouksista tai tilauksista, joille ei vielä ole avointa kirjausriviä

  • valinnainen suora siirto OCA:n tiliotetuonnista kohdistusnäkymään

  • saksankielinen käännös englanninkielisellä lähdekoodilla

Keskitetty yleisnäkymä löytyy Odoosta kohdasta Kirjanpito → Kirjanpito → Pankkirivien kohdistus. Siellä vielä avoimia pankkirivejä voidaan hakea ja käsitellä yhdessä.

Jäljitettävä kohdistus mustan laatikon sijaan

Rahoitustiedoissa ei riitä, että ehdotetaan mitä tahansa osumaa. Käyttäjien on pystyttävä näkemään, miksi pankkitapahtuman pitäisi sopia tiettyyn asiakirjaan.

Bank Statement Matcher toimii siksi selkeästi määriteltyjen sääntöjen ja eri luottamustasojen avulla:

LuottamusSääntöMerkitys
100ViiteAsiakirjan numero, maksuviite tai alkuperäviite löytyi kirjaustekstistä.
80Kumppani ja summaLiikekumppani ja avoin summa täsmäävät.
60Yksiselitteinen summaSumma sopii täsmälleen vain yhteen avoimeen erään.
30KumppaniKumppani täsmää, mutta summa ei; tämä on vain vihje.

Jokaiselle päiväkirjalle voidaan määrittää, mistä luottamustasosta alkaen yksiselitteinen ehdotus saa hyväksyä joukkotoiminnolla. Heikommat osumat pysyvät näkyvissä, mutta ne on tarkistettava ja vahvistettava yksitellen.

Tärkeää: Moduuli ei kirjaa valvomatta taustalla. Se luo ehdotuksia. Kohdistus tapahtuu vasta käyttäjän tietoisella toimenpiteellä – yksitellen tai hallitun joukkokäsittelyn kautta.

Myös hankalat pankkiviitteet otetaan huomioon

Pankit eivät aina välitä maksuviitteitä yhtenäisessä muodossa. Laskunumeroon voi liittyä nimiä, numeroita tai muita tietoja. Erottimet voivat puuttua tai olla esitetty eri tavalla kuin alkuperäisessä asiakirjassa.

Matcher normalisoi siksi vertailuarvot ja ottaa huomioon myös kirjainten ja numeroiden väliset siirtymät. Näin viitteet voidaan tunnistaa esimerkiksi silloinkin, kun ne on liitetty pankkitekstissä suoraan muun sisällön perään.

Haku tehdään tarkoituksella Odoo-asiakirjasta pankkitekstiin. Näin vältetään se, että kirjaustekstin lyhyet, yleiset numerosarjat johtaisivat suureen määrään sopimattomia osumia.

Säännöt eivät rajoitu tiettyyn pankkiin, tiettyyn maahan eivätkä kiinteästi määrättyyn numerointijärjestelmään. Se tekee moduulista kiinnostavan myös muille Odoo 19 Community -asennuksille.

Miksi uusi haku on tärkeä

Kaikkia pankkimaksuja ei voida kohdistaa jo tuonnin yhteydessä. Käytännössä maksu voi saapua ennen kuin siihen kuuluva lasku on luotu tai kirjattu Odoossa. Myös ostolasku tai hyvityslasku voidaan kirjata vasta myöhemmin.

Siksi pankkirivit voidaan tarkistaa myöhemmin uudelleen toiminnolla ”Hae uudelleen”. Heti kun sopiva avoin erä on olemassa, aiemmin kohdistamattomasta pankkitapahtumasta voi tulla yksiselitteinen osuma.

Jos pankkiteksti mainitsee esimerkiksi tarjouksen tai tilauksen, jolle ei vielä ole laskua eikä siten avointa erää, moduuli antaa hyödyllisen vihjeen. Pelkän ”ei osumaa” -ilmoituksen sijaan se huomauttaa, että lasku on ehkä luotava ensin.

Turvallisuus menee edelle

Väärä automaattinen kohdistus voi aiheuttaa kirjanpidossa enemmän työtä kuin avoin pankkirivi. Bank Statement Matcher on siksi tarkoituksella suunniteltu varovaiseksi:

  • Yhtä hyvin arvioituja osumia ei ratkaista mielivaltaisesti.

  • Heikot ehdotukset näytetään, mutta niitä ei hyväksytä joukkotoiminnolla.

  • Ennen kohdistusta tarkistetaan uudelleen, onko avoin erä vielä käytettävissä.

  • Erää, jonka toinen käyttäjä on välissä tasannut, ei käsitellä uudelleen.

  • Jokainen pankkirivi käsitellään omassa tietokannan palautuspisteessä (savepoint).

  • Yhden pankkirivin virhe ei estä kaikkien muiden rivien käsittelyä.

  • Puutteelliset vanhat tiedot, joilla ei ole kelvollista kirjauspäivää, suljetaan varmuuden vuoksi pois.

Näin moduuli tukee automaatiota siellä, missä se säästää aikaa, ja vaatii manuaalisen päätöksen siellä, missä tietotilanne ei ole riittävän yksiselitteinen.

Yhteispeli Bank Statement Importin kanssa

Repositorio koostuu kahdesta moduulista:

ModuuliTehtävä
account_statement_matcherTarjoaa varsinaisen haun, arvioinnin, tarkistuksen ja kohdistuksen. Tarvitsee vain Odoo-moduulin account.
account_statement_matcher_import_ocaValinnainen silta OCA:n tiliotetuontiin. Tuonnin jälkeen avataan suoraan kohdistusnäkymä, jossa ovat juuri tuodut rivit.

Valinnainen silta asentuu automaattisesti, kun sekä Matcher että OCA-moduuli account_statement_import_file ovat olemassa. Tiliotetuonti ja sitä seuraava kohdistus kytkeytyvät näin suoraan toisiinsa.

Lisätietoja tuetuista pankkiformaateista tuonnissa löydät artikkelistamme:

Odoo 19 Bank Statement Import – laajennuksemme Odoo Communitylle

Asennus Odoo 19 Communityyn

Asennus tapahtuu kuten tavallisessa Odoon lisämoduulissa:

  1. Kopioi moduulikansiot määritettyyn Odoon addons-polkuun.

  2. Päivitä Odoon sovellusluettelo.

  3. Asenna moduuli Bank Statement Matcher.

  4. Määritä pankkipäiväkirjakohtaisesti, haetaanko tuonnin yhteydessä ehdotuksia.

  5. Valitse haluttu vähimmäisarvo hallitulle joukkokohdistukselle.

Moduuli on kehitetty ja testattu versiolle Odoo 19.0 Community. Ennen käyttöä muissa Odoo-versioissa on tarkistettava erityisesti sisäisten kirjanpito- ja täsmäytystoimintojen muutokset.

Kuten kaikissa kirjanpidon alueen laajennuksissa, suosittelemme tarkistamaan asennuksen ensin testiympäristössä oman tietokannan kopiolla ja tyypillisillä tiliotteilla.

Ilmainen ja avoin lähdekoodi Odoo Communitylle

Me Biricon IT Services GmbH:ssa kehitämme ratkaisuja ensin oman toimintamme konkreettisiin tarpeisiin. Kun siitä syntyy yleisesti käytettävä moduuli, emme halua piilottaa sitä yhteen asennukseen.

Odoo 19 Bank Statement Matcher on siksi saatavilla ilmaiseksi avoimen lähdekoodin projektina. Lähdekoodia voi tarkastella, tarkistaa, mukauttaa ja kehittää edelleen AGPL-3-lisenssin puitteissa.

Tavoitteemme ei ole automatisoida mahdollisimman monta kirjauspäätöstä sokeasti. Haluamme vähentää toistuvaa työtä ja samalla varmistaa, että taloudelliset kohdistukset pysyvät jäljitettävinä ja hallittavina.

Näin ymmärrämme mielekkään avoimen lähdekoodin kehityksen: ratkaistaan todellinen ongelma, dokumentoidaan ratkaisu läpinäkyvästi ja annetaan se sen jälkeen yhteisön käyttöön.

Projekti, lähdekoodi ja osallistuminen

Koko lähdekoodi, asennusohjeet ja tekninen dokumentaatio ovat saatavilla GitHubissa:

Avaa Odoo 19 Bank Statement Matcher GitHubissa

Otamme mielellämme vastaan käytännön kokemuksia, virheraportteja, parannusehdotuksia ja Odoo Communityn kehitysapua.

Ilmainen. Jäljitettävä. Avoin lähdekoodi. Odoo 19 Communitylle.