Intégration paie / SIRH

L'API publique KONFORMITI sert un usage précis : synchroniser le registre des employés depuis le système de paie ou le SIRH de l'opérateur (ADP, SAGE, Odoo, ou un système maison), et exposer un instantané de conformité consommable par d'autres outils internes.

Concrètement, deux familles d'endpoints. L'import d'employés (POST /employees/import) reçoit une liste d'employés avec leur catégorie Art. 14 (cadre, maîtrise, qualifié, non qualifié). L'import est idempotent : un employé déjà connu (identifié par son NNI haché) n'est pas dupliqué. Le snapshot de conformité (GET /compliance/snapshot) retourne les quotas courants, le statut du certificat de conformité et les sanctions actives du tenant. Deux endpoints complémentaires exposent en lecture les registres légaux publics (Arts. 7 et 10).

Chaque appel est authentifié par une clé API (Authorization: Bearer <clé>), gérée depuis le backoffice KONFORMITI et porteuse de scopes précis (employees:read, employees:write, compliance:read, registry:read) : une clé ne peut appeler que ce pour quoi elle a été créée, avec un rate limit configurable par clé.

La spécification complète, endpoint par endpoint, fait foi dans l'OpenAPI généré par la plateforme : explorer l'API (Swagger) ou télécharger la spec OpenAPI.