Connecter Kroneo à votre SI : API, webhooks et paie

API de lecture du planning, des absences et des heures, webhooks signés HMAC-SHA256, connecteurs paie PayFit et Silae. Périmètre et limites.

Publié le 8 juillet 2026

Un logiciel de planning qui ne parle à rien d'autre finit en double saisie. Les heures se retapent dans la paie, les absences se recopient dans le SIRH, et l'erreur s'installe quelque part entre les deux.

Kroneo expose trois mécanismes d'interopérabilité. Ils répondent à trois besoins distincts, qu'il vaut mieux ne pas confondre.

Lire : l'API V1

Trois ressources en lecture, exposées par le service kroneo-api :

L'authentification se fait par jeton d'identité signé (RS256, clés publiques publiées via JWKS). Le locataire — l'entreprise à laquelle les données appartiennent — est résolu depuis le jeton lui-même, jamais depuis un paramètre de requête. Un appelant ne peut donc pas lire les données d'une autre entreprise en changeant un identifiant dans l'URL.

C'est une API de lecture. Elle ne crée ni ne modifie de planning.

Être notifié : les webhooks

Interroger une API en boucle pour savoir si quelque chose a changé est un gaspillage. Les webhooks inversent le sens : Kroneo appelle votre système quand un événement survient.

Chaque requête sortante est signée en HMAC-SHA256. Votre point de réception recalcule la signature avec le secret partagé et rejette tout ce qui ne correspond pas. Sans cette vérification, n'importe qui connaissant votre URL pourrait vous injecter de faux événements — la signature n'est pas une option de confort.

L'émission est best-effort : un webhook qui échoue ne fait pas échouer l'écriture métier qui l'a déclenché. Votre planning est enregistré même si votre serveur de réception est tombé. La contrepartie est qu'un événement peut être perdu, et qu'un système critique ne doit pas dépendre du seul webhook pour sa cohérence — l'API de lecture sert alors de filet.

Exporter : les connecteurs paie

POST /v1/paie/sync exporte les heures et les absences vers PayFit ou Silae. C'est le trajet qui portait historiquement la double saisie, et celui dont la suppression se mesure directement en heures de travail administratif.

Une réserve, à deux niveaux

L'interopérabilité est réservée au plan Premium. Ce gating est appliqué deux fois, volontairement.

D'abord côté interface : l'onglet « Intégrations » n'apparaît pas si le plan ne le permet pas. Ensuite côté serveur : chaque route /v1/* relit le plan de l'entreprise dans la base et renvoie 403 si ce n'est pas Premium.

Le second contrôle rend le premier redondant, et c'est le but. Une vérification côté navigateur ne protège rien : elle masque un bouton. Seul le contrôle serveur fait autorité, et il ne fait pas confiance à ce que le client prétend être.

FAQ

Kroneo propose-t-il une API ?

Oui, sur le plan Premium. L'API V1 expose en lecture le planning, les absences et les heures, avec une authentification par jeton d'identité signé en RS256. Elle ne permet pas d'écrire dans le planning.

Comment sécuriser les webhooks émis par Kroneo ?

Chaque webhook est signé en HMAC-SHA256 avec un secret partagé. Le système récepteur doit recalculer la signature à partir du corps de la requête et la comparer à celle transmise, puis rejeter toute requête dont la signature ne correspond pas.

Kroneo s'intègre-t-il avec PayFit et Silae ?

Oui. Le point d'entrée de synchronisation paie exporte les heures et les absences vers PayFit ou Silae, sur le plan Premium.

Que se passe-t-il si mon serveur de webhooks est indisponible ?

L'émission est best-effort : l'échec d'un webhook n'annule pas l'écriture métier correspondante dans Kroneo. L'événement peut être perdu. Pour garantir la cohérence, un système tiers doit pouvoir se resynchroniser via l'API de lecture.

Pour aller plus loin

La présentation produit décrit l'ensemble des modules. Les critères de choix d'un outil de planning consacrent une section aux exports et à l'interopérabilité, sans comparatif nominatif.