DIANFacturación electrónica

Cómo descargar una factura electrónica con el CUFE, sin entrar a la DIAN

Un cliente te manda un CUFE por WhatsApp y necesitas el documento. No hace falta entrar al portal ni pedir el enlace de acceso: la DIAN tiene una búsqueda pública que casi nadie usa.

6 min de lecturaActualizado el

¿Muchas facturas al mes? ContAuxi las causa por ti en Alegra o Siigo. 30 gratis al mes, sin tarjeta.

Probar gratis

Un cliente te reenvía un CUFE por WhatsApp y te pregunta si esa factura existe. O estás cuadrando un pago y el único soporte es una factura impresa con un QR. En los dos casos necesitas el documento, y la ruta que todo el mundo conoce —entrar al portal de «Facturando electrónicamente»— pide el enlace de acceso que la DIAN manda por correo y que vence en una hora.

Para un documento suelto hay un camino mucho más corto, y es público: no pide iniciar sesión.

Qué es el CUFE

El CUFE es el Código Único de Factura Electrónica: una cadena de 96 caracteres hexadecimales que identifica un documento concreto ante la DIAN. No es el número de la factura ni el prefijo; es una huella del documento completo.

Aparece en tres sitios donde lo tienes a mano sin pedírselo a nadie:

  • Al pie de la representación gráfica (el PDF que te manda el proveedor).
  • Dentro del QR de la factura impresa.
  • En el XML, en el campo UUID.

Las notas crédito y débito electrónicas tienen su equivalente —el CUDE—, y la búsqueda las acepta igual.

El recorrido, paso a paso

La DIAN expone una búsqueda pública de documentos electrónicos en catalogo-vpfe.dian.gov.co/User/SearchDocument. No hay usuario ni contraseña: el formulario pide dos datos y un captcha.

  1. Pega el CUFE en el campo de la clave del documento.
  2. Escribe el NIT. Puede ser el del emisor o el del receptor, indistintamente, y va sin puntos y sin dígito de verificación. Si el NIT es 901.751.722-1, escribes 901751722.
  3. Resuelve el reto de Cloudflare que protege el formulario.
  4. Busca. Si el documento existe, sale su ficha: emisor, receptor, serie, folio, fechas y los eventos registrados.
  5. Descarga el PDF desde el botón de la ficha.

Eso es todo. Sin correo, sin token, sin esperar.

Los tres detalles donde se tropieza

El PDF viene con contraseña, y la contraseña es el NIT. La DIAN cifra el archivo con el mismo NIT que digitaste en la búsqueda. No es un error ni un documento corrupto: ábrelo con ese número, sin puntos ni dígito de verificación.

El NIT tiene que corresponder al documento. Es la causa más común de un «no encontrado» cuando el CUFE está bien copiado. Si el del receptor no funciona, prueba con el del emisor.

Por esta vía no hay XML. La ficha pública entrega solo el PDF, que es la representación gráfica. Para contabilizar necesitas el XML, que es el que tiene validez legal y datos estructurados, y ese vive en el listado de documentos recibidos del portal —la ruta larga, con sesión—. Lo explicamos en cómo descargar las facturas recibidas de la DIAN.

Cuándo sirve cada ruta

Las dos rutas no compiten; resuelven cosas distintas.

Búsqueda por CUFE Documentos recibidos
Qué necesitas CUFE + NIT Enlace de acceso por correo
Caduca No caduca El enlace vive ~1 hora
Qué entrega PDF + ficha ZIP con XML y PDF
Sirve para Un documento concreto Un periodo completo
Sirve para contabilizar No (falta el XML) Sí

En corto: el CUFE es para verificar y para rescatar un documento suelto; el listado es para el cierre del mes.

Qué resuelve de verdad esto en el día a día

Tres situaciones donde la búsqueda por CUFE ahorra una llamada:

  • Verificar que una factura existe y está validada antes de pagarla. La ficha muestra los eventos registrados ante la DIAN, así que ves si el documento es real sin pedirle nada al proveedor.
  • Rescatar el soporte de un gasto cuando solo quedó la impresión o el correo con el QR.
  • Revisar un documento de un cliente del que no administras el portal. No necesitas sus credenciales: con el CUFE y su NIT basta, y el NIT es público.

Ese último punto es el que más cambia el trabajo de quien lleva varias empresas: puedes resolver la pregunta sin pedirle a nadie que se meta a generar un enlace de acceso.

Y cuando no es uno, son veinte

Donde el recorrido manual se cae es en el volumen. Cada documento es un formulario, un captcha y una descarga, y después abrir cada PDF con su contraseña. Para veinte documentos son veinte captchas.

Eso es lo que automatizamos. Desde tu asistente de IA —Claude, con el conector de ContAuxi— le pasas la lista de CUFE (o el Excel de la DIAN que los trae) y el NIT, y te devuelve:

  • Los PDF ya desbloqueados, sin que tengas que teclear el NIT en cada uno.
  • Un resumen de cada documento en la misma conversación —serie, folio, fecha, emisor, IVA y total—, para que puedas preguntarle sobre ellos ahí mismo.
  • Un ZIP con los PDF y la ficha completa de cada uno, por un enlace que vive una hora.
  • En los planes pagos, y solo si lo pides, un Excel con los datos de cada factura leídos del PDF.

Admite hasta 50 documentos en una sola petición y tarda del orden de 15 a 25 segundos por documento, así que un lote grande se pide y se recoge un rato después. Cómo se pide, qué entrega y la otra vía —el mes completo con el enlace de acceso— están en cómo automatizar la descarga de facturas de la DIAN con IA.

Necesitas una cuenta de ContAuxi para usarlo, y nada más: no hay que conectar Alegra ni Siigo. Al registrarte eliges «Descargar mis facturas de la DIAN» y con el nombre y el NIT de la empresa queda lista.


ContAuxi es un servicio independiente y no está afiliado a la DIAN. El recorrido descrito es el de la búsqueda pública del portal, tal como está hoy.

Seguir leyendo