← Takaisin self-hostereille
Beancount-ohje

Synkronoi pankkisi Beancountiin.

Vaihe vaiheelta -opas plaintext-kirjanpitoon: hae EU:n ja Ison-Britannian pankkitapahtumasi suoraan Beancount-kirjanpitoosi. 3 €/kk, ei eIDAS-varmennetta, ei rate limit -seinää, ja salattu niin että vain sinä voit lukea sen.

AloitaKatso PyPI:ssä

€3/kk — 1 tili sisältyy · Ei luottokorttia tarvita

5 minuutin asennus

Pankista kirjanpitoon viidessä vaiheessa.

  1. Asenna importer

    Nouda beangulp-importer PyPI:stä. Sen mukana tulee tarvittava client-SDK, joten tämä on ainoa lisättävä riippuvuus.

    bash

    pip install beancount-openbanking-io

  2. Vie tunnistetietosi

    Vie open-banking.io-hallintapaneelista credentials.json — se yhdistää API keyn purkuavaimeen, joka on vain sinulla, jotta importer voi lukea tietosi paikallisesti.

    bash

    # Dashboard → Settings → API keys → "Export credentials"
# downloads credentials.json. Keep it next to your ledger.
mv ~/Downloads/credentials.json ./credentials.json

    list_accounts.py

    from beancount_openbanking_io import Client

client = Client("credentials.json")
for account in client.accounts():
    print(account.id, account.currency, account.name)

    Toinen katkelma tulostaa jokaisen tilitunnuksen, jonka voit määrittää. Kopioi ne tunnukset, jotka haluat synkronoida — liität ne asetuksiin seuraavassa vaiheessa.

  3. Määritä tilit asetustiedostossa

    Luo *openbanking.yaml-tiedosto kirjanpitosi viereen. Osoita se tunnistetietoihisi ja määritä jokainen pankkitilin tunnus Beancount-tiliin. currency, counterpart ja assert_balance ovat valinnaisia tilikohtaisesti.

    myfinances.openbanking.yaml

    # Any file ending in *openbanking.yaml is picked up by the importer.
credentials: credentials.json

accounts:
  - id: "a1b2c3d4-0000-1111-2222-333344445555"
    account: Assets:Bank:Checking
    currency: EUR                       # optional — inferred from the bank if omitted
    counterpart: Expenses:Uncategorized # optional — default second posting
    assert_balance: true                # optional — append a balance assertion

  - id: "f6e5d4c3-9999-8888-7777-666655554444"
    account: Assets:Bank:Savings

    Minkä tahansa openbanking.yaml-päätteisen tiedostonimen tunnistaa automaattisesti importerin identify()-vaihe — pidä yksi tiedosto per kirjanpito, tai useita jos jaat kirjasi.

  4. Aja tuonti

    Kytke importer yhden tiedoston beangulp-skriptiin, poimi sitten tapahtumat ja liitä ne kirjanpitoosi. Aja se käsin, Makefilestä tai cron-aikataulussa.

    import.py

    #!/usr/bin/env python3
import beangulp
from beancount_openbanking_io import OpenBankingImporter

importers = [
    OpenBankingImporter(),
]

if __name__ == "__main__":
    beangulp.Ingest(importers).main()

    bash

    python import.py extract myfinances.openbanking.yaml >> ledger.beancount

    beangulpin extract tulostaa Beancount-merkinnät stdoutiin — ohjaa ne kirjanpitoosi tai välitiedostoon, jonka tarkistat ennen yhdistämistä.

  5. Lue tulos

    Saat oikeita Beancount-tapahtumia etumerkillisillä summilla, obio-id:n jokaisessa kirjauksessa deduplikointia varten ja valinnaisen saldotarkistuksen jokaisen ajon lopussa.

    ledger.beancount

    2026-06-28 * "Netto" "Card purchase"
  obio-id: "txn_9f2c7a1e5b"
  Assets:Bank:Checking  -42.18 EUR

2026-06-29 * "ACME A/S" "Salary June"
  obio-id: "txn_1b8e4d9077"
  Assets:Bank:Checking  +2450.00 EUR

2026-06-30 balance Assets:Bank:Checking  8137.55 EUR

    Uudelleenajo on turvallista: beangulp deduplikoi obio-id-metatiedon perusteella, joten saman ajanjakson tuonti kahdesti ei koskaan kaksinkertaista kirjauksiasi. Ohjaa tuloste smart_importerin läpi kategorisoidaksesi vastakirjauksen automaattisesti.

Miksi se sopii plaintext-kirjanpitoon

Rakennettu niin kuin kirjanpitosi jo toimii.

Salattu — emme voi lukea sitä

Tapahtumat salataan laitteellasi avaimella, joka on vain sinulla. Me tallennamme salatekstiä, joten tiliotteesi ei koskaan ole luettavassa muodossa palvelimillamme.

Ei eIDAS-varmennetta

Ei PSD2- (eIDAS-)varmennetta ostettavaksi tai rekisteröitäväksi, eikä pankkihakemusta täytettäväksi ensin. Yhdistä pankkisi ja aloita tuominen.

Ei 4 pyyntöä päivässä -seinää

Ei neljän pyynnön päiväkohtaista tilirajaa, jonka ympäri pitäisi aikatauluttaa. Poimi niin usein kuin kirjanpitosi todella tarvitsee.

Toimii hyvin työkalujesi kanssa

Tavallista beangulp-tulostetta — ohjaa se smart_importerin läpi automaattista kategorisointia varten, tai favan, bean-checkin ja omien skriptiesi kautta. Ei lukkiutumista.

Korvaatko GoCardlessin tai Nordigenin?

Heidän ilmainen henkilökohtainen tasonsa lopetti uusien self-hostereiden hyväksymisen, ja neljän pyynnön päiväkohtainen tiliraja rikkoo rutiininomaiset Beancount-tuonnit. open-banking.io on 3 €/kk -korvaaja — ei varmennetta, ei päivittäistä seinää, ja salattu niin että vain sinä voit lukea sen. (Pankkiyhteydet tarjoaa lisensoitu toimittajamme Enable Banking.)

Syvenny lisää

Lähdekoodi, paketti ja laajempi teknologiapino.

Tuo pankkisi Beancountiin.

Yhdistä EU:n tai Ison-Britannian pankki minuuteissa ja pidä kirjanpitosi synkronoituna — 3 eurolla kuukaudessa.

Aloita

Ei luottokorttia tarvita