Naar de inhoud

mijnloonbrief.be

Ruimte voor boekhouders

API en AI-assistent voor boekhouders

Laat een AI-assistent de lonen van uw dossiers coderen: API-sleutel, MCP-server, OpenAPI en een gids voor taalmodellen.

Pagina nagekeken op 10 oktober 2026

Kan een boekhoudkantoor zelf de loonbrieven van zijn klanten opmaken en per API invoeren?

Ja. Een boekhoudkantoor kan zelf de loonbrieven van zijn klanten opmaken zonder sociaal secretariaat te worden: het platform berekent elke loonbrief volgens het officiële barema, het kantoor valideert. Met mijnloonbrief.be schrijft het kantoor elk klantbedrijf in vanuit één account, de klant ondertekent enkel zijn twee mandaten (RSZ in Mahis, Finprof bij de FOD Financiën), en het kantoor krijgt één maandfactuur, dossier per dossier opgesplitst. Een API-sleutel van het kantoor maakt werknemers aan, voert de prestaties van de maand in, berekent het voorbeeld en valideert de loonbrief; een MCP-server laat een AI-assistent hetzelfde doen, met een gids geschreven voor taalmodellen. Elke schrijfopdracht vraagt een idempotentiesleutel, en dry_run rekent zonder iets te bewaren. De loonbrieven dragen het logo van het kantoor. mijnloonbrief.be blijft een niet-erkende aanbieder van sociale diensten: kantoor en klant blijven verantwoordelijk voor hun aangiften.

Wat de API doet

Een sleutel van uw kantoor dekt al uw dossiers. Hij maakt werknemers aan, dient de prestaties van de maand in, berekent het voorbeeld, valideert de loonafrekening en geeft de pdf en de verschuldigde aangiften terug. Hij dekt het hele personeel van een dossier, elke medewerker: het statuut, bediende of arbeider, geeft u op bij het aanmaken van de werknemer.

Dezelfde controles als op het scherm: sectorale minima, baremavakken, facturatie. Een weigering wordt nooit stil omzeild.

Veiligheid zonder moeite

De sleutel vervalt niet en vraagt geen nieuwe aanmelding. U trekt hem met één klik in; hij valt automatisch weg als u de toegang tot een dossier verliest.

Elke schrijfopdracht vraagt een Idempotency-Key: een herhaalde aanvraag maakt nooit een tweede afrekening. dry_run=true berekent zonder iets op te slaan. Elke oproep staat in uw logboek.

De sleutel staat enkel in de header Authorization, nooit in een URL.

Een eerste oproep

Vervang fdp_… door uw sleutel en het btw-nummer door dat van het dossier.

curl -H "Authorization: Bearer fdp_…" https://fiche2paie.be/api/v1/dossiers
curl -H "Authorization: Bearer fdp_…" -H "X-Societe: BE0123456789" https://fiche2paie.be/api/v1/travailleurs

Uw AI-assistent verbinden

1. Maak in Instellingen > API-toegang een sleutel met scope schrijven.

2. Voeg in uw assistent (Claude, ChatGPT of een andere MCP-client) een MCP-server toe met het adres https://fiche2paie.be/mcp.

3. Kies het streamable HTTP-transport en voeg de header Authorization: Bearer fdp_… toe.

4. Vraag de assistent eerst de gids te lezen (bron fiche2paie://guide/nl/LISEZ-MOI.md) of de prompt encoder_le_mois te gebruiken.

5. Laat hem de maand coderen: hij toont u elke weigering en elke waarschuwing voor hij valideert.

Voorbeeld stap voor stap: de maand van een werknemer invoeren

1. GET /api/v1/dossiers: zoek het dossier en geef zijn id of btw-nummer door in de header X-Societe.

2. POST /api/v1/travailleurs met dry_run=true: de server weigert een loon onder het minimum van het paritair comité, een onbekend baremavak of een statuut dat niet bij het comité past. Herhaal zonder dry_run zodra het antwoord schoon is.

3. PUT /api/v1/prestations: dien de uren, dagen, afwezigheden en premies van de maand in. Een nieuwe indiening voor dezelfde maand vervangt de vorige.

4. POST /api/v1/fiches/apercu: bruto, netto, kost, lijnen en waarschuwingen, zonder iets op te slaan. Lees elke waarschuwing.

5. POST /api/v1/fiches: valideert de loonbrief, die dan wordt gefactureerd zoals op het scherm.

6. GET /api/v1/fiches/{id}/pdf: downloadt de pdf.

Vijf veelgemaakte fouten bij het koppelen

Valideren zonder de waarschuwingen van het voorbeeld te lezen. De loonafrekening moet juist zijn en aan de vermeldingen voldoen die de wet van 12 april 1965 betreffende de bescherming van het loon oplegt: het voorbeeld kost niets, de validatie wel.

Een AI-assistent zonder nalezing laten valideren. De aangever blijft verantwoordelijk voor zijn aangiften (wet van 27 juni 1969): lees de weigeringen en waarschuwingen die de assistent toont voor u hem laat verdergaan.

De sleutel in een URL of in een codeopslagplaats zetten. Beveiliging van de verwerking is een plicht van artikel 32 van de AVG: de sleutel hoort alleen in de header Authorization, en wordt met één klik ingetrokken als hij ooit uitlekt.

Het INSZ buiten de voorziene velden verwerken. Het gebruik van het INSZ is beperkt door artikel 13 van de wet van 8 augustus 1983: het wordt enkel in het voorziene veld niss doorgegeven en de API geeft het niet terug.

Een dossier behandelen zonder mandaat. Een kantoor dat voor zijn klant aangeeft, heeft een mandaat nodig (RSZ-administratieve instructies over de mandatarissen): de klant ondertekent het in Mahis, en de sleutel dekt enkel de dossiers waartoe uw kantoor toegang heeft.

Wat de sleutel niet doet

De sleutel vervangt het mandaat van de klant niet en omzeilt geen enkele weigering: een loon onder het minimum van het paritair comité, een onbekend baremavak of een onverenigbaar statuut blijft geweigerd, met de reden in het antwoord. Dezelfde controles als op het scherm gelden dus ook voor een assistent.

Voor een juridische vraag geeft de sleutel geen antwoord: de gids voor taalmodellen en de OpenAPI beschrijven de velden en de codes, de regels zelf staan op de pagina van het comité.

Veelgestelde vragen

Moet ik een sociaal secretariaat zijn om de API te gebruiken?

Nee. De API is bedoeld voor een boekhoudkantoor of fiduciaire dat zelf de lonen van zijn klanten opmaakt. Het wordt daardoor geen sociaal secretariaat: mijnloonbrief.be blijft een niet-erkende aanbieder van sociale diensten, en kantoor en klant blijven verantwoordelijk voor hun aangiften.

Dekt één API-sleutel alle dossiers van het kantoor?

Ja. Een sleutel van uw kantoor dekt al uw dossiers, en u duidt het beoogde dossier aan in de header X-Societe. De sleutel vervalt niet, wordt met één klik ingetrokken en valt vanzelf weg als u de toegang tot een dossier verliest. Hij reist enkel in de header Authorization, nooit in een URL.

Hoe vermijd ik een dubbele loonbrief als een aanvraag herhaald wordt?

Elke schrijfopdracht vraagt een Idempotency-Key: een herhaalde aanvraag maakt nooit een tweede loonbrief. Met dry_run=true berekent en controleert de server zonder iets op te slaan, zodat u een invoer kunt testen voor u ze valideert. Elke oproep staat in uw logboek.

Kan een AI-assistent de loonbrieven alleen valideren?

Hij kan de maand coderen en het voorbeeld opvragen, maar hij toont u elke weigering en elke waarschuwing voor hij valideert. De validatie wordt gefactureerd zoals op het scherm en blijft onder de verantwoordelijkheid van het kantoor: lees de waarschuwingen van het voorbeeld, of laat ze nalezen, voor u de assistent laat valideren.

Documentatie voor ontwikkelaars en AI

Aanmelden om een sleutel te maken Mijn kantoor inschrijven