Intégrateur Lucca
Intégration de l'API Lucca dans votre système
Nous connectons Lucca à vos applications métier : congés, temps, notes de frais et référentiel collaborateurs. Les absences arrivent tout de suite dans le planning, pas au prochain export nocturne.
- Équipe produit senior
- connecteurs SIRH en production
- du cadrage au monitoring
Pourquoi faire appel à un intégrateur Lucca et que peut-on connecter à Lucca ?
Lucca est un SIRH modulaire utilisé par des entreprises de toutes tailles pour gérer congés, temps, notes de frais, paie et formation. Un intégrateur Lucca relie Lucca à votre planning de production, votre logiciel comptable, votre annuaire d'accès ou votre entrepôt de données. Le travail consiste à synchroniser les absences pour le planning, exporter les variables de paie vers le logiciel comptable, ou alimenter un dashboard RH avec les données consolidées. L'API Lucca couvre l'ensemble des modules, avec une attention particulière à la gestion des droits par dossier et aux quotas partagés.
Ce que débloque une intégration Lucca
Planning réajusté à chaque congé validé
Dès qu'un congé est validé, le planning de production ou de chantier libère l'affectation. Vous cessez de découvrir une absence le matin même.
Arrivées et départs automatisés
Le référentiel collaborateurs de Lucca déclenche la création puis la révocation des comptes applicatifs, avec un journal auditable des accès ouverts.
Rentabilité par projet
Les temps saisis dans Timmi et les notes de frais Cleemy croisent le chiffre d'affaires du CRM. La marge par projet devient consultable en continu.
Validation depuis l'outil du manager
Les demandes de congé s'approuvent ou se refusent depuis votre application, sans imposer une connexion supplémentaire à vos managers.
Ce qu'une intégration Lucca change pour votre business
La technique au service d'un résultat mesurable : moins de ressaisie RH, des plannings justes, des accès maîtrisés.
Une seule saisie, partout
La donnée RH est saisie une fois dans Lucca et se propage. Le temps de recopie disparaît, et avec lui les écarts entre vos outils.
Des plannings qui reflètent la réalité
Les absences validées arrivent immédiatement dans l'outil de planification. Vous arrêtez d'affecter quelqu'un qui n'est pas là.
Des accès qui se ferment vraiment
Un départ déclaré dans Lucca révoque les comptes applicatifs. Le risque des comptes fantômes sort de votre surface d'exposition.
Un connecteur qui vous appartient
Code livré, documenté et maintenable. Vous n'êtes captif ni d'une boîte noire ni d'un abonnement à un connecteur générique.
Comment nous connectons Lucca à votre système
Cadrage
Quels modules Lucca, quelle génération d'API par ressource, quel périmètre d'établissements sur la clé d'intégration. On tranche le sens des flux avant de coder.
Architecture
Webhooks pour l'événementiel, lectures incrémentales filtrées pour le rattrapage, limiteur de débit centralisé. Le quota de 50 requêtes par minute est une contrainte de conception, pas un détail.
Développement et recette
Couche d'accès unique qui masque v3, v4 et v5, traitement idempotent des webhooks, file de reprise. Rejeu sur un jeu de données pseudonymisé.
Monitoring
Alertes sur échec de livraison, compteur de consommation du quota, tableau de bord de santé. Vous savez qu'un flux est cassé avant vos équipes RH.
Ce que permet Lucca
- Congés et compteurs
- Lecture des congés et des compteurs, création et mise à jour, plus les demandes et leurs décisions d'approbation ou de refus.
- Référentiel collaborateurs
- Utilisateurs, contrats de travail, départements, entités juridiques et établissements. La source unique des arrivées et des départs.
- Temps, projets et notes de frais
- Les modules Timmi et Cleemy exposent les temps saisis, les affectations projet, la présence et les notes de frais avec leur axe analytique.
- Webhooks événementiels
- Notification sur création de collaborateur, création de contrat, ouverture de poste ou mise à jour de congé, avec livraison au moins une fois.
Le vocabulaire d'une intégration Lucca
- Tenant
- Votre instance Lucca, identifiée par son domaine. Toutes les URL d'appel en dépendent, et le quota de débit s'applique à ce domaine et non à votre application.
- Clé d'intégration
- Déclaration qui porte le contact technique, les scopes OAuth et la liste des établissements accessibles. Un établissement créé plus tard n'entre pas automatiquement dans le périmètre.
- Api-Version
- En-tête qui épingle la version datée de la nouvelle API. Sans lui, une évolution côté Lucca peut changer une réponse sous vos pieds.
- Legacy v3 et v4
- Les deux générations antérieures, toujours en service. Elles se reconnaissent à l'URL et n'ont ni la même pagination ni la même façon de sélectionner les champs.
- Business establishment
- L'établissement au sens de la v5, qui remplace les anciennes notions d'entité juridique et d'établissement. Un connecteur écrit sur les anciennes notions devra être repris.
- Livraison au moins une fois
- Un même webhook peut arriver deux fois et dans le désordre. Le traitement doit être idempotent et réordonné par la date d'occurrence de l'événement.
Les contraintes réelles d'une intégration Lucca
50 requêtes par minute, partagées par tout le domaine
Le plafond s'applique au tenant, pas à votre application : les intégrations d'autres prestataires le consomment aussi. Au delà, l'API répond 429. Cela disqualifie tout balayage complet du référentiel.
Cinq secondes d'exécution côté serveur
Une requête plus longue est interrompue et renvoie 408. Une requête trop large n'est donc pas seulement lente, elle échoue : il faut filtrer et paginer dès la conception.
La nouvelle API ne couvre pas encore tout
Organisation et congés sont en v5, mais temps, notes de frais, formation et rémunération restent en Legacy v3 et v4, dont la documentation reconnaît des incohérences entre endpoints. Il faut budgéter des migrations successives.
Le bac à sable est une option payante
Il existe un seul environnement de test par compte, son rafraîchissement passe par le support, et les applications autorisées n'y sont pas dupliquées : les clés doivent être redéclarées.
Lucca ou Silae, et ce que ça implique
Les deux vivent dans la même chaîne RH mais ne jouent pas le même rôle. Le choix n'est presque jamais technique : il dépend de qui détient la donnée et de qui produit la paie.
| Critère | LuccaCette page | SilaeMoteur de paie |
|---|---|---|
| Rôle dans la chaîne | SIRH : congés, temps, notes de frais, référentiel | Production de la paie et déclarations |
| Ouverture de l'accès | Clé d'intégration créée dans votre instance | Contrat signé et formulaire d'ouverture, via un partenaire |
| Authentification | OAuth 2.0, jeton valable 30 minutes | OAuth 2.0, jeton valable 60 minutes, plus une clé d'abonnement |
| Forme de l'API | Ressources REST, deux générations en cohabitation | Catalogue de fonctions nommées, plusieurs versions par fonction |
| Limite documentée | 50 requêtes par minute par domaine | 60 jetons par minute sur l'authentification |
| Temps réel | Webhooks événementiels | Motif asynchrone avec suivi d'état |
| Le bon cas | Brancher un planning, un annuaire ou un suivi de projet sur la donnée RH | Automatiser la collecte des variables et l'écriture comptable de paie |
Nous ne revendiquons ni certification ni statut de partenaire Lucca : nous développons sur l'API publique documentée, comme équipe de développement sur votre intégration. Les deux outils se combinent souvent plutôt qu'ils ne s'opposent.
Ce que nous mesurons sur un projet Lucca
Les autres outils de paie et de SIRH
Le choix se fait sur l'outil déjà en place chez vous, et sur qui produit la paie.
LuccaIntégration de l'API Lucca dans votre systèmeCette page
SilaeLe moteur de paie derrière beaucoup de cabinets, à l'accès contractuel encadré.
PayFitPaie et RH dans un seul outil, courant chez les PME qui internalisent.On combine Lucca avec
La stack qui entoure Lucca sur nos projets.
Intégration Lucca : vos questions
Trois étapes. D'abord créer une clé d'intégration dans votre instance Lucca, avec le contact technique, les scopes OAuth utiles et la liste des établissements à couvrir. Ensuite obtenir un jeton en client credentials et le mettre en cache pour ses 30 minutes de validité, en épinglant la version de l'API dans les en-têtes. Enfin déclarer vos endpoints webhook et bâtir la synchronisation en événementiel, avec une lecture incrémentale filtrée pour le rattrapage. La difficulté réelle n'est pas l'appel technique, c'est de tenir dans 50 requêtes par minute tout en couvrant des ressources réparties sur trois générations d'API.
Cela dépend des modules concernés, du sens des flux et de la génération d'API à utiliser. Remonter les congés validés vers un planning se chiffre bien plus bas qu'une chaîne complète mêlant temps Timmi, notes de frais Cleemy et référentiel collaborateurs, chacun sur une convention différente. Le coût de l'environnement de test entre aussi dans l'équation, puisque le bac à sable Lucca est une option payante. Nous cadrons le périmètre en amont et donnons une estimation ferme avant de commencer.
La certification est un label commercial d'éditeur, utile sur le déploiement du SIRH lui-même. Pour connecter Lucca à une application sur mesure, ce qui compte est l'expérience des connecteurs sous contrainte de quota et la rigueur sur le traitement des webhooks. Nous ne revendiquons pas de statut de partenaire Lucca : nous développons sur l'API publique documentée et nous intervenons comme équipe de développement sur l'intégration, aux côtés de vos équipes RH.
Oui, et c'est une demande fréquente. Le principe est de faire de Lucca la source des éléments collectés (absences, temps, éléments variables) et du logiciel de paie le moteur qui les consomme. Il faut alors traiter deux mondes différents : côté Lucca des ressources REST sous quota serré, côté paie un accès souvent contractuel avec ses propres délais d'ouverture. Nous construisons le connecteur avec une clé de déduplication persistée hors des deux outils, pour qu'un rejeu ne pousse jamais deux fois le même élément sur la même période.
Deux limites documentées structurent toute l'architecture. Le débit est plafonné à 50 requêtes par minute par domaine, et ce plafond est partagé avec les autres intégrations de votre instance, y compris celles d'autres prestataires. Le temps d'exécution côté serveur est limité à cinq secondes, ce qui fait échouer une requête trop large au lieu de la ralentir. S'y ajoutent les contraintes de webhooks : trois secondes pour accuser réception, cinq tentatives de livraison réparties sur environ 24 heures, livraison au moins une fois et sans garantie d'ordre. On conçoit donc en événementiel avec réconciliation, jamais en balayage complet.
Un projet d'intégration Lucca ?
Parlons-en. 30 minutes pour identifier vos modules Lucca, vérifier ce que la génération d'API couvre et vous dire franchement ce qui est faisable.
Parler de mon projet Lucca