IronXL vs Microsoft Excel Interop para SII/AEAT en Docker: sin licencia Office

¿Cómo crea la biblioteca Interop un libro de Excel?

El espacio de nombres Microsoft.Office.Interop.Excel expone el mismo modelo de objetos COM que Excel utiliza internamente. Para leer o crear archivos de Excel a través de esta biblioteca, primero debe instanciar un objeto Application, agregar un nuevo libro de trabajo a su colección Workbooks y, a continuación, acceder a las celdas individuales de la hoja de cálculo. El siguiente ejemplo muestra una aplicación de consola mínima que utiliza Microsoft.Office.Interop.Excel para crear un fichero XLSX y escribir valores en las celdas.

using Excel = Microsoft.Office.Interop.Excel;
using System.Runtime.InteropServices;
// Create the Excel Application COM object
Excel.Application excelApp = new Excel.Application();
if (excelApp == null)
{
    Console.WriteLine("Error: Excel is not properly installed.");
    return;
}
// Add a new workbook and access the default worksheet
Excel.Workbook xlWorkBook = excelApp.Workbooks.Add(Type.Missing);
Excel.Worksheet xlWorkSheet = (Excel.Worksheet)xlWorkBook.ActiveSheet;
// Write data into specific cells
xlWorkSheet.Cells[1, 1] = "Product";
xlWorkSheet.Cells[1, 2] = "Price";
xlWorkSheet.Cells[2, 1] = "Widget";
xlWorkSheet.Cells[2, 2] = "29.99";
// Save as an XLSX file and clean up COM objects
string filepath = @"C:\Reports\products.xlsx";
xlWorkBook.SaveAs(filepath);
xlWorkBook.Close(false);
excelApp.Quit();
// Release every COM object to prevent orphaned Excel processes
Marshal.ReleaseComObject(xlWorkSheet);
Marshal.ReleaseComObject(xlWorkBook);
Marshal.ReleaseComObject(excelApp);

using Excel = Microsoft.Office.Interop.Excel;
using System.Runtime.InteropServices;
// Create the Excel Application COM object
Excel.Application excelApp = new Excel.Application();
if (excelApp == null)
{
    Console.WriteLine("Error: Excel is not properly installed.");
    return;
}
// Add a new workbook and access the default worksheet
Excel.Workbook xlWorkBook = excelApp.Workbooks.Add(Type.Missing);
Excel.Worksheet xlWorkSheet = (Excel.Worksheet)xlWorkBook.ActiveSheet;
// Write data into specific cells
xlWorkSheet.Cells[1, 1] = "Product";
xlWorkSheet.Cells[1, 2] = "Price";
xlWorkSheet.Cells[2, 1] = "Widget";
xlWorkSheet.Cells[2, 2] = "29.99";
// Save as an XLSX file and clean up COM objects
string filepath = @"C:\Reports\products.xlsx";
xlWorkBook.SaveAs(filepath);
xlWorkBook.Close(false);
excelApp.Quit();
// Release every COM object to prevent orphaned Excel processes
Marshal.ReleaseComObject(xlWorkSheet);
Marshal.ReleaseComObject(xlWorkBook);
Marshal.ReleaseComObject(excelApp);

Imports Excel = Microsoft.Office.Interop.Excel
Imports System.Runtime.InteropServices

' Create the Excel Application COM object
Dim excelApp As Excel.Application = New Excel.Application()
If excelApp Is Nothing Then
    Console.WriteLine("Error: Excel is not properly installed.")
    Return
End If

' Add a new workbook and access the default worksheet
Dim xlWorkBook As Excel.Workbook = excelApp.Workbooks.Add(Type.Missing)
Dim xlWorkSheet As Excel.Worksheet = CType(xlWorkBook.ActiveSheet, Excel.Worksheet)

' Write data into specific cells
xlWorkSheet.Cells(1, 1) = "Product"
xlWorkSheet.Cells(1, 2) = "Price"
xlWorkSheet.Cells(2, 1) = "Widget"
xlWorkSheet.Cells(2, 2) = "29.99"

' Save as an XLSX file and clean up COM objects
Dim filepath As String = "C:\Reports\products.xlsx"
xlWorkBook.SaveAs(filepath)
xlWorkBook.Close(False)
excelApp.Quit()

' Release every COM object to prevent orphaned Excel processes
Marshal.ReleaseComObject(xlWorkSheet)
Marshal.ReleaseComObject(xlWorkBook)
Marshal.ReleaseComObject(excelApp)

El código anterior crea un libro de Excel, rellena una hoja con valores, guarda el fichero y libera manualmente cada objeto COM. Esa limpieza final no es opcional: si se omite, aparecen procesos fantasma de EXCEL.EXE consumiendo memoria en el sistema. Si Microsoft Office no está instalado, cada línea generará un error —un problema crítico en servidores Linux de empresas que operan el SII de la AEAT. La versión de la biblioteca de interoperabilidad debe coincidir con la versión de Office instalada; de lo contrario, se producirán FileNotFoundException difíciles de depurar.

¿Qué problemas genera Interop para generar ficheros SII/AEAT en servidores y en la nube?

Microsoft desaconseja explícitamente el uso de Interop en entornos de servidor. La biblioteca inicia una instancia completa de Excel en segundo plano, lo que significa que cada solicitud a un servidor web activa un proceso oculto en el escritorio de Windows. En un servidor Linux, no funcionará en absoluto. Para los departamentos de tecnología que generan ficheros del modelo 303, modelo 347 u operaciones SII desde microservicios en contenedores Docker —ya sea en Azure, AWS o infraestructura propia—, Interop es inviable. Las entidades supervisadas por el Banco de España / CNMV que deben generar informes regulatorios XLSX periódicos tampoco pueden depender de licencias Office en cada nodo del clúster.

Los desarrolladores suelen publicar sobre estos problemas en Stack Overflow y Microsoft Q&A, buscando cómo crear archivos de Excel sin tener Excel instalado. La siguiente tabla resume las principales diferencias.

| Característica | Interoperabilidad de oficina | IronXL| | ---| ---| ---| | Requiere tener Excel instalado. | Sí, solo la máquina del desarrollador y todos los servidores de producción. | No | | Formatos de archivo de Excel compatibles | XLS, XLSX| XLS, XLSX, CSV, TSV, JSON, XML| | Multiplataforma (.NET Core, Linux, macOS) | Sólo para Windows| Windows, Linux, macOS, Azure| | Se requiere la limpieza del objeto COM | Sí, manual Marshal.ReleaseComObject | No | | Implementación en servidor/nube | Microsoft no lo recomienda. | Totalmente compatible| | Rendimiento| Más lento: inicia un proceso oculto de Excel. | Mejor rendimiento: código .NET administrado | | Compatibilidad con .NET Framework y .NET Core | Solo para .NET Framework | .NET Framework, .NET Core, .NET 5–10 | | Generación ficheros SII/AEAT en Linux/Docker | No funciona | Sí, sin Office |

¿Cómo generar ficheros SII AEAT en XLSX sin tener Microsoft Office instalado?

IronXL es una biblioteca .NET para Excel que lee, escribe y crea archivos de Excel completamente en código administrado, sin dependencia de Microsoft Office, sin objetos COM que publicar, sin conflictos de versiones. Es la alternativa natural a Microsoft.Office.Interop para generar ficheros SII/AEAT en entornos Docker sin licencia Office. Instálalo a través de NuGet, busca IronXL y listo. Funciona en .NET Framework 4.6.2+, .NET Core y .NET 5 a .NET 10 en todos los sistemas operativos principales.

El siguiente ejemplo crea el mismo fichero que el código Interop, con la mitad de líneas —y sin ninguna dependencia externa que impida desplegarlo en Linux:

using IronXL;
// Create a new Excel workbook — default value is XLSX format
WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
// Add a worksheet and populate cells with data
WorkSheet workSheet = workBook.CreateWorkSheet("Sales");
workSheet["A1"].Value = "Product";
workSheet["B1"].Value = "Price";
workSheet["A2"].Value = "Widget";
workSheet["B2"].Value = 29.99;
// Apply basic formatting
workSheet["A1"].Style.Font.Bold = true;
workSheet["B1"].Style.Font.Bold = true;
// Save the XLSX file
workBook.SaveAs(@"C:\Reports\products.xlsx");

using IronXL;
// Create a new Excel workbook — default value is XLSX format
WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
// Add a worksheet and populate cells with data
WorkSheet workSheet = workBook.CreateWorkSheet("Sales");
workSheet["A1"].Value = "Product";
workSheet["B1"].Value = "Price";
workSheet["A2"].Value = "Widget";
workSheet["B2"].Value = 29.99;
// Apply basic formatting
workSheet["A1"].Style.Font.Bold = true;
workSheet["B1"].Style.Font.Bold = true;
// Save the XLSX file
workBook.SaveAs(@"C:\Reports\products.xlsx");

Imports IronXL

' Create a new Excel workbook — default value is XLSX format
Dim workBook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
' Add a worksheet and populate cells with data
Dim workSheet As WorkSheet = workBook.CreateWorkSheet("Sales")
workSheet("A1").Value = "Product"
workSheet("B1").Value = "Price"
workSheet("A2").Value = "Widget"
workSheet("B2").Value = 29.99
' Apply basic formatting
workSheet("A1").Style.Font.Bold = True
workSheet("B1").Style.Font.Bold = True
' Save the XLSX file
workBook.SaveAs("C:\Reports\products.xlsx")

¿Cómo se pueden leer y escribir los datos de declaraciones AEAT en filas y celdas?

Leer ficheros XLSX existentes —por ejemplo, el borrador del modelo 390 (resumen anual IVA) para revisión antes de la presentación— es igual de sencillo. El método WorkBook.Load acepta una ruta de archivo a cualquier fichero XLS, XLSX o CSV. Cada hoja expone sus filas y celdas como colecciones iterables, facilitando la lectura de datos, la modificación de valores o la carga de resultados en una base de datos. En el contexto del TicketBAI (Bizkaia, Gipuzkoa, Araba), este patrón se usa para leer los registros de facturación XLSX y verificar su estructura antes de generar el XML de presentación.

using IronXL;
// Load an existing Excel file
WorkBook workBook = WorkBook.Load(@"C:\Reports\products.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;
// Read and display each row of data
foreach (var row in workSheet.Rows)
{
    foreach (var cell in row.ToArray())
    {
        Console.Write(cell.Value + "\t");
    }
    Console.WriteLine();
}
// Update a specific cell and save
workSheet["B2"].Value = 34.99;
workBook.SaveAs(@"C:\Reports\products_updated.xlsx");

using IronXL;
// Load an existing Excel file
WorkBook workBook = WorkBook.Load(@"C:\Reports\products.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;
// Read and display each row of data
foreach (var row in workSheet.Rows)
{
    foreach (var cell in row.ToArray())
    {
        Console.Write(cell.Value + "\t");
    }
    Console.WriteLine();
}
// Update a specific cell and save
workSheet["B2"].Value = 34.99;
workBook.SaveAs(@"C:\Reports\products_updated.xlsx");

Imports IronXL

' Load an existing Excel file
Dim workBook As WorkBook = WorkBook.Load("C:\Reports\products.xlsx")
Dim workSheet As WorkSheet = workBook.DefaultWorkSheet

' Read and display each row of data
For Each row In workSheet.Rows
    For Each cell In row.ToArray()
        Console.Write(cell.Value & vbTab)
    Next
    Console.WriteLine()
Next

' Update a specific cell and save
workSheet("B2").Value = 34.99
workBook.SaveAs("C:\Reports\products_updated.xlsx")

¿Cuál es la mejor manera de avanzar en la automatización de Excel con .NET para cumplimiento AEAT?

Si un proyecto está vinculado a un entorno de escritorio Windows heredado donde Microsoft Office ya está instalado y se mantendrá estable, Interop puede funcionar para tareas básicas. Pero para todo lo demás —implementaciones en servidores Linux de la AEAT, microservicios de SII en contenedores Docker, APIs de VeriFactu (Real Decreto-Ley 15/2025), generación de informes regulatorios para el Banco de España / CNMV, o cualquier escenario donde se desee mejor rendimiento sin depender de licencias Office—, una biblioteca .NET Excel independiente es la opción más lógica.

IronXL gestiona todas las operaciones comunes de Excel (creación de libros de trabajo, lectura de datos, escritura en celdas, guardado en múltiples formatos de archivo incluyendo XLS y XLSX) a través de una API limpia que se ejecuta en cualquier lugar donde se ejecute .NET. Es compatible con proyectos de C# y Visual Basic, y el mismo código funciona en Windows, Linux y macOS sin modificaciones —eliminando la principal barrera para automatizar la generación de ficheros SII y declaraciones AEAT en infraestructuras modernas.

Comience una prueba gratuita de 30 días para probarlo en su propio proyecto, o explore las opciones de licencia cuando esté listo para implementarlo.