API de control horari de Numa: integracions amb OpenAPI i MCP
Connecta les dades i els resultats del control horari amb les teves aplicacions i assistents d’intel·ligència artificial.
Numa ofereix una API REST documentada amb OpenAPI i un servidor MCP per a assistents d’IA compatibles. Dues vies d’accés a informació d’empleats, fitxatges, càlculs horaris i informes, pensades per incorporar el control horari als processos de la teva empresa.
L’API de Numa està documentada amb OpenAPI 3.1.1, amb operacions, paràmetres i estructures de resposta definits. Les consultes de dades retornen informació en JSON i l’accés es realitza mitjançant una clau API associada a un usuari de Numa.
Pots consultar empleats d’una empresa i seleccionar-los per centre, departament, categoria o estat actiu. Les consultes de control horari permeten escollir el període i el nivell de detall necessari, amb paginació per recuperar els resultats de manera progressiva.
Numa també admet identificadors externs per relacionar registres amb altres aplicacions, disponibles en entitats com empleats, empreses i departaments. Una base útil per establir correspondències amb els registres del teu ERP o sistema de personal.
Parlem de la teva integració
Molt més que exportar entrades i sortides
L’API permet obtenir resultats diaris i resums per període, com hores teòriques, hores normals i extraordinàries, desglossaments diürns i nocturns, pauses, retards, absències i incidències.
Fitxatges amb context
Detall de cada jornada
Indicadors personalitzats
Acumuladors i saldos
El detall també permet distingir retards i absències originals dels resultats ajustats per les regles de l’horari, com toleràncies o arrodoniments. Això facilita desenvolupar eines de revisió que vagin més enllà d’un simple quadre de totals.
Servidor MCP: consulta el control horari des d’un assistent d’IA
El servidor MCP de Numa permet que un assistent compatible utilitzi les eines disponibles per consultar dades i recuperar resultats de control horari.
Un cop configurada la connexió, pots plantejar consultes com:
Mostra les hores normals i extra del mes passat dels empleats del departament de producció.
Quines jornades tenen errors de processament aquesta setmana?
Genera l’informe de resum mensual per als empleats d’aquest centre.Aquestes consultes es poden resoldre combinant les eines de selecció d’empleats, els resums horaris i la generació d’informes disponibles.
Dades acompanyades de documentació per interpretar-les
Numa proporciona una guia per a assistents, un model de domini, un glossari i documentació sobre els conceptes de control horari, disponibles en castellà i anglès.
L’assistent disposa així de context sobre conceptes com jornades, horaris, incidències, vacances, comptadors i saldos. No rep únicament xifres i identificadors: també pot consultar què representen dins de Numa.
Genera els informes que ja tens configurats
L’API i el MCP permeten generar informes per a un període i una selecció d’empleats, reutilitzant la configuració definida a Numa: columnes, filtres, agrupacions, ordenació i altres opcions.
Els informes es poden obtenir en PDF, HTML o CSV, segons els formats admesos per cada informe. La configuració de l’informe es modifica a Numa; la integració en sol·licita la generació.
Accés vinculat als permisos de l’usuari
Cada clau API està associada a un usuari de Numa. Les peticions s’executen amb els permisos d’aquest usuari i segueixen les mateixes regles d’autorització que l’aplicació.
Això permet definir l’accés de la integració a partir dels permisos configurats a Numa, en lloc d’oferir un accés indiscriminat a les dades.
Incorpora Numa als teus processos
Aquestes capacitats ofereixen una base per desenvolupar integracions com:
ERP i nòmines. Incorporar hores normals, extraordinàries, nocturnitat i incidències als processos de l’aplicació de destinació.
Quadres de comandament. Consultar periòdicament els resultats de Numa i construir indicadors per empleat, centre o departament.
Assistents interns. Facilitar consultes sobre control horari i generació d’informes mitjançant llenguatge natural.
Són possibles projectes d’integració: la connexió amb cada aplicació requereix definir les dades, les correspondències i el procés que s’ha d’implementar.
