API de RRHH: como integrar LapsoWork co teu ERP, o teu programa de nóminas ou o teu BI

Un software de RRHH que vive illado obriga a teclear dúas veces: as horas que xa están no control horario vólvense meter no programa de nóminas, as altas que xa están no ERP vólvense dar na plataforma de persoal, e o informe de xerencia móntase cada mes á man con datos de tres sitios. Unha API de RRHH existe para evitar iso: que os sistemas se lean entre si sen intervención humana. Nesta guía explicamos que datos expón a API REST de LapsoWork, que integracións teñen sentido nunha peme, como deseñalas para que non rompan e cando, sinceramente, abonda cunha exportación a Excel.

Que expón a API de LapsoWork

A API REST de LapsoWork está documentada publicamente e autorízase mediante un token de acceso que identifica a túa conta. Os recursos principais son:

• Empregados: número de usuarios activos nun intervalo de datas, listaxe completa de empregados activos entre dúas datas e busca por nome.
• Fichaxes: rexistros de fichaxe no intervalo de datas indicado.
• Horas: sumatorio de horas diarias, semanais e mensuais dun empregado.
• Ausencias: ausencias rexistradas nun intervalo de datas.
• Vacacións: días restantes por empregado.
• Centros de traballo: listaxe e busca por nome.
• Clientes: listaxe e busca por nome, para empresas que imputan horas a clientes.
• Documentos: número de ficheiros subidos e tipos de documento configurados.

É dicir, todo o que outro sistema necesita ler de RRHH: quen está activo, canto traballou, cando faltou e que lle queda de vacacións. A documentación de cada endpoint, cos seus parámetros de data e as súas respostas, está na páxina para desenvolvedores.

As catro integracións que compensan nunha peme

1. Nóminas: das horas ao recibo sen teclear

É a integración con máis retorno. En cada peche de mes, un proceso consulta as horas mensuais de cada empregado e as súas ausencias, convérteas nas variables que espera o teu programa de nóminas ou a túa xestoría (horas extra, complementos, descontos por ausencia) e entrégaas no formato que ese programa importe. LapsoWork non calcula as nóminas, como explicamos en externalizar as nóminas ou facelas con software propio; o que fai a API é que as variables lle cheguen limpas a quen si as calcula. Despois, a nómina calculada volve a LapsoWork para distribuírse e asinarse.

2. ERP: unha soa lista de empregados e centros

Se o ERP é o mestre de empregados e centros, a integración mantén sincronizadas as altas, as baixas e os cambios de centro, de xeito que ninguén dá de alta dúas veces a mesma persoa. Se o mestre é LapsoWork, o ERP le da API a listaxe de empregados activos e os centros. O importante é decidir cal dos dous manda sobre cada dato e non deixar que os dous escriban o mesmo.

3. BI e cadros de mando

Un panel de xerencia que cada mañá le horas traballadas, horas extra, ausencias por tipo e vacacións pendentes por centro e equipo, sen que ninguén exporte nada. Con eses datos calcúlanse os indicadores de recursos humanos e o absentismo que doutro xeito se calculan á man e se abandonan.

4. Control de accesos e sistemas propios

Empresas con tornos, pechaduras ou aplicacións internas que necesitan saber se unha persoa está activa ou cantas horas leva na semana. A API responde a esas consultas en tempo real.

Como deseñar unha integración que non rompa

1. Decide o sistema mestre de cada dato. Empregados, centros, calendarios, horas: cada un ten un dono. O resto só le.
2. Traballa por intervalos de datas e de forma incremental. Os endpoints de fichaxes, horas e ausencias aceptan data de inicio e de fin; consulta só o que cambiou desde a última execución, non todo o histórico cada vez.
3. Garda o token coma un segredo. Nun xestor de segredos ou en variables de contorno do servidor, nunca no código nin nunha folla de cálculo compartida. Rótao se cambia o responsable.
4. Rexistra cada execución. Que se consultou, cantos rexistros, que erros. Cando unha nómina saia mal, ese rexistro é o que dirá se o dato chegou.
5. Trata os erros sen inventar datos. Se a API non responde, a integración detense e avisa; non enche horas a cero.
6. Respecta os límites de uso e consulta en horas de baixa carga para os procesos masivos.
7. Documenta o mapeo. Que campo de LapsoWork alimenta que campo do outro sistema e con que transformación. É o que permitirá mantelo cando cambie a persoa que o fixo.
8. Cumpre o RXPD. A integración é un tratamento de datos persoais: minimiza os campos que trasladas, limita o acceso e reflicte o fluxo no rexistro de actividades de tratamento.

Cando abonda cunha exportación

Non toda peme necesita unha integración programada. Se pechas nóminas unha vez ao mes, tes un só centro e a túa xestoría acepta un Excel, a exportación de informes de horas e ausencias que inclúe LapsoWork resolve o problema en dous minutos ao mes. A API compensa cando hai varios sistemas que necesitan o mesmo dato, cando o proceso é semanal ou diario, ou cando o volume fai que exportar e pegar sexa unha fonte de erros. Un bo criterio: se alguén dedica máis dunha hora ao mes a mover datos de RRHH entre sistemas, a integración págase soa, como calculamos en como calcular o ROI dun software de RRHH.

Quen pode facela

Non fai falta un equipo de desenvolvemento. Un desenvolvedor con experiencia en API REST, interno ou externo, monta en poucos días unha integración de nóminas ou de BI coa documentación pública. Moitas xestorías e provedores de ERP teñen xa conectores ou experiencia con este tipo de integracións. E se a túa empresa ten máis de corenta empregados e necesidades específicas, o plan Personalizado de LapsoWork inclúe desenvolvementos á medida, como podes ver na nosa páxina de prezos.

Preguntas frecuentes

Que datos podo obter da API de LapsoWork?

Empregados activos e a súa busca por nome, fichaxes e horas diarias, semanais e mensuais por empregado, ausencias nun intervalo de datas, días de vacacións restantes, centros de traballo, clientes e datos sobre os documentos subidos. A documentación con cada endpoint e os seus parámetros está na páxina para desenvolvedores.

Como se autentica a API?

Mediante un token de acceso asociado á túa conta, que se envía en cada petición. Debe gardarse coma un segredo no servidor que executa a integración, nunca no código nin en documentos compartidos, e renovarse se cambia a persoa responsable.

Pódese integrar LapsoWork co programa de nóminas?

Si. A integración habitual consulta en cada peche as horas mensuais e as ausencias de cada empregado e entrégaas no formato que importa o programa de nóminas ou a xestoría. LapsoWork non calcula as nóminas; distribúe as que calcula a túa xestoría ou o teu programa, e a API encárgase de que as variables cheguen sen teclealas.

Necesito un desenvolvedor para usar a API?

Para unha integración programada, si: un desenvolvedor con experiencia en API REST, interno ou externo, móntaa en poucos días coa documentación pública. Para necesidades puntuais, a exportación de informes de horas e ausencias a Excel non require ningún desenvolvemento.

A integración cumpre o RXPD?

Debe cumprilo: é un tratamento de datos persoais dos empregados. Traslada só os campos necesarios, limita quen accede ao token e aos datos, rexistra as execucións e reflicte o fluxo no rexistro de actividades de tratamento da empresa.

Conclusión

Unha API de RRHH serve para que as horas, as ausencias e os empregados activos cheguen á nómina, ao ERP ou ao cadro de mando sen que ninguén os teclee. A de LapsoWork expón exactamente eses datos con autenticación por token e documentación pública, e as integracións que compensan nunha peme son poucas e claras: nóminas, ERP, BI e control de accesos. Se moves datos de RRHH á man máis dunha hora ao mes, proba LapsoWork 30 días gratis e revisa a documentación da API co teu desenvolvedor.