Inconvenientes con la Lectura de QR - DIAN

De tfhkacolwiki
Revisión del 21:12 31 jul 2025 de Imacias (discusión | contribs.)
(difs.) ← Revisión anterior | Revisión actual (difs.) | Revisión siguiente → (difs.)
Ir a la navegación Ir a la búsqueda


11.1.7 Código Bidimensional «QR»


De acuerdo con el parágrafo 1 del artículo 35 de la resolución 000165 de 1 de noviembre de 2023:
Para efectos del numeral 16 del artículo 11 de esta resolución, se debe incluir el Código de respuesta rápida -Código QR-, de conformidad con las condiciones, términos y mecanismos técnicos y tecnológicos establecidos por la Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales -DIAN, en el «Anexo Técnico de la factura electrónica de venta».
El tamaño mínimo que debe tener el código bidimensional QR es de 2cm para facilitar la lectura por los diferentes dispositivos. La Representación Gráfica La representación gráfica puede ser diseñada de acuerdo con las necesidades del OFE; como la generación está en formato XML, entonces cualquier herramienta informática de conversión de este formato a .pdf, .docx, u otros formatos digitales será suficiente para cumplir con lo previsto en la normatividad vigente. El requisito que debe cumplir es la inclusión del código bidimensional QR tal como se precisa arriba. Una alternativa a los formatos digitales es la impresión en papel de la representación gráfica diseñada de acuerdo con las necesidades del OFE. El requisito que debe cumplir es la inclusión del código bidimensional QR tal como se precisa arriba. La representación gráfica debe incluir el código QR en todas las páginas de los formatos digitales y de la impresión en papel de la factura electrónica. La representación gráfica siempre será “una representación, una imagen” de la información consignada en el formato XML de los perfiles de transacciones comerciales para la DIAN. Esto significa que el documento electrónico siempre será el que tenga valor legal para las autoridades nacionales. Si cualquier persona requiere validar la autenticidad de una representación gráfica, entonces deberá acceder al sitio web que la DIAN disponga para ello, activar el hiperenlace, diligenciar los campos de información, disparar el botón de Validación, y comparar lo que le muestra la respuesta devuelta por el sistema de facturación electrónica de la DIAN con lo que le exhibe la representación que tiene a la mano, y proceder en consecuencia. Si la información difiere, podrá denunciar el hecho a la DIAN, porque puede tratarse de un documento apócrifo, sin validez legal, y que podría ser la evidencia de una acción que amerita ser investigada fiscalmente, con las implicaciones comerciales

Detalle Xpath
NumFac:

[NUMERO_FACTURA]

/root/cbc:ID
FecFac: [FECHA_FACTURA]

/root/cbc:IssueDate

HorFac:

[HORA_FACTURA(con GMT)]

/root/cbc:IssueTime

NitFac: [NIT FACTURADOR] /root/cac:AccountingSupplierParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyI

D

DocAdq:

[NUMERO_ID_ADQUIRENTE]

/root/cac:AccountingCustomerParty/cac:Party/cac:PartyTaxScheme/cbc:Compan

yID

ValFac: [VALOR_FACTURA] /root/cac:LegalMonetaryTotal/cbc:LineExtensionAmount

/root/cac:RequestedMonetaryTotal/cbc:LineExtensionAmount

ValIva: [VALOR_IVA] /root/cac:TaxTotal/cbc:TaxAmount Donde

/root/cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID = 01

ValOtroIm:

[VALOR_OTROS_IMPUESTOS]

Sumatoria de /root/cac:TaxTotal[X]/cbc:TaxAmount[X] Donde

/root/cac:TaxTotal[X]/cac:TaxSubtotal[X]/cac:TaxCategory[X]/cac:TaxScheme[X]/c bc:ID[X] sea diferente a 01

ValTolFac:

[VALOR_TOTAL_FACTURA

/root/cac:LegalMonetaryTotal/cbc:PayableAmount o

/root/cac:RequestedMonetaryTotal/cbc:PayableAmount

CUFE /root/cbc:UUID
QRCode /root/ext:UBLExtensions/ext:UBLExtension/ext:ExtensionContent/sts:DianExtensi

ons/sts:QRCode


Ejemplo:
Teniendo en cuenta los datos de entrada, se presenta el código QR que se incluye en la representación gráfica de la factura electrónica:

NumFac:323200000129
FecFac:2019-16-01
HorFac:10:53:10-05:00
NitFac:700085371
DocAdq:800199436
ValFac:1500000.00
ValIva:285000.00
ValOtroIm: 0.00
ValTolFac:1785000.00
CUFE:e5bac48e354bc907bccff0ea7d45fbf784f0a8e7243b58337361e1fbd430489d



El código QR (Quick Response) es un componente de seguridad y control indispensable en la representación gráfica (el archivo PDF o la imagen) de las Facturas Electrónicas de Venta, Notas Débito y Notas Crédito. Su propósito no es almacenar los datos de la factura, sino servir como un puente directo y seguro para verificar la validez y existencia del documento electrónico tal como fue validado por la DIAN.
Esta guía detalla su base normativa, su funcionamiento operativo y las especificaciones técnicas conforme a los Anexos Técnicos vigentes (versiones 1.8 y 1.9) y aclaraciones prácticas.

Fundamento Normativo

La exigencia de incluir un código QR no es opcional; es un requisito legal definido por la DIAN para garantizar la autenticidad e integridad de los documentos electrónicos.

Mandato Legal:
Resoluciones como la Nº 000042 de 2020 y sus modificaciones posteriores, junto con sus Anexos Técnicos (versión 1.8 y la más reciente 1.9), establecen que la representación gráfica de la factura electrónica debe incluir de forma visible un código de barras bidimensional QR.

Mecanismo de Control:
El QR es, junto al CUFE (Código Único de Factura Electrónica) o CUDE (Código Único de Documento Electrónico), uno de los principales mecanismos de control. Permite que cualquier actor (comprador, transportista, autoridad fiscal, etc.) pueda validar el documento de forma inmediata

Que función cumple el QR

El rol del código QR es específico y a menudo malinterpretado. Su función es de verificación, no de almacenamiento de datos.

Su función Principal:
Al ser escaneado por un dispositivo (como un smartphone), el código QR debe redirigir automáticamente a la URL de consulta oficial de la DIAN.

Verificación:
En el portal de la DIAN, el sistema muestra la información clave del documento electrónico (el archivo XML) que fue previamente validado. Esto permite al usuario comparar los datos del PDF con la información oficial y confirmar:

a) Que la factura existe y fue validada por la DIAN
b) Que los datos clave (emisor, receptor, valores, etc.) no han sido alterados.

Especificaciones Técnicas Detalladas (Según Anexo Técnico 1.9)

Los anexos técnicos son extremadamente precisos sobre el contenido que debe codificarse en la imagen QR.

Contenido del Código: El QR debe contener únicamente la URL que dirige al "Documento en el portal web de la DIAN".
Estructura de la URL: La URL se construye utilizando el CUFE o CUDE del documento, asegurando que la consulta sea única e inequívoca. La estructura es la siguiente:
URL de la DIAN + "NumFE=" + CUFE/CUDE



Ejemplo de URL a codificar (tomado del Anexo Técnico):

https://catalogo-vpfe.dian.gov.co/User/Login?ReturnUrl=%2fdocument%2fsearch%3fdocumentkey%3d[Aquí va el CUFE o CUDE del documento]

Generación del CUFE/CUDE:

Este código alfanumérico, que es la "llave" para la URL, se genera concatenando 14 campos específicos de la factura, entre ellos:

A) Número de factura (NumFac)
B) Fecha y Hora de Generación (FecGen y HorGen)
C) Valor Bruto y Valor de Impuestos (ValFac, ValIva, ValIca, ValImpo)
D) NIT del facturador, del adquirente y la clave técnica.
E) El resultado se procesa con un algoritmo de encriptación (SHA-384).


Visibilidad:

El código QR debe ser visualmente claro y tener un tamaño suficiente para ser escaneado sin dificultad en la representación gráfica.

Inconvenientes con la lectura del codigo QR con sistemas IOS

Debido al problema que se ha venido presentando en la lectura de los códigos QR en dispositivos móviles con sistema operativo IOS, Se realizaron las respectivas validaciones y pruebas;

1. Si la información del código QR contiene un enlace URL que apunta a un sitio web específico. Se puede escanear el código QR utilizando la cámara del Iphone de la siguiente manera:

  1. Abre la aplicación de la cámara en el iPhone.
  2. Apunta la cámara hacia el código QR. Asegúrese de que el código QR esté bien enfocado en la pantalla.
  3. El iPhone debería detectar automáticamente el código QR y mostrar una notificación en la parte superior de la pantalla.
  4. Toca la notificación que aparece en la parte superior para abrir el enlace web.



2. Si el código QR contiene información en formato de texto, como se encuentra establecido en el anexo técnico 1.8 del 01 de noviembre del 2023. Para procesar esta información, necesitarás una aplicación de escáner de códigos QR que pueda leer y analizar el contenido del código QR. Puede seguir estos pasos:

  1. Abre la App Store en el iPhone.
  2. Busca "lector de códigos QR" o "QR code scanner" en la barra de búsqueda.
  3. Selecciona una aplicación de escáner de códigos QR de su elección e instálala en el iPhone. Algunas aplicaciones populares incluyen "QR Code Reader" o "QR Code Scanner".
  4. Abre la aplicación que has instalado.
  5. Utiliza la cámara del iPhone para escanear el código QR que contiene la información.
  6. La aplicación debería leer el contenido del código QR y mostrar la información en pantalla.


En resumen, la forma en que escanea un código QR en el iPhone depende del contenido del código QR. Puede abrir enlaces web directamente desde la cámara de tu iPhone, pero para procesar otro tipo de información, necesitará una aplicación de escáner de códigos QR.
Nosotros como The Factory Hka cumplimos con la generación del código QR estándar con la estructura que establece la Dian según el anexo técnico 1.9 del 01 de noviembre del 2023.
Puede realizar una prueba, descargando la factura que emite la Dian hay se puede evidenciar que ese código que genera la Dian tampoco se puede escanear.

Ingrese a la página de la Dian https://catalogo-vpfe.dian.gov.co/User/Login

Buscar documento --> Pegamos el cufe la factura --> Le damos click en Buscar --> Descargamos el pdf de la factura que genera la Dian, en la segunda hoja podemos evidenciar el QR que genera la Dian, se intenta escanear tampoco nos arroja la información.