> For the complete documentation index, see [llms.txt](https://factura-electronica.aliaddo.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://factura-electronica.aliaddo.dev/master.md).

# Introducción

## API Facturación Electrónica

Con la **API de Facturación Electrónica de 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 que uses.  

### **Modo Habilitación**

El **modo habilitación** se usa para pruebas y para que la DIAN te habilite como facturador electrónico. 

{% 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.
{% endhint %}

    **Ejemplo:**

`https://isv.aliaddo.net/api/v1/public/documents/invoice/habilitation/4bf6673a-7a71-496e-8cfd-f7246067e4ca`

### Modo Pruebas

El **modo pruebas** se usa para emitir facturas 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.

    **Ejemplo:**

`https://isv.aliaddo.net/api/v1/public/documents/invoice/test`

### Modo Producción

El **modo producción** se usa para enviar documentos oficialmente a la DIAN después de haber sido habilitado como facturador electrónico.

    **Ejemplo:**

`https://isv.aliaddo.net/api/v1/public/documents/invoice`

### Métodos HTTP

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

| Método | Función              |
| ------ | -------------------- |
| GET    | Trae uno más objetos |
| POST   | Crea un objeto       |
| PUT    | Modifica un objeto   |

{% hint style="warning" %}
Por favor revise la siguiente sección: [***Consideraciones Importantes***](/primeros-pasos/consideraciones.md)
{% endhint %}

## Archivo Plano

Al final de esta documentación encontrarás como importar documentos por medio de archivo plano delimitado por punto y coma.

{% content-ref url="/pages/-M04TPz-Lj20QYo2ZXAc" %}
[Archivo Plano (.CSV)](/archivo-plano-.csv/consideraciones-sobre-el-archivo-plano.md)
{% endcontent-ref %}

> Made with 🧡