Facturación electrónica DIAN con Odoo: guía para pymes

Casi ninguna pyme le teme a facturar. Le teme a lo que pasa después: ¿la DIAN la aceptó? ¿Por qué la rechazó? ¿Dónde está el XML que pide el cliente? ¿Quién tiene la clave del portal? Esta guía explica cómo funciona la facturación electrónica en Colombia, qué exige la DIAN para habilitarte y cómo se ve el proceso completo cuando vive dentro de Odoo en vez de en un portal aparte.

El problema no es el impuesto, es no saber en qué quedó la factura

La facturación electrónica es obligatoria para la inmensa mayoría de empresas y personas naturales que facturan en Colombia. Lo que casi nadie te cuenta es que el riesgo diario no está en la norma sino en la operación: una factura emitida con un rango de numeración vencido, un NIT sin dígito de verificación, un cliente que reclama el XML tres días después, una nota de crédito hecha “a mano” que no recorrió el circuito de validación. Cada uno de esos huecos termina en dos sitios: en una sanción del Estatuto Tributario, que va desde multas hasta el cierre del establecimiento, o en una cartera que no se cobra porque el documento no es válido.

Y el patrón se repite: el problema rara vez es la DIAN. Es que el estado del documento vive lejos del documento.

Cómo funciona la facturación electrónica en Colombia, explicado simple

El modelo colombiano es de validación previa: la factura no existe jurídicamente hasta que la DIAN la valida. En la práctica, cada factura recorre cinco pasos:

• Se genera un XML con la estructura que exige la DIAN (formato UBL 2.1 adaptado a Colombia).
• Se firma digitalmente con el certificado del emisor o del software habilitado.
• Se calcula el CUFE, el código único que identifica esa factura y que aparece impreso junto al código QR.
• La DIAN valida el documento y responde: acepta o rechaza, con un motivo si rechaza.
• Se entrega al cliente la representación gráfica (PDF con QR) junto con el XML y la respuesta de validación.

Las notas de crédito y de débito recorren exactamente el mismo circuito. Por eso “corregir una factura” en Colombia nunca es editarla: es emitir otro documento electrónico que la referencia.

Para poder emitir, la empresa debe estar habilitada ante la DIAN: tener una resolución de facturación con su prefijo, su rango de numeración y su clave técnica, y haber decidido con qué software factura (un proveedor tecnológico, la solución gratuita de la DIAN o un software propio habilitado).

Qué resuelve Odoo, paso por paso

La localización colombiana de Odoo integra la facturación electrónica en el mismo flujo contable, así que el ciclo completo ocurre desde la factura y no desde un portal externo. Así se ve con Odoo 19:

1. Emisión y validación en un solo envío

Confirmas la factura, pulsas Enviar y marcas dos casillas: DIAN y correo electrónico. Odoo genera el XML jurídico, lo firma, produce el CUFE y envía el documento a la DIAN, que lo valida de forma sincrónica. Al cliente le llega un archivo .zip con el XML, la respuesta de validación y el PDF con su código QR.

2. La respuesta queda en la factura

Cada factura tiene una pestaña DIAN con la Fecha de firma, el Estado y los botones Descargar y Obtener documento adjunto. No hay que entrar a otro sistema para saber si fue aceptada: el estado vive en el documento.

3. Corregir también es electrónico

Desde una factura confirmada, el botón Añadir nota de crédito ofrece el Método de crédito que necesites: reembolso parcial, completo, o completo con nuevo borrador de factura. La nota de débito se crea con Añadir nota de cargo y puede copiar las líneas del original. Ambas recorren el mismo circuito de firma y validación.

4. Cuando la DIAN rechaza, te dice por qué

Si la DIAN rechaza el documento, el mensaje de error aparece junto al campo Estado de la propia factura. Lo habitual es un dato maestro incompleto: el NIT del cliente sin dígito de verificación, una responsabilidad fiscal mal marcada, un impuesto sin retención asociada. Se corrige el dato y se vuelve a procesar el XML. Sin llamadas y sin adivinar.

5. La contabilidad ya viene puesta

La localización trae el plan de cuentas basado en el PUC, las retenciones de ICA, IVA y Fuente asignadas a los impuestos, y los certificados de retención dentro de los reportes de Declaraciones colombianas. La factura electrónica no es una isla: alimenta la contabilidad que después declaras.

Checklist de habilitación: lo que debe estar listo antes de la primera factura

La primera factura se gana en la configuración, no en el software. Este es el orden que seguimos en cada implementación:

1. Datos de la empresa completos. NIT con dígito de verificación al final (precedido por guion), dirección, régimen fiscal y las obligaciones y responsabilidades que aparecen en el RUT (por ejemplo O-13, O-15, O-23, O-47).
2. Resolución de facturación vigente en el portal de la DIAN, con prefijo, rango de numeración, fechas de vigencia y clave técnica.
3. Diario de ventas configurado en Odoo con esa misma resolución: prefijo, rango y clave técnica tienen que coincidir carácter por carácter con lo que dice el portal. Si no coinciden, no sale ni la primera.
4. Impuestos y retenciones revisados. Que cada producto o servicio tenga su IVA correcto y que las retenciones (Fuente, ICA, IVA) estén asociadas a los impuestos que aplican.
5. Datos maestros de clientes. Tipo de documento, NIT o cédula con dígito de verificación, responsabilidades fiscales y correo electrónico de recepción de facturas. La mayoría de rechazos se originan aquí.
6. Set de pruebas superado. Antes de emitir en producción, la DIAN exige completar las pruebas de habilitación. Hacerlo con datos reales de tu operación (no con ejemplos) evita sorpresas en la primera semana.
7. Un responsable con nombre. Quién revisa a diario los documentos rechazados y quién custodia la resolución y las credenciales. Sin esto, el mejor software se convierte en un portal más que nadie mira.