DIAN factura electrónica en Odoo (Colombia 2026): guía operativa

Qué exige DIAN en 2026

La factura electrónica en Colombia no es PDF firmado. Es un XML estructurado que pasa por validación previa de DIAN — antes de llegar al cliente. Si el XML no cumple, DIAN devuelve código de rechazo y la operación se descarta: no se vendió ni se reportó.

Los tres pilares operativos en 2026:

1. CUFE (Código Único de Factura Electrónica)  — hash SHA-384 generado a partir de los campos críticos del documento (NIT emisor, NIT receptor, monto, fecha, software ID, autorización DIAN). Cualquier cambio posterior invalida el CUFE — y por tanto la factura.
2. RADIAN (Registro de Facturas Electrónicas como Título Valor)  — obligatorio desde 2024 si tu factura entra en circulación como instrumento de cobro. Sincronización con DIAN cada vez que hay evento (aceptación, endoso, pago). Sin sincronizar, no es negociable.
3. Validación previa  — DIAN ya no recibe acumulados. Cada documento se valida en línea contra su set de reglas (UBL 2.1 + adendas colombianas). Latencia típica: 2–8 segundos. Si tu Odoo no maneja reintentos asíncronos, vas a tener facturas «en limbo» cada semana.

Configuración del módulo l10n_co paso a paso

El módulo de localización colombiana viene con Odoo Community y Enterprise. Lo que no viene es el conector certificado con DIAN — eso lo añade un módulo de terceros (Vauxoo, Bistec, Tridian, Carvajal). Antes de elegir proveedor, verifica tres cosas:

• Que esté en la lista de software autorizado por DIAN  (Resolución DIAN 042 de 2020 + adendas).
• Pide el número de autorización del software  — no es opcional, debe aparecer en cada XML emitido.
• Confirma que soporte RADIAN sincronía bidireccional, no solo emisión.

#1. Configuración de empresa

En Configuración → Empresas → Tu empresa:

• NIT con dígito de verificación en el campo correcto. Error común: meter NIT-DV junto en el VAT field; Odoo entonces falla la validación al generar el XML.
• Régimen tributario  (Común / Simplificado / Responsable de IVA) — afecta la estructura de impuestos en cada documento.
• Actividad económica CIIU  — sin esto, DIAN rechaza la primera factura del periodo.
• Resolución de facturación vigente (número, fecha, rango autorizado, fecha vencimiento). Si la resolución se vence y no la renuevas con 15 días de anticipación, paras emisión.

#2. Impuestos y retenciones

Activa los impuestos colombianos desde Contabilidad → Configuración → Impuestos. Críticos:

• IVA 19%, 5%, 0%, Excluido (mapeados a códigos DIAN correctos).
• Retención en la fuente por renta (Rete-fuente) — el porcentaje cambia según concepto y régimen del proveedor.
• Retención de IVA (Rete-IVA) — aplica solo si eres Gran Contribuyente o Agente de Retención.
• Retención de ICA — municipal, depende de ciudad y actividad.

El error típico: dejar los códigos de impuesto de la instalación demo. La factura sale pero DIAN responde FAU01b — Código de impuesto no corresponde con régimen.

#3. Conector DIAN

Cualquiera que elijas, los pasos en común:

1. Cargar el certificado digital de firma electrónica  (P12, con clave). Suele durar 1–2 años — renovar es trámite aparte con tu Cámara de Comercio.
2. Cargar resolución DIAN  (PDF de la autorización), con rango de numeración y fechas.
3. Configurar ambiente: pruebas (habilitación) primero, producción después de validar 50 facturas con DIAN OK.
4. Activar colas asíncronas en Odoo (queue_job). Sin esto, cada emisión bloquea el thread HTTP del usuario por 5–8 segundos.

Errores típicos que rebota DIAN — caso anónimo

Auditoría reciente en una distribuidora del Valle del Cauca, 1.200 facturas/mes. El 22% rebotaba en DIAN.

Causas, en orden de frecuencia:

1. FAU03b · Hash CUFE no coincide  — el conector estaba recalculando CUFE después de aplicar descuento por pronto pago, pero usaba el monto antes del descuento. Resultado: hash inválido. Solución: parchar el connector para recalcular en el orden correcto (descuento → impuesto → CUFE).
2. FAJ50 · Comprador inexistente en RUT DIAN  — cliente recién creado, NIT mal digitado por el vendedor en el TPV. Validación previa client-side resolvería el 90% de estos casos. Mejor: integrar con el Servicio de Consulta de NIT de DIAN antes de guardar el cliente.
3. FAB05 · Total no corresponde con la sumatoria  — redondeo. Odoo redondea por línea, DIAN espera redondeo al total. Configurar regla de redondeo: Round per line debe estar OFF para Colombia.
4. FAB23 · Resolución vencida  — la facturación operó dos semanas con resolución expirada porque nadie monitoreaba la fecha. Implementa alerta automática a 30, 15 y 5 días.

"Después del ajuste, la tasa de rechazo cayó de 22% a 1,4%. El costo de NO ajustar: 264 facturas/mes que no se cobraban hasta refacturación manual — aprox. $48M COP en CxC añeja innecesaria."

Nómina electrónica como extensión natural

Si ya tienes factura electrónica corriendo, nómina electrónica (NE) es la siguiente capa. DIAN exige reportar:

• Devengo: sueldo, comisiones, horas extras, bonificaciones.
• Deducciones: salud, pensión, retención en la fuente, embargos.
• Aportes patronales: parafiscales, ARL, caja.
• Notas de ajuste cuando hay errores de período anterior.

Los XML de NE comparten infraestructura con factura (mismo certificado digital, mismo conector autorizado), pero el calendario de cargue es independiente: dentro de los 10 días calendario siguientes al pago de nómina.

Dos errores que DIAN castiga más en NE:

1. Reportar nómina sin haber pagado todavía (intentando «anticipar»). DIAN cruza con extractos bancarios reportados por las EPS.
2. Omitir devengos no monetarios (bonos, alimentación) — son deducibles para el empleador, pero solo si están en el XML.

Cuándo no es suficiente y necesitas un partner Gold

El setup self-served con un conector certificado funciona para PYMES con un único establecimiento, menos de 5.000 facturas/mes y sin operación multimoneda. Donde se rompe:

• Multi-empresa con NITs distintos en el mismo Odoo — requiere cada empresa con su propia resolución, certificado, y configuración fiscal aislada. Sin un partner que sepa hacer esto, terminas con facturas firmadas con el certificado equivocado y DIAN no perdona.
• Volumen alto  (más de 10K docs/mes) — necesitas tuning de queue_job, particionamiento de tablas account.move, y monitoreo activo de la cola de validación.
• Integraciones con TPV de terceros  (Manhattan, NCR, Toast) — el CUFE debe generarse en Odoo, no en el TPV; orquestar esto sin race conditions necesita arquitecto con experiencia.
• Auditoría DIAN en curso  — si ya recibiste requerimiento, no es momento de hacer setup self-served. Partner con experiencia en defensa frente a DIAN ahorra meses.

Recursos relacionados:

• Página país Colombia  — l10n, fiscalidad, lista de partners DIAN-experimentados
• Auditoría Odoo de 5 días  — identifica puntos de rechazo, parches necesarios, plan de remediación
• Checklist DIAN 2026 (24 puntos)  — antes de pasar a producción

FAQ

Las preguntas que llegan cada semana en consulta de PYMES colombianas con Odoo + DIAN.