Modelo 303 AEAT en C#: Crear libro Excel sin Office con IronXL (SII)

¿Cómo empiezo a crear libros de Excel en C#?

En este tutorial, aprenderemos a crear un nuevo libro utilizando IronXL en C#. Repasaremos los pasos necesarios, desde configurar tu entorno de desarrollo hasta escribir código que genere un nuevo libro de Excel para el modelo 303 u otras declaraciones de la AEAT. Descubrirás cómo crear hojas de cálculo programáticamente sin ninguna instalación de Excel en tu máquina.

Al final de este tutorial, tendrás una comprensión sólida de cómo aprovechar IronXL para crear libros de Excel programáticamente, permitiéndote integrar funcionalidad de Excel en tus aplicaciones en C# con facilidad — ya sea para declaraciones de la AEAT, informes del Banco de España, o exportaciones TicketBAI y VeriFactu. ¡Comencemos!

¿Qué es IronXL?

IronXL es una versátil biblioteca de C# que te permite trabajar con documentos de Excel sin necesitar Microsoft Office Excel Interop o cualquier aplicación de Excel. Te permite leer, crear y modificar libros de trabajo fácilmente, dar formato a celdas, agregar fórmulas y trabajar con formatos de archivos de Excel tanto modernos como antiguos.

Puedes validar datos, insertar imágenes, aplicar formato condicional y crear gráficos sin necesidad de Microsoft Office. Los desarrolladores pueden construir soluciones de Excel para tareas como informes financieros, paneles de datos y gestión de inventarios fácilmente usando IronXL. La biblioteca admite convertir entre diferentes formatos de hojas de cálculo incluyendo XLSX, XLS, CSV, TSV, JSON y XML.

Comencemos a crear un archivo de Excel en C#.

¿Cómo creo un nuevo proyecto C# para desarrollo de Excel?

Abra Visual Studio y cree un nuevo proyecto de Aplicación de Consola en C#. Nómbralo como prefieras. También puedes crear otros tipos de proyectos como ASP.NET MVC, Blazor, MAUI, Web Forms, Windows Forms, Web API, etc. Este código funcionará con todos los tipos de proyectos. Estoy usando una aplicación de consola por simplicidad y para hacerla relevante para todos los tipos de proyectos. La biblioteca incluso funciona en contenedores Docker y Azure Functions.

¿Cómo instalo el paquete NuGet de IronXL?

Para instalar el paquete IronXL en tu proyecto de C#, puedes usar cualquiera de las siguientes formas. Una configuración de clave de licencia adecuada asegura que tus despliegues de producción funcionen sin restricciones.

1. Para instalar IronXL, haz clic derecho en tu proyecto en el Explorador de Soluciones, elige "Administrar paquetes NuGet", busca IronXL y luego procede con la instalación.

2. Alternativamente, puedes instalar IronXL a través de la consola del administrador de paquetes usando el siguiente comando:

Install-Package IronXL.Excel

Este comando descargará, instalará y agregará una referencia de ensamblado a tu proyecto. Espera a que el paquete sea descargado e instalado. Una vez completada la instalación, puedes comenzar a usar IronXL en tu proyecto para trabajar con archivos de Excel programáticamente.

¿Cómo importo los espacios de nombres necesarios?

En la parte superior de tu archivo C#, agrega el siguiente espacio de nombres:

using IronXL;

using IronXL;

Imports IronXL

¿Cómo creo un nuevo libro Excel para el modelo 303 de la AEAT?

Un caso de uso real para la mayoría de los desarrolladores en España es crear un fichero XLSX para la declaración trimestral de IVA — el modelo 303. El siguiente ejemplo muestra cómo generar este libro programáticamente con IronXL sin Office, cumpliendo además con la LOPDGDD mediante la exportación únicamente de los campos obligatorios (NIF, base imponible, cuota):

internal class Program
{
    static void Main(string[] args)
    {
        // Create a new workbook in the XLSX format — Excel sin Office para declaraciones AEAT
        WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
        workBook.Metadata.Author = "Equipo Fiscal";

        // Add a worksheet for modelo 303 — 1T
        WorkSheet workSheet = workBook.CreateWorkSheet("Modelo 303 1T");

        // Cabeceras — solo columnas requeridas (LOPDGDD: datos mínimos)
        workSheet["A1"].Value = "NIF Declarante";
        workSheet["B1"].Value = "Ejercicio";
        workSheet["C1"].Value = "Período";
        workSheet["D1"].Value = "Base Imponible (EUR)";
        workSheet["E1"].Value = "Cuota IVA (EUR)";

        // Datos de ejemplo — 1T 2026
        workSheet["A2"].Value = "B12345678";
        workSheet["B2"].Value = "2026";
        workSheet["C2"].Value = "1T";
        workSheet["D2"].Value = 48750.00;
        workSheet["E2"].Value = 10237.50;

        // Save the Excel file — modelo_303_1T_2026.xlsx
        workBook.SaveAs("modelo_303_1T_2026.xlsx");
    }
}

internal class Program
{
    static void Main(string[] args)
    {
        // Create a new workbook in the XLSX format — Excel sin Office para declaraciones AEAT
        WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
        workBook.Metadata.Author = "Equipo Fiscal";

        // Add a worksheet for modelo 303 — 1T
        WorkSheet workSheet = workBook.CreateWorkSheet("Modelo 303 1T");

        // Cabeceras — solo columnas requeridas (LOPDGDD: datos mínimos)
        workSheet["A1"].Value = "NIF Declarante";
        workSheet["B1"].Value = "Ejercicio";
        workSheet["C1"].Value = "Período";
        workSheet["D1"].Value = "Base Imponible (EUR)";
        workSheet["E1"].Value = "Cuota IVA (EUR)";

        // Datos de ejemplo — 1T 2026
        workSheet["A2"].Value = "B12345678";
        workSheet["B2"].Value = "2026";
        workSheet["C2"].Value = "1T";
        workSheet["D2"].Value = 48750.00;
        workSheet["E2"].Value = 10237.50;

        // Save the Excel file — modelo_303_1T_2026.xlsx
        workBook.SaveAs("modelo_303_1T_2026.xlsx");
    }
}

Imports System

Friend Class Program
    Shared Sub Main(args As String())
        ' Create a new workbook in the XLSX format — Excel sin Office para declaraciones AEAT
        Dim workBook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
        workBook.Metadata.Author = "Equipo Fiscal"

        ' Add a worksheet for modelo 303 — 1T
        Dim workSheet As WorkSheet = workBook.CreateWorkSheet("Modelo 303 1T")

        ' Cabeceras — solo columnas requeridas (LOPDGDD: datos mínimos)
        workSheet("A1").Value = "NIF Declarante"
        workSheet("B1").Value = "Ejercicio"
        workSheet("C1").Value = "Período"
        workSheet("D1").Value = "Base Imponible (EUR)"
        workSheet("E1").Value = "Cuota IVA (EUR)"

        ' Datos de ejemplo — 1T 2026
        workSheet("A2").Value = "B12345678"
        workSheet("B2").Value = "2026"
        workSheet("C2").Value = "1T"
        workSheet("D2").Value = 48750.0
        workSheet("E2").Value = 10237.5

        ' Save the Excel file — modelo_303_1T_2026.xlsx
        workBook.SaveAs("modelo_303_1T_2026.xlsx")
    End Sub
End Class

El código anterior demuestra cómo crear un fichero XLSX para el modelo 303 usando IronXL en C#. Crea un nuevo libro en formato XLSX, establece metadatos del autor, agrega una hoja de cálculo con las columnas mínimas que exige la AEAT (NIF, ejercicio, período, base imponible y cuota) y guarda el fichero. La restricción de columnas es deliberada: la LOPDGDD obliga a no exportar más datos personales de los estrictamente necesarios para la declaración.

Este mismo patrón se aplica al modelo 390 (resumen anual de IVA), al modelo 347 (operaciones con terceros superiores a 3.005,06 €) y al modelo 130 (pago fraccionado del IRPF para autónomos).

IronXL ofrece una gama de funcionalidades para trabajar con archivos de Excel, incluyendo creación, manipulación y guardado en varios formatos como XLSX, CSV, TSV, JSON, XML y HTML. También puedes cargar hojas de cálculo existentes para modificarlas o gestionar varias hojas dentro de un solo libro de trabajo.

La salida es como:

¿Cómo aplico formato y estilos a los archivos de Excel?

IronXL te permite formatear celdas, aplicar estilos de fuente, establecer colores de fondo y ajustar alineación. Puedes crear hojas de cálculo de apariencia profesional personalizando la apariencia de las celdas. La biblioteca admite un estilo completo de celdas que incluye bordes, fuentes y opciones de alineación.

// Set style of heading for cell A1
workSheet["A1"].Style.BackgroundColor = "#FFFF66"; // Light yellow background
workSheet["A1"].Style.Font.Bold = true; // Bold font

// Set border style for a specific range (A1:A4)
var range = workSheet["A1:A4"];
range.Style.BottomBorder.Type = BorderType.Medium; // Medium bottom border
range.Style.LeftBorder.Type = BorderType.Medium; // Medium left border
range.Style.RightBorder.Type = BorderType.Medium; // Medium right border
range.Style.TopBorder.Type = BorderType.Medium; // Medium top border

// Set style of heading for cell A1
workSheet["A1"].Style.BackgroundColor = "#FFFF66"; // Light yellow background
workSheet["A1"].Style.Font.Bold = true; // Bold font

// Set border style for a specific range (A1:A4)
var range = workSheet["A1:A4"];
range.Style.BottomBorder.Type = BorderType.Medium; // Medium bottom border
range.Style.LeftBorder.Type = BorderType.Medium; // Medium left border
range.Style.RightBorder.Type = BorderType.Medium; // Medium right border
range.Style.TopBorder.Type = BorderType.Medium; // Medium top border

' Set style of heading for cell A1
workSheet("A1").Style.BackgroundColor = "#FFFF66" ' Light yellow background
workSheet("A1").Style.Font.Bold = True ' Bold font

' Set border style for a specific range (A1:A4)
Dim range = workSheet("A1:A4")
range.Style.BottomBorder.Type = BorderType.Medium ' Medium bottom border
range.Style.LeftBorder.Type = BorderType.Medium ' Medium left border
range.Style.RightBorder.Type = BorderType.Medium ' Medium right border
range.Style.TopBorder.Type = BorderType.Medium ' Medium top border

El código anterior demuestra cómo personalizar la apariencia de celdas específicas en una hoja de cálculo de Excel usando IronXL en C#. Primero establece el color de fondo y patrón de la celda A1 a un tono amarillo claro y hace que la fuente sea negrita, dando estilo efectivamente como encabezado.

A continuación, define un rango que abarca las celdas A1 a A4 y establece bordes de peso medio a lo largo de los bordes inferior, izquierdo, derecho y superior de este rango, mejorando su distinción visual dentro de la hoja de cálculo. Estas opciones de estilo permiten a los desarrolladores crear documentos de Excel visualmente atractivos y organizados según sus necesidades específicas. También puedes establecer formatos de datos de celda para números, fechas y monedas.

La salida es como:

¿Cómo agrego fórmulas y cálculos?

Puedes agregar fórmulas a las celdas programáticamente. IronXL admite una amplia gama de funciones de Excel y operaciones matemáticas. La biblioteca puede establecer tanto fórmulas como evaluar sus resultados.

// Add a new column to display the length of developer names
workSheet["B1"].Value = "Name Length";
workSheet["B1"].Style.BackgroundColor = "#FFFF66"; // Styled as heading
workSheet["B1"].Style.Font.Bold = true; // Bold font

// Formula to calculate the length of names in column B
workSheet["B2"].Value = "=LEN(A2)";
workSheet["B3"].Value = "=LEN(A3)";
workSheet["B4"].Value = "=LEN(A4)";

// Add a total count of the length of names in cell A5
workSheet["A5"].Value = "Sum of Length";
workSheet["B5"].Formula = "=SUM(B2:B4)";

// Add a new column to display the length of developer names
workSheet["B1"].Value = "Name Length";
workSheet["B1"].Style.BackgroundColor = "#FFFF66"; // Styled as heading
workSheet["B1"].Style.Font.Bold = true; // Bold font

// Formula to calculate the length of names in column B
workSheet["B2"].Value = "=LEN(A2)";
workSheet["B3"].Value = "=LEN(A3)";
workSheet["B4"].Value = "=LEN(A4)";

// Add a total count of the length of names in cell A5
workSheet["A5"].Value = "Sum of Length";
workSheet["B5"].Formula = "=SUM(B2:B4)";

' Add a new column to display the length of developer names
workSheet("B1").Value = "Name Length"
workSheet("B1").Style.BackgroundColor = "#FFFF66" ' Styled as heading
workSheet("B1").Style.Font.Bold = True ' Bold font

' Formula to calculate the length of names in column B
workSheet("B2").Value = "=LEN(A2)"
workSheet("B3").Value = "=LEN(A3)"
workSheet("B4").Value = "=LEN(A4)"

' Add a total count of the length of names in cell A5
workSheet("A5").Value = "Sum of Length"
workSheet("B5").Formula = "=SUM(B2:B4)"

El código anterior ilustra cómo usar fórmulas y funciones en IronXL para calcular la longitud de los nombres de los desarrolladores y computar la suma de estas longitudes dentro de una hoja de cálculo de Excel. A través de esta demostración, los desarrolladores pueden entender cómo integrar fórmulas y funciones en IronXL para realizar cálculos dinámicos y manipulaciones dentro de las hojas de cálculo de Excel programáticamente, ofreciendo flexibilidad y automatización en tareas de procesamiento de datos.

Primero, se agrega un encabezado titulado "Longitud del Nombre" a la celda B1, con estilo para resaltar su importancia. A continuación, se aplican fórmulas a las celdas B2, B3 y B4 para calcular la longitud de cada nombre de desarrollador usando la función LEN, haciendo referencia a la celda correspondiente en la columna A. Esto permite calcular automáticamente las longitudes de los nombres a medida que cambian.

Además, un recuento total de las longitudes de los nombres se calcula en la celda B5 utilizando la función SUM, que suma los valores de las celdas B2 a B4. También puedes usar otras funciones agregadas como AVERAGE, MIN y MAX.

Al incorporar estas fórmulas, la hoja de cálculo se actualiza dinámicamente. Si bien este caso de uso específico puede no ser práctico, sirve como un ejemplo de cómo usar fórmulas de Excel en código.

Cumplimiento regulatorio español: TicketBAI, VeriFactu y LOPDGDD con IronXL

¿Cuáles son mis próximos pasos con IronXL?

En resumen, este tutorial ha demostrado cómo crear un nuevo libro de Excel en C# usando IronXL, una robusta biblioteca que facilita la manipulación de archivos de Excel en el ecosistema de C#. Con IronXL, los desarrolladores pueden integrar sin problemas la funcionalidad de Excel en sus aplicaciones — desde generar los modelos 303, 347 y 390 de la AEAT hasta preparar informes para el Banco de España y la CNMV, o exportar registros compatibles con TicketBAI y VeriFactu. Junto con su capacidad para realizar tareas como formateo, estilización y aplicación de fórmulas, IronXL ofrece un conjunto de características integral para una gestión y análisis de datos eficientes.

Para referencias sobre cómo usar IronXL, visita la página de documentación. IronXL también ofrece una colección de ejemplos de código que son útiles para comenzar. Explora escenarios avanzados como crear gráficos, trabajar con rangos nombrados o proteger hojas de trabajo.

Los desarrolladores pueden explorar IronXL a través de su prueba gratuita y compra, asegurando una transición sin problemas de la evaluación a la implementación a gran escala. Para más detalles sobre licencias perpetuas, visita la página de licencias. Considera explorar extensiones de licencia para características adicionales.