Cómo automatizar la facturación DIAN con n8n (self-hosted) en Colombia

Nos escriben casi cada semana con la misma historia: el negocio ya está obligado a facturar electrónicamente, ya paga su proveedor tecnológico, pero cada factura se arma a mano en un portal. Copiar el NIT del cliente, digitar los ítems, descargar el PDF, mandarlo por correo y guardar el XML en una carpeta. Diez facturas son media hora. Cien facturas son un dolor de cabeza. Y la pregunta que sigue es siempre la misma: ¿esto se puede automatizar con n8n?

Se puede. Pero no como la mayoría lo imagina, y hay una pieza que decide todo el diseño.

¿Qué significa automatizar la facturación DIAN con n8n?

Automatizar la facturación electrónica con n8n es montar un flujo que toma los datos de una venta desde donde ya viven (un formulario, un Excel, un ERP, el POS del local) y los lleva hasta una factura validada por la DIAN, sin que nadie vuelva a escribir en el portal. Sirve para emitir, enviar, archivar y hacer seguimiento de facturas en volumen; no sirve para saltarse la habilitación ni para emitir sin un emisor autorizado.

Y aquí va la aclaración que casi nadie da en los tutoriales: n8n es el orquestador, no el emisor. n8n no se conecta directamente a los servicios de la DIAN para emitir. Lo que hace es llamar la API de un proveedor tecnológico habilitado (o de tu propio software con habilitación, si vas por ese camino) y disparar la emisión desde ahí. Si tu proveedor no tiene API, no hay nada que automatizar.

n8n es una herramienta de automatización de flujos con licencia fair-code (Sustainable Use License). Self-hosted es gratis para uso interno de tu empresa; revenderlo como servicio a terceros requiere licencia comercial.

¿Qué hay que tener listo antes de escribir el primer flujo?

• RUT actualizado y responsabilidad de facturar. Sin esto no hay factura electrónica válida, por más flujo bonito que tengas.
• Habilitación en el portal de la DIAN. El emisor debe estar habilitado; si nunca lo hiciste, ese trámite va primero.
• Proveedor tecnológico habilitado con API documentada. Es el eslabón que casi siempre falla. Pregunta antes de contratar: ¿tienen API REST?, ¿cobran por documento?, ¿tienen ambiente de pruebas?
• Resolución de numeración autorizada con rango vigente, prefijo y fecha de vencimiento.
• Firma electrónica, si vas a firmar tú el XML. Si el proveedor firma por ti, no la necesitas, pero pierdes control sobre el archivo.
• Fuente de datos de la venta. Si las ventas nacen en un cuaderno o en un chat, la automatización empieza por digitalizar el pedido, no por n8n.
• Un servidor, un dominio y alguien que lo mantenga. Esto no se monta y se olvida.

¿Cuánto cuesta al mes tener n8n self-hosted en Colombia?

Esta es la pregunta que más nos llega por WhatsApp. El servidor es la parte barata; la sorpresa aparece por otro lado.

Precios de lista sin impuestos, con un dólar cerca de los $4.200. Un VPS de 4 GB de RAM aguanta sin problema una operación de varios miles de facturas al mes.

Y lo que casi nunca se suma en los cálculos:

• Dominio: entre $40.000 y $70.000 al año.
• Correo transaccional para enviar las facturas: desde $0 hasta unos $80.000 al mes, según volumen.
• Backups del VPS: entre $5.000 y $20.000 al mes si los contratas aparte.
• Proveedor tecnológico: desde unos $30.000 al mes en planes básicos hasta varios cientos de miles en operaciones grandes. Suele cobrar por documento.
• Tu tiempo o el de alguien más: la hora de ingeniería es el rubro más caro y el que más se ignora.

¿Cómo se monta, paso a paso?

1. Confirma quién emite y con qué habilitación. Antes de tocar un servidor, verifica que tu proveedor tecnológico te da API y en qué ambiente puedes hacer pruebas.
2. Pide las credenciales de la API: token, URL base, endpoints de emisión, consulta de estado y eventos RADIAN. Guarda el manual; lo vas a leer mil veces.
3. Levanta el VPS. Ubuntu LTS, usuario distinto de root, Docker y Docker Compose, firewall activo y fail2ban. Nada de exponer el puerto de la base de datos a internet.
4. Ponle dominio y HTTPS. Un registro DNS apuntando a la IP y un proxy inverso con certificado automático (Caddy o Nginx con Let's Encrypt). n8n necesita URL pública para recibir webhooks.
5. Instala n8n con PostgreSQL, no con SQLite, si vas a producción. Define en las variables de entorno la clave de cifrado, la zona horaria America/Bogota y la URL de webhooks.
6. Guarda las credenciales del proveedor como credenciales de n8n, cifradas. Nunca en un nodo de texto ni en el repositorio.
7. Modela el JSON de la factura. Emisor, adquiriente con tipo de documento y NIT, régimen y responsabilidades tributarias, ítems con código y descripción, cantidades, valor unitario, IVA o INC, descuentos, forma y medio de pago, y moneda. Este es el 70% del trabajo real.
8. Arma el flujo: disparador (formulario, webhook, fila nueva en la hoja de cálculo, evento del ERP) → validación de datos → llamada a la API del proveedor → guardar CUFE, XML y PDF → enviar al cliente → registrar en contabilidad.
9. Valida antes de emitir, no después. NIT del cliente, rango de numeración disponible, fecha, topes de la resolución y campos obligatorios del anexo técnico. Un dato malo emitido se corrige con nota crédito, y eso cuesta tiempo y plata.
10. Blinda los errores. Reintentos con espera, control de idempotencia para no emitir dos veces por un timeout, alerta a WhatsApp o correo cuando algo falle, y respaldo diario de la base de datos.

¿Qué se alcanza a automatizar y qué no?

Lo que sí queda resuelto:

• Emisión y envío de facturas en lote.
• Notas crédito y notas débito.
• Eventos RADIAN: acuse de recibo, recibo del bien o servicio, aceptación expresa, endoso y mandato.
• Recordatorios de pago y conciliación con los pagos recibidos.
• Envío mensual de soportes al contador y reportes de cartera.

Lo que sigue siendo humano:

• La habilitación ante la DIAN y los trámites con el proveedor tecnológico.
• Las decisiones tributarias y la interpretación de la norma.
• La calidad de los datos de origen: si el vendedor escribe mal el NIT, el flujo no adivina.
• La responsabilidad legal del emisor. La automatización no reparte culpas.

¿Cuáles son los errores que más hemos visto?

• Facturas duplicadas por reintentos sin control de idempotencia.
• Numeración desincronizada entre el portal y el flujo.
• Timeout del proveedor que deja la factura emitida pero no registrada en el sistema.
• Certificado de firma vencido un domingo, sin que nadie lo note hasta que un cliente reclama.
• Datos del cliente mal digitados que obligan a emitir nota crédito.
• Actualizar n8n sin respaldo y perder la clave de cifrado, con lo que las credenciales guardadas dejan de funcionar.

¿Cuándo SÍ y cuándo NO conviene montarlo self-hosted?

Cuándo SÍ:

• Emites más de 50 facturas al mes y el trabajo manual ya es un cuello de botella.
• Tus ventas nacen digitales (tienda, formulario, ERP, app propia).
• Tienes a alguien técnico o un aliado que responda cuando algo se caiga.
• Necesitas integrar la facturación con cartera, inventario o contabilidad.
• Quieres controlar el costo por documento a medida que creces.

Cuándo NO:

• Emites 5 o 10 facturas al mes: el portal de tu proveedor es más rápido y más barato.
• No tienes a nadie que administre un servidor y no quieres depender de terceros.
• Tu proveedor tecnológico no ofrece API.
• Estás contra una fecha de cierre y no hay tiempo de pruebas.
• Manejas información muy sensible y no tienes controles de seguridad mínimos.

Preguntas frecuentes

¿n8n puede emitir facturas electrónicas directamente ante la DIAN? No. n8n orquesta el proceso, pero la emisión y la validación las hace un proveedor tecnológico habilitado (o software propio con habilitación). Sin ese emisor, ninguna automatización produce una factura válida.

¿Es legal automatizar la facturación electrónica? Sí. La obligación es emitir, firmar y validar la factura conforme a la normativa de facturación electrónica; el canal técnico que uses es decisión tuya. Esto es información general, no asesoría tributaria: confirma tu caso con tu contador.

¿Cuánto se demora montar el primer flujo? Entre una y tres semanas para una primera versión que emita de verdad, dependiendo de la API del proveedor tecnológico y de qué tan ordenados estén los datos de venta. La parte de n8n es la rápida; modelar y validar datos es la lenta.

¿Qué pasa si una factura sale con datos errados? Se corrige con nota crédito y, si aplica, se emite una nueva. Por eso conviene validar antes de emitir: es mucho más barato detener un flujo que reversar un documento ya validado por la DIAN.

¿Puedo usar n8n Cloud en lugar de self-hosted? Puedes. Cloud te ahorra el servidor y las actualizaciones, y a cambio pagas una suscripción mensual y dependes de su disponibilidad. Self-hosted te da control total y costo de infraestructura bajo, pero el mantenimiento es tuyo.

¿Sirve igual para una empresa que para un taller o una tienda? Sí, cambia la fuente de datos. Un taller dispara la factura al cerrar la orden en su software; una tienda, al confirmar el pago. El flujo hacia la DIAN es el mismo.

Una nota nuestra

Si después de leer esto te queda la sensación de que el cuello de botella no es n8n sino el proveedor tecnológico, estás en lo correcto: es el punto que más frena a las pymes colombianas. En Sitexx montamos automatizaciones con n8n self-hosted para procesos comerciales, y también te decimos con franqueza cuándo no vale la pena. Si emites pocas facturas al mes, nuestro consejo va a ser que te quedes con el portal de tu proveedor; y si el problema real es que te pagan tarde, eso se resuelve con recordatorios, no con un servidor. Si quieres que miremos tu caso, escríbenos por WhatsApp y lo revisamos sin compromiso.