Regnskapsregisteret: regnskapstall via API

Hva det er

Regnskapsregisteret er det offisielle registeret over årsregnskap for norske bedrifter med regnskapsplikt, i hovedsak AS og ASA. Hver innlevering dekker én regnskapsperiode og inneholder resultatregnskap og balanse i den valutaen bedriften rapporterer i, som regel norske kroner.

API-et gir bare siste innleverte år per bedrift per henting, ikke hele historikken. Orakel lagrer hvert hentede år som en Financial-post og beholder tidligere år mellom synkroniseringene, så flere år bygger seg opp passivt, omtrent ett nytt år per driftsår. Dypere historikk (eldre årsregnskap, fullstendige noter, innleveringer på papir) finnes bare i Brønnøysundregistrenes betalte arkiv, som Orakel ikke laster inn. Se policyen for betalte kilder. API-et er merket som forhåndsvisning av registeret, så enkeltoppslag kan feile. Orakel beholder det den har og prøver igjen.

Felt som følger med

Regnes ut i hvert svar

Bedrifts- og søkeendepunktene legger utregnede nøkkeltall på hver Financial-post. De lagres ikke i databasen, men regnes ut når du leser.

Hvert nøkkeltall er tomt når nevneren er null, eller når et av tallene mangler.

Endepunkter som gir deg dette

• GET /api/companies/:orgNumber: bedriftskortet inneholder financials[] sortert med det ferskeste først, med nøkkeltall og vekst siste år
• GET /api/companies: søkeresultatene inneholder inntil de to siste innleveringene per bedrift, med nøkkeltall
• GET /api/updates?since=<ISO-dato>: bedrifter som er endret, kommer med sin siste innlevering

Det finnes ikke et eget /api/financials-endepunkt. Regnskapstall returneres alltid sammen med bedriften.

Begrensninger

• Bare bedrifter med regnskapsplikt finnes her: AS, ASA og noen få andre former. Enkeltpersonforetak leverer ikke regnskap og har ingen poster.
• Feltet latestRevenueNOK på bedriftsraden oppdateres under regnskapssynkroniseringen og brukes til å filtrere på omsetning. Det henger etter siste innlevering til neste synkronisering.
• Utregnede nøkkeltall er tomme når nevneren er null eller tallet mangler. Ikke tolk en tom verdi som et nøytralt tall.
• API-et er merket som forhåndsvisning av registeret. Sporadiske 5xx-svar prøves på nytt med økende ventetid. Et langvarig avbrudd viser seg som gamle verdier i syncedAt.

Verdt å vite

• En full regnskapssynkronisering tar rundt ti timer for alle AS og ASA. Jobben er delt i porsjoner og kjører hvert 30. minutt, og fortsetter fra det siste behandlede organisasjonsnummeret, så den overlever utrullinger.
• Antall år vokser av seg selv. En synkronisering henter bare siste innlevering, så en bedrift som synkroniseres for første gang i dag, gir ett år. Flere år kommer etter hvert som Orakel fortsetter å kjøre, omtrent ett nytt år per driftsår. Ikke en dyp historikk med det samme. Krever en avtale lange tidsserier, pris inn det betalte arkivet.
• Regnskapsår følger ikke alltid kalenderåret. Bruk periodFrom og periodTo framfor å gjette et årstall.
• Én bedrift kan ha både en SELSKAP-innlevering og en KONSERN-innlevering for samme periode. De lagres som egne poster, med nøkkelen (country, orgNumber, regnskapstype, periodFrom, periodTo).
• Valutaen lagres slik den er innlevert. En innlevering i norske kroner og en i euro kan stå side om side for det samme konsernet. Sjekk alltid currency før du summerer på tvers av bedrifter.