IronBarcode en Linux para VeriFactu, SII y facturación electrónica en España

Distribuciones de Linux con soporte oficial

Soportamos oficialmente y recomendamos las últimas distribuciones de Linux de 64 bits a continuación para una configuración de "cero configuración" de IronBarcode:

• Ubuntu ≥18
• Debian ≥10
• CentOS ≥7

Otras distribuciones de Linux son soportadas en parte, pero pueden requerir una configuración manual adicional.

Paquete específico de Linux

El paquete BarCode.Linux habilita funciones de código de barras en dispositivos Linux a través de proyectos multiplataforma .NET. No se necesita el paquete BarCode estándar.

PM > Install-Package BarCode.Linux

Compatibilidad con Ubuntu

Ubuntu es nuestro sistema operativo Linux más probado. Esto se debe a que se utiliza ampliamente en la infraestructura de Azure que soporta nuestras pruebas y implementaciones continuas. Esta plataforma también tiene soporte oficial de Microsoft .NET y están disponibles imágenes oficiales de Docker.

Ubuntu 20

Imágenes oficiales de Docker de Microsoft:

• .NET Standard
• ASP.NET Core

Configuración de Ubuntu 20

Para ejecutar IronBarcode, primero asegúrese de tener privilegios de administrador sudo, luego añada estos comandos a su Dockerfile:

# Update package lists
RUN apt update

# Install libgdiplus, a library used for GDI+ support
RUN apt install -y libgdiplus

Ubuntu 18

Imágenes oficiales de Docker de Microsoft

• .NET Standard
• ASP.NET Core

Configuración de Ubuntu 18

Para ejecutar IronBarcode, primero asegúrese de tener privilegios de administrador sudo, luego añada estos comandos a su Dockerfile:

# Update package lists
RUN apt update

# Install libgdiplus, a library used for GDI+ support
RUN apt install -y libgdiplus

Debian 11

Imágenes oficiales de Docker de Microsoft

• .NET Standard
• ASP.NET Core

Configuración de Debian 11

Para ejecutar IronBarcode, primero asegúrese de tener privilegios de administrador sudo, luego añada estos comandos a su Dockerfile:

# Update package lists
RUN apt update

# Install libgdiplus, a library used for GDI+ support
RUN apt install -y libgdiplus

Debian 10

Imágenes oficiales de Docker de Microsoft

• .NET Standard
• ASP.NET Core

Configuración de Debian 10

Para ejecutar IronBarcode, primero asegúrese de tener privilegios de administrador sudo, luego añada estos comandos a su Dockerfile:

# Update package lists
RUN apt update

# Install libgdiplus, a library used for GDI+ support
RUN apt install -y libgdiplus

IronBarcode en el pipeline VeriFactu sobre Linux

Los servicios de facturación electrónica en España que deben cumplir VeriFactu generan en tiempo real el QR de AEAT en el momento de emisión de la factura. A continuación se describe la arquitectura de referencia sobre Linux:

Servicio .NET en Ubuntu/Debian: Un servicio .NET 8 en Ubuntu 20 o Debian 11 recibe las peticiones de generación de factura, construye la URL de AEAT con los parámetros nif, numserie, fecha, importe y huella del registro VeriFactu, y genera el QR con BarcodeWriter.CreateBarcode(url, BarcodeEncoding.QRCode). El QR se incrusta en el PDF Facturae antes de enviarlo a la AEAT o a FACe.

Procesamiento por lotes SII: El SII obliga a comunicar las facturas emitidas en cuatro días hábiles. Un servicio en CentOS 7+ con IronBarcode lee los QR de facturas pendientes de reconciliación, extrae los parámetros de cada URL y los coteja con los registros enviados a la AEAT mediante el servicio web del SII.

TicketBAI en servidores Linux del País Vasco: Los sistemas de gestión de Bizkaia, Gipuzkoa y Araba que ejecutan backends en Linux pueden integrar IronBarcode para generar y verificar los QR de TicketBAI sin necesidad de componentes adicionales.

El paquete BarCode.Linux proporciona la versión específica de Linux optimizada para estas cargas de trabajo. Instálelo con:

dotnet add package BarCode.Linux

dotnet add package BarCode.Linux

# Install EPEL repository for extra packages
RUN yum install epel-release -y

# Install Mono, a cross-platform implementation of .NET
RUN yum install mono-complete -y

# Install libgdiplus and libc6-dev for graphics support
RUN yum install libgdiplus libc6-dev -y