dit bladDit blad laat zien hoe je je bonnen uit Meerstaat krijgt: via CSV, de REST API of webhooks, en wat er nadrukkelijk niet is.
De drie uitgangen
Alles wat erin gaat, kun je er weer uit halen.
Je gegevens blijven van jou. Drie uitgangen, alle drie in de prijs, geen kosten per bon of per aanroep.
CSV-export
Selecteer een periode, een klus, een medewerker of een status en download een CSV met precies de bonnen die op je scherm staan. Direct in te lezen in Excel.
REST API
GET /v1/entries geeft bonnen met cursor-paginering, GET en POST /v1/jobs houdt je klussenlijst gelijk. De sleutel vraag je aan, er is nog geen beheerscherm.
Webhooks
Bij elke nieuwe bon (new.entry) en elke goedkeuring (approved.entry) gaat er een bericht naar jouw server, ondertekend met HMAC-SHA256.
- basis-url
- https://app.meerstaat.nl/api/v1
- specificatie
- meerstaat.nl/api
De export
Negen kolommen, meer niet.
De weg die altijd werkt, ook als je boekhouder liever een bestand krijgt dan een koppeling.
serial;status;job;member;captured_at;received_at;amount_eur;description;rejection_reason- serial
- Het bonnummer, bijvoorbeeld MS-0148.
- status
- draft, submitted, approved, rejected of invoiced.
- job
- De klus waar de bon bij hoort.
- member
- De medewerker die de bon gemaakt heeft.
- captured_at
- Datum en tijd van vastleggen, als 16-07-2026 14:20.
- received_at
- Datum en tijd waarop de bon binnenkwam. Met bereik dezelfde minuut als captured_at, zonder bereik later.
- amount_eur
- Bedrag met twee decimalen en een komma, leeg als er nog geen bedrag op staat.
- description
- Wat er extra gedaan is, in de woorden van de vakman.
- rejection_reason
- Alleen gevuld bij een afgekeurde bon.
De velden staan tussen puntkomma’s en het bestand begint met een UTF-8 byte order mark: dat is wat een Nederlandse Excel nodig heeft om er kolommen van te maken en de accenten goed te zetten. Wil je komma’s en ISO-tijden voor je eigen systeem, neem dan de REST API. Het bestand bevat precies de bonnen die op dat moment op je scherm staan, in elke status. Wil je alleen wat is goedgekeurd, zet dan eerst het statusfilter op Goedgekeurd: een afgekeurde bon hoort niet op de factuur, en een concept is nog niet aan jou voorgelegd.
Eerlijk
Wat we niet leveren.
Elke meerwerk-app zet een rij logo's van boekhoudpakketten op de site. Wij niet, want dan zou je iets aanzetten dat er niet is.
wat er wel is, en de drie dingen die er niet zijn
Wat er wel is, is klein en voorspelbaar. De volledige specificatie, inclusief het controleren van de HMAC-handtekening, staat op de API-pagina.
Beginnen
Eerst bonnen, dan koppelen.
De CSV-export werkt vanaf de eerste dag, zonder dat er iets ingericht hoeft te worden. Een sleutel vraag je later aan.
geen creditcard nodig
maandelijks opzegbaar