Bienvenido a la API de Facturación Electrónica Aliaddo Orka, una solución moderna y robusta desarrollada para facilitar la emisión, gestión y consulta de documentos electrónicos bajo los lineamientos de la DIAN (Dirección de Impuestos y Aduanas Nacionales de Colombia).Esta API permite a los sistemas ERP, plataformas contables o aplicaciones personalizadas integrar procesos de facturación electrónica de manera segura y automatizada, sin necesidad de acceder a un portal web.
⚙️ Funcionalidades principales#
🧾 Creación de documentos electrónicos#
Crea y envía a la DIAN los diferentes tipos de documentos electrónicos admitidos:Documento Equivalente Electrónico
Nota de Ajuste al Documento Soporte
Nota Crédito al Documento Equivalente
Cada documento se valida y se transmite automáticamente a la DIAN, retornando su estado de procesamiento.
Una vez la DIAN responde, el resultado se puede consultar mediante el ID del documento o a través del Prefijo y Consecutivo.
🔍 Consulta de documentos#
Puedes consultar cualquier documento creado en la plataforma utilizando dos métodos:| Tipo de consulta | Endpoint | Descripción |
|---|
| 🔹 Por ID | GET /v2/documents/{documentType}/{id} | Consulta directa por identificador único del documento |
| 🔹 Por Prefijo y Consecutivo | GET /v2/documents/{documentType}/find-by-prefix-and-consecutive | Consulta por prefijo y número de factura de la DIAN |
💡 Ejemplo: GET /v2/documents/invoices/find-by-prefix-and-consecutive?prefix=SETP&consecutive=123
📚 Lista de valores (Catálogos DIAN)#
La API incluye una sección llamada Lista de Valores, desde donde puedes obtener catálogos oficiales y parámetros requeridos para la generación correcta de documentos electrónicos.Estos catálogos están siempre sincronizados con los códigos oficiales de la DIAN, asegurando que tus integraciones cumplan con los estándares actuales.
🔐 Autenticación#
Aliaddo Orka utiliza autenticación basada en tokens (Bearer Token).
Cada solicitud a la API debe incluir el encabezado: Modificado en 2026-03-10 14:29:29