API de nómina para consultar tus datos desde otros sistemas
La API de consultas de Nómina360 es una API REST de solo lectura que entrega en JSON los datos de nómina y de personal de tu empresa: roles de pago, ingresos y salidas de personal, liquidaciones, permisos, faltas y vacaciones. Tu ERP, tu herramienta de BI o tus propios sistemas los consultan con un token propio de tu empresa.
Actualizado:
¿Por qué sacar los datos de nómina a mano no escala?
Los equipos de finanzas, TI y gerencia necesitan los datos de nómina en otros sistemas: el ERP, un tablero de Power BI o un sistema propio de la empresa. Si cada mes alguien descarga reportes en Excel y los vuelve a subir, los datos llegan tarde, se copian con errores y nadie sabe cuál es la versión correcta.
Reportes descargados a mano
Cada área pide su archivo y alguien lo arma todos los meses.
Datos que no coinciden
El tablero muestra una cifra y el rol de pagos otra.
Accesos sin control
Para ver los datos se comparten usuarios del sistema de nómina.
GET /api/v1/roles-de-pago?anio=2026&mes=9{ "roles": [ … ], "total": 120 }Beneficios de la API de consultas de Nómina360
- Solo lectura: consulta los datos sin poder cambiar nada en la nómina.
- Un token propio de tu empresa, que Nómina360 genera y puede desactivar.
- Cada consulta devuelve solo los datos de tu empresa.
- Respuestas en JSON, fáciles de leer desde cualquier lenguaje o herramienta.
- Consultas por rango de fechas o por mes, según el dato.
- Documentación técnica en formato OpenAPI para tu equipo de TI.
¿Qué datos puedes consultar con la API?
| Consulta | Qué devuelve |
|---|---|
| Roles de pago | Rol de fin de mes de cada colaborador del mes: ingresos, egresos y neto a recibir |
| Ingresos de personal | Contratos que empiezan en el rango, con cargo, área, departamento, centro de costo, tipo de contrato y tipo de sueldo |
| Salidas de personal | Contratos liquidados en el rango, con nombre y cédula del colaborador |
| Liquidaciones | Fichas de liquidación del rango |
| Período de prueba | Contratos que están en período de prueba en el mes |
| Permisos | Permisos del rango, por tipo: médicos, maternidad, paternidad y otros |
| Faltas | Faltas del rango, justificadas o injustificadas |
| Vacaciones | Saldo de vacaciones de cada colaborador |
| Cumpleaños | Colaboradores que cumplen años entre dos meses |
¿Cómo se conecta la API de consultas?
Contratas la API
Nómina360 genera el token de tu empresa y te entrega la documentación.
Conectas tu sistema
tu equipo envía el token en cada consulta a la API.
Consultas los datos
pides la información por mes o por rango de fechas y la recibes en JSON.
¿Qué incluye la API de consultas de Nómina360?
Se contrata aparte, en planes según la cantidad de consultas diarias y mensuales, y lee los datos que ya manejas en Core HR y Liquidaciones. Complementa la integración de nómina con ERP, que envía asientos y archivos al sistema contable.
Nómina y pagos
Los roles de pago de fin de mes con su detalle.
- Ingresos y egresos de cada colaborador, con su rubro.
- Neto a recibir por persona.
- Consulta por año y mes.
Movimientos de personal
Las altas y bajas para tus reportes de rotación.
- Ingresos de personal con cargo, área, departamento y centro de costo.
- Salidas y fichas de liquidación por rango de fechas.
- Contratos en período de prueba del mes.
Ausencias y vacaciones
Lo que necesitas para medir el ausentismo.
- Permisos por tipo y faltas justificadas o injustificadas.
- Saldo de vacaciones por colaborador.
- Cumpleaños para comunicación interna.
Acceso seguro y separado
Solo tu empresa ve tus datos.
- Token propio de la empresa, que se puede desactivar.
- Consultas de solo lectura.
- Documentación OpenAPI de cada consulta.
En resumen
| Dato | Detalle |
|---|---|
| Tipo | API REST de solo lectura, versión 1, respuestas en JSON |
| Acceso | Token propio de cada empresa, generado y desactivado por Nómina360 |
| Datos | Roles de pago, ingresos y salidas de personal, liquidaciones, período de prueba, permisos, faltas, vacaciones y cumpleaños |
| Filtros | Por año y mes o por rango de fechas, según la consulta; tipo de permiso y tipo de falta |
| Documentación | OpenAPI 3.0 |
| Usos típicos | Tableros de Power BI, ERP, sistemas propios de la empresa |
| Disponibilidad | Se contrata aparte, en planes según la cantidad de consultas diarias y mensuales; lee los datos de Core HR |
Preguntas frecuentes sobre la API de nómina
¿Qué es la API de consultas de Nómina360?
Es una API REST que permite a otros sistemas de tu empresa leer tus datos de nómina y de personal sin entrar a Nómina360. Devuelve en JSON los roles de pago, los ingresos y salidas de personal, las liquidaciones, los permisos, las faltas y los saldos de vacaciones, filtrados por mes o por rango de fechas.
¿La API permite modificar datos de la nómina?
No. La API de consultas es de solo lectura: todas sus consultas leen información y ninguna crea, cambia ni borra datos. Los roles, los contratos y las liquidaciones se siguen trabajando dentro de Nómina360.
¿Cómo se protege el acceso a los datos?
Cada empresa tiene su propio token, que Nómina360 genera al contratar la API y puede desactivar cuando lo pidas. En cada consulta la API valida el token y devuelve solo los datos de la empresa a la que pertenece, aunque la consulta pida otra cosa.
¿En qué se diferencia de la integración con ERP?
La integración con ERP envía desde Nómina360 los asientos contables y archivos al sistema contable; si tu ERP no está en la lista, existe la integración con otros ERP. La API de consultas funciona al revés: es tu sistema el que pide a Nómina360 los datos que necesita, cuando los necesita.
Otras integraciones de Nómina360
Lleva tus datos de nómina a donde los necesitas
Te mostramos en una demo qué datos entrega la API y cómo se conecta con tu ERP o tu BI.