API de recursos humans: com integrar LapsoWork amb el teu ERP, el teu programa de nòmines o el teu BI

Un programari de recursos humans que viu aïllat obliga a teclejar dues vegades: les hores que ja són al control horari es tornen a introduir al programa de nòmines, les altes que ja són a l’ERP es tornen a donar a la plataforma de personal, i l’informe de gerència es munta cada mes a mà amb dades de tres llocs. Una API de recursos humans existeix per evitar això: que els sistemes es llegeixin entre si sense intervenció humana. En aquesta guia expliquem quines dades exposa l’API REST de LapsoWork, quines integracions tenen sentit en una pime, com dissenyar-les perquè no es trenquin i quan, sincerament, n’hi ha prou amb una exportació a Excel.

Què exposa l’API de LapsoWork

L’API REST de LapsoWork està documentada públicament i s’autoritza mitjançant un token d’accés que identifica el teu compte. Els recursos principals són:

• Empleats: nombre d’usuaris actius en un interval de dates, llista completa d’empleats actius entre dues dates i cerca per nom.
• Fitxatges: registres de fitxatge en l’interval de dates indicat.
• Hores: sumatori d’hores diàries, setmanals i mensuals d’un empleat.
• Absències: absències registrades en un interval de dates.
• Vacances: dies restants per empleat.
• Centres de treball: llista i cerca per nom.
• Clients: llista i cerca per nom, per a empreses que imputen hores a clients.
• Documents: nombre de fitxers pujats i tipus de document configurats.

És a dir, tot el que un altre sistema necessita llegir de recursos humans: qui està actiu, quant ha treballat, quan ha faltat i què li queda de vacances. La documentació de cada endpoint, amb els seus paràmetres de data i les seves respostes, és a la pàgina per a desenvolupadors.

Les quatre integracions que compensen en una pime

1. Nòmines: de les hores al rebut sense teclejar

És la integració amb més retorn. A cada tancament de mes, un procés consulta les hores mensuals de cada empleat i les seves absències, les converteix en les variables que espera el teu programa de nòmines o la teva gestoria (hores extres, complements, descomptes per absència) i les lliura en el format que aquest programa importi. LapsoWork no calcula les nòmines, com expliquem a externalitzar les nòmines o fer-les amb programari propi; el que fa l’API és que les variables arribin netes a qui sí que les calcula. Després, la nòmina calculada torna a LapsoWork per distribuir-la i signar-la.

2. ERP: una sola llista d’empleats i centres

Si l’ERP és el mestre d’empleats i centres, la integració manté sincronitzades les altes, les baixes i els canvis de centre, de manera que ningú no dona d’alta dues vegades la mateixa persona. Si el mestre és LapsoWork, l’ERP llegeix de l’API la llista d’empleats actius i els centres. L’important és decidir quin dels dos mana sobre cada dada i no deixar que tots dos escriguin el mateix.

3. BI i quadres de comandament

Un tauler de gerència que cada matí llegeix hores treballades, hores extres, absències per tipus i vacances pendents per centre i equip, sense que ningú exporti res. Amb aquestes dades es calculen els indicadors de recursos humans i l’absentisme que altrament es calculen a mà i s’abandonen.

4. Control d’accés i sistemes propis

Empreses amb torniquets, panys o aplicacions internes que necessiten saber si una persona està activa o quantes hores porta a la setmana. L’API respon a aquestes consultes en temps real.

Com dissenyar una integració que no es trenqui

1. Decideix el sistema mestre de cada dada. Empleats, centres, calendaris, hores: cadascun té un propietari. La resta només llegeix.
2. Treballa per intervals de dates i de manera incremental. Els endpoints de fitxatges, hores i absències accepten data d’inici i de fi; consulta només el que ha canviat des de l’última execució, no tot l’històric cada vegada.
3. Desa el token com un secret. En un gestor de secrets o en variables d’entorn del servidor, mai al codi ni en un full de càlcul compartit. Rota’l si canvia el responsable.
4. Registra cada execució. Què es va consultar, quants registres, quins errors. Quan una nòmina surti malament, aquest registre és el que dirà si la dada va arribar.
5. Tracta els errors sense inventar dades. Si l’API no respon, la integració s’atura i avisa; no emplena hores a zero.
6. Respecta els límits d’ús i consulta en hores de baixa càrrega per als processos massius.
7. Documenta el mapatge. Quin camp de LapsoWork alimenta quin camp de l’altre sistema i amb quina transformació. És el que permetrà mantenir-lo quan canviï la persona que el va fer.
8. Compleix l’RGPD. La integració és un tractament de dades personals: minimitza els camps que trasllades, limita l’accés i reflecteix el flux en el registre de les activitats de tractament.

Quan n’hi ha prou amb una exportació

No totes les pimes necessiten una integració programada. Si tanques nòmines un cop al mes, tens un sol centre i la teva gestoria accepta un Excel, l’exportació d’informes d’hores i absències que inclou LapsoWork resol el problema en dos minuts al mes. L’API compensa quan hi ha diversos sistemes que necessiten la mateixa dada, quan el procés és setmanal o diari, o quan el volum fa que exportar i enganxar sigui una font d’errors. Un bon criteri: si algú dedica més d’una hora al mes a moure dades de recursos humans entre sistemes, la integració es paga sola, com calculem a com calcular el ROI d’un programari de recursos humans.

Qui la pot fer

No cal un equip de desenvolupament. Un desenvolupador amb experiència en API REST, intern o extern, munta en pocs dies una integració de nòmines o de BI amb la documentació pública. Moltes gestories i proveïdors d’ERP ja tenen connectors o experiència amb aquest tipus d’integracions. I si la teva empresa té més de quaranta empleats i necessitats específiques, el pla Personalitzat de LapsoWork inclou desenvolupaments a mida, com pots veure a la nostra pàgina de preus.

Preguntes freqüents

Quines dades puc obtenir de l’API de LapsoWork?

Empleats actius i la seva cerca per nom, fitxatges i hores diàries, setmanals i mensuals per empleat, absències en un interval de dates, dies de vacances restants, centres de treball, clients i dades sobre els documents pujats. La documentació amb cada endpoint i els seus paràmetres és a la pàgina per a desenvolupadors.

Com s’autentica l’API?

Mitjançant un token d’accés associat al teu compte, que s’envia en cada petició. S’ha de desar com un secret al servidor que executa la integració, mai al codi ni en documents compartits, i renovar-lo si canvia la persona responsable.

Es pot integrar LapsoWork amb el programa de nòmines?

Sí. La integració habitual consulta a cada tancament les hores mensuals i les absències de cada empleat i les lliura en el format que importa el programa de nòmines o la gestoria. LapsoWork no calcula les nòmines; distribueix les que calcula la teva gestoria o el teu programa, i l’API s’encarrega que les variables arribin sense teclejar-les.

Necessito un desenvolupador per fer servir l’API?

Per a una integració programada, sí: un desenvolupador amb experiència en API REST, intern o extern, la munta en pocs dies amb la documentació pública. Per a necessitats puntuals, l’exportació d’informes d’hores i absències a Excel no requereix cap desenvolupament.

La integració compleix l’RGPD?

L’ha de complir: és un tractament de dades personals dels empleats. Trasllada només els camps necessaris, limita qui accedeix al token i a les dades, registra les execucions i reflecteix el flux en el registre de les activitats de tractament de l’empresa.

Conclusió

Una API de recursos humans serveix perquè les hores, les absències i els empleats actius arribin a la nòmina, a l’ERP o al quadre de comandament sense que ningú els teclegi. La de LapsoWork exposa exactament aquestes dades amb autenticació per token i documentació pública, i les integracions que compensen en una pime són poques i clares: nòmines, ERP, BI i control d’accés. Si mous dades de recursos humans a mà més d’una hora al mes, prova LapsoWork 30 dies gratis i revisa la documentació de l’API amb el teu desenvolupador.