API RH : comment intégrer LapsoWork à votre ERP, votre logiciel de paie ou votre BI

Un logiciel RH qui vit isolé oblige à saisir deux fois : les heures déjà dans le pointage sont ressaisies dans le programme de paie, les embauches déjà dans l’ERP sont recréées dans la plateforme du personnel, et le rapport de direction se monte chaque mois à la main avec des données de trois endroits. Une API RH existe pour éviter cela : que les systèmes se lisent entre eux sans intervention humaine. Dans ce guide, nous expliquons quelles données expose l’API REST de LapsoWork, quelles intégrations ont du sens dans une PME, comment les concevoir pour qu’elles ne cassent pas et quand, sincèrement, un export Excel suffit.

Ce qu’expose l’API de LapsoWork

L’API REST de LapsoWork est documentée publiquement et s’autorise par un jeton d’accès qui identifie votre compte. Les principales ressources sont :

• Salariés : nombre d’utilisateurs actifs sur une plage de dates, liste complète des salariés actifs entre deux dates et recherche par nom.
• Pointages : enregistrements de pointage sur la plage de dates indiquée.
• Heures : somme des heures quotidiennes, hebdomadaires et mensuelles d’un salarié.
• Absences : absences enregistrées sur une plage de dates.
• Congés : jours restants par salarié.
• Sites de travail : liste et recherche par nom.
• Clients : liste et recherche par nom, pour les entreprises qui imputent des heures aux clients.
• Documents : nombre de fichiers téléversés et types de documents configurés.

Autrement dit, tout ce qu’un autre système a besoin de lire des RH : qui est actif, combien il a travaillé, quand il a été absent et ce qu’il lui reste de congés. La documentation de chaque point d’accès, avec ses paramètres de dates et ses réponses, se trouve sur la page développeurs.

Les quatre intégrations qui valent la peine dans une PME

1. Paie : des heures au bulletin sans saisie

C’est l’intégration au meilleur retour. À chaque clôture mensuelle, un processus interroge les heures mensuelles de chaque salarié et ses absences, les convertit en variables attendues par votre programme de paie ou votre cabinet (heures supplémentaires, compléments, retenues pour absence) et les livre dans le format que ce programme importe. LapsoWork ne calcule pas la paie, comme nous l’expliquons dans externaliser la paie ou logiciel interne ; ce que fait l’API, c’est que les variables arrivent propres à celui qui la calcule. Ensuite, le bulletin calculé revient dans LapsoWork pour être distribué et signé.

2. ERP : une seule liste de salariés et de sites

Si l’ERP est le référentiel des salariés et des sites, l’intégration maintient synchronisés les entrées, sorties et changements de site, de sorte que personne ne crée deux fois la même personne. Si le référentiel est LapsoWork, l’ERP lit dans l’API la liste des salariés actifs et des sites. L’important est de décider lequel des deux fait autorité sur chaque donnée et de ne pas laisser les deux écrire la même chose.

3. BI et tableaux de bord

Un tableau de bord de direction qui lit chaque matin les heures travaillées, les heures supplémentaires, les absences par type et les congés en attente par site et par équipe, sans que personne n’exporte rien. Avec ces données se calculent les indicateurs de ressources humaines et l’absentéisme qui, autrement, se calculent à la main puis sont abandonnés.

4. Contrôle d’accès et systèmes internes

Entreprises avec des tourniquets, des serrures ou des applications internes qui doivent savoir si une personne est active ou combien d’heures elle a faites dans la semaine. L’API répond à ces requêtes en temps réel.

Comment concevoir une intégration qui ne casse pas

1. Décidez du système référent pour chaque donnée. Salariés, sites, calendriers, heures : chacun a un propriétaire. Les autres ne font que lire.
2. Travaillez par plages de dates et de façon incrémentale. Les points d’accès des pointages, heures et absences acceptent une date de début et de fin ; interrogez seulement ce qui a changé depuis la dernière exécution, pas tout l’historique à chaque fois.
3. Gardez le jeton comme un secret. Dans un gestionnaire de secrets ou des variables d’environnement du serveur, jamais dans le code ni dans un tableur partagé. Renouvelez-le si le responsable change.
4. Journalisez chaque exécution. Ce qui a été interrogé, combien d’enregistrements, quelles erreurs. Quand une paie sort mal, ce journal dira si la donnée est arrivée.
5. Traitez les erreurs sans inventer de données. Si l’API ne répond pas, l’intégration s’arrête et alerte ; elle ne remplit pas les heures à zéro.
6. Respectez les limites d’usage et interrogez aux heures creuses pour les traitements massifs.
7. Documentez la correspondance. Quel champ de LapsoWork alimente quel champ de l’autre système et avec quelle transformation. C’est ce qui permettra de la maintenir quand la personne qui l’a faite changera.
8. Respectez le RGPD. L’intégration est un traitement de données personnelles : minimisez les champs transférés, limitez l’accès et inscrivez le flux dans le registre des activités de traitement.

Quand un export suffit

Toutes les PME n’ont pas besoin d’une intégration programmée. Si vous clôturez la paie une fois par mois, avez un seul site et que votre cabinet accepte un fichier Excel, l’export des rapports d’heures et d’absences inclus dans LapsoWork règle le problème en deux minutes par mois. L’API vaut la peine lorsque plusieurs systèmes ont besoin de la même donnée, lorsque le processus est hebdomadaire ou quotidien, ou lorsque le volume fait d’exporter et coller une source d’erreurs. Un bon critère : si quelqu’un consacre plus d’une heure par mois à déplacer des données RH entre systèmes, l’intégration se paie toute seule, comme nous le calculons dans comment calculer le ROI d’un logiciel RH.

Qui peut la réaliser

Pas besoin d’une équipe de développement. Un développeur expérimenté en API REST, interne ou externe, monte en quelques jours une intégration de paie ou de BI avec la documentation publique. Beaucoup de cabinets et de fournisseurs d’ERP ont déjà des connecteurs ou de l’expérience sur ce type d’intégrations. Et si votre entreprise compte plus de quarante salariés et des besoins spécifiques, l’offre Personnalisée de LapsoWork inclut des développements sur mesure, comme vous pouvez le voir sur notre page de tarifs.

Questions fréquentes

Quelles données puis-je obtenir de l’API de LapsoWork ?

Les salariés actifs et leur recherche par nom, les pointages et les heures quotidiennes, hebdomadaires et mensuelles par salarié, les absences sur une plage de dates, les jours de congés restants, les sites de travail, les clients et des données sur les documents téléversés. La documentation de chaque point d’accès et de ses paramètres se trouve sur la page développeurs.

Comment l’API s’authentifie-t-elle ?

Par un jeton d’accès associé à votre compte, envoyé avec chaque requête. Il doit être conservé comme un secret sur le serveur qui exécute l’intégration, jamais dans le code ni dans des documents partagés, et renouvelé si la personne responsable change.

Peut-on intégrer LapsoWork au programme de paie ?

Oui. L’intégration habituelle interroge à chaque clôture les heures mensuelles et les absences de chaque salarié et les livre dans le format qu’importe le programme de paie ou le cabinet. LapsoWork ne calcule pas la paie ; il distribue les bulletins calculés par votre cabinet ou votre programme, et l’API fait que les variables arrivent sans saisie.

Ai-je besoin d’un développeur pour utiliser l’API ?

Pour une intégration programmée, oui : un développeur expérimenté en API REST, interne ou externe, la monte en quelques jours avec la documentation publique. Pour des besoins ponctuels, l’export des rapports d’heures et d’absences vers Excel ne nécessite aucun développement.

L’intégration respecte-t-elle le RGPD ?

Elle doit le respecter : c’est un traitement de données personnelles des salariés. Ne transférez que les champs nécessaires, limitez qui accède au jeton et aux données, journalisez les exécutions et inscrivez le flux dans le registre des activités de traitement de l’entreprise.

Conclusion

Une API RH sert à ce que les heures, les absences et les salariés actifs arrivent à la paie, à l’ERP ou au tableau de bord sans que personne les saisisse. Celle de LapsoWork expose exactement ces données avec une authentification par jeton et une documentation publique, et les intégrations qui valent la peine dans une PME sont peu nombreuses et claires : paie, ERP, BI et contrôle d’accès. Si vous déplacez des données RH à la main plus d’une heure par mois, essayez LapsoWork gratuitement pendant 30 jours et parcourez la documentation de l’API avec votre développeur.