Bienvenido a Aleluya
Aleluya API
Integra fácilmente tus aplicaciones con Aleluya y obtén control total sobre tus operaciones de nómina, facilitando su liquidación y procesamiento de manera confiable, cumpliendo con los estándares normativos exigidos por la DIAN y la UGPP.
¿Qué puedes integrar?
Aleluya API está organizada en módulos independientes. Puedes integrar solo lo que necesitas o construir un flujo completo de nómina desde cero.
Configuración de empresa
Registra los datos tributarios y de operación de la empresa antes de liquidar nómina.
- NIT, razón social, sector económico y dirección
- Frecuencia de pago: mensual o quincenal
- Múltiples cuentas bancarias para generar archivos de pago por banco
- Decretos aplicables (558, 376, Ley 1607)
Personas y contratos
Registra y mantén actualizada la información de cada persona en la empresa.
- Datos personales, documento y cuenta bancaria
- Tipo de contrato y salario
- Ingresos fijos, auxilios y deducciones recurrentes
- Historial de cargos y áreas
Novedades del período
Registra todo lo que afecta el pago de cada persona en el mes.
- Vacaciones disfrutadas y licencias
- Incapacidades por enfermedad o maternidad
- Horas extras diurnas, nocturnas y festivas
- Bonificaciones y descuentos puntuales
Liquidación de nómina
Liquida el pago de cada persona por período, incluyendo los conceptos salariales, deducciones y obligaciones legales.
- Salario proporcional a días trabajados
- Retención en la fuente
- Cesantías, prima y vacaciones acumuladas
- Liquidación final cuando termina un contrato
Aportes a seguridad social
Gestiona los aportes mensuales a seguridad social, desde el cálculo hasta el pago al operador.
- Aportes a pensión, salud y riesgos laborales
- Aportes parafiscales (SENA, ICBF, CCF)
- Envío y pago directo al operador (Aportes en Línea o Enlace Operativo)
Archivos y nómina electrónica
Descarga los archivos necesarios para pagar, contabilizar y cumplir con la DIAN.
- Archivo bancario
- Nómina electrónica con transmisión a DIAN
- Reporte de retención en la fuente
- Desprendibles de pago para cada persona
¿Cómo integrar?
Aleluya API ofrece un conjunto completo de endpoints REST para construir soluciones personalizadas.
API REST
Nuestras APIs REST son la base del ecosistema de Aleluya, potenciando todas las funcionalidades principales.
Características:
- Endpoints organizados por recurso (
companies,workers,payrolls,periods, etc.). - Autenticación por JWT Bearer token o cookies de sesión.
- Manejo granular de permisos y roles.
- Documentación completa con ejemplos.
- Límite de 150 peticiones por minuto por IP y por usuario.
Casos de uso:
- Incorporar la liquidación de nómina colombiana en una plataforma de RR. HH. existente.
- Dashboards de reportes personalizados.
- Sincronización bidireccional con sistemas contables.
- Enviar desprendibles de pago a empleados desde tu propio sistema.
Ambientes disponibles
Aleluya tiene dos ambientes con el mismo comportamiento. Usa staging para desarrollar y producción cuando tu integración esté lista.
https://nominapp-api-stage.herokuapp.comPara desarrollar y probar tu integración sin afectar datos reales.
Los errores aquí no tienen consecuencias. Prueba todo antes de ir a producción.
https://nominapp-api.herokuapp.comPara cuando tu integración está lista. Opera con datos y transacciones reales.
Las operaciones son irreversibles. Los pagos y transmisiones a la DIAN son oficiales.
Consideraciones técnicas
Límites y restricciones
- Rate limit: 150 peticiones por minuto por IP y por usuario (ventana móvil de 60 segundos).
- Tamaño de archivos adjuntos: Máximo 1MB por archivo.
- Respuestas: Formato JSON.
- Períodos: Soporte para nómina mensual y quincenal.
Contexto normativo colombiano
Aleluya cumple con regulaciones locales clave:
- DIAN: Transmisión de nómina electrónica y certificados.
- UGPP: Gestión de archivos especiales.
- EPS/ARL/AFP/CCF: Afiliación y pago automático.
- PILA: Pago centralizado de aportes.
Recursos
Inicio rápido
Crea tu cuenta y haz tu primera llamada a la API paso a paso.
Centro de ayuda
Tutoriales, conceptos y normatividad explicados desde Aleluya.
Nuestro Blog
Liquidar nómina en Colombia, todo lo que debes saber.