Cómo automatizar la descarga de facturas de la DIAN con IA (Claude)

Cada mes es lo mismo. Entras a «Facturando electrónicamente», esperas el correo con el enlace de acceso, filtras las fechas y bajas los documentos recibidos de a uno. Si llevas varias empresas, lo repites por cada una, y el enlace vence en una hora: si te interrumpen a la mitad, vuelves a empezar.

Nada de eso exige criterio contable. Es recorrer un portal. Y recorrer un portal es justo lo que un asistente de IA puede hacer por ti si le das las herramientas.

Qué se puede automatizar y qué no

La DIAN no ofrece una API para que un contador consulte las facturas que recibió una empresa. Lo que hay es el portal, con su enlace de acceso por correo, y una búsqueda pública por CUFE protegida con captcha. Automatizar la descarga, entonces, es recorrer esas mismas pantallas con un navegador, sin que tengas que hacerlo tú.

Eso hace ContAuxi, y lo expone a tu asistente de IA por medio de un conector MCP: el estándar que usan Claude y otros asistentes para usar herramientas externas. Tú le hablas normal al asistente, el asistente llama a la herramienta, y ContAuxi recorre la DIAN.

Lo que no se puede automatizar del todo es el acceso. El enlace de la DIAN llega a tu correo y vence en una hora, así que cada consulta por periodo necesita que alguien lo genere. Es una medida de seguridad de la DIAN, y está bien que siga ahí.

Lo que necesitas

• Una cuenta de ContAuxi. No hace falta conectar Alegra ni Siigo: al registrarte eliges «Descargar mis facturas de la DIAN» y con el nombre y el NIT de la empresa basta.
• Un asistente con conectores MCP. Lo usamos y lo probamos con Claude.
• Uno de estos dos insumos, según lo que necesites: el enlace de acceso de la DIAN para un periodo completo, o los CUFE de documentos puntuales.

Vía 1: el mes completo, con el enlace de acceso

Es la vía para el cierre del mes. Entras a catalogo-vpfe.dian.gov.co/User/CompanyLogin, la DIAN te manda un correo con el botón «Ingrese aquí», y en vez de abrirlo le das clic derecho y copias la dirección del enlace. Ese enlace se lo pegas al asistente con el periodo:

«Descárgame las facturas recibidas de septiembre. Este es el enlace de la DIAN: …»

La consulta tarda minutos, no segundos: cada documento se descarga por separado. El asistente la lanza y te avisa cuando termina. Al final tienes:

• Un ZIP con los XML (el documento con validez legal), los PDF y un resumen.csv con qué se bajó, de quién y por cuánto.
• El detalle de cada factura en la conversación: emisor, NIT, número, fecha y valor.
• El IVA del periodo discriminado por tarifa y el total por proveedor, ya sumados. Le puedes preguntar ahí mismo «¿cuánto IVA descontable tengo en septiembre?» o «¿qué le compré a este proveedor?».

El enlace de la DIAN viaja en la consulta y no se guarda: cuando vence, ya no sirve para nada.

Vía 2: una lista de CUFE, desde el Excel de la DIAN

A veces no necesitas el mes completo sino documentos concretos. Por ejemplo, los del informe de «Facturas electrónicas adquiridas» que entrega la DIAN, que trae el CUFE de cada factura, o los que te reenvió un cliente.

Para esto no hace falta el enlace de acceso. Usa la búsqueda pública por CUFE, que pide el CUFE y el NIT del emisor o del receptor. Si son facturas recibidas por la empresa, su propio NIT sirve para todas:

«Te paso el Excel de facturas adquiridas de la DIAN. Descárgame los PDF; el NIT de la empresa es 900123456.»

El asistente lee los CUFE del archivo, los manda en lotes de hasta 50 y te entrega:

• Un ZIP con los PDF ya desbloqueados. La DIAN los cifra con el NIT de la búsqueda, y te llegan abiertos.
• Un resumen de cada documento en la conversación: serie, folio, fecha, emisor, IVA y total.
• La cobertura del lote: cuántos pediste, cuántos llegaron y cuáles no.

Cada documento toma del orden de 15 a 25 segundos, así que un lote de 50 se pide y se recoge un rato después. El detalle de la vía por CUFE, paso a paso y a mano, está en cómo descargar una factura electrónica con el CUFE.

Y si las necesitas en Excel

Bajar los PDF es la mitad del trabajo. La otra mitad es pasar a una hoja de cálculo el emisor, las fechas, el subtotal, el IVA y el total de cada uno.

En los planes pagos de ContAuxi, eso también se le pide al asistente. No se hace solo: lo pides tú, al lanzar el lote o después, mientras el lote siga disponible (60 minutos desde que terminó):

«Pásame esas facturas a Excel.»

ContAuxi lee cada PDF con el mismo motor que usa para leer las facturas antes de causarlas, y te entrega un Excel con dos hojas:

• Facturas: una fila por documento, con número, fechas, emisor, adquirente, forma de pago, subtotal, IVA, otros impuestos, total y retenciones.
• Detalle: una fila por cada línea de factura.

Tiene un cupo mensual propio, del mismo tamaño que el cupo de facturas de tu plan pero aparte de él: pasar facturas a Excel no te descuenta de las que registras en el ERP. En el plan gratis se entregan solo los PDF.

Cómo conectarlo

1. Crea tu cuenta en ContAuxi y elige «Descargar mis facturas de la DIAN».
2. Agrega el conector en tu asistente: en la configuración de conectores, uno personalizado con la dirección https://api.contauxi.com/mcp. Te pide iniciar sesión con tu cuenta de ContAuxi.
3. Pídele algo pequeño primero, como las facturas de ayer, para verlo funcionar.

Las instrucciones completas están en la página del conector de ContAuxi para asistentes de IA.

Lo que conviene saber antes

• Una consulta a la vez por usuario. Cada una abre un navegador que recorre la DIAN. Si pides otra mientras hay una en curso, el asistente retoma la que está corriendo.
• Los enlaces de descarga duran una hora. El ZIP y el Excel se entregan por enlace; bájalos cuando lleguen.
• El plan gratis tiene un tope de 30 documentos de la DIAN al mes. En los planes pagos las descargas de la DIAN no tienen tope.
• Descargar no es causar. El conector trae las facturas; proponer las cuentas del PUC, calcular retenciones y registrar en Alegra o Siigo es otro flujo de ContAuxi, que tú revisas.

Preguntas frecuentes

¿Funciona con ChatGPT u otros asistentes?

El conector sigue el estándar MCP, así que en principio cualquier asistente que admita conectores MCP remotos puede usarlo. Lo usamos y lo probamos con Claude; con otros asistentes no lo hemos verificado.

¿Es seguro pegarle al asistente el enlace de la DIAN?

El enlace es de solo lectura, lo generas tú para esa consulta y vence en una hora. ContAuxi no lo guarda: viaja en la consulta y se descarta al terminar.

¿Puedo dejar la descarga programada para que se haga sola cada mes?

Por periodo, no del todo: cada consulta necesita un enlace nuevo de la DIAN, y ese enlace solo llega a tu correo. La vía por CUFE no necesita enlace, pero sí la lista de documentos.

¿Cuánto cuesta?

El conector no tiene costo adicional sobre tu plan. El plan gratis incluye 30 documentos de la DIAN al mes; el Excel con los datos de cada factura es de los planes pagos. Los precios están en la página de precios.

---

ContAuxi es un servicio independiente y no está afiliado a la DIAN ni a Anthropic.