← Tilbake til self-hosters
Beancount-veiledning

Synkroniser banken din inn i Beancount.

En trinn-for-trinn-veiledning for plaintext-regnskap: hent banktransaksjonene dine fra EU og Storbritannia rett inn i Beancount-hovedboken din. €3/måned, intet eIDAS-sertifikat, ingen rate limit-mur, og kryptert så bare du kan lese det.

Kom i gangSe på PyPI

€3/måned — 1 konto inkludert · Ingen kredittkort nødvendig

Oppsett på 5 minutter

Fra bank til hovedbok i fem trinn.

  1. Installer importøren

    Hent beangulp-importøren fra PyPI. Den leveres med klient-SDK-et den trenger, så dette er den eneste avhengigheten du må legge til.

    bash

    pip install beancount-openbanking-io

  2. Eksporter dine credentials

    Fra open-banking.io-dashbordet eksporterer du credentials.json — den parer en API-nøkkel med dekrypteringsnøkkelen som bare du har, så importøren kan lese dataene dine lokalt.

    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)

    Det andre utdraget skriver ut hver konto-id du kan mappe. Kopier id-ene du vil synkronisere — dem limer du inn i konfigurasjonen i neste trinn.

  3. Map kontoer i en konfigurasjonsfil

    Opprett en *openbanking.yaml-fil ved siden av hovedboken din. Pek den mot dine credentials, og map hver bankkonto-id til en Beancount-konto. currency, counterpart og assert_balance er valgfrie per konto.

    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

    Ethvert filnavn som ender på openbanking.yaml, oppdages automatisk av importørens identify()-trinn — hold én fil per hovedbok, eller flere hvis du deler opp regnskapet.

  4. Kjør importen

    Koble importøren inn i et beangulp-skript på én fil, trekk så ut transaksjonene og føy dem til hovedboken din. Kjør det for hånd, fra en Makefile, eller på en cron-plan.

    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

    beangulps extract skriver ut Beancount-posteringer til stdout — omdiriger dem inn i hovedboken din, eller til en mellomlagringsfil du gjennomgår før du fletter.

  5. Les resultatet

    Du får ekte Beancount-transaksjoner med fortegn på beløpene, en obio-id på hver postering for deduplisering, og en valgfri saldo-assertion til slutt i hver kjøring.

    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

    Det er trygt å kjøre på nytt: beangulp dedupliserer på obio-id-metadataen, så å importere samme vindu to ganger dobler aldri posteringene dine. Send utdataene gjennom smart_importer for automatisk å kategorisere den andre posteringen.

Hvorfor det passer til plaintext-regnskap

Bygget slik hovedboken din allerede fungerer.

Kryptert — vi kan ikke lese det

Transaksjoner krypteres på enheten din med en nøkkel bare du har. Vi lagrer chiffertekst, så kontoutdraget ditt ligger aldri i lesbar form på serverne våre.

Intet eIDAS-sertifikat

Intet PSD2- (eIDAS-)sertifikat å kjøpe eller registrere, og ingen banksøknad å sende inn først. Koble til banken din og begynn å importere.

Ingen mur på 4 forespørsler om dagen

Ingen grense på fire forespørsler per konto per dag å planlegge rundt. Trekk ut data så ofte regnskapet ditt faktisk trenger.

Spiller godt sammen med verktøyene dine

Vanlig beangulp-utdata — send det gjennom smart_importer for automatisk kategorisering, eller fava, bean-check og dine egne skript. Ingen lock-in.

Erstatter du GoCardless eller Nordigen?

Det gratis privatnivået deres sluttet å ta imot nye self-hostere, og grensen på fire forespørsler per konto per dag ødelegger rutinemessige Beancount-importer. open-banking.io er erstatningen til €3/måned — intet sertifikat, ingen daglig mur, og kryptert så bare du kan lese det. (Bankforbindelsen leveres av vår lisensierte leverandør, Enable Banking.)

Grav dypere

Kildekode, pakke og resten av stakken.

Få banken din inn i Beancount.

Koble til en EU- eller UK-bank på få minutter, og hold hovedboken din synkronisert — for €3 i måneden.

Kom i gang

Ingen kredittkort nødvendig