Convierte archivos PDF en formato JSON a escala mediante la API de Mindee

Los formatos de documento admitidos son:

• PDF (application/pdf): aunque técnicamente es un formato de documento y no una imagen, es compatible de forma nativa con todos los modelos de extracción.
• JPEG / JPG (image/jpeg)
• PNG (image/png): sin animaciones.
• WebP (image/webp)
• TIFF / TIF (image/tiff): se admiten archivos de una o varias páginas, que se procesan de forma similar a un PDF.
• HEIC (image/heic) : el formato de imagen de alta eficiencia de Apple.

‍

📌 Limitaciones técnicas importantes:
Para garantizar que el proceso de OCR se ejecute sin problemas y te devuelva el JSON correctamente, asegúrate de que tus archivos cumplan con las siguientes restricciones:

• Tamaño máximo: 100 MB por archivo.
• Límite de páginas: hasta 200 páginas por documento.
• Estado del archivo: los documentos no pueden estar cifrados y los PDF no deben estar protegidos con contraseña.

Sí, es totalmente posible procesar y convertir PDFs por lotes con Mindee.

El mejor enfoque depende de cómo esté organizado tu lote de documentos o imágenes:

1. Múltiples archivos de imagen separados (por ejemplo, una carpeta de JPG o PNG)

Múltiples archivos independientes (por ejemplo, una carpeta con archivos JPG, PNG o PDF):Por defecto, el endpoint estándar de la API de Mindee procesa un archivo por cada solicitud HTTP. Para convertir un volumen grande de archivos individuales, puedes gestionar la orquestación en el lado del cliente:

• Llamadas concurrentes a la API: puedes escribir un script (en Python, Node.js, etc.) para recorrer tus archivos y enviar múltiples solicitudes en paralelo.
• API asíncrona: para grandes volúmenes de nivel Enterprise, Mindee ofrece una API asíncrona (/predict_async). En lugar de mantener la conexión abierta, envías tu lote a una cola de procesamiento y utilizas webhooks (o polling) para recibir los datos JSON estructurados a medida que cada archivo se procesa.

2. Múltiples documentos agrupados en un solo archivo:

Si tu lote es en realidad un archivo grande que contiene varios documentos (como un PDF multipágina con correspondencia variada o una imagen con cuatro recibos sobre una mesa), Mindee cuenta con funciones de IA integradas:

• Recorte automático: si subes una imagen con varios elementos, la API detecta, aísla y recorta cada uno en un archivo independiente listo para la extracción de datos.
• División automática: si subes un escaneo multipágina, la detección inteligente de límites identifica dónde empieza y termina cada documento, dividiendo el archivo en registros individuales.
• Clasificación automática: una vez separado el lote, el motor de clasificación categoriza cada documento por tipo (por ejemplo, separando facturas de contratos) y lo envía al pipeline de extracción correcto.

Combinando llamadas asíncronas para archivos individuales con las funciones de recorte, división y clasificación de Mindee, puedes construir un pipeline de procesamiento por lotes altamente eficiente y automatizado.

Sí, por supuesto. Mindee te ofrece una prueba gratuita de 14 días para que puedas evaluar la plataforma a fondo, sin necesidad de introducir una tarjeta de crédito al registrarte.

Esta prueba gratuita incluye:

• Procesamiento de hasta 200 páginas.
• Llamadas a la API: para que puedas probar la integración técnica directamente con tu propio stack tecnológico.
• Acceso a todos los modelos preentrenados: (recibos, facturas, contratos, documentos de identidad, etc.) y a la documentación completa.
• Acceso a funciones opcionales: para que puedas poner a prueba casos de uso específicos.

Una vez finalizada la prueba de 14 días, o cuando alcances el límite de 200 páginas, solo tendrás que elegir uno de nuestros planes de suscripción (Starter, Pro, Business o Enterprise) para seguir utilizando el servicio y adaptar el plan a tu volumen de procesamiento.

Sí, tus datos están totalmente seguros y protegidos durante todo el proceso de conversión. Como solución de OCR de nivel Enterprise, en Mindee nos tomamos la seguridad y la privacidad muy en serio.

A continuación, te detallamos nuestras principales medidas de protección:

• Cumplimiento y certificaciones: nuestra infraestructura cuenta con la certificación SOC 2 Tipo II y cumple íntegramente con el RGPD (GDPR), garantizando los estándares más exigentes de la industria en materia de protección de datos.
• Cifrado de extremo a extremo: todos los documentos y datos extraídos están completamente cifrados, tanto en tránsito (durante las llamadas a la API) como en reposo.
• Soberanía y localización de datos: tú decides dónde se procesa tu información, con la opción de alojar y procesar tus datos en servidores de la Unión Europea o de Estados Unidos.
• Privacidad garantizada: respetamos la confidencialidad de tu información al 100 %. Tus documentos procesados no se comparten con terceros ni se utilizan jamás para entrenar modelos globales de IA.

En resumen: tus documentos confidenciales se procesan en un entorno seguro y aislado, y permanecen en todo momento bajo tu exclusivo control.

Obtener un JSON es el primer paso; asegurarte de que sea un JSON válido es el segundo. La mayoría de las APIs modernas, como la de Mindee, te permiten definir un esquema de datos claro.

Para evitar que tu base de datos falle al procesar la información, te recomendamos:

• Validar la respuesta: utiliza herramientas de validación de esquemas adaptadas a tu stack tecnológico (como Pydantic para Python, Zod para TypeScript, o sus equivalentes en Java, .NET, Ruby y PHP) para revisar la salida de la API antes de procesarla.
• Configurar un flujo de revisión humana: si la extracción no cumple con el esquema establecido (por ejemplo, si falta un campo obligatorio como el número de factura o invoice_id), marca el documento para una validación manual.

La API de Mindee es RESTful y devuelve los datos exclusivamente en formato JSON (no admite XML).

Para conectar Mindee a tu herramienta de negocio, puedes utilizar nuestra API REST + JSON a través de un conector ERP/CRM, peticiones HTTP o webhooks. La mayoría de las herramientas ERP/CRM se integran fácilmente mediante acciones o nodos HTTP (entornos low-code) o a través de plataformas de automatización.

Además, si tu ERP/CRM admite webhooks entrantes, puedes configurar los webhooks de Mindee para recibir los resultados directamente en tu endpoint (una opción altamente recomendada para entornos de producción con un uso intensivo).