Bokföringsprogram med API

Varje del av Nordlet är tillgänglig via ett enda JSON-API, komplett med SDK-er, webhooks, idempotenta omsökningar och en MCP-server för AI-assistenter.

Ett API (applikationsprogrammeringsgränssnitt) är ett sätt för ett program att kommunicera med ett annat. Med ett bokförings-API kan din egen programvara skapa fakturor, registrera betalningar och läsa rapporter utan att en person behöver klicka sig igenom gränssnitt.

Nordlet är ett bokföringsprogram där API:et är den primära ingången. Allt som webbapplikationen gör är tillgängligt via samma JSON-API. Denna sida riktar sig till utvecklare och till dem som beslutar om vad deras produkt ska integreras med.

Vad Nordlet gör

Enhetlig struktur på anrop. Varje anrop är på formen POST /v1/{module}/{resource}/{action} med en JSON-body, till exempel sales/invoices/create eller bank/transactions/match.
API-nycklar med behörigheter (scopes). Varje nyckel tillhör ett företag och har behörigheter som sales:read eller bank:write. En nyckel som saknar nödvändig behörighet får svarskoden 403.
Pengar som text. Belopp hanteras som decimalsträngar med upp till 4 decimaler, aldrig som flyttal, vilket förhindrar att ören går förlorade vid avrundning.
Enhetligt felformat. Alla fel returneras i samma struktur med felkod, meddelande och ett ärende-ID (request id).
Gemensamma listfrågor. Alla list-anrop använder samma fält för paginering, sortering och filtrering, och kan returnera summor.
Verkliga bokföringsregler. Verifikat måste balansera, verifikationsserier får inte ha luckor och en låst bokföringsperiod avvisar nya bokningar med svarskoden 409. Varje ändring skrivs till en händelselogg (audit log).

Säker hantering av omsökningar med idempotens

Ett nätverk kan drabbas av fel efter att din förfrågan har behandlats men innan du har hunnit ta emot svaret. Om du då gör om förfrågan kan samma faktura skapas två gånger. Idempotens innebär att en upprepad förfrågan får exakt samma effekt som den första.

Skicka med en Idempotency-Key-header vid alla anrop som ändrar data.
En förfrågan som görs om med samma nyckel och samma body får det lagrade svaret tillbaka, tillsammans med headern x-idempotent-replay: true.
Samma nyckel med en annan body avvisas.
Nycklar sparas i 24 timmar.

Webhooks

En webhook är ett meddelande som Nordlet skickar till din server när en händelse inträffar, till exempel sale_invoice.paid.

Händelser skrivs i samma databastransaktion som ändringen, vilket innebär att en ändring som rullas tillbaka inte skickar någon händelse.
Varje leverans signeras med HMAC-SHA256 med hjälp av din hemliga prenumerationsnyckel (subscription secret), så att du kan verifiera att den kommer från Nordlet.
En misslyckad leverans görs om under cirka 24 timmar. Du kan också skicka den på nytt manuellt.
Prenumerationer administreras under Konto → Webhooks eller via API:et.

Verktyg för utvecklare

API-referens. En interaktiv API-referens som har genererats från OpenAPI-beskrivningen, tillsammans med en Postman-samling.
SDK-er. Typade klienter för TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift och Rust, genererade från samma beskrivning. Läs mer i guiden för SDK-er.
MCP-server. AI-assistenter som Claude kan söka i och anropa API:et med din API-nyckel. Läs mer i guiden för MCP-servern.
Testföretag (sandbox companies). Ett testföretag fungerar som ett riktigt företag, är markerat som testdata och skickar skattedeklarationer och e-fakturor enbart till myndigheternas testmiljöer.
Frekvensbegränsning (rate limit). 300 förfrågningar per minut och API-nyckel, med headers som visar hur mycket som återstår.

FAQ

Vad kan jag göra via API:et?

Allt som finns i produkten: fakturering, inköp, huvudbok, bankavstämning, lager, anläggningstillgångar, löner, rapporter och myndighetsrapportering. Kom igång-guiden går igenom en komplett cykel från faktura till momssiffror.

Kan jag bygga in bokföring i min egen produkt?

Ja. Varje företag i Nordlet har sin egen bokföring, och din programvara arbetar mot denna via sin API-nyckel. API:et saknar funktioner för att redigera eller radera bokförda verifikat. En rättelse görs genom ett nytt verifikat, vilket säkerställer en oföränderlig huvudbok (immutable ledger).