Cómo obtener el mejor soporte para IronOCR
Gracias por tomarse el tiempo para hacer que IronOCR funcione correctamente. Tenemos un equipo de ingenieros trabajando para mejorar IronOCR con lanzamientos regulares. Las actualizaciones a menudo se implementan en NuGet cada 1 a 2 meses.
Para ayudarnos a ayudarte, necesitamos categorizar el problema que estás teniendo en uno de los siguientes tipos:
Excepciones y errores
Si recibe un error fatal con IronOCR que le impide usar nuestro código, ¡queremos saberlo! Cuanto más claro sea el informe de errores, más rápido se resolverá. Por favor, infórmelo siguiendo las instrucciones en nuestra página de informe de excepciones y errores para aislar el problema.
- Leer nuestras guías de solución de problemas y las preguntas frecuentes del paquete de idiomas puede hacerle consciente de problemas comunes y limitaciones de IronOCR.
- Si su problema está en la siguiente lista de problemas conocidos, puede que ya haya una solución disponible:
Problemas de implementación conocidos
Si su solución funciona localmente pero falla cuando se implementa en otra máquina, nos encantaría mejorar nuestro soporte de esa plataforma y agradeceríamos que hiciera un informe de error con detalles sobre la máquina donde ocurre el problema.
Ventanas
- System.Exception: No se pudo inicializar Tesseract. La lógica de respaldo falló.
- Por favor, instale Visual C++ Runtimes en Windows para ambos tiempos de ejecución de 32 bits y 64 bits.
- Excepción no manejada: System.Runtime.InteropServices.SEHException
- Esta es una limitación conocida para soportar procesadores Celeron y Atom. Hay una solución planeada en progreso.
Linux, Docker y MacOS
- Excepción no manejada. System.DllNotFoundException: No se pudo encontrar o cargar la biblioteca nativa de ningún nombre: [ libgdiplus, libgdiplus.so ] o [ libgdiplus, libgdiplus.dylib ]
- Es posible que necesite instalar libgdiplus para soportar System.Drawing.Common en su sistema operativo Linux o MacOS.
- System.TypeInitializationException: El inicializador de tipo para 'Gdip' lanzó una excepción.
- Problemas específicos de .NET 6 en Linux y Mac. Es posible que necesite agregar soporte para Microsoft System.Drawing.Common a su proyecto de .NET 6 o usar .NET Framework, Core 3.1 o .NET 5 hasta que se mejore esta limitación general de .NET 6.
Azure Functions v3 y v4
- Las excepciones sobre "Archivo OCRData no encontrado" pueden resolverse usando nuestra guía de implementación de funciones de Azure.
Licencias
Nuestras preguntas más comunes son sobre el licenciamiento:
- Cómo obtener una licencia para IronOCR y qué licencia se aplica a su caso de uso.
- Cómo aplicar una clave de licencia para el despliegue comercial también es un artículo muy común.
_Si estos no se aplican ni ayudan a resolver el problema y le gustaría solicitar asistencia de uno de nuestros ingenieros altamente capacitados, por favor siga esta guía para producir la resolución más rápida._
Guía de soporte para empresas españolas bajo LOPDGDD y AEPD
Para los equipos de desarrollo en España que utilizan IronOCR en pipelines que procesan documentos con datos personales —DNI, NIE, TIE, nóminas, contratos— bajo la LOPDGDD (Ley Orgánica de Protección de Datos y Garantía de Derechos Digitales), el proceso de solicitud de soporte requiere precauciones adicionales supervisadas por la AEPD.
Antes de contactar con soporte:
- Anonimiza las imágenes de muestra. Nunca envíes imágenes de documentos reales que contengan datos personales. Crea réplicas sintéticas con los mismos formatos, dimensiones y características visuales que reproduzcan el problema sin datos reales.
- No incluyas datos de DNI, NIE o TIE reales en capturas de pantalla, logs o ficheros adjuntos. Usa datos ficticios que mantengan la estructura del documento.
- Para problemas con facturas Facturae o documentos AEAT: comparte únicamente la estructura del XML o los metadatos de imagen, nunca el NIF real de emisor o receptor.
- En entornos ENS (Esquema Nacional de Seguridad) del sector público, consulta con tu responsable de seguridad antes de enviar cualquier muestra de documento procesado, ya que puede requerir clasificación previa.
Al seguir estas pautas, obtendrás soporte técnico eficaz manteniendo el cumplimiento de la LOPDGDD y los requisitos de la AEPD para la protección de datos personales en tus pipelines OCR.
Preguntas Frecuentes
¿Puedo enviar imágenes con DNI o NIE al soporte técnico de IronOCR bajo LOPDGDD?
No. Bajo la LOPDGDD y los requisitos de la AEPD, debes anonimizar cualquier imagen antes de enviarla al soporte. Crea réplicas sintéticas con las mismas dimensiones y características que reproduzcan el problema sin datos personales reales.
¿Cómo solicito soporte para problemas de IronOCR con facturas Facturae sin comprometer datos de la AEAT?
Comparte únicamente la estructura del XML de la factura o los metadatos de imagen sin el NIF real del emisor o receptor. El equipo de soporte puede diagnosticar el problema con datos ficticios que mantengan la estructura del documento Facturae.
¿Qué debo hacer en un entorno ENS del sector público antes de enviar muestras al soporte de IronOCR?
En entornos bajo el Esquema Nacional de Seguridad (ENS), consulta con tu responsable de seguridad antes de compartir cualquier muestra de documento procesado. Es posible que el documento requiera clasificación previa.
¿Con qué frecuencia se actualiza IronOCR?
IronOCR publica actualizaciones en NuGet cada 1 a 2 meses aproximadamente, con mejoras de rendimiento, correcciones de errores y nuevas funcionalidades.
¿Cómo resuelvo el error SEHException en procesadores Celeron o Atom con IronOCR?
Esta es una limitación conocida en procesadores sin soporte AVX. Actualiza a IronOCR versión 2022.8.7804 o posterior, que incluye soporte para procesadores no AVX.

