API de control horario de Numa: integraciones con OpenAPI y MCP
Conecta los datos y resultados del control horario con tus aplicaciones y asistentes de inteligencia artificial.
Numa ofrece una API REST documentada con OpenAPI y un servidor MCP para asistentes de IA compatibles. Dos vías de acceso a información de empleados, fichajes, cálculos horarios e informes, pensadas para incorporar el control horario a los procesos de tu empresa.
La API de Numa está documentada con OpenAPI 3.1.1, con operaciones, parámetros y estructuras de respuesta definidos. Las consultas de datos devuelven información en JSON y el acceso se realiza mediante una clave API asociada a un usuario de Numa.
Puedes consultar empleados de una empresa y seleccionarlos por centro, departamento, categoría o estado activo. Las consultas de control horario permiten escoger el periodo y el nivel de detalle necesario, con paginación para recuperar los resultados de forma progresiva.
Numa también admite identificadores externos para relacionar registros con otras aplicaciones, disponibles en entidades como empleados, empresas y departamentos. Una base útil para establecer correspondencias con los registros de tu ERP o sistema de personal.
Hablemos de tu integración
Mucho más que exportar entradas y salidas
La API permite obtener resultados diarios y resúmenes por periodo, como horas teóricas, horas normales y extraordinarias, desgloses diurnos y nocturnos, pausas, retrasos, ausencias e incidencias.
Fichajes con contexto
Detalle de cada jornada
Indicadores personalizados
Acumuladores y saldos
El detalle también permite distinguir retrasos y ausencias originales de los resultados ajustados por las reglas del horario, como tolerancias o redondeos. Esto facilita desarrollar herramientas de revisión que vayan más allá de un simple cuadro de totales.
Servidor MCP: consulta el control horario desde un asistente de IA
El servidor MCP de Numa permite que un asistente compatible utilice las herramientas disponibles para consultar datos y recuperar resultados de control horario.
Una vez configurada la conexión, puedes plantear consultas como:
Muestra las horas normales y extra del mes pasado de los empleados del departamento de producción.
¿Qué jornadas tienen errores de procesamiento esta semana?
Genera el informe de resumen mensual para los empleados de este centro.Estas consultas se pueden resolver combinando las herramientas de selección de empleados, los resúmenes horarios y la generación de informes disponibles.
Datos acompañados de documentación para interpretarlos
Numa proporciona una guía para asistentes, un modelo de dominio, un glosario y documentación sobre los conceptos de control horario, disponibles en castellano e inglés.
El asistente dispone así de contexto sobre conceptos como jornadas, horarios, incidencias, vacaciones, contadores y saldos. No recibe únicamente cifras e identificadores: también puede consultar qué representan dentro de Numa.
Genera los informes que ya tienes configurados
La API y el MCP permiten generar informes para un periodo y una selección de empleados, reutilizando la configuración definida en Numa: columnas, filtros, agrupaciones, ordenación y otras opciones.
Los informes se pueden obtener en PDF, HTML o CSV, según los formatos admitidos por cada informe. La configuración del informe se modifica en Numa; la integración solicita su generación.
Acceso vinculado a los permisos del usuario
Cada clave API está asociada a un usuario de Numa. Las peticiones se ejecutan con los permisos de ese usuario y siguen las mismas reglas de autorización que la aplicación.
Esto permite definir el acceso de la integración a partir de los permisos configurados en Numa, en lugar de ofrecer un acceso indiscriminado a los datos.
Incorpora Numa a tus procesos
Estas capacidades ofrecen una base para desarrollar integraciones como:
ERP y nóminas. Incorporar horas normales, extraordinarias, nocturnidad e incidencias a los procesos de la aplicación de destino.
Cuadros de mando. Consultar periódicamente los resultados de Numa y construir indicadores por empleado, centro o departamento.
Asistentes internos. Facilitar consultas sobre control horario y generación de informes mediante lenguaje natural.
Son posibles proyectos de integración: la conexión con cada aplicación requiere definir los datos, las correspondencias y el proceso que debe implementarse.
