Gå til innholdet

Bank reconciliation

Reconciliation proves that the ledger’s bank account and the bank’s own records agree — bokføringsforskriften expects bankavstemming as part of ajourhold, and unexplained differences are the classic audit finding.

Connectivity tiers (how statements reach regnmed)

Section titled “Connectivity tiers (how statements reach regnmed)”
Tier Mechanism Status
1. File upload camt.053 (ISO 20022) exported from any Norwegian nettbank — no bank agreement needed Implemented
1b. CSV upload Bank CSV exports, layout auto-detected from headers Implemented
2. PSD2 / open banking Live account feeds via an AISP — requires a Finanstilsynet AISP license or a commercial aggregator (Neonomics, Tink, Mastercard/Aiia) Later — commercial/licensing decision
3. Direct filutveksling SFTP/ISO 20022 agreements per bank or via Mastercard Payment Services (also OCR-giro, issue #16) Later — per-customer onboarding

All tiers feed the same reconciliation engine; only the transport differs. A company card’s statement is imported the same way, on the card’s own ledger account — also a credit card account in class 2, which the account list then includes (docs/utlegg.md «Firmakort»). Building file-first was deliberate: it works for every customer on day one with zero agreements.

  • bank_statement — one imported statement per ledger bank account. Statements are dokumentasjon: insert-only for the app role, and re-import of the same bank statement id (Stmt/Id) is rejected — imports are idempotent.
  • bank_transaction — statement lines. Amounts are stored in ledger sign for the bank account: money in (CRDT) = debit = positive, so a bank transaction equals its ledger entry exactly.
  • bank_match — links one bank transaction to one ledger entry (method auto/manual, who, when). Unique on both sides. “Unmatched” is always computed as the absence of a match row — never stored mutable state, same philosophy as balances.
  • camt.053 parser (regnmed-core::camt053, pure): tolerant, version-agnostic (camt.053.001.0x), reads only what reconciliation needs (statement id, IBAN, OPBD/CLBD balances, booked entries with date/amount/direction/reference/description). Pending (PDNG) entries are skipped. Amounts parse to integer øre.
  • CSV parser (regnmed-core::bankcsv, pure): tier 1b. Detects the layout from the header row instead of maintaining per-bank profiles — delimiter (;/tab/,), date column (“dato”/“bokføringsdato”/…, never “rentedato”), one signed beløp column or separate inn/ut columns, Norwegian number formats (“1 234,56”), optional KID/referanse. A file it cannot understand fails loudly with the headers it saw — never a silent half-import. Output is the same statement shape as camt.053, so storage, matching and reconciliation are one engine; the statement ref is the file’s content hash, so re-import stays idempotent, and balances are absent (a CSV has none — shown as absent, never zero). Same endpoint: the import distinguishes XML from CSV by content.
  • Matching engine (regnmed-core::bank, pure, deterministic): equal amount + same day first, then equal amount within a ±5-day window. Each side is used at most once. Ties are never guessed — two equally close candidates fall to manual review. KID/reference matching arrives with reskontro (entries don’t carry payment references yet).
  • Forslag, aldri gjetting (regnmed-core::bank::suggest_entries): for hver bankpost motoren lot ligge, inntil tre åpne poster med NØYAKTIG samme beløp (fortegn inkludert), nærmeste dato først — og hver post foreslås for bare ÉN bankpost (den nærmeste), som i auto-matchingen, så tre like gebyrer og ett bilag ikke gir tre like knapper. Et annet beløp foreslås aldri — og en manuell kobling av ulike beløp avvises i databasen-laget (manual_match) med beløpene navngitt, så en feilkobling ikke kan skje med ett klikk.
  • Bokfør fra banklinjen: en bankpost uten bilag bak seg (gebyr, renter) bokføres og kobles i ÉN transaksjon (post_from_bank_line): bankkontoen mot valgt konto på bokføringsdatoen, uten mva, med kontoutskriftens referanse og tekst på banklinjen som dokumentasjon (referanse, bokføringsdato, beløp og tekst står på bilagslinjen; kontoutskriftsradene er innsettings-bare og oppbevares). Samme attesteringsport som manuelt bilag (refuse_if_attestation_required, docs/attestering.md) — med aktiv policy over grensen må det gå via innboksen. Krever både BANK_AVSTEM og BILAG_BOKFOR. Har utgiften mva eller kvittering, hører den hjemme i innboksen.
  • Differansen regnes på kontoutskriftens dato: hovedboken summeres til og med siste kontoutskrifts sluttdato (ledger_at_statement_ore) og sammenlignes med bankens utgående saldo. Dagens saldo ville tatt med alt bokført etterpå. CSV har ingen saldo, og differansen vises da som ukjent, aldri som null.
  • Åpne poster i hovedboken vises bare innenfor perioden kontoutskriftene dekker (en måned på hver side): historikk fra før første kontoutskrift er ikke avstemmingsarbeid, og ville ellers blitt hele den importerte hovedboken.
  • Web API (engagement-guarded; revisor ‘les’ may read, importing and matching require bokforing/admin):
    • POST /companies/{id}/bank/statements?account=1920 — camt.053 XML body; imports and auto-matches, returns counts.
    • GET /companies/{id}/bank/accounts — selskapets bankkontoer (aktive 19xx) med saldo, siste kontoutskrift og antall uavstemte.
    • GET /companies/{id}/bank/reconciliation?account=1920 — ledger balance (today and on the statement’s end date) vs latest statement closing balance, matched count, unmatched bank lines WITH their suggestions, open ledger entries within the statements’ period, the statements, and the 50 newest matches (recent_matches).
    • GET /companies/{id}/bank/entries?account=1920&q= — søk i åpne poster på kontoen: bilagsnummer («2026-14»), tekst, eller beløp slik det skrives («1 290,00»; regnmed-core::money::parse_kroner, samme regler som bank-CSV-en). Maks 20.
    • POST /companies/{id}/bank/transactions/{tid}/post {konto, tekst} — bokfør banklinjen og koble den.
    • POST /companies/{id}/bank/matches + DELETE /companies/{id}/bank/matches/{bank_transaction_id} — manual match/unmatch; cross-company and cross-account pairings are rejected in the database layer.

OCR files from Mastercard Payment Services (tidligere Nets/BBS) carry KID-tagged incoming payments — the detail behind the lump-sum “OCR innbetaling” line on the bank statement.

  • Parser (regnmed-core::ocr, pure): the official fixed-width 80-character record format (service 09), layouts verified against the published systemspesifikasjon and the netsgiro reference implementation. Control records are enforced (transaction count and sum must match, so truncated or tampered files are rejected); reversal signs are honored; invalid KIDs are flagged, never rejected — the bank accepted the payment, so it must be recorded.
  • KID check digits (regnmed-core::kid): MOD10 and MOD11 validation, plus check-digit generation for faktura (issue #13).
  • Storage (migration 0008): batches insert-only and idempotent per (forsendelse, oppdrag) — a re-uploaded file errors instead of duplicating payments.
  • Web API: POST /companies/{id}/ocr/files?account=1920 (file body), GET /companies/{id}/ocr/payments?from=&to=. Same access rules as bank reconciliation.
  • With reskontro (issue #3), payments auto-apply to open invoices by KID; until then the payment list is the working view, and OCR batch sums reconcile against the statement’s lump-sum line.
  • regnmed-core/src/camt053.rs — parsing (balances, signs, pending skipped, entities, øre), malformed input.
  • regnmed-core/src/bank.rs — matching rules, window, no-reuse, ambiguity-goes-to-manual.
  • regnmed-api/tests/grupper/bank.rs (real Postgres, also CI) — the whole flow over HTTP: revisor 403 on import, import + auto-match, duplicate import rejected, revisor reads reconciliation, manual match to full reconciliation, unmatch, stranger 404. a_bank_line_is_posted_from_the_statement_and_amounts_must_agree: bankkontolisten, ingen forslag med annet beløp, kontoutskriftslisten, hovedboken på kontoutskriftens dato, søk på beløp som skrevet, kobling av ulike beløp avvist, forslaget er posten med likt beløp, revisor 403 på bokføring, attesteringsporten, bokført og koblet i ett steg (og ikke to ganger), avstemt på øret, kjedeverifikasjon.

Bank (#/c/{id}/bank/…) har fanene Avstemming (forsiden), Betalinger og Valutakurser. Avstemming: bankkontovelger når selskapet har flere, «Last opp kontoutskrift» (eller dra filen inn), statuslinje med banken og hovedboken på samme dato og differansen, og hver uavstemte bankpost med det som kan lukke den — ett klikk på forslaget med likt beløp, «Bokfør» (konto foreslått: 7700 for penger ut, 8050 for penger inn — standardkontoplanens, brukerens valg), eller «Finn bilag» (søk; poster med annet beløp kan ikke kobles). Under: åpne poster i hovedboken uten bankpost, de koblede med «Fjern kobling» (bekreftes), og kontoutskriftene. Knappene følger rettighetene.