API et assistant IA pour les comptables
Laissez un assistant IA encoder la paie de vos dossiers : clé d'API, serveur MCP, OpenAPI et un guide écrit pour les modèles.
Page revue le 10 octobre 2026
Un cabinet comptable peut-il établir lui-même les fiches de ses clients et les saisir par API ?
Oui. Un cabinet comptable peut établir lui-même les fiches de paie de ses clients sans devenir secrétariat social : la plateforme calcule chaque fiche au barème officiel, le cabinet la valide. Avec fiche2paie.be, le cabinet inscrit chaque société cliente depuis un seul compte, le client ne fait que signer ses deux mandats (ONSS dans Mahis, Finprof au SPF Finances), et le cabinet reçoit une seule facture mensuelle, détaillée dossier par dossier. Une clé d'API de cabinet crée les travailleurs, encode les prestations du mois, calcule l'aperçu et valide la fiche ; un serveur MCP permet à un assistant IA de faire de même, avec un guide écrit pour les modèles. Chaque écriture exige une clé d'idempotence, et le mode dry_run calcule sans rien enregistrer. Les fiches portent le logo du cabinet. fiche2paie.be reste un prestataire de services sociaux non agréé : le cabinet et son client restent responsables de leurs déclarations.
Ce que fait l'API
Une clé de votre cabinet couvre tous vos dossiers. Elle crée les travailleurs, dépose les prestations du mois, calcule l'aperçu, valide la fiche de paie, puis rend le PDF et les déclarations dues. Elle sert pour chaque salarié du dossier : le statut, employé ou ouvrier, se donne à la création du travailleur.
Les mêmes contrôles qu'à l'écran : minima sectoriels, cases de barème, facturation. Un refus n'est jamais contourné en silence.
La sécurité, sans effort
La clé n'expire pas et ne demande aucune reconnexion. Vous la révoquez d'un clic ; elle tombe d'elle-même si vous perdez l'accès à un dossier.
Chaque écriture exige une Idempotency-Key : une requête rejouée ne crée jamais une seconde fiche. dry_run=true calcule sans rien écrire. Chaque appel figure dans votre journal.
La clé ne voyage que dans l'en-tête Authorization, jamais dans une URL.
Un premier appel
Remplacez fdp_… par votre clé et le numéro de TVA par celui du 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
Connecter votre assistant IA
1. Dans Réglages > Accès API, créez une clé de portée écriture.
2. Dans votre assistant (Claude, ChatGPT ou un autre client MCP), ajoutez un serveur MCP à l'adresse https://fiche2paie.be/mcp.
3. Choisissez le transport HTTP streamable et ajoutez l'en-tête Authorization: Bearer fdp_….
4. Demandez-lui de lire d'abord le guide (ressource fiche2paie://guide/fr/LISEZ-MOI.md) ou d'utiliser le prompt encoder_le_mois.
5. Laissez-le encoder le mois : il vous montre chaque refus et chaque avertissement avant de valider.
Exemple pas à pas : encoder le mois d'un travailleur
1. GET /api/v1/dossiers : repérez le dossier et passez son identifiant ou son numéro de TVA dans l'en-tête X-Societe.
2. POST /api/v1/travailleurs avec dry_run=true : le serveur refuse un salaire sous le minimum de la commission paritaire, une case de barème inconnue ou un statut incompatible. Rejouez sans dry_run quand la réponse est propre.
3. PUT /api/v1/prestations : déposez les heures, jours, absences et primes du mois. Un nouveau dépôt pour le même mois remplace le précédent.
4. POST /api/v1/fiches/apercu : brut, net, coût, lignes et avertissements, sans rien écrire. Lisez chaque avertissement.
5. POST /api/v1/fiches : valide la fiche, qui est alors facturée comme à l'écran.
6. GET /api/v1/fiches/{id}/pdf : télécharge le PDF.
Cinq erreurs fréquentes à la connexion
Valider sans lire les avertissements de l'aperçu. Le décompte doit être exact et porter les mentions que fixe la loi du 12 avril 1965 sur la protection de la rémunération : l'aperçu ne coûte rien, la validation oui.
Laisser un assistant IA valider sans relecture. Le déclarant reste responsable de ses déclarations (loi du 27 juin 1969) : lisez les refus et les avertissements que l'assistant vous montre avant de le laisser continuer.
Mettre la clé dans une URL ou dans un dépôt de code. La sécurité du traitement est une obligation de l'article 32 du RGPD : la clé ne voyage que dans l'en-tête Authorization, et se révoque d'un clic si elle fuit.
Traiter le NISS hors du champ prévu. L'usage du NISS est encadré par l'article 13 de la loi du 8 août 1983 : il se donne uniquement dans le champ niss prévu, et l'API ne le rend pas.
Traiter un dossier sans mandat. Un cabinet qui déclare pour son client a besoin d'un mandat (instructions administratives de l'ONSS sur les mandataires) : le client le signe dans Mahis, et la clé ne couvre que les dossiers auxquels votre cabinet a accès.
Ce que la clé ne fait pas
La clé ne remplace pas le mandat du client et ne contourne aucun refus : un salaire sous le minimum de la commission paritaire, une case de barème inconnue ou un statut incompatible reste refusé, avec le motif dans la réponse. Les mêmes contrôles qu'à l'écran valent donc aussi pour un assistant.
Pour une question de droit, la clé ne répond pas : le guide pour les modèles de langage et l'OpenAPI décrivent les champs et les codes, et les règles elles-mêmes sont sur la page de la commission.
Questions fréquentes
Faut-il être secrétariat social pour utiliser l'API ?
Non. L'API s'adresse à un cabinet comptable ou à une fiduciaire qui établit lui-même la paie de ses clients. Il ne devient pas secrétariat social pour autant : fiche2paie.be reste un prestataire de services sociaux non agréé, et le cabinet comme son client restent responsables de leurs déclarations.
Une clé d'API couvre-t-elle tous les dossiers du cabinet ?
Oui. Une clé de votre cabinet couvre tous vos dossiers, et vous désignez le dossier visé dans l'en-tête X-Societe. La clé n'expire pas, se révoque d'un clic et tombe d'elle-même si vous perdez l'accès à un dossier. Elle ne voyage que dans l'en-tête Authorization, jamais dans une URL.
Comment éviter une fiche en double si une requête est rejouée ?
Chaque écriture exige une Idempotency-Key : une requête rejouée ne crée jamais une seconde fiche. Avec dry_run=true, le serveur calcule et contrôle sans rien enregistrer, ce qui permet de tester une saisie avant de la valider. Chaque appel figure dans votre journal.
Un assistant IA peut-il valider les fiches tout seul ?
Il peut encoder le mois et demander l'aperçu, mais il vous montre chaque refus et chaque avertissement avant de valider. La validation est facturée comme à l'écran et reste sous la responsabilité du cabinet : lisez les avertissements de l'aperçu, ou faites-les relire, avant de laisser l'assistant valider.
Documentation pour développeurs et IA
- Guide pour les modèles de langage (Markdown)
- Le guide en archive (zip)
- OpenAPI 3.1
- MCP :
https://fiche2paie.be/mcp