# 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***](https://factura-electronica.aliaddo.dev/primeros-pasos/consideraciones)
{% 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="archivo-plano-.csv" %}
[archivo-plano-.csv](https://factura-electronica.aliaddo.dev/archivo-plano-.csv)
{% endcontent-ref %}

> Made with 🧡