Nordlet voor app-ontwikkelaars

Voeg facturatie, boekhouding en EU-belastingaangiften toe aan uw software via één JSON-API, getypeerde SDK's, webhooks, een MCP-server en sandbox-bedrijven.

Veel apps genereren geldstromen: een bestelling wordt betaald, een abonnement wordt verlengd, een terugbetaling wordt verwerkt. Elk van deze gebeurtenissen moet in de boeken van een bedrijf terechtkomen.

Nordlet is boekhoudsoftware die API-first is ontworpen. Alles wat de webapplicatie kan, is ook beschikbaar via één JSON-API. Uw app stuurt de gebeurtenissen, waarna Nordlet de boekhouding bijhoudt en de belastingaangiften voorbereidt.

Wat Nordlet doet

Stelt elke actie beschikbaar als POST /v1/{module}/{resource}/{action} met een JSON-body, bijvoorbeeld /v1/sales/invoices/create.
Authenticeert elk verzoek met een API-sleutel die toebehoort aan één bedrijf. Elke sleutel is gekoppeld aan rechten (scopes), zoals sales:read of sales:write, die bepalen wat ermee mogelijk is.
Accepteert bedragen als decimale strings en nooit als driekommagetallen (floating-point numbers), zodat er geen centen verloren gaan door afronding.
Accepteert een Idempotency-Key-header bij elke wijziging. Een herhaald verzoek met dezelfde sleutel retourneert het eerdere antwoord in plaats de handeling dubbel uit te voeren. Idempotentie (idempotency) betekent dat een herhaald verzoek hetzelfde effect heeft als een enkele aanvraag.
Geeft elke foutmelding terug in één gedeeld formaat.
Staat 300 verzoeken per minuut toe per API-sleutel.
Registreert elke wijziging in een auditlogboek.

De gids met API-conventies behandelt elk van deze regels in detail.

Boekhouding die klopt

Bij het uitreiken van een factuur wordt automatisch een volgend nummer toegewezen, wordt gecontroleerd of de boekhoudperiode (accounting period) openstaat en wordt de boeking (journal entry) in dezelfde databasetransactie vastgelegd.
Elke boeking moet in balans zijn. De database zelf controleert dit op het moment dat de transactie wordt opgeslagen.
Uitgereikte en geregistreerde documenten kunnen niet worden verwijderd. Een verkeerde bankkoppeling wordt gecorrigeerd met een tegenboeking, niet door het oude document te bewerken. Dit is wat een onveranderbaar grootboek (immutable ledger) definieert.

SDK's, MCP en webhooks

Getypeerde SDK's worden gegenereerd vanuit dezelfde OpenAPI-beschrijving voor TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift en Rust. Totdat een SDK is gepubliceerd, kunt u deze installeren vanuit de broncodeopslagplaats. Raadpleeg de SDK-gids.
Er is een Postman-collectie beschikbaar met daarin elk eindpunt.
Via de MCP-server kan een AI-assistent zoals Claude Code de API doorzoeken en aanroepen met uw API-sleutel. Elke aanroep is een normaal API-verzoek met dezelfde rechten en limieten.
Webhooks informeren uw app wanneer er iets gebeurt, bijvoorbeeld sale_invoice.issued of sale_invoice.paid. Elke verzending is ondertekend met een HMAC-handtekening zodat u kunt verifiëren dat deze afkomstig is van Nordlet. Mislukte verzendingen worden gedurende ongeveer 24 uur opnieuw geprobeerd.

Testen met sandbox-bedrijven

Maak een bedrijf aan met isSandbox: true, of vink het sandbox-vakje aan wanneer u een bedrijf instelt in de app.
Een sandbox-bedrijf werkt exact zoals een echt bedrijf: dezelfde modules, dezelfde API.
Het is duidelijk gemarkeerd als testdata, en het is niet mogelijk om van een echt bedrijf een sandbox te maken of omgekeerd.
Aangiften en e-facturen (e-invoice) van een sandbox-bedrijf worden verzonden naar de testomgevingen van de belastingdienst.
Het gebruik van een sandbox-bedrijf wordt geregistreerd en gefactureerd op dezelfde manier als een echt bedrijf.

De startgids leidt u stap voor stap door de eerste API-sleutel, de eerste factuur en de volledige cyclus.

FAQ

Kan één app meerdere bedrijven bedienen?

Ja. Elke API-sleutel hoort bij één bedrijf, dus u maakt per bedrijf een sleutel aan. Elke webhook-levering bevat de companyId van het bedrijf waarvoor deze is bedoeld, waardoor één ontvanger meerdere bedrijven kan bedienen.

Moet ik de belastingaangiften zelf bouwen?

Nee. Nordlet stelt de aangiften samen op basis van de administratie. Afhankelijk van het land wordt de aangifte direct verzonden, wordt er een bestand gegenereerd dat u kunt uploaden, of worden de cijfers getoond die u kunt overnemen. De ondersteuningstabel voor aangiften geeft een overzicht per land.