Boekhoudsoftware met een API

Elk onderdeel van Nordlet is beschikbaar via één JSON-API, met SDK's, webhooks, idempotente hertransacties en een MCP-server voor AI-assistenten.

Een API (application programming interface) is een manier voor het ene programma om met het andere te communiceren. Via een boekhoud-API kan uw eigen software facturen aanmaken, betalingen registreren en rapporten inlezen, zonder dat er iemand door schermen hoeft te klikken.

Nordlet is boekhoudsoftware waarbij de API de belangrijkste ingang is. Alles wat de webapplicatie doet, is beschikbaar via dezelfde JSON-API. Deze pagina is bedoeld voor ontwikkelaars en voor de personen die bepalen waar hun product mee koppelt.

Wat Nordlet doet

Eén aanvraagstructuur. Elke aanroep is POST /v1/{module}/{resource}/{action} met een JSON-body, bijvoorbeeld sales/invoices/create of bank/transactions/match.
API-sleutels met scopes. Elke sleutel behoort toe aan één bedrijfsentiteit en is voorzien van scopes zoals sales:read of bank:write. Een sleutel die de vereiste scope mist, krijgt een 403-antwoord.
Geld als tekst. Bedragen zijn decimale tekenreeksen met maximaal 4 decimalen, en dus nooit driekommagetallen, zodat er geen centen verloren gaan door afronding.
Eén foutopmaak. Elke foutmelding gebruikt dezelfde envelop met een code, een bericht en een request id.
Gedeelde lijstquery's. Elke list-aanroep maakt gebruik van dezelfde velden voor paginering, sortering en filtering, en kan totalen retourneren.
Echte boekhoudregels. Boekingen moeten in evenwicht zijn, documentnummers kennen geen gaten, en een vergrendelde boekhoudperiode weigert nieuwe journaalposten met een 409-antwoord. Elke wijziging wordt weggeschreven naar een auditlogboek.

Veilige hertransacties met idempotentie

Een netwerkverbinding kan wegvallen nadat uw aanvraag is verwerkt, maar voordat u het antwoord heeft ontvangen. Het opnieuw versturen van de aanvraag kan er dan toe leiden dat dezelfde factuur dubbel wordt aangemaakt. Idempotentie betekent dat een herhaald verzoek hetzelfde effect heeft als het eerste.

Stuur een Idempotency-Key-header mee bij elke aanroep die gegevens wijzigt.
Een hertransactie met dezelfde sleutel en dezelfde body retourneert het opgeslagen antwoord, vergezeld van x-idempotent-replay: true.
Dezelfde sleutel met een afwijkende body wordt geweigerd.
Sleutels worden 24 uur lang bewaard.

Webhooks

Een webhook is een bericht dat Nordlet naar uw server stuurt wanneer er iets gebeurt, zoals sale_invoice.paid.

Gebeurtenissen worden weggeschreven in dezelfde databasetransactie als de wijziging, zodat een wijziging die wordt teruggedraaid geen evenement verstuurt.
Elke levering is ondertekend met HMAC-SHA256 op basis van uw abonnementsgeheim, zodat u kunt verifiëren dat deze afkomstig is van Nordlet.
Een mislukte bezorging wordt gedurende ongeveer 24 uur opnieuw geprobeerd. U kunt het bericht ook handmatig opnieuw versturen.
Abonnementen worden beheerd via Account → Webhooks of via de API.

Hulpmiddelen voor ontwikkelaars

API-referentie. Een interactieve API-referentie op basis van de OpenAPI-beschrijving, inclusief een Postman-collectie.
SDK's. Getypeerde clients voor TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift en Rust, gegenereerd vanuit dezelfde beschrijving. Bekijk de gids voor SDK's.
MCP-server. AI-assistenten zoals Claude kunnen de API doorzoeken en aanroepen met uw API-sleutel. Bekijk de MCP-servergids.
Sandboxbedrijven. Een testbedrijf werkt precies zoals een echt bedrijf, is gemarkeerd als testdata en verstuurt aangiften en e-facturen uitsluitend naar de test-endpoints van de overheidsinstanties.
Rate limit. 300 verzoeken per minuut per API-sleutel, met headers die aangeven hoeveel capaciteit er nog over is.

FAQ

Wat kan ik doen via de API?

Alles wat het product te bieden heeft: facturatie, inkopen, het grootboek, bankkoppelingen, voorraad, activa, loonadministratie, rapportages en wettelijke aangiften. De aan de slag-gids doorloopt een volledige cyclus van factuur tot btw-aangiftecijfers.

Kan ik boekhouding integreren in mijn eigen product?

Ja. Elk bedrijf in Nordlet heeft een eigen administratie, en uw software werkt hierop via de bijbehorende API-sleutel. De API kent geen aanroep waarmee een reeds geboekte journaalpost kan worden gewijzigd of verwijderd. Een correctie is een nieuwe boeking, waardoor de onveranderbaarheid van het grootboek gewaarborgd blijft.