Saltar al pie de página
USO DE IRONBARCODE

Generador de Códigos QR para VeriFactu en Blazor | IronBarcode España

Para desarrolladores en España: Las aplicaciones web Blazor que sirven al mercado español tienen requisitos normativos específicos en materia de facturación electrónica. El Real Decreto 1007/2023 obliga a que el software de facturación homologado por la AEAT genere un código QR en cada factura. VeriFactu (Real Decreto-Ley 15/2025) añade la exigencia de registros con hash encadenado y la leyenda VERI*FACTU visible en el documento PDF. En el País Vasco (Bizkaia, Gipuzkoa, Araba), TicketBAI impone un código QR o de barras en cada tíquet emitido desde un TPV. IronBarcode permite generar todos estos códigos desde Blazor Server y Blazor WebAssembly con una API unificada.

Los códigos de barras se han convertido en una parte esencial de las operaciones comerciales modernas. Simplifican la gestión de inventarios, mejoran el seguimiento de productos y agilizan los procesos de entrada de datos. Integrar capacidades de generación de códigos de barras en aplicaciones web puede ser increíblemente beneficioso, y Blazor, un popular marco de trabajo web de Microsoft, ofrece una excelente plataforma para lograr esto sin problemas.

En este tutorial, exploraremos la generación de códigos de barras dentro del marco de trabajo de Blazor utilizando la poderosa biblioteca IronBarcode. Aprenderás a crear y personalizar códigos de barras sin esfuerzo, haciendo que tus aplicaciones en Blazor sean aún más versátiles y eficientes.

IronBarcode

IronBarcode es una poderosa biblioteca de .NET diseñada para simplificar el proceso de creación de códigos de barras dentro de tus aplicaciones. Proporciona un conjunto de herramientas y funciones que permiten a los desarrolladores generar varios tipos de códigos de barras con facilidad. Ya sea que necesites crear códigos de barras para etiquetas de productos, gestión de inventarios u otros propósitos, IronBarcode hace que la tarea sea sencilla y eficiente.

Prerrequisitos

Antes de comenzar, asegúrate de tener los siguientes requisitos previos:

  • Visual Studio (o cualquier otro IDE como Visual Studio Code).
  • IronBarcode instalado.
  • Conocimientos básicos de Blazor y C#.

Configuración de una aplicación Blazor Server en Visual Studio

Blazor Server es una excelente opción para construir aplicaciones web interactivas con .NET. Visual Studio, el potente entorno de desarrollo integrado (IDE) de Microsoft, facilita la creación de estas aplicaciones. Aquí, crearemos una aplicación de servidor Blazor usando Visual Studio.

Si aún no has instalado Visual Studio, puedes descargarlo desde el sitio web de Visual Studio.

Crear un nuevo proyecto

  • Haz clic en "Crear un nuevo proyecto". Cómo generar un código de barras en Blazor: Figura 1: El cuadro de diálogo Comenzar en Visual Studio.

  • Busca "Blazor Server App" utilizando la barra de búsqueda en la parte superior.
  • Selecciona "Blazor Server App" de la lista de plantillas de proyectos y haz clic en el botón "Siguiente". How to Generate Barcode in Blazor: Figure 2 - The Create a new project dialogue in Visual Studio.

Configurar la aplicación Blazor

  • En el diálogo "Configura tu nuevo proyecto", deberás proporcionar algunos detalles:
    • Nombre del proyecto: ingrese un nombre para su aplicación Blazor .
    • Ubicación: elige dónde quieres guardar los archivos de tu proyecto.
    • Nombre de la solución: Opcionalmente, puede cambiar el nombre de la solución que contiene su proyecto.
  • Haz clic en el botón "Siguiente" para continuar. How to Generate Barcode in Blazor: Figure 3 - The Configure your new project dialogue in Visual Studio.

información adicional

  • Asegúrate de que ".NET 6.0 (LTS)" esté seleccionado en el menú desplegable.
  • Si deseas agregar autenticación a tu aplicación, puedes elegir entre las opciones disponibles. Visual Studio proporciona plantillas para Cuentas de Usuario Individuales, Cuentas de Trabajo o Escuela, entre otras. También puedes elegir "Ninguna" si no necesitas autenticación de inmediato.
  • Haz clic en el botón "Crear" para finalizar la configuración de tu proyecto. How to Generate Barcode in Blazor: Figure 4 - The Additional information dialogue in Visual Studio.

Instalar IronBarcode

Para instalar la biblioteca IronBarcode a través del Administrador de Paquetes NuGet en Visual Studio para tu proyecto Blazor, puedes seguir estos pasos:

  1. Haz clic derecho en tu proyecto en el Explorador de Soluciones de Visual Studio, y luego selecciona "Administrar Paquetes NuGet". Cómo generar un código de barras en Blazor: Figura 5: El menú desplegable del Administrador de paquetes NuGet en Visual Studio.

  2. En la ventana "Administrador de Paquetes NuGet", asegúrate de estar en la pestaña "Examinar".
  3. En el cuadro de búsqueda en la esquina superior derecha, escribe "IronBarcode" y presiona Enter. Cómo generar un código de barras en Blazor: Figura 6 - La ventana del Administrador de paquetes NuGet .

  4. Haz clic en el botón "Instalar" a continuación, y comenzará el proceso de instalación.

Siguiendo esta configuración, asegúrate de que IronBarcode esté integrado exitosamente en tu proyecto agregando la directiva using necesaria en tu código y pruébalo generando un código de barras simple:

using IronBarCode; // Import the IronBarcode library

namespace YourNamespace
{
    public class BarcodeGenerator
    {
        public void GenerateBarcode()
        {
            // Creates a barcode with text "Hello World"
            BarcodeWriter.CreateBarcode("Hello World", BarcodeWriterEncoding.Code128)
                .SaveAsPng("barcode.png"); // Saves the barcode image as a PNG file
        }
    }
}
using IronBarCode; // Import the IronBarcode library

namespace YourNamespace
{
    public class BarcodeGenerator
    {
        public void GenerateBarcode()
        {
            // Creates a barcode with text "Hello World"
            BarcodeWriter.CreateBarcode("Hello World", BarcodeWriterEncoding.Code128)
                .SaveAsPng("barcode.png"); // Saves the barcode image as a PNG file
        }
    }
}
Imports IronBarCode ' Import the IronBarcode library

Namespace YourNamespace
	Public Class BarcodeGenerator
		Public Sub GenerateBarcode()
			' Creates a barcode with text "Hello World"
			BarcodeWriter.CreateBarcode("Hello World", BarcodeWriterEncoding.Code128).SaveAsPng("barcode.png") ' Saves the barcode image as a PNG file
		End Sub
	End Class
End Namespace
$vbLabelText   $csharpLabel

Asegúrese de reemplazar "YourNamespace" con el espacio de nombres apropiado para su aplicación. El código anterior crea un código de barras 'Code128' con el texto "Hello World" y lo guarda como un archivo PNG en el directorio del proyecto.

Esta sección ahora está libre de errores ortográficos y gramaticales. Además, se ha corregido el lenguaje del bloque de código delimitado a "cs" según el código fuente incrustado.

Generación de QR AEAT y TicketBAI en aplicaciones Blazor para España

En aplicaciones Blazor desplegadas en el mercado español, la generación de códigos QR cumpliendo normativa AEAT es un requisito frecuente. El siguiente patrón muestra cómo integrar la generación del QR de facturas VeriFactu en un componente Blazor Server:

using IronBarCode;

// Componente Blazor: generar QR de factura para cumplimiento AEAT/VeriFactu
public class FacturaQRService
{
    public byte[] GenerarQRFactura(string nif, string serie, string numero, DateTime fecha, decimal importe)
    {
        // Construir la URL requerida por AEAT (Real Decreto 1007/2023)
        string urlAeat = $"https://sede.agenciatributaria.gob.es/Sede/factura?nif={nif}&serie={serie}&numserie={numero}&fecha={fecha:dd-MM-yyyy}&importe={importe:F2}";

        // Generar el QR con nivel de corrección Medium (recomendado para impresión en papel)
        var qr = QRCodeWriter.CreateQrCode(urlAeat, 300, QRCodeWriter.QrErrorCorrectionLevel.Medium);
        return qr.ToPngBinaryData();
    }
}
using IronBarCode;

// Componente Blazor: generar QR de factura para cumplimiento AEAT/VeriFactu
public class FacturaQRService
{
    public byte[] GenerarQRFactura(string nif, string serie, string numero, DateTime fecha, decimal importe)
    {
        // Construir la URL requerida por AEAT (Real Decreto 1007/2023)
        string urlAeat = $"https://sede.agenciatributaria.gob.es/Sede/factura?nif={nif}&serie={serie}&numserie={numero}&fecha={fecha:dd-MM-yyyy}&importe={importe:F2}";

        // Generar el QR con nivel de corrección Medium (recomendado para impresión en papel)
        var qr = QRCodeWriter.CreateQrCode(urlAeat, 300, QRCodeWriter.QrErrorCorrectionLevel.Medium);
        return qr.ToPngBinaryData();
    }
}
Imports IronBarCode

' Componente Blazor: generar QR de factura para cumplimiento AEAT/VeriFactu
Public Class FacturaQRService
    Public Function GenerarQRFactura(nif As String, serie As String, numero As String, fecha As DateTime, importe As Decimal) As Byte()
        ' Construir la URL requerida por AEAT (Real Decreto 1007/2023)
        Dim urlAeat As String = $"https://sede.agenciatributaria.gob.es/Sede/factura?nif={nif}&serie={serie}&numserie={numero}&fecha={fecha:dd-MM-yyyy}&importe={importe:F2}"

        ' Generar el QR con nivel de corrección Medium (recomendado para impresión en papel)
        Dim qr = QRCodeWriter.CreateQrCode(urlAeat, 300, QRCodeWriter.QrErrorCorrectionLevel.Medium)
        Return qr.ToPngBinaryData()
    End Function
End Class
$vbLabelText   $csharpLabel

Este servicio se inyecta en cualquier componente Blazor (@inject FacturaQRService QRService) y permite mostrar el QR directamente en el navegador o incorporarlo al PDF de la factura mediante IronPDF. Para aplicaciones TicketBAI en Bizkaia, Gipuzkoa o Araba, el mismo patrón aplica con los parámetros específicos del esquema de cada Diputación Foral.

Las aplicaciones de e-commerce y TPV online desplegadas en España también pueden utilizar este enfoque para generar los QR de pago y los justificantes de compra que el cliente espera según la normativa de Crea y Crece y la LOPDGDD. IronBarcode gestiona automáticamente la corrección de errores Reed-Solomon y el nivel de módulo adecuado para que el código QR sea legible en papel impreso desde cualquier impresora TPV estándar.

Preguntas Frecuentes

¿Cómo puedo integrar la generación de códigos de barras en una aplicación Blazor?

Puedes integrar la generación de códigos de barras en una aplicación Blazor usando la biblioteca IronBarcode. Comienza instalando IronBarcode a través del Administrador de Paquetes NuGet en tu proyecto Blazor. Luego, usa la clase BarcodeWriter de la biblioteca para generar códigos de barras con el texto o datos deseados.

¿Cuáles son las herramientas necesarias para comenzar un proyecto de códigos de barras en Blazor?

Para comenzar un proyecto de códigos de barras en Blazor, necesitarás un Entorno de Desarrollo Integrado (IDE) como Visual Studio o Visual Studio Code, la biblioteca IronBarcode y conocimientos básicos de Blazor y C#. Esta configuración te permitirá crear aplicaciones web interactivas con capacidades de códigos de barras.

¿Cómo creo un código de barras 'Code128' en una aplicación Blazor?

Para crear un código de barras 'Code128' en una aplicación Blazor, usa IronBarcode importándolo a tu proyecto. Utiliza la clase BarcodeWriter para generar el código de barras y establece las propiedades deseadas para un tipo 'Code128'. Finalmente, guarda el resultado como un archivo de imagen, como PNG.

¿Cuáles son los pasos para configurar una Aplicación de Servidor Blazor para la generación de códigos de barras?

Para configurar una Aplicación de Servidor Blazor para la generación de códigos de barras, abre Visual Studio y crea un nuevo proyecto. Selecciona 'Aplicación de Servidor Blazor', configura los detalles del proyecto y elige .NET 6.0 (LTS). Instala IronBarcode usando NuGet, e intégralo en tu proyecto Blazor para comenzar a generar códigos de barras.

¿Es posible generar códigos QR usando una biblioteca .NET en Blazor?

Sí, puedes generar códigos QR en Blazor usando la biblioteca IronBarcode. Esta biblioteca .NET admite varios tipos de códigos de barras, incluidos los códigos QR. Usa las funciones de la biblioteca para crear y personalizar códigos QR según los requisitos de tu aplicación.

¿Cómo verifico la integración exitosa de una biblioteca de códigos de barras en mi proyecto Blazor?

Para verificar la integración exitosa de una biblioteca de códigos de barras en tu proyecto Blazor, genera un código de barras de muestra utilizando IronBarcode. Implementa un fragmento de código simple en tu proyecto para crear una imagen de código de barras y asegúrate de que se produzca como se esperaba, confirmando que la biblioteca funciona correctamente.

¿Qué beneficios aporta la integración de funcionalidades de códigos de barras a las aplicaciones web?

Integrar funcionalidades de códigos de barras en aplicaciones web mejora la eficiencia en la gestión de inventario, seguimiento de productos y entrada de datos. Simplifica los procesos, reduce los errores humanos y mejora los flujos de trabajo operativos, demostrando ser altamente beneficioso para las empresas modernas.

¿Puedo usar IronBarcode en Blazor para generar los códigos QR obligatorios en facturas según VeriFactu y la AEAT en España?

Sí. IronBarcode se integra directamente en aplicaciones Blazor Server y Blazor WebAssembly. El servicio QRCodeWriter.CreateQrCode() genera el código QR con la URL firmada de la AEAT requerida por el Real Decreto 1007/2023 y VeriFactu (Real Decreto-Ley 15/2025). El resultado en bytes (ToPngBinaryData()) se puede incrustar en el PDF de la factura o mostrar directamente en el navegador. Para TicketBAI en Bizkaia, Gipuzkoa y Araba, el mismo patrón se aplica con los parámetros del esquema de la Diputación Foral correspondiente.

Curtis Chau
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

Leer más

Equipo de soporte de Iron

Estamos disponibles online las 24 horas, 5 días a la semana.
Chat
Email
Llámame