Lovpålagte spesifikasjoner og rapporter
This content is not available in your language yet.
Bokføringsforskriften §3-1 requires that a set of specifications can be
produced from the books for any period, on demand, for as long as the
oppbevaringsplikt runs. regnmed satisfies this the only way that cannot
drift: every report is a query over the immutable ledger — pure
SUM(amount_ore) and ordered SELECTs, never stored report state. A
report for 2026 produced today and one produced in five years are the
same numbers, because the underlying vouchers cannot change
(ledger.md).
The specifications and where they live:
| Spesifikasjon | Endpoint | Source |
|---|---|---|
| Bokføringsspesifikasjon | GET /companies/{id}/reports/bokforingsspesifikasjon?from=&to= |
every voucher in posting (chain) order with all lines |
| Kontospesifikasjon (hovedbok) | GET …/reports/kontospesifikasjon?from=&to=[&account=] |
every posting per account, running saldo seeded from inngående balance, bilagshenvisning journal-år-nummer |
| Kunde-/leverandørspesifikasjon | GET …/reports/kundespesifikasjon?from=&to= and GET …/reports/leverandorspesifikasjon?from=&to= |
per party: inngående saldo, every posting with running saldo and bilagshenvisning, utgående saldo; a party with nonzero inngående but no movement is still listed. (GET …/parties/{pid}/items remains the åpne poster working view — no period filter, no running saldo — see reskontro.md) |
| Mva-spesifikasjon | GET …/reports/mva?year=&termin= |
dated rates (mva.md) |
| Saldobalanse | GET …/reports/saldobalanse?from=&to= |
per account: inngående, debet, kredit, utgående |
| Resultatregnskap | GET …/reports/resultat?from=&to= (optional avdeling=/prosjekt= — resultat per dimensjon, docs/dimensjoner.md) |
NS 4102 classes 3–8 |
| Balanse | GET …/reports/balanse?date= |
NS 4102 classes 1–2 + udisponert resultat |
All endpoints follow the standard guard: any access level may read (reports never mutate; revisor read access is the point), no access → 404. The portal’s Rapporter section renders all of them per year.
Sider og CSV (bokførings- og kontospesifikasjon)
Section titled “Sider og CSV (bokførings- og kontospesifikasjon)”De to lange spesifikasjonene tar limit= og offset= og svarer med
total ved siden av siden. Uten limit kommer hele perioden, som før
(MCP-verktøyene og kontosiden i Hovedbok bruker det). Siden er et
utsnitt av hele perioden: spørringen og den løpende saldoen regnes over
alt, så saldoen på side to er den samme som i hele listen. Kostnaden som
sidene fjerner, er tegningen i nettleseren, ikke lesingen.
format=csv laster ned hele perioden uansett side — filen er
spesifikasjonen forskriften krever (bokføringsforskriften §3-1), ikke
et vindu inn i den. Formatet er semikolonseparert, desimalkomma og
UTF-8 med BOM, slik et norsk regneark åpner det uten importdialog.
Bokføringsspesifikasjonen gir én rad per bilagslinje.
Hver linje i kontospesifikasjonen, bokføringsspesifikasjonen og
kunde-/leverandørspesifikasjonen bærer voucher_id, og portalen lenker
bilagshenvisningen til bilagssiden i Hovedbok — sporbarheten fra
spesifikasjon til bilag (bokføringsloven §4 nr. 7) er ett klikk.
Saldobalansens kontoer lenker til kontosiden.
Portalen
Section titled “Portalen”Fane, år og fanens egen tilstand (kontofilter, side, kunde/leverandør,
dimensjonsfilter, periodeslutt) står i adressen —
#/c/{id}/rapporter/kontospesifikasjon?year=2026&konto=1920&side=2 —
så tilbake-knappen fra et bilag, en omlasting eller en delt lenke lander
der brukeren var. Fanene følger WAI-ARIA-mønsteret (piltaster,
Home/End, ett tabulatorstopp); på smale skjermer er de en vanlig
nedtrekksliste. En feilet henting vises i rapportfeltet med «Prøv
igjen», aldri som en spinner som aldri stopper.
Sign conventions
Section titled “Sign conventions”The ledger stores debit positive, credit negative
(docs/README.md). Saldobalanse, kontospesifikasjon and
bokføringsspesifikasjon show ledger signs unchanged — they are the
accountant’s working documents. Resultat and balanse are presentation:
inntekter (class 3) and egenkapital/gjeld (class 2) are shown negated so
the reader sees positive numbers; the grouping logic is pure and unit
tested in regnmed-core::regnskap.
Resultat/balanse grouping (NS 4102 classes)
Section titled “Resultat/balanse grouping (NS 4102 classes)”1 eiendeler · 2 egenkapital og gjeld · 3 driftsinntekter · 4 varekostnad · 5 lønnskostnad · 6–7 annen driftskostnad · 8 finansposter, skatt m.m.
Derived lines: driftsresultat = −(sum classes 3–7), årsresultat
= −(sum classes 3–8). The balanse shows the running result as
udisponert resultat on the egenkapital side, so it balances mid-year
without a closing entry; differanse_ore (eiendeler − egenkapital/gjeld
− udisponert) is exposed in the API and must be zero — double-entry
guarantees it, and the integration test asserts it.
This is the internal statutory presentation. The formal årsregnskap oppstillingsplan (regnskapsloven) and skattemelding/næringsspesifikasjon are separate M2 deliverables (issues #11, #12) that will build on the same saldo queries.
Where it is tested
Section titled “Where it is tested”crates/regnmed-core/src/regnskap.rs— grouping, presentation signs, driftsresultat/årsresultat, the balanse identity, class 6+7 merge, zero-balance omission.crates/regnmed-api/tests/grupper/regnskap.rs(real Postgres, also in CI) — saldobalanse carries inngående across a year boundary and splits debet/kredit; kontospesifikasjon running saldo and bilagshenvisning; bokføringsspesifikasjon in posting order with every voucher balancing; resultat/balanse reconcile to the øre; 404 for outsiders, 400 for an inverted period; a page of either specification is the same slice of the whole period (running saldo included), and CSV ignores paging.ui/portal/src/sections/rapporter/reportAddress.test.js— the report address (tab, year, the tab’s own state) round-trips.
Nøkkeltall og likviditet (#36)
Section titled “Nøkkeltall og likviditet (#36)”GET /companies/{id}/reports/nokkeltall?year= — oversiktens svar på
«hvordan går det», utelukkende fra tall som allerede finnes, som rene
SUM-spørringer (aldri lagret tilstand):
- Resultat hittil i år (resultatkontoene 3xxx–8xxx, presentasjonsfortegn) mot samme periode i fjor — fjoråret måles til samme dato, så sammenlikningen er ærlig midt i året.
- Månedskolonner: resultat per måned for året — portalen tegner dem som rene CSS-søyler (ingen grafbibliotek; frugality).
- Likviditetsbildet: bank og kontanter (19xx-saldoene) + utestående kundefordringer − leverandørgjeld − beregnet mva-netto for inneværende periode = «disponibelt om alt gjøres opp».
- Kommende frister: de neste mva-fristene etter selskapets terminordning (docs/mva.md) — fristbevissthet uten varsler, som første steg.
Året styrer «hittil»-tallene og månedskolonnene; likviditet og frister er alltid nå. Budsjettavvik hører til budsjett.md (#41), ikke her — der ligger også avviksrapporten som måler de samme resultattallene mot en navngitt, fastsatt plan.
Testet i crates/regnmed-api/tests/grupper/nokkeltall.rs: resultat mot
håndregnede tall (fjorårets poster ETTER cutoff teller ikke),
månedskolonner med kostnadsmåned, likviditetsbildet fra reskontro og
bank, og at fristene aldri ligger i fortiden.
Prosjektlønnsomhet (#71)
Section titled “Prosjektlønnsomhet (#71)”GET /companies/{id}/reports/prosjekt?year=&prosjekt= — svaret på
«tjener vi penger på dette prosjektet?», som ren sammenstilling av det
som allerede finnes (ingen lagret tilstand, ingen ny SQL-vei):
- Inntekter og kostnader per prosjekt fra de dimensjonsfiltrerte
SUM-spørringene (
balance_lines/project_balance_lines), foldet medstatements::profitability— presentasjonsfortegnene ett sted, som alt annet. Bare posteringer MED prosjektdimensjon telles; en bankmotpost uten dimensjon er ikke prosjektøkonomi. - Timene fra timelistesummeringene, splittet fakturert/ufakturert til registrert timesats — det ufakturerte er «på bordet».
- Kunden fra prosjekt→kunde-koblingen (#80, docs/dimensjoner.md) — lønnsomheten kan leses per kunde.
- Uten
prosjekt=: oversikten, én rad per registrert prosjekt (også avsluttede — historikken er poenget). Med: NS 4102-seksjonene for akkurat det prosjektet; ukjent kode er en høylytt 400, aldri en tom rapport.
Året går gjennom fiscal_year-sømmen (#52). Portal: Rapporter →
Prosjekt (rad-klikk åpner seksjonene), lenket fra
dimensjonsregisteret.
Testet i crates/regnmed-api/tests/grupper/dimensions.rs
(prosjektlonnsomhet_composes_ledger_and_hours): faktura + kostnadsbilag +
delvis fakturerte timer på et kundekoblet prosjekt gir håndregnede
tall i oversikt og detalj; motpost uten dimensjon lekker ikke inn;
ukjent kode nektes.