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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://nomina-electronica.aliaddo.dev/master.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.