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


---

# 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://factura-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.