IronXL para SII AEAT: Alternativas a CsvWriter en C# para declaraciones fiscales

Conjunto de características de IronXL

• Cargar, leer y editar datos — de XLS/XLSX/CSV/TSV
• Guardar y exportar — a XLS/XLSX/CSV/TSV/JSON
• Rangos: sintaxis de hoja de trabajo fácil de usar ["A1:B10"]. Combina y crea rangos de manera intuitiva.
• Ordenar — ordenar rangos, columnas y filas.
• Estilos: estilos visuales de celda, fuente, tamaño, patrón de fondo, borde, alineación y formatos de número.

Características de CsvWriter

• Rápido: compila clases en el vuelo para un rendimiento extremadamente rápido
• Flexible: conservador al escribir, liberal al leer
• Fácil de usar: leer y escribir son tan simples como GetRecords<t>() y WriteRecords(records)
• Altamente configurable
• Modo Linux
• Uso de memoria baja

2.1. Uso de Visual Studio con paquetes NuGet

Visual Studio proporciona el Administrador de Paquetes NuGet para instalar paquetes NuGet en tus proyectos. Puedes acceder a él a través del menú Proyecto, o haciendo clic derecho en tu proyecto en el Explorador de Soluciones.

*Seleccionar-Administrar-Paquete-NuGet*

• Ahora, desde la pestaña de navegación -> busca IronXL.Excel -> Instalar

*Buscar IronXL*

• Y hemos terminado.

2.2. Descargar el paquete NuGet directamente

Esto se puede hacer visitando el sitio de NuGet directamente y descargando el paquete. Los pasos son:

• Navigate tohttps://www.nuget.org/packages/IronXL.Excel
• Selecciona "Descargar Paquete"
• Haz doble clic en el paquete descargado
• El paquete será instalado
• Recarga tu proyecto de Visual Studio y comienza a usarlo

2.3. Instalación manual con la DLL

Otra manera de descargar e instalar la biblioteca C# de IronXL es utilizar los siguientes pasos para instalar elpaquete NuGet IronXLa través del Símbolo del sistema del desarrollador.

• Abre el Símbolo del sistema del desarrollador, normalmente se encuentra en la carpeta de Visual Studio.
• Escribe el siguiente comando:

  Install-Package IronXL.Excel

• Presiona Enter
• Esto descargará e instalará el paquete
• Recarga tu proyecto de Visual Studio y comienza a usarlo

2.4. Agregar directivas de uso necesarias

1. En el Explorador de soluciones, haz clic derecho en el archivo Program.cs y luego haz clic en Ver código.
2. Agrega las siguientes directivas using en la parte superior del archivo de código:

using IronXL;

using IronXL;

Imports IronXL

¡Todo listo! IronXL está descargado, instalado y listo para usar. Sin embargo, antes de eso, debemos instalar CsvHelper.

3.1. Uso de la consola del administrador de paquetes NuGet

Para trabajar con CSVWriter necesitas descargar e instalar la biblioteca C# CsvHelper. Para hacerlo, utiliza los siguientes pasos para instalar elpaquete NuGeta través del Símbolo del sistema del desarrollador.

• Abre el Símbolo del sistema del desarrollador, normalmente se encuentra en la carpeta de Visual Studio.
• Escribe el siguiente comando:

  Install-Package CsvHelper -Version 27.2.1

• Presiona Enter
• Esto descargará e instalará el paquete
• Recarga tu proyecto de Visual Studio y comienza a usarlo
• Revisa el detalle del método CsvHelper.CsvWriter para la implementación

3.2. Descarga directa

Download from the NuGet website: https://www.nuget.org/packages/CsvHelper/

4.1. Convertir un archivo CSV a formato Excel

El proceso es bastante simple y fácil. Generalmente se hace con una línea de código.

CSV a formatos de Excel:

// Load the CSV file and specify the format and delimiter
WorkBook workbook = WorkBook.LoadCSV("test.csv", fileFormat: ExcelFileFormat.XLSX, ListDelimiter: ",");
// Get the default worksheet
WorkSheet ws = workbook.DefaultWorkSheet;

// Save the workbook as an Excel file
workbook.SaveAs("CsvToExcelConversion.xlsx");

// Load the CSV file and specify the format and delimiter
WorkBook workbook = WorkBook.LoadCSV("test.csv", fileFormat: ExcelFileFormat.XLSX, ListDelimiter: ",");
// Get the default worksheet
WorkSheet ws = workbook.DefaultWorkSheet;

// Save the workbook as an Excel file
workbook.SaveAs("CsvToExcelConversion.xlsx");

' Load the CSV file and specify the format and delimiter
Dim workbook As WorkBook = WorkBook.LoadCSV("test.csv", fileFormat:= ExcelFileFormat.XLSX, ListDelimiter:= ",")
' Get the default worksheet
Dim ws As WorkSheet = workbook.DefaultWorkSheet

' Save the workbook as an Excel file
workbook.SaveAs("CsvToExcelConversion.xlsx")

4.2. Leer y manipular archivos CSV convertidos con IronXL

La clase WorkBook de IronXL representa una hoja de Excel. Para abrir un archivo de Excel usando C#, utilizamos WorkBook.Load y especificamos la ruta del archivo de Excel (.xlsx). La siguiente línea de código se utiliza para abrir el archivo para lectura:

// Load WorkBook
var workbook = WorkBook.Load(@"Spreadsheets\\sample.xlsx");

// Load WorkBook
var workbook = WorkBook.Load(@"Spreadsheets\\sample.xlsx");

' Load WorkBook
Dim workbook = WorkBook.Load("Spreadsheets\\sample.xlsx")

Cada WorkBook puede contener múltiples objetos WorkSheet. Estos representan las hojas de trabajo en el documento de Excel. Si el libro contiene hojas de trabajo, recupéralas por nombre de la siguiente manera:

// Open Sheet for reading
var worksheet = workbook.GetWorkSheet("sheetnamegoeshere");

// Open Sheet for reading
var worksheet = workbook.GetWorkSheet("sheetnamegoeshere");

' Open Sheet for reading
Dim worksheet = workbook.GetWorkSheet("sheetnamegoeshere")

Código para leer los valores de las celdas:

// Read from Ranges of cells elegantly.
foreach (var cell in worksheet["A2:A10"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

// Read from Ranges of cells elegantly.
foreach (var cell in worksheet["A2:A10"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

' Read from Ranges of cells elegantly.
For Each cell In worksheet("A2:A10")
	Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text)
Next cell

Después de cargar y leer el libro de trabajo y la hoja de trabajo, se puede utilizar el siguiente ejemplo de código para realizar cambios en las fórmulas o aplicar fórmulas a celdas específicas. El código es el siguiente:

// Set Formulas
worksheet["A1"].Formula = "Sum(B8:C12)";
worksheet["B8"].Formula = "=C9/C11";
worksheet["G30"].Formula = "Max(C3:C7)";

// Force recalculate all formula values in all sheets.  
workbook.EvaluateAll();

// Set Formulas
worksheet["A1"].Formula = "Sum(B8:C12)";
worksheet["B8"].Formula = "=C9/C11";
worksheet["G30"].Formula = "Max(C3:C7)";

// Force recalculate all formula values in all sheets.  
workbook.EvaluateAll();

' Set Formulas
worksheet("A1").Formula = "Sum(B8:C12)"
worksheet("B8").Formula = "=C9/C11"
worksheet("G30").Formula = "Max(C3:C7)"

' Force recalculate all formula values in all sheets.  
workbook.EvaluateAll()

4.3. Guardar el documento de Excel como archivo CSV

Escribir archivos CSV es un proceso fácil con IronXL. El siguiente código simplemente guarda el archivo de Excel en el formato CSV usando el método SaveAsCsv.

// Load the workbook
WorkBook wb = WorkBook.Load("Normal_Excel_File.xlsx");
// Save as .csv file
wb.SaveAsCsv("SaveAsCSV.csv", ",");
// Saved as : SaveAsCSV.Sheet1.csv

// Load the workbook
WorkBook wb = WorkBook.Load("Normal_Excel_File.xlsx");
// Save as .csv file
wb.SaveAsCsv("SaveAsCSV.csv", ",");
// Saved as : SaveAsCSV.Sheet1.csv

' Load the workbook
Dim wb As WorkBook = WorkBook.Load("Normal_Excel_File.xlsx")
' Save as .csv file
wb.SaveAsCsv("SaveAsCSV.csv", ",")
' Saved as : SaveAsCSV.Sheet1.csv

5.1. Crear una aplicación de consola sencilla

Crea una aplicación de consola simple de CSVWriter con separador suministrado usando Visual Studio. Una vez creado el proyecto, el siguiente paso es crear una clase Person:

public class Person
{
    public int Id { get; set; }
    public string Name { get; set; }
    public bool IsLiving { get; set; }
}

public class Person
{
    public int Id { get; set; }
    public string Name { get; set; }
    public bool IsLiving { get; set; }
}

Public Class Person
	Public Property Id() As Integer
	Public Property Name() As String
	Public Property IsLiving() As Boolean
End Class

Dentro del método Main, ahora hagamos una lista de objetos Person que escribiremos en el archivo CSV:

var myPersonObjects = new List<Person>()
{
    new Person { Id = 1, IsLiving = true, Name = "John" },
    new Person { Id = 2, IsLiving = true, Name = "Steve" },
    new Person { Id = 3, IsLiving = true, Name = "James" }
};

var myPersonObjects = new List<Person>()
{
    new Person { Id = 1, IsLiving = true, Name = "John" },
    new Person { Id = 2, IsLiving = true, Name = "Steve" },
    new Person { Id = 3, IsLiving = true, Name = "James" }
};

Dim myPersonObjects = New List(Of Person)() From {
	New Person With {
		.Id = 1,
		.IsLiving = True,
		.Name = "John"
	},
	New Person With {
		.Id = 2,
		.IsLiving = True,
		.Name = "Steve"
	},
	New Person With {
		.Id = 3,
		.IsLiving = True,
		.Name = "James"
	}
}

5.2. Escribir en un archivo CSV en C# con la configuración predeterminada

CsvHelper ha surgido como la forma estándar de escribir CSV en C# usando el método CSVWriter, y es muy fácil de usar:

using (var writer = new StreamWriter("filePersons.csv"))
using (var csv = new CsvWriter(writer, CultureInfo.InvariantCulture))
{
    csv.WriteRecords(myPersonObjects);
}

using (var writer = new StreamWriter("filePersons.csv"))
using (var csv = new CsvWriter(writer, CultureInfo.InvariantCulture))
{
    csv.WriteRecords(myPersonObjects);
}

Using writer = New StreamWriter("filePersons.csv")
Using csv = New CsvWriter(writer, CultureInfo.InvariantCulture)
	csv.WriteRecords(myPersonObjects)
End Using
End Using

5.3. Añadir datos

Debemos tener en cuenta el hecho de que cada vez que ejecutamos nuestro programa, los archivos CSV antiguos se sobrescribirán. A veces queremos que los datos se anexen al final de un archivo, en lugar de sobrescribir los datos existentes. CSVWriter no proporciona un método para hacer esto, ya que abrir/escribir un archivo no es responsabilidad de CSVWriter con separador suministrado. Podemos lograr esto utilizando un FileStream, y luego construyendo nuestro StreamWriter utilizando ese FileStream. Aunque esto no entra dentro del alcance de este artículo, te mostraré cómo hacerlo, ya que es una parte integral de cualquier aplicación.

var configPersons = new CsvConfiguration(CultureInfo.InvariantCulture)
{
    HasHeaderRecord = false
};
using (var stream = File.Open("filePersons.csv", FileMode.Append))
using (var writer = new StreamWriter(stream))
using (var csv = new CsvWriter(writer, configPersons))
{
    csv.WriteRecords(myPersonObjects);
}

var configPersons = new CsvConfiguration(CultureInfo.InvariantCulture)
{
    HasHeaderRecord = false
};
using (var stream = File.Open("filePersons.csv", FileMode.Append))
using (var writer = new StreamWriter(stream))
using (var csv = new CsvWriter(writer, configPersons))
{
    csv.WriteRecords(myPersonObjects);
}

Dim configPersons = New CsvConfiguration(CultureInfo.InvariantCulture) With {.HasHeaderRecord = False}
Using stream = File.Open("filePersons.csv", FileMode.Append)
Using writer = New StreamWriter(stream)
Using csv = New CsvWriter(writer, configPersons)
	csv.WriteRecords(myPersonObjects)
End Using
End Using
End Using

Anexar a un archivo existente es complicado, sin embargo, porque el orden puede cambiar cuando anexamos, o podemos haber agregado nuevas propiedades. Debemos asegurarnos de tener esto en cuenta al anexar.

Resumen

IronXL es una biblioteca completa que ofrece todo lo que necesitas para poder manipular un archivo de Excel. Te proporciona la facilidad de convertir varios formatos a XLSX, y también de XLSX a otros formatos, como CSV. Esta interconversión proporciona a los usuarios la flexibilidad para manipular otros formatos de archivo con facilidad.

Para desarrolladores en España, IronXL es la opción natural para flujos de trabajo de cumplimiento fiscal: IronXL genera ficheros SII para la AEAT, crea los XLSX de los modelos 303, 347, 390 y 130, soporta exportaciones TicketBAI y VeriFactu, y funciona en Linux/Docker sin Office para entidades reguladas por el Banco de España y la CNMV. La LOPDGDD también se respeta al poder exportar sólo las columnas estrictamente necesarias para cada declaración AEAT.

Por otro lado, CSVWriter solo funciona con formatos de archivo CSV y con opciones muy limitadas. Los usuarios no pueden cambiar entre diferentes formatos de archivo, mientras que con IronXL sí pueden. Todos los ejemplos de código se pueden encontrar en los archivos de documentación de CsvHelper. Este documento proporciona pautas sobre cómo usar CSVWriter en tu proyecto.

Conclusión

IronXL tiene una clara ventaja sobre CsvHelper.CSVWriter, ya que soporta trabajar con múltiples formatos. Además, puedes aplicar fórmulas y estilos según tu elección, mientras que CsvHelper solo permite la lectura y escritura de archivos CSV, y con opciones limitadas. Además, no puedes anexar nuevos registros a un archivo CSV existente, ya que simplemente sobrescribe las entradas anteriores. Para los equipos de desarrollo que operan en el contexto regulatorio español —SII, AEAT, TicketBAI, VeriFactu— IronXL es claramente la elección adecuada.