Nordlet

← All features

Regnskapsprogramvare med API

Alle deler av Nordlet er tilgjengelige gjennom ett enkelt JSON-API, komplett med SDK-er, webhooker, idempotent gjentakelse og en MCP-server for KI-assistenter.

Et API (grensesnitt for applikasjonsprogrammering) er en måte for ett program å kommunisere med et annet på. Et regnskaps-API gjør det mulig for din egen programvare å opprette fakturaer, registrere betalinger og lese av rapporter uten at en person trenger å klikke seg gjennom skjermbilder.

Nordlet er regnskapsprogramvare der API-et er hovedinngangsporten. Alt nettgrensesnittet kan gjøre, er tilgjengelig via det samme JSON-API-et. Denne siden er for utviklerne og for dem som bestemmer hva produktet skal integreres med.

Hva Nordlet gjør

  • Én forespørselsstruktur. Alle kall utføres som POST /v1/{module}/{resource}/{action} med et JSON-innhold, for eksempel sales/invoices/create eller bank/transactions/match.
  • API-nøkler med omfang (scopes). Hver nøkkel tilhører ett foretak og har tilhørende omfang, som sales:read eller bank:write. En nøkkel som mangler det nødvendige omfanget, gir en 403-feilmelding.
  • Penger som tekst. Beløp er desimalstrenger med opptil 4 desimaler, aldri flyttall, slik at ingen ørebeløp går tapt på grunn av avrunding.
  • Én enkelt feilformat. Alle feilmeldinger har den samme strukturen med en kode, en melding og en forespørsels-ID (request id).
  • Delte listekall. Alle list-kall bruker de samme feltene for sideinndeling (paging), sortering og filtrering, og kan returnere summer.
  • Reelle regnskapsregler. Buntelgninger / bilag må balansere, dokumentnumre skal være fortløpende uten hull, og en låst regnskapsperiode avviser nye bokføringer med en 409-feilmelding. Alle endringer skrives til en revisjonslogg (audit log).

Sikre forsøk med idempotens

Et nettverk kan feile etter at forespørselen din har blitt behandlet, men før du mottar svaret. Et nytt forsøk kan da føre til at den samme fakturaen opprettes to ganger. Idempotens betyr at en gjentatt forespørsel gir nøyaktig samme virkning som den første.

  • Send med en Idempotency-Key-topptekst (header) for alle kall som endrer data.
  • Et nytt forsøk med samme nøkkel og samme innhold gir det lagrede svaret tilbake, merket med x-idempotent-replay: true.
  • Den samme nøkkelen med et annet innhold avvises.
  • Nøkler lagres i 24 timer.

Webhooker

En webhook er en melding som Nordlet sender til serveren din når en hendelse inntreffer, for eksempel sale_invoice.paid.

  • Hendelser skrives i den samme databasetransaksjonen som endringen, slik at en endring som blir rullet tilbake (rolled back), ikke utløser noen hendelse.
  • Hver levering signeres med HMAC-SHA256 ved hjelp av abonnementshemmeligheten din, slik at du kan bekrefte at den kommer fra Nordlet.
  • En mislykket levering forsøkes på nytt i omtrent 24 timer. Du kan også utløse den manuelt på nytt.
  • Abonnementer administreres under Konto → Webhooker eller via API-et.

Verktøy for utviklere

  • API-referanse. En interaktiv API-referanse bygget på OpenAPI-beskrivelsen, i tillegg til en Postman-samling.
  • SDK-er. Typede klienter for TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift og Rust, generert fra den samme beskrivelsen. Se veiledningen for SDK-er.
  • MCP-server. KI-assistenter som Claude kan søke i og kalle API-et ved hjelp av API-nøkkelen din. Se veiledningen for MCP-serveren.
  • Testforetak (sandbox companies). Et testforetak fungerer som et ekte foretak, er merket som testdata, og sender innberetninger og e-fakturaer utelukkende til myndighetene sine testendepunkter.
  • Frekvensbegrensning (rate limit). 300 forespørsler per minutt per API-nøkkel, med topptekster som viser hvor mye som gjenstår.

FAQ

Hva kan jeg gjøre gjennom API-et?

Alt i produktet: fakturering, innkjøp, hovedbok, bankavstemming, lager, anleggsmidler, lønn, rapporter og offentlige rapportering til myndighetene. Kom i gang-veiledningen tar deg gjennom en komplett syklus fra faktura til mva-tall.

Kan jeg bygge regnskap inn i mitt eget produkt?

Ja. Hvert foretak i Nordlet har sine egne regnskapsbøker, og programvaren din opererer på disse via sin egen API-nøkkel. API-et har ingen kall som endrer eller sletter et bokført bilag. En korrigering utføres som et nytt bilag, noe som sikrer en uforanderlig hovedbok.

Relatert