Nordlet

← All features

Nordlet for app-utviklere

Legg til fakturering, regnskap og EU-skatteinnberetninger i programvaren din gjennom ett enkelt JSON-API, typede SDK-er, webhooks, en MCP-server og sandkasseselskaper.

Mange apper skaper pengenevener: en ordre blir betalt, et abonnement fornyes, en refusjon utstedes. Hver av disse hendelsene må ende opp i regnskapet til et selskap.

Nordlet er regnskapsprogramvare bygget med API-et i sentrum (API-first). Alt nettgrensesnittet gjør, er også tilgjengelig gjennom ett enkelt JSON-API. Appen din sender hendelsene, og Nordlet fører regnskapet og klargjør skatteinnberetningene.

Hva Nordlet gjør

  • Eksponerer hver handling som POST /v1/{module}/{resource}/{action} med et JSON-brødtekst, for eksempel /v1/sales/invoices/create.
  • Autentiserer hver forespørsel med en API-nøkkel som tilhører ett selskap. Hver nøkkel har tilganger (scopes), som sales:read eller sales:write, som begrenser hva den kan gjøre.
  • Tar imot beløp som desimalstrenger, aldri som flyttall, slik at ingen ørebeløp går tapt ved avrunding.
  • Godtar en Idempotency-Key-header ved hver endring. Et nytt forsøk med samme nøkkel returnerer det første svaret i stedet for å utføre arbeidet en gang til. Idempotens betyr at en gjentatt forespørsel har nøyaktig samme virkning som én enkelt forespørsel.
  • Returnerer alle feil i et felles format.
  • Tillater 300 forespørsler i minuttet per API-nøkkel.
  • Registrerer hver endring i en revisjonslogg (audit log).

Veiledningen for API-konvensjoner dekker hver av disse reglene i detalj.

Regnskap som holder seg korrekt

  • Utstedelse av en faktura tildeler et hullfritt nummer, sjekker at regnskapsperioden er åpen, og bokfører bilaget i samme databasetransaksjon.
  • Alle posteringer må balansere. Databasen sjekker dette selv når transaksjonen lagres.
  • Utstedte og registrerte dokumenter kan ikke slettes. En feilaktig bankavstemming angres med en motpostering i stedet for å redigere den gamle. Dette er hva en uforanderlig hovedbok / immutable ledger betyr.

SDK-er, MCP og webhooks

  • Typede SDK-er genereres fra den samme OpenAPI-beskrivelsen for TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift og Rust. Før en SDK blir publisert, installerer du den fra kilderepositoriet. Se SDK-veiledningen.
  • En Postman-samling med alle endepunkter er tilgjengelig.
  • MCP-serveren lar en KI-assistent som Claude Code søke i API-et og kalle det opp med API-nøkkelen din. Hvert kall er en vanlig API-forespørsel med de samme tilgangiene og grensene.
  • Webhooks varsler appen din når noe skjer, for eksempel sale_invoice.issued eller sale_invoice.paid. Hver levering er signert med en HMAC-signatur slik at du kan sjekke at den kommer fra Nordlet. Mislykkede leveringer forsøkes på nytt i omtrent 24 timer.

Testing med sandkasseselskaper

  • Opprett et selskaper med isSandbox: true, eller kryss av i sandkasseboksen når du oppretter et selskap i appen.
  • Et sandkasseselskap fungerer akkurat som et ekte selskap: samme moduler, samme API.
  • Det er tydelig merket som testdata, og du kan ikke gjøre et ekte selskap om til en sandkasse eller omvendt.
  • Innberetninger og e-fakturaer fra et sandkasseselskap går til Skatteetatens testtjenester.
  • Bruk i et sandkasseselskap måles og faktureres på samme måte som bruk i et ekte selskap.

Kom i gang-veiledningen viser deg gjennom den første API-nøkkelen, den første fakturaen og hele syklusen.

FAQ

Kan én app betjene flere selskaper?

Ja. Hver API-nøkkel tilhører ett selskap, så du oppretter en nøkkel per selskap. Hver webhook-levering inneholder companyId for selskapet den tilhører, slik at én mottaker kan betjene flere selskaper.

Må jeg bygge skatteinnberetningene selv?

Nei. Nordlet bygger innberetningene ut fra regnskapet. For hver innberetning skjer det enten automatisk innsending, generering av en fil du laster opp, eller visning av tall du fyller ut manuelt, avhengig av land. Oversikten over innberetningsstøtte lister opp alle tilfeller.

Relatert