Wat is een accounting-API? Een praktische gids voor platformbouwers

Een heldere definitie van de accounting-API, het verschil met een belasting- of betalings-API en waar u op moet letten voordat u hierop integreert.

Een accounting-API is een interface waarmee het ene programma de administratie van een ander programma kan bijhouden. Uw software stuurt een financiële gebeurtenis via HTTP. De API zet die gebeurtenis om in sluitende journaalposten volgens de dubbele boekhouding op basis van een grootboekrekeningschema (chart of accounts), slaat deze onveranderbaar op, past de correcte btw-behandeling toe en geeft rapporten, documenten en exports terug via dezelfde interface.

Die definitie dekt het grootste deel van de lading. Al het overige in dit artikel volgt logisch uit deze werking.

De kern in één zin

Een accounting-API accepteert financiële gebeurtenissen van uw applicatie, zet elke gebeurtenis om in een sluitende journaalpost, slaat deze onveranderbaar op inclusief btw-behandeling en onderbouwende bewijsstukken, en stelt het resulterende grootboek, documenten en rapporten beschikbaar via programmeerbare endpoints.

Als een product zichzelf een accounting-API noemt maar geen journaalposten genereert, is het iets anders met een mooi jasje. Dat hoeft niet per se slecht te zijn, maar het betekent wel dat het niet de taak zal uitvoeren waar u het voor nodig heeft.

Wat een accounting-API niet is

Vier aanverwante productcategorieën worden vaak verward met accounting-API's, doorgaans laat in een project.

Categorie	Wat het wel doet	Wat het niet doet
Belastingberekenings-API	Geeft het juiste tarief of btw-bedrag terug voor een transactie	Uw administratie bijhouden of de bewijsstukken achter de beslissing bewaren gedurende de bewaartermijn
Betalings-API	Verplaatst geld tussen partijen en rapporteert over die geldstromen	De verdiende commissie, verschuldigde btw of de schuld aan een verkoper vastleggen tussen betaling en uitbetaling
Geaggregeerde API	Leest en schrijft data in de bestaande boekhouding van uw klant	Dienen als het systeem van registratie (system of record); uw administratie bevindt zich in het tool dat elke klant al gebruikt
Rapportage- of BI-API	Leest cijfers uit een bestaand grootboek en visualiseert deze	De journaalposten aanmaken waar de cijfers uit worden afgeleid

Al deze categorieën hebben nuttige toepassingen. Een platform dat als bron van waarheid moet fungeren, heeft echter een accounting-API nodig als fundament, en niet als vervanging daarvan.

De vijf taken van een accounting-API

1. Sluitende posten vastleggen. Elke gebeurtenis mondt uit in debets en credits die exact met elkaar in balans zijn. Wanneer een koper 100 euro betaalt op een marktplaats die 15 euro commissie inhoudt, debiteert de boeking een tussenrekening met 100 euro, crediteert het de schuld aan de verkoper met 85 euro en crediteert het de commissie-omzet met 15 euro. Dit is geen administratieve rompslomp, maar een structurele controle die allerlei integratiefouten eruit pikt nog voordat ze in een rapport verschijnen.

2. Historie bewaren. Een geboekte post wordt niet achteraf bewerkt. Een fout wordt gecorrigeerd via een tegenboeking (reversal) plus een gecorrigeerde post, die beide gekoppeld blijven aan het origineel. Afgesloten maanden worden vergrendeld zodat er geen posten meer aan kunnen worden toegevoegd met een datum in die periode.

3. Btw afhandelen. Voor handel binnen de EU betekent dit dat de plaats van dienst (place of supply), de verleggingsregeling (reverse charge), gecontroleerde btw-identificatienummer in het VIES-register en het onderbouwende bewijsmateriaal worden opgeslagen bij de transactie in plaats van te worden weggegooid na de berekening.

4. Afletteren tegen extern geld. Een administratie die nooit wordt vergeleken met een bankafschrift is slechts een schatting. De API moet bankafschriften of uitbetalingen van providers inlezen en deze matchen met wat er in de administratie is vastgelegd.

5. Exporteren. Het genereren van rapporten, documenten en auditbestanden in formaten die door een accountant en de Belastingdienst worden geaccepteerd.

Een product dat de eerste drie taken wel uitvoert maar de laatste twee niet, laat u alsnog maandelijks handmatig werk verrichten in spreadsheets.

Hoe een API-aanroep er in de praktijk uitziet

De technische werking is eenvoudiger dan de boekhouding zelf. In de API van Nordlet is elke operatie een RPC-achtige POST met een voorspelbare structuur:

POST /v1/{module}/{resource}/{action}
Authorization: Bearer <api key>
Idempotency-Key: <your event id>

U maakt een verkoopfactuur aan en boekt deze vervolgens definitief. Het definitief maken is het moment waarop de boeking plaatsvindt: het document krijgt een sluitend opeenvolgend nummer, de gebalanceerde journaalpost wordt geboekt en de btw-regels worden daarbij vastgelegd. Uw platform hoeft nooit handmatig debets en credits bij elkaar op te tellen.

Drie details in dat fragment zijn belangrijker dan de naam van het endpoint:

De scope van de sleutel. Een sleutel draagt specifieke rechten zoals sales:write, zodat een integratie alleen de toegang krijgt die nodig is.
De idempotentiesleutel (idempotency key). Als u dezelfde aanvraag met dezelfde payload herhaalt, krijgt u de opgeslagen respons terug in plaats van een tweede factuur. Stuurt u dezelfde sleutel mee met een andere payload, dan wordt de aanvraag afgewezen met idempotency_key_reuse in plaats van stilzwijgend geaccepteerd.
Bedragen als strings. Bedragen zijn decimale strings en geen floating-point getallen, omdat floats afrondingsfouten kunnen veroorzaken die pas aan het einde van het jaar aan het licht komen.

Waar de API zich bevindt in uw architectuur

Uw applicatie blijft de frontend en de bron van zakelijke gebeurtenissen. De accounting-API fungeert erachter als het financiële systeem van registratie. De doorloop ziet er doorgaans zo uit:

Er gebeurt iets in uw product: een bestelling, een terugbetaling, een uitbetaling of de verlenging van een abonnement.
Uw backend roept de accounting-API aan met de gebeurtenis en een idempotentiesleutel.
De API boekt de journaalpost, past de btw toe en stuurt identificatoren terug die u opslaat in uw eigen administratie.
Een webhook zoals sale_invoice.paid laat uw systeem weten wanneer de status verandert, zodat u direct reageert op gebeurtenissen in plaats van te pollen.
Banktransacties komen binnen via een bankfeed of een bestandsimport en worden afgeletterd tegen de geregistreerde documenten.
Aan het einde van de periode worden rapporten en btw-aangiften gegenereerd op basis van dezelfde data en wordt de afgesloten maand vergrendeld.

Voor geen van deze stappen is het nodig dat iemand handmatig een boekhoudprogramma opent. Dat is precies de kracht van dit type product.

Hoe het zich verhoudt tot alternatieven

Aanpak	Startinspanning	Auditgeschiktheid	Schaalbaarheid bij transactievolume
Spreadsheets en handmatige invoer	Laagst	Zwak; historie is aanpasbaar	Nee
Boekhoudsoftware plus CSV-exports	Laag	Hangt volledig af van discipline	Matig; iemand moet bestanden importeren
Geaggregeerde API naar de administratie van elke klant	Gemiddeld	Neemt de eigenschappen over van het tool van de klant	Ja, maar u bent nooit eigenaar van de brondata
Embedded accounting-API	Gemiddeld	Sterk als het grootboek onveranderbaar is en perioden vergrendeld kunnen worden	Ja
Uw eigen grootboek bouwen	Hoogst	Alleen sterk als u zelf ook de controles inbouwt	Ja, maar u onderhoudt dit voor onbepaalde tijd

Het zelf bouwen van een grootboek kan voor sommige teams een bewuste keuze zijn. Dit wordt uitvoeriger behandeld in onze gids over zelf bouwen versus inkopen voor marktplaatsen.

Waarop te letten voordat u integreert

Wordt het saldo berekend of opgeslagen? Vraag of het saldo van een verkoper wordt berekend op basis van journaalregels of dat het een los veld is dat ergens wordt bijgewerkt. Slechts één van beide opties houdt stand tijdens een accountantscontrole.
Hoe wordt er omgegaan met een herhalingsaanvraag (retry)? Stuur dezelfde aanvraag tweemaal en tel het aantal resulterende boekingen.
Kunt u een definitieve boeking bewerken? Het antwoord hierop moet 'nee' zijn, ondersteund door een gedocumenteerde correctieprocedure.
Weigert een vergrendelde periode daadwerkelijk nieuwe boekingen? Test dit in een sandbox-omgeving. Nordlet geeft een 409-foutmelding terug voor een boeking met een datum in een vergrendelde periode.
Hoe worden bedragen weergegeven? Als decimale strings of als gehele getallen in centen (minor units). Gebruik nooit floats.
Wat zit er in het auditlogboek? Acteur, actie, entiteit en de wijziging zelf, opvraagbaar in plaats van verstopt in logbestanden.
Wat zijn de rate limits? Nordlet staat 300 aanvragen per minuut toe per API-sleutel en rapporteert uw resterende limiet in de response headers. Wat het getal ook is, zorg dat u het weet voordat u de synchronisatie ontwerpt.
Hoe haalt u uw data op? Rapporten, documenten en journaalposten in formaten die u direct aan een accountant kunt overhandigen.

Al deze punten kunt u binnen een middag testen in een sandbox-omgeving. De lijst met functies op een marketingpagina biedt geen zekerheid; een reproduceerbare test wel.

FAQ

Is een accounting-API hetzelfde als boekhoudsoftware?

Het is boekhoudsoftware waarbij de interface is verplaatst. Traditionele boekhoudsoftware toont een scherm aan een mens; een accounting-API toont de data aan uw code. De onderliggende verplichtingen, de dubbele boekhouding en de rapportages zijn exact hetzelfde.

Heb ik nog steeds een accountant nodig als ik hier gebruik van maak?

Ja. Een API automatiseert de registratie, berekening en rapportage. Het neemt geen beslissingen over waarderingen, fiscale voorzieningen of hoe een specifiek contract moet worden behandeld, en in de meeste landen ondertekent of dient het uw wettelijke jaarrekening niet in.

Kan ik een accounting-API gebruiken zonder verstand te hebben van dubbel boekhouden?

Grotendeels wel. Een goede API stelt de journaalposten automatisch voor u samen op basis van een bedrijfsdocument zoals een factuur. U moet echter wel begrijpen wat de grootboekrekeningen betekenen wanneer u een rapport leest of een saldo uitlegt aan een accountant of belastinginspecteur.

Wat is het verschil tussen een accounting-API en een ledger-API?

Een ledger-API registreert gebalanceerde geldstromen tussen rekeningen. Een accounting-API doet dat ook, maar voegt de wettelijke en fiscale laag daaraan toe: documenten met opeenvolgende nummers, btw-behandeling, btw-registers, vaste activa, periodeafsluiting en de rapportages die in een jurisdictie vereist zijn. Elke accounting-API bevat een ledger, maar niet elke ledger is een compleet boekhoudsysteem.

Hoe lang duurt een integratie?

Voor een eerste werkende stroom — een klant aanmaken, een factuur versturen, een betaling ontvangen en de journaalpost inzien — kunt u met een getypeerde SDK en een sandbox rekenen op een paar dagen in plaats van weken. Een productie-integratie die ook terugbetalingen, correcties, multi-valuta, aflettering en periodeafsluiting omvat, is complexer. Een eerlijke schatting hangt af van hoeveel van die scenario's daadwerkelijk in uw product voorkomen.