# Gids van de fiche2paie-API voor AI-assistenten

Deze map is geschreven voor een taalmodel. Lees ze volledig voor de eerste schrijfopdracht. Ze volstaat, alleen, om de loon van een dossier foutloos te coderen.

- API-versie : 1.0.0
- OpenAPI 3.1 : https://fiche2paie.be/api/v1/openapi.json
- MCP-server (streamable HTTP) : https://fiche2paie.be/mcp
- Deze gids, als archief : https://fiche2paie.be/api/v1/guide.zip
- Paritaire comités gekend door de motor : 177
- Statuten van werknemers : `employe`, `ouvrier`, `flexi`, `etudiant`

## De vijf regels

1. Elke schrijfopdracht eerst met `dry_run=true`, daarna dezelfde met een unieke `Idempotency-Key`.
2. Nooit een wettelijke waarde raden (paritair comité, baremavak, categorie, indexcijfer): vraag het aan de boekhouder.
3. Een weigering `REFUS_REGLE` wordt niet omzeild: je geeft ze door aan de boekhouder.
4. Lees alle waarschuwingen van het voorbeeld voor je een afrekening valideert.
5. Het INSZ komt enkel in het veld `niss` van een werknemer (aanmaak of wijziging): het wordt er versleuteld bewaard en nooit teruggegeven. Nergens anders, nooit in een log of notitie.

## Bestanden

- [01-DEMARRAGE.md](01-DEMARRAGE.md) : Sleutel, dossier, idempotentie, dry_run, MCP-verbinding.
- [02-ORDRE-DU-MOIS.md](02-ORDRE-DU-MOIS.md) : De exacte volgorde van het werk van een maand, met voorbeelden.
- [03-TRAVAILLEURS.md](03-TRAVAILLEURS.md) : Elk veld van een werknemer, en wat elk statuut vereist.
- [04-PRESTATIONS.md](04-PRESTATIONS.md) : Elk veld van de prestaties van de maand.
- [05-REFUS-ET-ERREURS.md](05-REFUS-ET-ERREURS.md) : De foutcodes en hoe op elke weigering te reageren.
- [06-INTERDITS.md](06-INTERDITS.md) : Wat nooit mag.
- [07-FACTURATION.md](07-FACTURATION.md) : Wat gefactureerd wordt, en aan wie.
- [08-ROUTES-ET-OUTILS.md](08-ROUTES-ET-OUTILS.md) : Alle REST-routes en alle MCP-tools.
- [09-LIMITES-ET-FAQ.md](09-LIMITES-ET-FAQ.md) : Debietlimieten, idempotentie, integratievragen.
