← 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 rekisteröitymistä, 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 rekisteröitymistä

Ei mitään ostettavaa tai rekisteröitävää, 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