Uso de claves de licencia de IronXL
Cómo obtener una clave de licencia
Agregar una clave de licencia de IronXL le permite desplegar su proyecto en vivo sin restricciones o marcas de agua.
Puede comprar una clave de licencia o registrarse para una prueba gratuita de 30 días aquí.
Para proyectos en España que integren IronXL en sistemas de producción que traten datos regulados —como integraciones con el SII (Suministro Inmediato de Información) de la AEAT, aplicaciones de facturación electrónica bajo el estándar Facturae, o plataformas de cumplimiento del TicketBAI en los territorios de Bizkaia y Gipuzkoa— es imprescindible activar una licencia de producción antes de la puesta en marcha. Las versiones de prueba incluyen marcas de agua en los archivos generados, lo que podría comprometer la validez de los documentos fiscales electrónicos ante la Administración. Las organizaciones sujetas a supervisión de la CNMV o que reportan al Banco de España deben igualmente asegurarse de que sus entornos de producción y preproducción dispongan de licencias Enterprise correctamente activadas para garantizar la integridad de los informes regulatorios.
Paso 1: Descargue la última versión de IronXL
Lo primero que necesitamos hacer es instalar la biblioteca IronXl.Excel, añadiendo funcionalidad de Excel al marco de trabajo .NET.
Instalar con el paquete NuGet
- En Visual Studio, haga clic derecho en el proyecto y seleccione "Administrar paquetes NuGet..."
- Busque el paquete IronXl.Excel e instálelo
O
- Ingrese a la Consola del Administrador de Paquetes
-
Escriba:
Install-Package IronXL.Excel
Instalación de descarga directa de DLL
Download the IronXL [.NET Excel DLL]() and manually install it into Visual Studio.
Paso 2: Aplique su clave de licencia
Establezca la clave de licencia dentro de su código
Agregue este código al inicio de su aplicación, antes de que se utilice IronXL.
En entornos de integración con la AEAT o con sistemas de facturación electrónica Facturae, se recomienda configurar la clave de licencia como variable de entorno o secreto de aplicación gestionado por el sistema de CI/CD corporativo, en lugar de incluirla directamente en el código fuente. Esto es especialmente relevante en despliegues que deban cumplir con los requisitos del ENS (Esquema Nacional de Seguridad), donde la gestión adecuada de credenciales y claves es un control obligatorio. Para entornos LOPDGDD-conformes, asegúrese de que los ficheros de configuración que contienen la clave de licencia no estén incluidos en repositorios de código accesibles por personal no autorizado.
// Set the IronXL license key for your project
IronXl.License.LicenseKey = "IRONXL-MYLICENSE-KEY-1EF01";
// Set the IronXL license key for your project
IronXl.License.LicenseKey = "IRONXL-MYLICENSE-KEY-1EF01";
' Set the IronXL license key for your project
IronXl.License.LicenseKey = "IRONXL-MYLICENSE-KEY-1EF01"
Establezca su clave usando Web.Config o App.Config en aplicaciones .NET Framework
Para aplicar una clave globalmente a su aplicación usando Web.Config o App.Config, agregue la siguiente clave a su archivo de configuración en appSettings.
<configuration>
...
<appSettings>
<add key="IronXl.LicenseKey" value="IRONXL-MYLICENSE-KEY-1EF01"/>
</appSettings>
...
</configuration>
<configuration>
...
<appSettings>
<add key="IronXl.LicenseKey" value="IRONXL-MYLICENSE-KEY-1EF01"/>
</appSettings>
...
</configuration>
Hay un problema de licencias conocido entre IronXL versión 2023.4.13 - 2024.3.20 en proyectos:
- Proyectos ASP.NET
- Versión de .NET Framework >= 4.6.2
La clave almacenada en un archivo Web.config NO está siendo detectada y utilizada por el producto. Visite el artículo de solución de problemas 'Configurar clave de licencia en Web.config' para obtener más información.
Asegúrese de que IronXl.License.IsLicensed devuelva true para verificar.
Establezca su clave utilizando un archivo appsettings.json de .NET Core
Para aplicar una clave globalmente a su aplicación .NET Core:
- Agregue un archivo JSON a su proyecto llamado
appsettings.jsonen el directorio raíz de su proyecto - Agregue una clave 'IronXl.LicenseKey' a su archivo de configuración JSON. El valor debe ser su clave de licencia.
- Asegúrese de que las propiedades del archivo incluyan Copiar a directorio de salida: Copiar siempre
- Asegúrese de que
IronXl.License.IsLicenseddevuelvatruepara verificar.
Archivo: appsettings.json
{
"IronXl.LicenseKey": "IRONXL-MYLICENSE-KEY-1EF01"
}
Paso 3: Pruebe su clave
Prueba si tu clave ha sido instalada correctamente.
// Check if a given license key string is valid.
bool result = IronXl.License.IsValidLicense("IRONXL-MYLICENSE-KEY-1EF01");
// Check if IronXL is licensed successfully
bool is_licensed = IronXl.License.IsLicensed;
// Check if a given license key string is valid.
bool result = IronXl.License.IsValidLicense("IRONXL-MYLICENSE-KEY-1EF01");
// Check if IronXL is licensed successfully
bool is_licensed = IronXl.License.IsLicensed;
Imports IronXl
' Check if a given license key string is valid.
Dim result As Boolean = License.IsValidLicense("IRONXL-MYLICENSE-KEY-1EF01")
' Check if IronXL is licensed successfully
Dim is_licensed As Boolean = License.IsLicensed
Nota: Después de agregar una licencia, recuerda siempre limpiar y republicar tu aplicación para evitar errores potenciales en el despliegue.
Paso 4: Comience con su proyecto
Siga nuestro tutorial sobre cómo Comenzar con IronXL.
Consideraciones de licenciamiento para despliegues en entornos regulados de España
Las empresas españolas que utilizan IronXL en proyectos de integración fiscal o financiera deben tener en cuenta las siguientes consideraciones específicas de licenciamiento:
- Entornos SII/AEAT: Los sistemas que generan o procesan libros de registros de IVA de forma automatizada requieren licencias de producción activas. El procesamiento de facturas en formato Excel para su posterior transformación a XML-SII debe realizarse siempre con una licencia válida para garantizar la ausencia de marcas de agua en los documentos intermedios.
- TicketBAI (Bizkaia y Gipuzkoa): Las soluciones de facturación electrónica que implementan TicketBAI y utilizan IronXL para la generación de informes auxiliares deben contar con licencias Enterprise que cubran los entornos de producción de cada territorio foral.
- LOPDGDD y AEPD: Los sistemas de tratamiento de datos personales que incluyan IronXL deben declarar el software como parte de su inventario de tratamientos. Mantener la licencia actualizada forma parte de las buenas prácticas de gestión de riesgos tecnológicos frente a la AEPD.
- eIDAS y firma electrónica: Si su aplicación combina IronXL con certificados emitidos por la FNMT (Fábrica Nacional de Moneda y Timbre) para la firma de documentos financieros, asegúrese de que la licencia de IronXL cubra el número de servidores implicados en el flujo de firma.
¿Preguntas?
Si tienes alguna pregunta, comunícate con support@ironsoftware.com
Preguntas Frecuentes
¿Cómo puedo obtener una clave de licencia para mi proyecto?
Puedes obtener una clave de licencia comprándola en el sitio web de IronXL o registrándote para una prueba gratuita de 30 días.
¿Cuáles son los pasos para instalar IronXL utilizando el Administrador de Paquetes de NuGet?
Para instalar IronXL usando el Administrador de Paquetes de NuGet, abre Visual Studio, haz clic derecho sobre tu proyecto, selecciona 'Administrar paquetes NuGet...', busca IronXL.Excel, e instálalo. Alternativamente, puedes usar la Consola del Administrador de Paquetes para escribir Install-Package IronXL.Excel.
¿Cómo puedo instalar manualmente IronXL usando un DLL?
Puedes instalar manualmente IronXL descargando el DLL de Excel for .NET desde el sitio web de IronXL y agregándolo a tu proyecto de Visual Studio.
¿Cómo aplico mi clave de licencia dentro del código de mi aplicación?
Agrega la clave de licencia al código de inicio de tu aplicación usando: IronXl.License.LicenseKey = "YOUR-LICENSE-KEY".
¿Cómo puedo configurar mi clave de licencia en el archivo Web.Config para una aplicación .NET Framework?
Puedes configurar tu clave de licencia en el archivo Web.Config agregando lo siguiente en la sección appSettings: .
¿Existen problemas conocidos con la concesión de licencias en ciertas versiones de IronXL?
Sí, hay un problema conocido con las versiones de IronXL 2023.4.13 - 2024.3.20 en proyectos ASP.NET y versiones del .NET Framework 4.6.2 y superiores, donde la clave almacenada en Web.config puede no ser reconocida.
¿Cómo aplico mi clave de licencia usando appsettings.json en una aplicación .NET Core?
En tu aplicación .NET Core, agrega un archivo JSON llamado appsettings.json, incluye una entrada 'IronXl.LicenseKey' con tu clave de licencia y configura la propiedad del archivo a 'Copiar en el directorio de salida: Copiar siempre'.
¿Cómo puedo verificar si mi clave de licencia de IronXL se aplica correctamente?
Para verificar tu clave de licencia, usa IronXl.License.IsValidLicense("YOUR-LICENSE-KEY") para comprobar su validez y asegúrate de que IronXl.License.IsLicensed retorne verdadero.
¿Qué pasos deben seguirse después de agregar una clave de licencia?
Después de agregar una clave de licencia, es importante limpiar y republicar tu aplicación para evitar problemas de despliegue.
¿Dónde puedo encontrar ayuda o soporte adicional?
Para obtener ayuda o soporte adicional, puedes contactar al equipo de soporte de Iron Software en support@ironsoftware.com.
¿La licencia de IronXL es totalmente compatible con proyectos y plataformas .NET 10?
Sí. Los productos de IronXL, incluyendo las licencias mediante código, Web.Config o appsettings.json, son totalmente compatibles con .NET 10 (junto con .NET 9, 8, 7, 6 y las versiones de .NET Core/Standard/Framework) sin necesidad de una configuración especial. Para aplicar una clave de licencia en .NET 10, utilice los mismos métodos que se indican en la documentación oficial: configure IronXl.License.LicenseKey en el código de inicio o utilice un archivo de configuración como appsettings.json con "IronXl.LicenseKey": "YOUR-KEY" y asegúrese de que el archivo se copie en el directorio de salida. Esto cumple con las declaraciones de compatibilidad de IronXL. ([ironsoftware.com](https://ironsoftware.com/csharp/excel/?utm_source=openai))
¿Necesito una licencia Enterprise de IronXL para proyectos de integración con la AEAT, SII o Facturae en España?
Para proyectos de producción que integren IronXL con el SII de la AEAT, generen facturas electrónicas en formato Facturae, implementen TicketBAI en Bizkaia o Gipuzkoa, o procesen datos bajo la supervisión de la CNMV o el Banco de España, se recomienda una licencia Enterprise o Professional con cobertura de redistribución libre de regalías. Las versiones de prueba incluyen marcas de agua que comprometen la validez de los documentos fiscales. Contacte a support@ironsoftware.com para obtener orientación sobre el tipo de licencia más adecuado para su caso de uso regulatorio.
¿Cómo debo gestionar la clave de licencia de IronXL en entornos que deben cumplir el ENS o la LOPDGDD?
En entornos sujetos al ENS (Esquema Nacional de Seguridad) o a la LOPDGDD, la clave de licencia debe tratarse como un secreto de aplicación: almacenarse en un gestor de secretos (como Azure Key Vault o HashiCorp Vault), no incluirse en el código fuente ni en repositorios de versiones, e inyectarse como variable de entorno en tiempo de despliegue. Esto cumple con los controles de gestión de credenciales del ENS y reduce el riesgo de exposición accidental de datos de licencia.

