Logit.Utils.Excel 1.2.0

📦 Logit.Utils.Excel

Utilidad reusable para lectura estructurada de archivos Excel basada en EPPlus 8.4.0, diseñada para ser utilizada en microservicios .NET, procesos de carga masiva, validación previa y pipelines de procesamiento de archivos.

Este paquete NO contiene lógica de negocio, solo se encarga de leer Excel de forma consistente y predecible.

🎯 Objetivo

Centralizar la lectura de archivos Excel en un paquete común reutilizable entre microservicios, evitando:

• Duplicar lógica de lectura
• Dependencias directas a EPPlus en cada servicio
• Errores por cambios de formato en archivos Excel

✨ Características

• ✔ Compatible con .NET 8
• ✔ Basado en EPPlus 8.4.0
• ✔ Licencia No Comercial
• ✔ Lectura por definición de hoja (ExcelSheetDefinition)
• ✔ Integración sencilla con Dependency Injection
• ✔ Pensado para flujos: Blob Storage → Validación → Bulk Insert

📁 Estructura del paquete

Logit.Utils.Excel
│
├── Abstractions
│   └── IExcelReader.cs
│
├── Models
│   └── ExcelSheetDefinition.cs
│
├── Services
│   └── EpplusExcelReader.cs
│
├── Bootstrap
│   └── EpplusBootstrap.cs
│
├── Extensions
│   └── ExcelServiceCollectionExtensions.cs
│
├── LICENSE.txt
└── README.md

📄 ExcelSheetDefinition

Define cómo debe leerse un archivo Excel sin acoplarte al DTO ni a la base de datos.

public static class ServiceProvidersExcelDefinition
{
    public static ExcelSheetDefinition Actual => new()
    {
        SheetName = "Datos",
        HeaderRow = 1,
        Columns = new()
        {
            { "Tipo de identificación (obligatorio)", 1 },
            { "Número de identificación (obligatorio - sin dígito de verificación)", 2 },
            { "Razón social o nombre completo (obligatorio)", 3 },
            { "Funciones (obligatorio)", 4 },
            { "Ciudad (sede principal)", 5 },
            { "Dirección (sede principal)", 6 },
            { "Código postal", 7 },
            { "Teléfono", 8 },
            { "Moneda", 9 },
            { "Medio de pago", 10 },
            { "Plazo de pago", 11 },
            { "Usuario responsable (email)", 12 },
            { "Código banco central (Solo para IMC)", 13 },
            { "Código de integración", 14 },
            { "Incoterm", 15 }
        }
    };
}

📌 Importante:
Los nombres de las columnas deben ser idénticos a los del Excel, incluyendo tildes y textos entre paréntesis.

📦 Instalación

dotnet add package Logit.Utils.Excel

🔧 Configuración (Dependency Injection)

builder.Services.AddLogitExcel();

Esto:

• Configura la licencia No Comercial de EPPlus
• Registra IExcelReader<T>

📥 Uso básico

var rows = await _excelReader.ReadAsync<ServiceProvidersExcelDto>(
    excelBytes,
    ServiceProvidersExcelDefinition.Actual,
    cancellationToken
);

excelBytes normalmente proviene de:

• Azure Blob Storage
• Email
• API Gateway

⚖ Licencia EPPlus

Este paquete usa EPPlus bajo licencia No Comercial.

ExcelPackage.License = LicenseContext.NonCommercial;

Si necesitas uso comercial, deberás adquirir una licencia EPPlus válida.

📄 Licencia

MIT License © Logit