Habilitacion facturacion electronica DIAN: guía paso a paso para desarrolladores

Habilitacion facturacion electronica DIAN: guía paso a paso para desarrolladores

La habilitacion facturacion electronica DIAN es el proceso formal mediante el cual una empresa o persona natural queda autorizada para emitir facturas electrónicas con validez fiscal en Colombia. Sin completarlo, cualquier factura emitida es inválida ante la DIAN — sin importar si el sistema técnico funciona correctamente. Esta guía cubre cada paso del proceso, los errores más frecuentes en cada fase, y cómo la API de Alanube simplifica la implementación técnica una vez que la habilitación está activa.

Índice de contenidos

• Qué es la habilitación de facturación electrónica ante la DIAN
• Quiénes están obligados a habilitarse
• Prerrequisitos antes de iniciar el proceso
• Los 7 pasos de la habilitación facturación electrónica DIAN
• Errores frecuentes en la habilitacion facturacion electronica DIAN por paso
• Qué cambia técnicamente después de la habilitación
• Cómo conectar la habilitación con la API de Alanube

Qué es la habilitación de facturación electrónica ante la DIAN

La habilitacion facturacion electronica DIAN es el procedimiento regulado por la Dirección de Impuestos y Aduanas Nacionales (DIAN) mediante el cual un obligado a facturar electrónicamente registra su sistema tecnológico, prueba que cumple con el estándar UBL 2.1, y recibe autorización para emitir documentos electrónicos con validez tributaria.

Desde la Resolución 042 de 2020 y sus modificaciones posteriores, la habilitación es obligatoria para la mayoría de contribuyentes del régimen común en Colombia. No es un trámite opcional ni delegable a un proveedor sin participación activa del contribuyente — la DIAN exige que sea el propio NIT el que quede habilitado, no el proveedor tecnológico.

Quiénes están obligados a habilitarse

Prerrequisitos antes de iniciar el proceso

Antes de iniciar el proceso de habilitacion facturacion electronica DIAN, verificar que estos elementos estén listos:

1. RUT actualizado con actividad económica correcta y responsabilidad de IVA activa.
2. Firma electrónica o certificado digital vigente — emitido por una entidad certificadora autorizada por la Superintendencia de Industria y Comercio.
3. Proveedor tecnológico habilitado ante la DIAN (e-Provider) seleccionado — es el intermediario técnico que transmite las facturas. Alanube opera como e-Provider autorizado.
4. Set de prueba DIAN completado — la DIAN exige un conjunto de documentos de prueba válidos antes de activar el ambiente de producción.
5. NIT de la empresa sin inconsistencias en el RUT — errores en la razón social o en el tipo de contribuyente bloquean el proceso en el paso 3.

Los 7 pasos de la habilitación facturación electrónica DIAN

Paso 1 — Ingreso al portal MUISCA de la DIAN
Acceder con el usuario y contraseña del NIT en el portal de la DIAN. Si no hay usuario activo, crearlo con el certificado digital del representante legal. Este paso falla frecuentemente cuando el certificado digital expiró o no coincide con el NIT registrado.

Paso 2 — Registro como facturador electrónico
Dentro de MUISCA, ir a Factura Electrónica → Habilitación como facturador electrónico. Seleccionar la modalidad: Software propio si la empresa tiene desarrollo interno, o Proveedor tecnológico si se usa un e-Provider como Alanube. La mayoría de integraciones de ISVs y SaaS usan la modalidad de proveedor.

Paso 3 — Registro del software de facturación
Si se eligió software propio, registrar el sistema con nombre, versión y URL del endpoint de transmisión. Si se eligió proveedor tecnológico, el e-Provider (Alanube) ya tiene su software registrado — solo hay que vincularlo al NIT del emisor. La DIAN asigna un softwareID que se usará en todos los documentos XML.

Paso 4 — Generación del set de prueba
Este es el paso donde el 80% de las integraciones fallan. La DIAN genera un set de prueba con documentos específicos que el sistema debe emitir correctamente en formato UBL 2.1 firmado digitalmente. Los documentos del set incluyen: facturas de venta con distintos tipos de IVA, notas crédito, notas débito, y casos de error controlado.

Errores comunes en el set de prueba:

• Firma digital inválida — certificado no reconocido por la DIAN o algoritmo de canonicalización incorrecto.
• Campo InvoiceTypeCode incorrecto para el tipo de documento del set.
• CUFE mal calculado — el algoritmo de cálculo del CUFE usa SHA-384, no SHA-256.
• Formato de fecha incorrecto — debe ser ISO 8601: YYYY-MM-DD.

Paso 5 — Envío y aprobación del set de prueba
Una vez generados, los documentos se envían a la DIAN a través del webservice de habilitación (endpoint distinto al de producción). La DIAN valida cada documento y devuelve un ApplicationResponse con el resultado. Si alguno falla, el set completo se rechaza y hay que corregir y reenviar.

Paso 6 — Solicitud de numeración de facturación
Con el set de prueba aprobado, solicitar en MUISCA la numeración autorizada de facturación: prefijo, rango inicial y final, y vigencia. La DIAN emite una resolución de numeración que debe incluirse en cada factura emitida en producción.

Paso 7 — Activación en ambiente de producción
Con la numeración activa, el sistema queda habilitado para emitir facturas electrónicas con validez fiscal. El endpoint de producción es distinto al de prueba — verificar que el proveedor tecnológico actualiza automáticamente el routing.

Errores frecuentes en la habilitacion facturacion electronica DIAN por paso

Qué cambia técnicamente después de la habilitación

Una vez completada la habilitacion facturacion electronica DIAN, el sistema de facturación opera con tres cambios técnicos permanentes:

• Endpoint de producción activo: el webservice de transmisión cambia del ambiente de habilitación al de producción. Las URLs son distintas y el e-Provider debe actualizarlas.
• Resolución de numeración obligatoria: cada factura debe incluir el número de resolución DIAN, prefijo, y número consecutivo dentro del rango autorizado. Fuera del rango, la factura es inválida.
• CUFE obligatorio en cada documento: el Código Único de Factura Electrónica se calcula por documento y la DIAN lo valida en tiempo real. Un CUFE incorrecto resulta en rechazo inmediato.

Cómo conectar la habilitación con la API de Alanube

Alanube opera como e-Provider autorizado ante la DIAN, lo que significa que el proceso de habilitacion facturacion electronica DIAN se simplifica significativamente: el equipo de Alanube gestiona el registro del software, el set de prueba técnico y la vinculación del NIT al ambiente de producción. El developer solo necesita aportar los datos del emisor y las credenciales del RUT.

Una vez activa la habilitación, la integración técnica se hace a través de la API REST de Alanube con un único endpoint de emisión:

POST https://api.alanube.co/v1/col/invoices
Authorization: Bearer {token}
Content-Type: application/json

{
  "issuer": {
    "nit": "900123456",
    "name": "Empresa Ejemplo SAS",
    "resolutionNumber": "18764023349205"
  },
  "receiver": {
    "nit": "800987654",
    "name": "Cliente Ejemplo SA"
  },
  "items": [
    {
      "description": "Servicio de consultoría",
      "quantity": 1,
      "unitPrice": 5000000,
      "taxRate": 19
    }
  ]
}

La API de Alanube gestiona internamente la construcción del XML UBL 2.1, el cálculo del CUFE, la firma digital con el certificado del emisor y la transmisión a la DIAN. La respuesta incluye el CUFE validado y las URLs del XML firmado y el PDF de representación gráfica.

Para explorar la integración completa antes de completar la habilitación, el Sandbox de Alanube para Colombia permite probar el ciclo completo de emisión sin afectar el ambiente productivo de la DIAN.

Preguntas frecuentes sobre la habilitación facturación electrónica DIAN

¿Cuánto tiempo tarda el proceso de habilitación facturación electrónica DIAN?

El proceso completo toma entre 3 y 10 días hábiles, dependiendo de si el set de prueba se aprueba en el primer intento. El paso más demorado es la corrección del set de prueba cuando hay errores de firma digital o CUFE — cada ciclo de corrección-envío puede tomar 1-2 días adicionales.

¿Se puede emitir facturas mientras se está en proceso de habilitación?

No. Las facturas emitidas durante el proceso de habilitación no tienen validez fiscal ante la DIAN. Solo se pueden emitir documentos de prueba en el ambiente de habilitación hasta que la resolución de numeración esté activa en producción.

¿Qué pasa si la numeración DIAN se agota?

Cuando el consecutivo llega al número final de la resolución, el sistema no puede emitir más facturas hasta que se solicite una nueva resolución de numeración en MUISCA. El proceso de renovación es más simple que la habilitación inicial — no requiere un nuevo set de prueba.

¿La API de Alanube gestiona la habilitacion facturacion electronica DIAN automáticamente?

Alanube acompaña el proceso de habilitación como e-Provider autorizado: gestiona el registro técnico del software, el set de prueba y la vinculación en producción. El contribuyente debe aportar sus credenciales MUISCA y los datos del RUT — esa parte no puede delegarse a un tercero por regulación de la DIAN.

Empieza la integración antes de completar la habilitación

Con el Sandbox de Alanube puedes desarrollar y probar la integración completa con la DIAN mientras el proceso de habilitación está en curso — sin afectar el ambiente productivo.

Solicita acceso al Sandbox de Alanube para Colombia →

Fuentes

Dirección de Impuestos y Aduanas Nacionales. (2020). Resolución 042 de 2020 — Sistema de Facturación Electrónica. https://www.dian.gov.co

Dirección de Impuestos y Aduanas Nacionales. (2023). Anexo Técnico de Factura Electrónica de Venta versión 1.9. https://www.dian.gov.co