Regnskabsprogram med API

Alle dele af Nordlet er tilgængelige via et enkelt JSON API med SDK'er, webhooks, idempotente gentagelser og en MCP-server til AI-assistenter.

Et API (application programming interface) er en måde for et program at kommunikere med et andet på. Et regnskabs-API gør det muligt for din egen software at oprette fakturaer, bogføre betalinger og læse rapporter uden at en person skal klikke sig gennem skærmbilleder.

Nordlet er et regnskabsprogram, hvor API'et er den primære indgang. Alt det, som webapplikationen kan gøre, er tilgængeligt over det samme JSON API. Denne side er til udviklere og til dem, der beslutter, hvad deres produkt skal integreres med.

Hvad Nordlet kan

Ét anmodningsformat. Hvert kald er POST /v1/{module}/{resource}/{action} med et JSON-indhold, for eksempel sales/invoices/create eller bank/transactions/match.
API-nøgler med rettigheder (scopes). Hver nøgle tilhører én virksomhed og bærer rettigheder som sales:read eller bank:write. En nøgle uden den nødvendige rettighed får et 403-svar.
Penge som tekst. Beløb er decimale strenge med op til 4 decimaler, aldrig flydende kommatal, så der ikke mistes ørebeløb ved afrunding.
Ét fejlformat. Hver fejl har den samme struktur med en kode, en meddelelse og et anmodnings-id (request ID).
Fælles listeforespørgsler. Hvert list-kald accepterer de samme felter til sideinddeling, sortering og filtrering, og kan returnere totaler.
Rigtige regnskabsregler. Kladder og posteringer skal balancere, bilagsnumre må ikke have huller, og en låst regnskabsperiode afviser nye posteringer med et 409-svar. Enhver ændring skrives til en revisionslog (audit log).

Sikre gentagelser med idempotens

Et netværk kan fejle, efter din anmodning er blevet behandlet, men før du modtager svaret. Et nyt forsøg kan derfor risikere at oprette den samme faktura to gange. Idempotens betyder, at en gentagen anmodning har nøjagtig samme virkning som den første.

Send en Idempotency-Key-header med ved alle kald, der ændrer data.
Et nyt forsøg med samme nøgle og samme indhold returnerer det gemte svar med x-idempotent-replay: true.
Den samme nøgle med et andet indhold afvises.
Nøgler gemmes i 24 timer.

Webhooks

En webhook er en meddelelse, Nordlet sender til din server, når der sker noget, for eksempel sale_invoice.paid.

Hændelser skrives i samme databasetransaktion som ændringen, så en ændring, der rulles tilbage, ikke sender nogen hændelse.
Hver levering signeres med HMAC-SHA256 ved hjælp af dit abonnementshemmelighed (subscription secret), så du kan kontrollere, at den kommer fra Nordlet.
En fejlet levering forsøges igen i ca. 24 timer. Du kan også udsende den manuelt.
Abonnementer administreres under Konto → Webhooks eller via API'et.

Værktøjer til udviklere

API-reference. En interaktiv API-reference bygget ud fra OpenAPI-beskrivelsen samt en Postman-samling.
SDK'er. Typede klienter til TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift og Rust, genereret ud fra den samme beskrivelse. Se vejledningen til SDK'er.
MCP-server. AI-assistenter som Claude kan søge i og kalde API'et ved hjælp af din API-nøgle. Se vejledningen til MCP-serveren.
Testvirksomheder (sandboxes). En testvirksomhed fungerer som en rigtig virksomhed, er markeret som testdata og sender indberetninger og e-fakturaer udelukkende til myndighedernes testmiljøer.
Sratgrænse (rate limit). 300 anmodninger i minuttet pr. API-nøgle med headers, der viser, hvad der er tilbage.

FAQ

Hvad kan jeg gøre via API'et?

Alt i produktet: fakturering, indkøb, finansregnskab (general ledger), bankafstemning, lager, anlægsaktiver, løn, rapporter og landespecifikke indberetninger. Kom i gang-vejledningen gennemgår en komplet cyklus fra faktura til momstal.

Kan jeg indbygge regnskab i mit eget produkt?

Ja. Hver virksomhed i Nordlet har sit eget regnskab, og din software arbejder på det via sin API-nøgle. API'et indeholder ikke kald, der redigerer eller sletter en bogført postering. En korrektion er en ny postering, hvilket sikrer en uforanderlig regnskabsbog (immutable ledger).