# Introducción

## 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. 

{% hint style="info" %}
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}}`
{% endhint %}

**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 |