CUFECheck.co / Guía práctica

El código QR de la factura electrónica: qué contiene y cómo consultarlo

El QR no guarda la factura: guarda una dirección del catálogo de la DIAN con el CUFE dentro. Leerlo bien evita copiar 96 caracteres a mano.

Visual abstracto de verificación CUFE con factura electrónica colombiana
Revisado por el equipo editorial de CUFECheckActualizado

Usar el QR de la representación gráfica para consultar la factura en la DIAN sin errores de copia.

Qué hay dentro del QR

El anexo técnico de factura electrónica de venta de la DIAN (versión 1.9) define el contenido del QR en la extensión sts:QRCode del XML: una dirección del catálogo con la forma https://catalogo-vpfe.dian.gov.co/document/searchqr?documentkey=CUFE, donde la palabra CUFE se reemplaza por el CUFE de la factura o el CUDE del documento, es decir, el valor de la etiqueta cbc:UUID. Nada más: ni el emisor, ni el valor, ni la fecha van en el QR.

Por eso el QR de una factura y el CUFE son la misma información en dos formatos. Quien tiene el QR tiene el CUFE sin riesgo de copiarlo mal, que es la primera causa de consultas fallidas. El anexo también fija el tamaño mínimo del código bidimensional en 2 cm, para que lo lean distintos dispositivos.

Cómo leerlo

Desde el celular basta la cámara o cualquier lector de QR apuntando al PDF en pantalla o al papel. Desde el computador, la mayoría de visores de PDF no leen QR: usa la cámara del teléfono sobre la pantalla, o pide el XML y copia el CUFE. Lo que obtienes al leerlo es una dirección web; si empieza por catalogo-vpfe.dian.gov.co y contiene documentkey seguido de 96 caracteres, es el QR oficial.

Ten cuidado con los reenvíos: una factura fotografiada y comprimida por una aplicación de mensajería suele dejar el QR ilegible o, peor, legible a medias. Un QR que devuelve una dirección con un CUFE de menos de 96 caracteres, o con caracteres fuera del rango hexadecimal, está dañado y su consulta fallará. En ese caso, el XML original es la fuente.

El mismo mecanismo vale para las notas crédito y débito y para los demás documentos electrónicos: su QR lleva la misma forma de dirección, con el CUDE del documento en lugar del CUFE. Y en una recepción de facturas con volumen, leer el QR al recibir el papel o el PDF es la forma más rápida de registrar el código correcto en el sistema sin teclearlo: la persona que recibe escanea, el código queda guardado y la consulta se hace después, en lote o una a una.

Del QR a la consulta oficial

Al abrir la dirección del QR, el catálogo de la DIAN prepara la consulta de ese documento. Como cualquier búsqueda en el catálogo hoy, puede pedirte completar la casilla de comprobación humana y el NIT del emisor o del receptor antes de mostrar el resultado; si aparece el mensaje «solicitud bloqueada por controles de seguridad», este sitio tiene una guía con el recorrido completo.

CUFECheck acepta la URL del QR tal cual: pégala en el campo de consulta y la herramienta extrae el CUFE, comprueba que tiene 96 caracteres hexadecimales y te abre el catálogo con el código cargado. Si además le entregas el XML, contrasta que el CUFE del QR es el mismo que el del documento, un control sencillo contra PDF editados.

Lo que el QR no garantiza

Un QR legible y una dirección oficial no prueban que la factura exista ni que esté vigente: prueban que alguien generó una representación gráfica con ese código. La prueba está en el catálogo, cuando muestra el documento validado y sus datos coinciden con lo que te facturaron. Y como con el XML, el catálogo tampoco dice si el proveedor sigue activo ni si el bien se entregó.

El orden de trabajo razonable es el mismo de siempre: QR o XML para obtener el CUFE limpio; catálogo para el estado del documento; RUT o registro mercantil para el proveedor; y una constancia con la hora de cada consulta junto a la factura.

Lista rápida antes de decidir

  • El QR contiene una dirección del catálogo de la DIAN con el código del documento como parámetro (documentkey).
  • Léelo con la cámara del celular o con un lector de QR sobre el PDF; el texto que sale es una URL, no la factura.
  • Pega esa URL completa en CUFECheck: extrae el CUFE de los 96 caracteres y te abre la consulta oficial.
  • El anexo técnico exige un QR de al menos 2 cm en la representación gráfica; si no se lee, pide el PDF original o el XML.
  • Si la URL del QR no apunta a catalogo-vpfe.dian.gov.co, no es el QR oficial de la DIAN.

Preguntas frecuentes

¿Escanear el QR ya verifica la factura?

No. Escanearlo te lleva a la consulta oficial de ese documento en el catálogo de la DIAN; la verificación ocurre cuando el catálogo muestra el documento y comparas sus datos con tu XML. Hoy el catálogo pide además una comprobación humana en cada consulta.

El QR de mi PDF no se deja leer. ¿Qué hago?

Pide el XML al emisor y copia el CUFE de la etiqueta cbc:UUID, o pide el PDF original (no una foto ni un reenvío comprimido). El anexo técnico fija un tamaño mínimo de 2 cm para el QR justamente para que se lea en cualquier dispositivo.

Este sitio reemplaza el catálogo de la DIAN?

No. CUFECheck ayuda a consultar el catálogo público, pero no sustituye el portal de la DIAN ni el criterio de tu contador o revisor fiscal.

El reporte PDF es una certificación DIAN?

No. Es un reporte PDF de verificación no oficial con fecha y hora de consulta. No es una constancia, certificado ni aval emitido por la DIAN.

Que pasa si el CUFE no aparece?

Verifica que pegaste el CUFE completo, sin espacios ni caracteres faltantes. Si el documento sigue sin aparecer, valida directamente en la DIAN y solicita soporte al emisor.