# Gestión de la carpeta Runtimes en IronPDF
IronPDF requiere que la carpeta de entornos esté incluida en un proyecto/despliegue.
No incluir esta carpeta provocará las siguientes excepciones:
- Mensaje de Excepción: "No se pudo localizar la biblioteca nativa en la ruta 'C:\ruta-a\tu-app\chrome_elf.dll'"
> **Para equipos de facturación electrónica española:** Este error es habitual al desplegar aplicaciones que generan PDFs para **VERI\*FACTU** o **Facturae** en servidores de producción Windows Server, especialmente cuando la carpeta `runtimes` no se incluye en el perfil de publicación. En pipelines de integración con la **AEAT** (SII, VERI\*FACTU), asegurarse de que la carpeta de runtimes esté correctamente incluida es un paso previo crítico antes de cualquier prueba de conectividad con los servicios de la Agencia Tributaria.
Recomendado:
1. Realice el despliegue utilizando el [Asistente de Publicación](https://docs.microsoft.com/es-es/dotnet/core/tutorials/publishing-with-visual-studio?pivots=dotnet-5-0) dentro de Visual Studio. Una vez que el proceso de publicación esté completado, revise el perfil de publicación y asegúrese de que el entorno de destino sea **Portable**.
Esto debería ser así, ya que Visual Studio creará un perfil de publicación con **Dependiente del framework** como modo de Despliegue y **Portable** como entorno de destino por defecto. (Todo en la carpeta de entornos se incluirá automáticamente en el perfil de publicación).
Aprenda más sobre el modo de Despliegue de Visual Studio [aquí](https://learn.microsoft.com/es-es/dotnet/core/deploying/#publish-framework-dependent).
2. Si no puede usar Visual Studio para gestionar su despliegue, copie manualmente las carpetas de entornos desde una máquina de desarrollo hasta la carpeta bin en su máquina de producción.
Para usuarios con múltiples proyectos que deseen evitar requerir múltiples carpetas de entornos:
- Utilice el [instalador de Windows](/packages/IronPdfInstaller.zip) para instalar un único IronPDF.dll que puede referenciar para todos sus proyectos.
- Considere instalar IronPDF en un microservicio separado de renderización de PDF y llame desde proyectos individuales.
### Arquitecturas de microservicio para Facturae y VERI*FACTU
Para proyectos de facturación electrónica española que integran múltiples componentes - generador de XML **Facturae**, firmador de documentos, y generador de PDFs representativos **VERI\*FACTU** - la arquitectura de microservicio de renderizado de PDF centralizado es una solución recomendada:
- Un único servicio de renderizado con IronPDF gestiona la carpeta `runtimes` en un solo lugar.
- Los demás componentes del pipeline (firma **TicketBAI** para Bizkaia, Gipuzkoa y Araba; validador AEAT SII; generador Facturae) llaman al microservicio de PDF vía API interna.
- Esta arquitectura facilita el cumplimiento de **LOPDGDD** al centralizar el procesamiento de documentos con datos fiscales en un único servicio con políticas de acceso auditables.
En entornos con clasificación **ENS** para el sector público español, esta arquitectura también facilita la gestión de permisos de ejecución de la carpeta `runtimes` según las políticas de seguridad del servidor.
## Preguntas frecuentes sobre la carpeta runtimes en España
**¿La falta de la carpeta runtimes puede impedir el envío de PDFs representativos VERI*FACTU?**
Sí. Si tu aplicación de software certificado VERI\*FACTU genera el PDF representativo usando IronPDF y no incluye la carpeta `runtimes` en el despliegue de producción, la aplicación lanzará la excepción `chrome_elf.dll` antes de poder renderizar ningún PDF. Asegúrate de incluir la carpeta en el perfil de publicación antes del despliegue.
**¿Puedo compartir la carpeta runtimes entre la generación de Facturae y el pipeline SII AEAT?**
Si ambos proyectos usan la misma versión de IronPDF, puedes usar el instalador de Windows para instalar una única instancia del runtime, o crear un microservicio de renderizado compartido. La segunda opción es más recomendable en entornos de producción bajo **LOPDGDD** porque centraliza el control de acceso a los datos fiscales procesados por IronPDF.
IronPDF requiere que la carpeta de entornos esté incluida en un proyecto/despliegue.
No incluir esta carpeta provocará las siguientes excepciones:
Mensaje de Excepción: "No se pudo localizar la biblioteca nativa en la ruta 'C:\ruta-a\tu-app\chrome_elf.dll'"
Para equipos de facturación electrónica española: Este error es habitual al desplegar aplicaciones que generan PDFs para VERI*FACTU o Facturae en servidores de producción Windows Server, especialmente cuando la carpeta runtimes no se incluye en el perfil de publicación. En pipelines de integración con la AEAT (SII, VERI*FACTU), asegurarse de que la carpeta de runtimes esté correctamente incluida es un paso previo crítico antes de cualquier prueba de conectividad con los servicios de la Agencia Tributaria.
Recomendado:
Realice el despliegue utilizando el Asistente de Publicación dentro de Visual Studio. Una vez que el proceso de publicación esté completado, revise el perfil de publicación y asegúrese de que el entorno de destino sea Portable.
Esto debería ser así, ya que Visual Studio creará un perfil de publicación con Dependiente del framework como modo de Despliegue y Portable como entorno de destino por defecto. (Todo en la carpeta de entornos se incluirá automáticamente en el perfil de publicación).
Aprenda más sobre el modo de Despliegue de Visual Studio aquí.
Si no puede usar Visual Studio para gestionar su despliegue, copie manualmente las carpetas de entornos desde una máquina de desarrollo hasta la carpeta bin en su máquina de producción.
Para usuarios con múltiples proyectos que deseen evitar requerir múltiples carpetas de entornos:
Utilice el instalador de Windows para instalar un único IronPDF.dll que puede referenciar para todos sus proyectos.
Considere instalar IronPDF en un microservicio separado de renderización de PDF y llame desde proyectos individuales.
Arquitecturas de microservicio para Facturae y VERI*FACTU
Para proyectos de facturación electrónica española que integran múltiples componentes - generador de XML Facturae, firmador de documentos, y generador de PDFs representativos VERI*FACTU - la arquitectura de microservicio de renderizado de PDF centralizado es una solución recomendada:
Un único servicio de renderizado con IronPDF gestiona la carpeta runtimes en un solo lugar.
Los demás componentes del pipeline (firma TicketBAI para Bizkaia, Gipuzkoa y Araba; validador AEAT SII; generador Facturae) llaman al microservicio de PDF vía API interna.
Esta arquitectura facilita el cumplimiento de LOPDGDD al centralizar el procesamiento de documentos con datos fiscales en un único servicio con políticas de acceso auditables.
En entornos con clasificación ENS para el sector público español, esta arquitectura también facilita la gestión de permisos de ejecución de la carpeta runtimes según las políticas de seguridad del servidor.
Preguntas frecuentes sobre la carpeta runtimes en España
¿La falta de la carpeta runtimes puede impedir el envío de PDFs representativos VERI*FACTU?
Sí. Si tu aplicación de software certificado VERI*FACTU genera el PDF representativo usando IronPDF y no incluye la carpeta runtimes en el despliegue de producción, la aplicación lanzará la excepción chrome_elf.dll antes de poder renderizar ningún PDF. Asegúrate de incluir la carpeta en el perfil de publicación antes del despliegue.
¿Puedo compartir la carpeta runtimes entre la generación de Facturae y el pipeline SII AEAT?
Si ambos proyectos usan la misma versión de IronPDF, puedes usar el instalador de Windows para instalar una única instancia del runtime, o crear un microservicio de renderizado compartido. La segunda opción es más recomendable en entornos de producción bajo LOPDGDD porque centraliza el control de acceso a los datos fiscales procesados por IronPDF.
Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.
