# IronBarcode en Linux para VeriFactu, SII y facturación electrónica en España
> **Linux y la infraestructura fiscal española:** Los principales proveedores de ERP para el mercado español —Sage, A3ERP, FacturaPlus— ejecutan servicios backend en Linux para el Suministro Inmediato de Información (SII) de la AEAT. IronBarcode en Linux permite generar el código QR de AEAT exigido por VeriFactu en cada factura sin costes de licencias de Windows Server, con soporte completo para .NET 8/9/10 en Ubuntu, Debian y CentOS.
IronBarcode es totalmente compatible con Linux para aplicaciones **.NET Standard**, **.NET Core** y **.NET Framework** en una amplia variedad de distribuciones.
<div class="main-content__small-images-inline">
<img src="https://img.icons8.com/color/96/000000/linux--v1.png" alt="Linux" />
<img src="https://img.icons8.com/color/96/000000/docker.png" alt="Docker" />
<img src="https://img.icons8.com/fluency/96/000000/azure-1.png" alt="Azure" />
<img src="https://img.icons8.com/color/96/000000/amazon-web-services.png" alt="Amazonas" />
<img src="https://img.icons8.com/color/96/000000/ubuntu--v1.png" alt="Ubuntu" />
<img src="https://img.icons8.com/color/96/000000/debian--v1.png" alt="Debian" />
</div>
No se requieren cambios de código para ejecutar IronBarcode en Linux. En general, IronBarcode funciona de inmediato gracias a cientos de horas de pruebas y configuraciones realizadas por nuestros ingenieros.
El soporte para Linux es importante ya que muchos de los servicios en la nube de hoy en día se ejecutan en Linux. En Iron Software, utilizamos regularmente estas herramientas en la nube y entendemos que muchos de nuestros clientes Enterprise y SaaS también lo hacen.
## 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](https://www.nuget.org/packages/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
<div class="main-content__small-images-inline">
<img src="https://img.icons8.com/color/48/000000/microsoft.png" alt="Microsoft" />
<img src="https://img.icons8.com/color/48/000000/ubuntu--v1.png" alt="Ubuntu" />
<img src="https://img.icons8.com/color/48/000000/chrome--v1.png" alt="Chrome" />
<img src="https://img.icons8.com/color/48/000000/safari--v1.png" alt="Safari" />
<img src="https://img.icons8.com/color/48/000000/docker.png" alt="Docker" />
<img src="https://img.icons8.com/fluency/48/000000/azure-1.png" alt="Azure" />
</div>
**Imágenes oficiales de Docker de Microsoft:**
* [.NET Standard](https://hub.docker.com/r/microsoft/dotnet-runtime/)
* [ASP.NET Core](https://hub.docker.com/r/microsoft/dotnet-aspnet/)
**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:
```dockerfile
# Update package lists
RUN apt update
# Install libgdiplus, a library used for GDI+ support
RUN apt install -y libgdiplus
```
### Ubuntu 18
<div class="main-content__small-images-inline">
<img src="https://img.icons8.com/color/48/000000/microsoft.png" alt="Microsoft" />
<img src="https://img.icons8.com/color/48/000000/ubuntu--v1.png" alt="Ubuntu" />
<img src="https://img.icons8.com/color/48/000000/chrome--v1.png" alt="Chrome" />
<img src="https://img.icons8.com/color/48/000000/safari--v1.png" alt="Safari" />
<img src="https://img.icons8.com/color/48/000000/docker.png" alt="Docker" />
<img src="https://img.icons8.com/fluency/48/000000/azure-1.png" alt="Azure" />
</div>
**Imágenes oficiales de Docker de Microsoft**
* [.NET Standard](https://hub.docker.com/r/microsoft/dotnet-runtime/)
* [ASP.NET Core](https://hub.docker.com/r/microsoft/dotnet-aspnet/)
**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:
```dockerfile
# Update package lists
RUN apt update
# Install libgdiplus, a library used for GDI+ support
RUN apt install -y libgdiplus
```
### Debian 11
<div class="main-content__small-images-inline">
<img src="https://img.icons8.com/color/48/000000/debian.png" alt="Debian" />
<img src="https://img.icons8.com/color/48/000000/microsoft.png" alt="Microsoft" />
<img src="https://img.icons8.com/color/48/000000/chrome--v1.png" alt="Chrome" />
<img src="https://img.icons8.com/color/48/000000/safari--v1.png" alt="Safari" />
<img src="https://img.icons8.com/color/48/000000/docker.png" alt="Docker" />
<img src="https://img.icons8.com/fluency/48/000000/azure-1.png" alt="Azure" />
</div>
**Imágenes oficiales de Docker de Microsoft**
* [.NET Standard](https://hub.docker.com/r/microsoft/dotnet-runtime/)
* [ASP.NET Core](https://hub.docker.com/r/microsoft/dotnet-aspnet/)
**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:
```dockerfile
# Update package lists
RUN apt update
# Install libgdiplus, a library used for GDI+ support
RUN apt install -y libgdiplus
```
### Debian 10
<div class="main-content__small-images-inline">
<img src="https://img.icons8.com/color/48/000000/debian.png" alt="Debian" />
<img src="https://img.icons8.com/color/48/000000/microsoft.png" alt="Microsoft" />
<img src="https://img.icons8.com/color/48/000000/chrome--v1.png" alt="Chrome" />
<img src="https://img.icons8.com/color/48/000000/safari--v1.png" alt="Safari" />
<img src="https://img.icons8.com/color/48/000000/docker.png" alt="Docker" />
<img src="https://img.icons8.com/fluency/48/000000/azure-1.png" alt="Azure" />
</div>
**Imágenes oficiales de Docker de Microsoft**
* [.NET Standard](https://hub.docker.com/r/microsoft/dotnet-runtime/)
* [ASP.NET Core](https://hub.docker.com/r/microsoft/dotnet-aspnet/)
**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:
```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:
```shell
dotnet add package BarCode.Linux
```
### CentOS
**Configuración de CentOS 7**
Para ejecutar IronBarcode, primero asegúrese de tener privilegios de administrador _sudo_, luego añada estos comandos a su Dockerfile:
```dockerfile
# 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
```
Linux y la infraestructura fiscal española: Los principales proveedores de ERP para el mercado español —Sage, A3ERP, FacturaPlus— ejecutan servicios backend en Linux para el Suministro Inmediato de Información (SII) de la AEAT. IronBarcode en Linux permite generar el código QR de AEAT exigido por VeriFactu en cada factura sin costes de licencias de Windows Server, con soporte completo para .NET 8/9/10 en Ubuntu, Debian y CentOS.
IronBarcode es totalmente compatible con Linux para aplicaciones .NET Standard, .NET Core y .NET Framework en una amplia variedad de distribuciones.
No se requieren cambios de código para ejecutar IronBarcode en Linux. En general, IronBarcode funciona de inmediato gracias a cientos de horas de pruebas y configuraciones realizadas por nuestros ingenieros.
El soporte para Linux es importante ya que muchos de los servicios en la nube de hoy en día se ejecutan en Linux. En Iron Software, utilizamos regularmente estas herramientas en la nube y entendemos que muchos de nuestros clientes Enterprise y SaaS también lo hacen.
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.
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.
Para ejecutar IronBarcode, primero asegúrese de tener privilegios de administrador sudo, luego añada estos comandos a su Dockerfile:
# Update package listsRUN apt update# Install libgdiplus, a library used for GDI+ supportRUN apt install -y libgdiplus
# Update package lists
RUN apt update
# Install libgdiplus, a library used for GDI+ support
RUN apt install -y libgdiplus
Text
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
SHELL
CentOS
Configuración de CentOS 7
Para ejecutar IronBarcode, primero asegúrese de tener privilegios de administrador sudo, luego añada estos comandos a su Dockerfile:
# Install EPEL repository for extra packagesRUN yum install epel-release -y# Install Mono, a cross-platform implementation of .NETRUN yum install mono-complete -y# Install libgdiplus and libc6-dev for graphics supportRUN yum install libgdiplus libc6-dev -y
# 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
Text
Preguntas Frecuentes
¿Cómo puedo integrar operaciones de código de barras en un entorno Linux?
Puede integrar sin problemas operaciones de código de barras en un entorno Linux usando IronBarcode, que es compatible con aplicaciones .NET Standard, .NET Core y .NET Framework. Funciona en varias distribuciones de Linux, incluidas Ubuntu, Debian y CentOS, sin requerir modificaciones de código.
¿Qué pasos se requieren para instalar IronBarcode en Ubuntu 20?
Para instalar IronBarcode en Ubuntu 20, asegúrese de tener privilegios de administrador sudo. Actualice su lista de paquetes con apt update e instale la biblioteca requerida usando apt install -y libgdiplus.
¿Puede usarse IronBarcode con servicios en la nube que operan en Linux?
Sí, IronBarcode puede usarse con servicios en la nube que operan en Linux. Su compatibilidad con Linux lo convierte en una opción ideal para clientes empresariales y de SaaS que dependen de infraestructuras de nube basadas en Linux.
¿Necesito librerías adicionales para ejecutar IronBarcode en CentOS 7?
Sí, para CentOS 7, necesita instalar el repositorio EPEL, Mono, libgdiplus y libc6-dev utilizando el gestor de paquetes yum para asegurar el funcionamiento correcto de IronBarcode.
¿Por qué se recomienda Ubuntu para ejecutar IronBarcode?
Se recomienda Ubuntu porque está extensamente probado dentro de la infraestructura de Azure, soporta imágenes oficiales de Microsoft .NET y Docker, y ofrece una configuración sencilla para IronBarcode.
¿Qué papel juega <code>libgdiplus</code> en la configuración de IronBarcode en Linux?
La biblioteca libgdiplus proporciona soporte GDI+, que es esencial para que IronBarcode realice operaciones de código de barras en sistemas Linux.
¿Existen imágenes Docker disponibles para configurar IronBarcode en Linux?
Sí, existen imágenes Docker oficiales de Microsoft disponibles para .NET Standard y ASP.NET Core, que pueden usarse para configurar IronBarcode en Linux.
¿Se requiere configuración manual para distribuciones de Linux distintas a Ubuntu, Debian o CentOS?
Sí, mientras que otras distribuciones de Linux son compatibles, pueden requerir configuración manual adicional más allá de lo necesario para Ubuntu, Debian o CentOS.
¿Cómo mejora IronBarcode la funcionalidad para desarrolladores en Linux?
IronBarcode simplifica la integración de operaciones de código de barras en entornos Linux, proporcionando una solución robusta que mejora la funcionalidad para desarrolladores y empresas sin requerir cambios de código.
¿IronBarcode es compatible con .NET 10 en Linux y qué plataformas son compatibles?
Sí, IronBarcode es compatible con .NET 10 en todas las plataformas Linux. El paquete BarCode.Linux funciona con .NET 10, así como con .NET 9, 8, 7, 6, 5, .NET Core 2.x y 3.x, .NET Standard 2.x y .NET Framework 4.6.2+. ([ironsoftware.com](https://ironsoftware.com/csharp/barcode/features/compatibility/?utm_source=openai))
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 estructurados y visualmente atractivos.
