# Guide de l'API fiche2paie pour les assistants IA

Ce dossier est écrit pour un modèle de langage. Lisez-le en entier avant la première écriture. Il suffit, seul, pour encoder la paie d'un dossier sans erreur.

- Version de l'API : 1.0.0
- OpenAPI 3.1 : https://fiche2paie.be/api/v1/openapi.json
- Serveur MCP (HTTP streamable) : https://fiche2paie.be/mcp
- Ce guide, en archive : https://fiche2paie.be/api/v1/guide.zip
- Commissions paritaires connues du moteur : 177
- Statuts de travailleur : `employe`, `ouvrier`, `flexi`, `etudiant`

## Les cinq règles

1. Toute écriture d'abord avec `dry_run=true`, puis la même avec une `Idempotency-Key` unique.
2. Ne jamais deviner une valeur légale (commission paritaire, case de barème, catégorie, chiffre d'index) : demander au comptable.
3. Un refus `REFUS_REGLE` ne se contourne pas : on le transmet au comptable.
4. Lire tous les avertissements de l'aperçu avant de valider une fiche.
5. Le NISS ne s'écrit que dans le champ `niss` d'un travailleur (création ou modification) : il y est enregistré chiffré et n'est jamais rendu. Jamais ailleurs, jamais dans un journal ou une note.

## Fichiers

- [01-DEMARRAGE.md](01-DEMARRAGE.md) : Clé, dossier, idempotence, dry_run, connexion MCP.
- [02-ORDRE-DU-MOIS.md](02-ORDRE-DU-MOIS.md) : L'ordre exact du travail d'un mois, avec exemples.
- [03-TRAVAILLEURS.md](03-TRAVAILLEURS.md) : Chaque champ d'un travailleur, et ce qu'exige chaque statut.
- [04-PRESTATIONS.md](04-PRESTATIONS.md) : Chaque champ des prestations du mois.
- [05-REFUS-ET-ERREURS.md](05-REFUS-ET-ERREURS.md) : Les codes d'erreur et comment réagir à chaque refus.
- [06-INTERDITS.md](06-INTERDITS.md) : Ce qui ne se fait jamais.
- [07-FACTURATION.md](07-FACTURATION.md) : Ce qui est facturé, et à qui.
- [08-ROUTES-ET-OUTILS.md](08-ROUTES-ET-OUTILS.md) : Toutes les routes REST et tous les outils MCP.
- [09-LIMITES-ET-FAQ.md](09-LIMITES-ET-FAQ.md) : Limites de débit, idempotence, questions d'intégration.
