Ves al contingut

API DESENVOLUPADORS

API per a desenvolupadors

Documentació orientada a desenvolupadors per integrar LapsoWork amb ERP, gestories, quadres de comandament o qualsevol sistema intern. Autenticació per token, respostes en JSON i endpoints que cobreixen empleats, fitxatges, absències, clients, centres i documents.

AUTORITZACIÓ PER UTILITZAR L’API

Autenticació per api-key

Per consumir l’API de LapsoWork, el desenvolupador necessita una api-key (token d’accés) que li facilita l’administrador del compte. Des del tauler de LapsoWork, al mòdul Gestió d’API, l’administrador genera la clau i l’envia a l’equip tècnic encarregat de la integració.

  • Token únic per compte, revocable i regenerable en qualsevol moment.
  • Enviament del token com a paràmetre ?token=... o capçalera HTTP.
  • Respostes en JSON, preparades per integrar-se amb ERP, BI o gestories.

Patró d’URL base 

GET http://url-mi-lapsowork/api/v1/{endpoint}/
  ?token=MI_TOKEN
  &start=2026-01-01
  &end=2026-01-31

Exemple — llista d’empleats actius 

curl "http://url-mi-lapsowork/api/v1/get-empleados-activos/\
?token=MI_TOKEN&start=2026-01-01&end=2026-01-31"
DOCUMENTACIÓ DE L’API

14 endpoints REST per integrar LapsoWork

Agrupats per recurs, amb la llista de paràmetres admesos. Tots utilitzen el mètode GET i retornen JSON.

Empleats

Recurs Mètode Ruta Paràmetres Descripció
Comptador d’empleats actius GET /api/v1/get-contador-empleados-activos/ token, start, end Retorna el valor numèric d’usuaris actius en l’interval indicat.
Llista d’empleats actius GET /api/v1/get-empleados-activos/ token, start, end Llista completa d’empleats actius entre dues dates.
Cerca d’empleats per nom GET /api/v1/get-empleados-por-nombre/ token, name Filtra els empleats per coincidència de nom.

Fitxatges i jornada

Recurs Mètode Ruta Paràmetres Descripció
Llista de registres de treball GET /api/v1/get-registros/ token, start, end Registres de fitxatge en l’interval indicat.
Informe d’hores per empleat GET /api/v1/get-horas-registros-por-empleado/ token, start, userId Sumatori d’hores diàries, setmanals i mensuals d’un empleat.

Clients i centres

Recurs Mètode Ruta Paràmetres Descripció
Llista de clients GET /api/v1/get-clientes/ token Llista completa de clients.
Clients filtrats per nom GET /api/v1/get-clientes-por-nombre/ token, name Cerca de clients per nom.
Llista de centres de treball GET /api/v1/get-centros/ token Llista de tots els centres de treball.
Centres filtrats per nom GET /api/v1/get-centros-por-nombre/ token, name Cerca de centres de treball per nom.

Absències

Recurs Mètode Ruta Paràmetres Descripció
Llista d’absències entre dates GET /api/v1/get-ausencias/ token, start, end Absències registrades en l’interval indicat.
Dies disponibles d’absències GET /api/v1/get-dias-disponibles-ausencias/ token Dies restants de vacances per empleat.

Documents

Recurs Mètode Ruta Paràmetres Descripció
Total de documents GET /api/v1/get-total-documentos/ token Nombre total de fitxers pujats al compte.
Tipus de documents GET /api/v1/get-tipos-documentos/ token Llista dels tipus de documents configurats.
Total de tipus de documents GET /api/v1/get-total-tipos-documentos/ token Quantitat de tipus de documents creats.
PER QUÈ INTEGRAR AMB L’API

Connecta LapsoWork amb la resta del teu stack

Quadres de comandament en temps real

Llegeix comptadors de plantilla, hores i absències des de Power BI, Looker o Metabase. Tot amb un simple GET.

Exportació a la gestoria

Obtén les hores reals treballades per empleat i envia-les a la teva gestoria o al teu programari de nòmines sense copiar dades a mà.

Seguretat per token

Cada integració fa servir el seu propi token, revocable des del tauler. Sense exposició de credencials d’usuari.

Preguntes freqüents sobre l’API

Tot el que els equips tècnics solen preguntar abans d’integrar.

Com obtinc el meu token d’accés a l’API?
L’administrador del compte LapsoWork accedeix al mòdul de gestió d’API dins del tauler, genera una api-key (token) i la lliura al desenvolupador. Cada token és únic, revocable i es pot regenerar en qualsevol moment des de la mateixa pantalla.
En quin format es retornen les respostes?
Totes les respostes de l’API es retornen en format JSON amb codificació UTF-8, a punt per integrar-se amb qualsevol llenguatge (PHP, Node.js, Python, Java, .NET, etc.) o eina de BI.
Quin format de data he d’utilitzar en els paràmetres?
Els paràmetres start i end segueixen el format ISO YYYY-MM-DD (per exemple 2026-01-31). Així es garanteix la compatibilitat amb cercadors, scripts d’ETL i eines de BI.
Necessito un entorn propi per fer servir l’API?
Sí. L’URL base apunta a la teva instal·lació (http://url-mi-lapsowork/api/v1/...). Cada client disposa del seu propi domini i token, cosa que aïlla les dades de la resta de comptes.
Puc integrar LapsoWork amb el meu ERP, la meva gestoria o el meu BI?
Sí. Els endpoints cobreixen els recursos habituals que demanen els ERP i les gestories (empleats, fitxatges, absències, hores, documents). Si la teva integració requereix suport específic, contacta amb el nostre equip tècnic.
PARLEM?

Necessites suport per integrar LapsoWork?

El nostre equip tècnic ajuda en projectes d’integració amb ERP, BI, gestories i programari a mida. Explica’ns el teu cas i et responem en 24 hores.

  • Et truquem el mateix dia feiner.
  • Prova activa en 30 minuts.
  • Sense targeta · Sense permanència.

O truca’ns directament

910 053 253 contacto@lapsowork.com

Et responem en menys de 24 h laborables.

El caos administratiu no s’arregla sol.

Prova LapsoWork 30 dies gratis, sense targeta de crèdit. Si no et convenç, te’n vas sense pagar res.

Comença gratis 30 dies

Prefereixes que t’ho ensenyem? Parla amb l’equip

  • Sense targeta
  • Sense permanència
  • 4,7★ a l’App Store