Hopp til innhold

Løsning

Vit når et selskap leverer regnskap

Denne kombinasjonen lar deg lese innleverte årsregnskapstall på forespørsel, eller abonnere på en signert endringshendelse i det øyeblikket et selskap leverer nytt regnskap. En overvåket grunnlinje sender ut hendelsen, så det blir ingen daglig polling og ingen tapt levering.

Hva den gjør

Overvåkeren kombinerer et oppslag på forespørsel med en hendelsesdrevet abonnementsflyt.

  • Les om årsregnskap er levert, siste regnskapsår og nøkkeltall (sum eiendeler, årsresultat) der de er tilgjengelige, som tri-tilstands-felter der null betyr ukjent.
  • Abonner på en signert accounts.updated-hendelse; en privat grunnlinje sikrer minst-én-gang-levering uten å miste en hendelse.
  • Webhook-signaturen er HMAC-SHA256; nøkkel idempotens på change.id.

Hvem den er for

For plattformer som reagerer på at et selskaps regnskapsstatus endrer seg.

  • Regnskaps- og finanssystemer som vil trigge arbeid når en klient leverer årsregnskap.
  • Regnskapsbyrå som følger leveringsstatus på tvers av en stor klientportefølje.

Et konkret eksempel

Les innleverte årsregnskapstall (autentisert med API-nøkkel):

curl -H 'Authorization: Bearer <API_KEY>' https://www.apier.no/api/v1/company/999999999/accounts

Svaret gir has_filed_annual_accounts, siste regnskapsår og et key_figures-objekt der det finnes et regnskap. For å bli varslet ved endring registrerer du et webhook-abonnement. Full flyt i oppskriften.

Kilder

Relaterte sider

Ofte stilte spørsmål

Er norske selskapers regnskap offentlige?

Ja — innlevert årsregnskap er offentlig, hentet fra Regnskapsregisteret hos Brønnøysundregistrene; vi bruker også de åpne dataene, og selger overvåkingen og leveringen oppå.

Hva er forskjellen på å lese på forespørsel og webhooken?

Du kan lese innleverte tall på forespørsel, eller abonnere på en signert accounts.updated-hendelse som utløses i det øyeblikket et selskap leverer; en overvåket privat grunnlinje sikrer minst-én-gang-levering, så det blir ingen daglig polling og ingen tapt levering.

Hvilke nøkkeltall gir oppslaget på forespørsel?

Du får has_filed_annual_accounts, siste regnskapsår og et key_figures-objekt (sum eiendeler og årsresultat der det finnes) som tri-tilstands-felter, der null betyr ukjent.

Hvordan er accounts.updated-webhooken sikret?

accounts.updated-webhooken er signert med HMAC-SHA256, og du nøkler idempotens på change.id, slik at en gjenlevert hendelse behandles bare én gang.

Kom i gang

Prøv endepunktene i sandkassen uten innlogging, eller se priser og grunnleggertilbudet.

Eller registrer deg for en API-nøkkel for å kalle de autentiserte endepunktene.