API de Facturación Aliaddo NITRO
    • Introducción
    • Autenticación
    • Códigos de respuesta de la API
    • Facturas electrónicas
      • Crear factura electrónica
        POST
      • Crear factura sector salud
        POST
      • Crear factura divisas
        POST
      • Consultar por ID
        GET
      • Consultar por prefijo y consecutivo
        GET
    • Documentos soporte
      • Crear documento soporte
        POST
      • Consultar por ID
        GET
      • Consultar por prefijo y consecutivo
        GET
    • Documentos equivalentes
      • Crear tiquete P.O.S
        POST
      • Crear tiquete de transporte terrestre
        POST
      • Crear tiquete de cine
        POST
      • Crear tiquete de cobro de peajes
        POST
      • Crear tiquete aereo
        POST
      • Crear boleta de ingreso a espectáculos públicos
        POST
      • Consultar por ID
        GET
      • Consultar por prefijo y consecutivo
        GET
    • Notas crédito
      • Crear nota crédito
        POST
      • Consultar por ID
        GET
      • Consultar por prefijo y consecutivo
        GET
    • Notas débito
      • Crear nota débito
        POST
      • Consultar por ID
        GET
      • Consultar por prefijo y consecutivo
        GET
    • Nota de ajuste al documento soporte
      • Crear nota de ajuste
      • Consultar por ID
      • Consultar por prefijo y consecutivo
    • Nota crédito al documento equivalente
      • Crear nota crédito al documento equivalente
      • Consultar por ID
      • Consultar por prefijo y consecutivo
    • Nota débito al documento equivalente
      • Crear nota débito al documento equivalente
      • Consultar por ID
      • Consultar por prefijo y consecutivo
    • Nota de ajuste al documento equivalente
      • Crear nota de ajuste al documento equivalente
    • Lista de valores
      • Actividades económicas
      • Ciudades
      • Códigos de monedas
      • Código estandar del producto
      • Condiciones de entrega (INCOTERMS)
      • Departamentos
      • Medios de pagos
      • Paises
      • Responsabilidades fiscales
      • Tipos de identificacion
      • Tipos de documentos electrónicos
      • Tipos de operación
      • Tipos de persona
      • Tipos de regimen
      • Tributos (Impuestos/Retenciones)
      • Unidades de cantidad
      • Responsable de impuestos
      • Códigos Postales de Colombia
    • Estructura de datos
      • Ancho del PDF
      • Descuentos y cargos
      • Direcciones del cliente
      • Documentos equivalentes
      • Extensiones de facturas
      • Factura electrónica de venta
      • Factura electrónica sector salud
      • Factura electrónica de venta y compra de divisas
      • Formatos permitidos PDF
      • ID set de pruebas DIAN
      • Modo contingencia
      • Modos de ambiente de facturación
      • Notas de ajuste débito y crédito al documento equivalente
      • Notas crédito y débito de factura electrónica de venta
    • Guía para importar archivos
      • Introducción
    • Schemas
      • Documentos electrónicos
        • FacturaElectronica
        • Divisas
        • DocumentoSoporteRequest
        • DocumentoEquivalenteRequest
        • BoletaEspectaculosRequest
      • Impuestos
      • Mandante
      • Retencioness
      • Resolución Pos
      • FacturaRequestPOS
      • FacturaRequest
      • Supplier
      • Dirección
      • Resolución
      • Cliente
      • Productos
      • LineaProductoPeaje
      • Totales
      • SectorSalud
      • Transporte
      • Sucursal
      • RequestResponse
      • Cinema
      • TikectAereo
      • EspectaculoPublico
      • ComprayVentaDeDivisas
      • Retenciones
      • Descuento
      • Propinas
      • Cargos
      • Supplier2
      • NotasCred/Deb/Ajus

    Introducción

    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:
    Factura Electrónica
    Documento Soporte
    Documento Equivalente Electrónico
    Nota Crédito
    Nota Débito
    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 consultaEndpointDescripción
    🔹 Por IDGET /v2/documents/{documentType}/{id}Consulta directa por identificador único del documento
    🔹 Por Prefijo y ConsecutivoGET /v2/documents/{documentType}/find-by-prefix-and-consecutiveConsulta 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.
    CatálogoDescripción
    🏙️ CiudadesCódigos y nombres de municipios según DIAN
    🌎 DepartamentosCódigos y nombres de departamentos
    💳 Medios de pagoMétodos de pago permitidos (efectivo, transferencia, etc.)
    📄 Tipos de documento DIANTipos de documento electrónico autorizados
    🔁 Tipos de operaciónTipos de operación para facturación, soporte o equivalentes
    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
    Siguiente
    Autenticación
    Built with