Recursos · Integración n8n

Integración Mindee n8nAutomatiza Mindee con n8n.

Teclear importes de facturas a mano se come una mañana entera cada semana. La integración Mindee n8n pasa ese trabajo a una API de OCR: el nodo expone 2 operaciones repartidas en 2 recursos, factura y ticket, y no trae ningún trigger propio. Sirve justo cuando el papeleo llega más rápido de lo que nadie puede escribir.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Qué resuelve la integración Mindee n8n?

Mindee ofrece API de OCR, es decir, servicios que leen el texto dentro de un documento y lo devuelven como campos con nombre en lugar de una imagen. El nodo de n8n llama a dos de ellas: la Invoice OCR API y la Receipt OCR API. Le entregas un archivo que ya viaja por el flujo como datos binarios y te devuelve valores que el siguiente nodo puede usar.

Dos operaciones, dos recursos y ningún nodo trigger por parte de Mindee.

Empieza por el montón de gastos. Un buzón recibe facturas de proveedor como adjuntos, un nodo Gmail las descarga, invoice.predict lee cada archivo y un nodo Google Sheets añade una fila por documento con lo que Mindee devolvió. Esa es la forma de la plantilla pública 1466, que junta ambos nodos para extraer gastos.

Segundo caso: el aviso. Los documentos caen en un buzón compartido, el flujo los lee y el resultado aparece en un canal de Slack, donde quien lleva la tesorería ve los importes sin abrir ni un adjunto. La plantilla 1467 conecta correo, Mindee y Slack para eso. Encaja cuando el volumen es bajo pero la respuesta tiene que ser rápida.

Tercer caso: el archivo que no es un adjunto. Un nodo HTTP Request descarga la imagen de un ticket desde una URL, la pasa como binario y receipt.predict la lee. La plantilla 702 hace exactamente eso, y es el patrón que conviene copiar cuando el documento vive en almacenamiento en la nube, en una herramienta de tickets o detrás de un formulario de subida.

Usa HTTP Request en vez del nodo dedicado cuando el producto de Mindee que necesitas no sea uno de esos dos. El nodo cubre la predicción de factura y la de ticket, nada más del catálogo de Mindee. El nodo HTTP Request llega a cualquier otro endpoint reutilizando el mismo credential mediante la autenticación predefinida, así que sigues teniendo un único sitio donde rotar la clave.

Conviene dejar claros los límites antes de montar nada. No hay trigger de Mindee, así que arranca un Schedule Trigger, un Webhook de n8n o el trigger de otra herramienta. Cada item lleva un solo campo binario, así que un correo con cuatro adjuntos se divide antes en cuatro items. Y el texto extraído merece una revisión humana en los casos raros, motivo suficiente para desviar los documentos dudosos hacia una persona en lugar de mandarlos directos a contabilidad. Si lo que frena es el montaje y no el OCR, el Curso n8n lo cubre, y la Reseña n8n dice dónde encaja la herramienta.

Conexión

¿Cómo se conecta Mindee con n8n?

  1. 01

    Abre la cuenta de Mindee y elige tu API

    Mindee separa sus productos de OCR por tipo de documento y n8n mantiene esa separación. La documentación de credentials indica dos métodos de autenticación admitidos: una Invoice API key, pensada para la Invoice OCR API, y una Receipt API key, pensada para la Receipt OCR API. Decide qué documentos va a leer el flujo antes de crear nada, porque la clave que generes pertenece a un producto concreto.

  2. 02

    Genera la clave de API

    Los dos tipos de credential piden un único valor, una API Key. Mindee explica cómo obtenerla en su página Create and Manage API Keys, y ese es el único campo que n8n reclama con cualquiera de los dos métodos. Copia la clave desde Mindee en vez de escribirla a mano: un espacio de más basta para que todas las llamadas fallen después sin un mensaje que ayude.

  3. 03

    Guarda el credential una vez en n8n

    Un credential vive en el menú Credentials de n8n, no dentro de un flujo. Lo creas ahí, pegas la clave, guardas, y desde ese momento cada nodo Mindee te lo ofrece en su desplegable. El comportamiento es el mismo en n8n Cloud y en una instancia autoalojada, así que un flujo exportado de un lado corre igual en el otro en cuanto el credential existe en ambos.

Acciones

Qué sabe hacer el nodo de Mindee

El nodo Mindee expone 2 operaciones en 2 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

Matriz recursos × operaciones
RecursoPredict
Invoice✓
Receipt✓

Invoice

1 operación
01

Predict

invoice.predict

Lo que ves en n8n

Notas y casos de uso

Manda el archivo del item actual a la Invoice OCR API y devuelve la factura como datos estructurados, listos para una hoja de cálculo o un programa de contabilidad.

Parámetros clave

  • Input Binary Field: el nombre del campo binario de entrada que contiene el archivo a subir, normalmente el que le puso el nodo anterior al adjunto.
  • API Version: la versión de la API de Mindee a la que apunta la llamada, entre 1, 3 y 4.
  • RAW Data: activado, n8n devuelve los datos tal cual llegan desde la API, útil cuando falta un campo en la salida corta.
Casos de uso
la factura del proveedor llega por correo cada mañana y acaba como una fila del libro.

Receipt

1 operación
02

Predict

receipt.predict

Lo que ves en n8n

Notas y casos de uso

La misma llamada con otro producto de Mindee: la Receipt OCR API lee el recibo de taxi arrugado o la cuenta del restaurante fotografiada con el móvil, y saca sus valores como campos.

Parámetros clave

  • Input Binary Field: apunta a la propiedad binaria que lleva el archivo del ticket, así que varios archivos por ejecución se separan antes en un item cada uno.
  • API Version: 1, 3 o 4, fijada cuando un nodo posterior espera una forma estable.
  • RAW Data: desactivado por defecto, activado cuando el flujo archiva la respuesta completa de la API.
Casos de uso
gastos fotografiados durante un viaje comercial, leídos al llegar y publicados en el canal donde el responsable los aprueba.
Necesitas ayuda

¿Necesitas ayuda para automatizar Mindee con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Mindee y n8n, las preguntas que vienen después

01¿La integración Mindee n8n es gratuita?
Por el lado de n8n, sí. El nodo de Mindee viene incluido con n8n: no hay nada que instalar ni coste extra, tanto en n8n Cloud como en una instancia autoalojada en Community Edition, con licencia Sustainable Use. El flujo es idéntico en ambos casos. Lo que queda fuera de n8n es la propia cuenta de Mindee: la abres, generas una clave de API, y lo que cueste esa cuenta depende de las condiciones de Mindee, que esta página no trata. El presupuesto de OCR se cierra entonces con Mindee directamente, y la parte de n8n solo cuesta el tiempo de montaje.
02¿Qué credentials hacen falta para conectar Mindee con n8n?
Primero una cuenta de Mindee. Después, la documentación de credentials indica dos métodos de autenticación y eliges el que corresponde a los documentos que vas a leer: una Invoice API key para la Invoice OCR API, o una Receipt API key para la Receipt OCR API. Cualquiera de las dos pide un único valor dentro de n8n, la API Key, generada siguiendo la documentación Create and Manage API Keys de Mindee. El credential se crea una vez en el menú Credentials y se reutiliza en todos los flujos, así que un equipo que trata facturas y tickets guarda las dos claves y elige la correcta en cada nodo.
03¿Qué límites tiene el nodo de Mindee en n8n?
El nodo cubre dos operaciones, invoice.predict y receipt.predict, y ahí acaba su superficie. Todo lo demás que ofrece Mindee pasa por el nodo HTTP Request, que llama a cualquier endpoint de la API reutilizando el mismo credential mediante la autenticación predefinida. Hay otras dos restricciones que pesan en la práctica. El archivo se lee desde un solo campo binario por item, así que un mensaje con varios adjuntos se divide antes del nodo. Y no existe un nodo trigger de Mindee, lo que significa que el flujo siempre arranca en otro sitio. Nada de esto impide llevarlo a producción, pero condiciona cómo se construye.
04¿Mindee dispara un flujo de n8n en tiempo real?
No. Mindee no tiene nodo trigger en n8n, así que nada por su parte despierta un flujo. La ejecución arranca en otro punto y el nodo de Mindee se coloca más abajo en la cadena. Tres puntos de partida habituales: un Schedule Trigger que se dispara a intervalo fijo y repasa un buzón o una carpeta, un Webhook de n8n, es decir, una URL que un servicio externo llama cuando pasa algo de su lado, o el trigger de otra herramienta que ya tengas montada. Elige el que encaje con la forma en que te llegan los documentos y pasa el archivo como binario.
05¿n8n o Make para Mindee?
Depende de cuatro criterios, y el precio es solo uno. El alojamiento: n8n se autoaloja con Docker o npm, o se usa en n8n Cloud, mientras que Make es una plataforma alojada sin opción de autoalojamiento. De ahí sale el control de los datos, que pesa mucho cuando lo que se lee son facturas con datos del proveedor y del banco. Luego el modelo de coste: Make factura por operación, así que un flujo con mucho documento se comporta distinto ahí. La lógica visual también cambia, aunque eso es más cuestión de costumbre. Las dos plataformas mueven este tipo de flujo de OCR. Lo que decide suele ser dónde pueden estar los archivos.