Cómo realizar una solicitud de soporte de ingeniería para IronBarcode

Una descripción concisa y clara del problema

Un buen informe técnico debe incluir suficiente información para reproducir el problema. Imagina que estás reportando el problema a un colega o publicándolo en Stack Overflow.

Un reporte de error debe contener:

• Una descripción clara de los síntomas experimentados y cualquier idea que puedas tener respecto a su causa.
• Entorno: Versión de IronBarcode, sistema operativo y versión de tiempo de ejecución de .NET, (entorno exacto en la nube si es aplicable)
• Tipo de aplicación/proyecto: Azure WebApp/WebJob/Function, ASP.NET MVC, ASP.NET Core, ASP.NET WebForms, aplicación de Windows, WPF, WebAPI (Core/Framework), IIS + versión, etc.

Por favor incluye tantos de los siguientes elementos como sea posible, para dar prioridad a tu ticket.

• Un proyecto de ejemplo que reproduzca completamente el problema
• Un fragmento de código al estilo Stack Overflow (por favor, no capture el código en pantalla)
• Capturas de pantalla de síntomas/excepciones
• Texto del mensaje de excepción (Excepción + Excepción Interna)
• El punto específico de depuración donde el proceso deja de funcionar o se detiene en el código
• Parámetros de entrada y activos: Imagen y PDF.

Escenarios de solicitud de ingeniería habituales en entornos de cumplimiento fiscal español

Los desarrolladores que trabajan con la normativa fiscal española suelen escalar al equipo de ingeniería los siguientes casos extremos:

1. Fallo de codificación QR para VeriFactu (AEAT): La URL de verificación de AEAT incluye los parámetros NIF, serie, fecha, importe total y huella (hash SHA-256). Cuando el conjunto completo de parámetros supera los 200 caracteres, un QR de Versión 3 resulta insuficiente y se producen errores de decodificación en la sede electrónica de la AEAT (sede.agenciatributaria.gob.es). La solicitud de ingeniería debe indicar la versión de QR empleada, la longitud exacta de la URL y el mensaje de error devuelto por el lector de la AEAT. IronBarcode precisa al menos Versión 4 con corrección de errores nivel M para garantizar la legibilidad.

2. Validación del formato de código de barras TicketBAI: La cadena TBAI-XXXXXXXXXXX-YYYYMMDD-HASH exigida por TicketBAI en Bizkaia, Gipuzkoa y Araba tiene restricciones estrictas de longitud y codificación. Los errores de análisis sintáctico de esta cadena son difíciles de reproducir sin el fichero XML de ejemplo. Adjunte el XML del ticket, el valor literal de la cadena TBAI y el fragmento de código donde se genera el código de barras.

3. Lectura de DataMatrix en envases farmacéuticos (SILICIE): Los envases de medicamentos que circulan por el SEVeM y el sistema SILICIE suelen presentar DataMatrix blancos sobre papel de aluminio o plástico plateado de baja reflectancia. Los filtros predeterminados de IronBarcode no siempre son suficientes en estas condiciones. Para escalar correctamente, incluya imágenes de muestra del envase, los valores de BinaryThreshold y Sharpen probados, y la excepción o el valor vacío devuelto.

4. Leyenda VERI*FACTU con asterisco: La leyenda obligatoria VERI*FACTU establecida por el Real Decreto-Ley 15/2025 contiene un asterisco que, en determinadas codificaciones de cadena o conversiones de juego de caracteres, se transforma en un carácter de control o espacio. Los registros hash-chained presentados a la AEAT quedan invalidados si la leyenda no coincide exactamente. Incluya en la solicitud el código de generación del QR, la cadena de bytes resultante y el mensaje de rechazo de la AEAT.

Problemas con la lectura de códigos de barras

Si tiene problemas para leer un código de barras, consulte primero los siguientes artículos:

1. Formatos de código de barras soportados
2. Código de barras no reconocido

Una vez que el formato se haya confirmado y los pasos de solución de problemas se hayan llevado a cabo, si el código de barras es válido pero aún no se reconoce correctamente, por favor envíenos una copia del archivo de entrada.

Nuestro equipo de ingeniería tiene experiencia en los requisitos técnicos de la normativa fiscal española y puede asistirle en la resolución de problemas relacionados con VeriFactu, los QR de verificación de la AEAT, los códigos de barras del TicketBAI (Bizkaia, Gipuzkoa, Araba), la trazabilidad DataMatrix de SILICIE y los documentos Facturae para el sector público. Si su problema está relacionado con alguno de estos contextos regulatorios, indíquelo expresamente en el asunto del correo y adjunte el mayor número posible de los elementos descritos en las secciones anteriores: esto permitirá al equipo priorizar y reproducir su caso con la máxima rapidez.