Introducción

Esta es la documentación oficial de nuestra API HRM (Human Resources Management)

API HRM

Con la API de Nómina (HRM) Aliaddo dispondrás de las funcionalidades de nuestra aplicación para integrarlas a tu software. Nuestra API está basada en REST, por lo que los datos serán codificados siempre como tipo JSON.

Nuestra API puede ser usada de tres formas, en modo habilitación, modo pruebas y en modo producción, dependiendo del endpoint o url que uses.

Modo Habilitación

El modo habilitación se usa para pruebas y para que la DIAN te habilite la nómina electrónica.

Es importante contar con el testSetId que te proporcionará la DIAN para hacer tus pruebas, en el ejemplo se encuentra al final de la ruta, de la siguiente manera:

https://api.aliaddo.net/api/v1/payrolls/habilitation/{{testSetId}}

Ejemplo:

https://api.aliaddo.net/api/v1/payrolls/habilitation/4bf6673a-7a71-496e-8cfd-f7246067e4ca

Modo Pruebas

El modo pruebas se usa para emitir nóminas ficticias a la API con el fin de corroborar el funcionamiento de esta y también para verificar que la estructura y los datos de tus objetos se encuentren correctamente construidos.

Las nóminas de prueba se enviarán a este endpoint: https://api.aliaddo.net/api/v1/payrolls/test

Modo Producción

El modo producción se usa para enviar documentos oficialmente a la DIAN después de haber sido habilitado en nómina electrónica.

Las nóminas de producción se deben enviar a este endpoint: https://api.aliaddo.net/api/v1/payrolls/

Métodos HTTP

Estos son los métodos que se usan en nuestra API.

Método	Función
POST	Crea un objeto