Intégration Mindee n8nAutomatiser Mindee avec n8n.
Recopier des montants de factures à la main finit par coûter une demi-journée par semaine. L'intégration Mindee n8n confie ce travail à une API d'OCR : le nœud expose 2 opérations sur 2 ressources, facture et ticket, et n'apporte aucun trigger. De quoi traiter le courrier fournisseur au rythme où il arrive.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
À quoi sert l'intégration Mindee n8n ?
Mindee propose des API d'OCR, c'est-à-dire des services qui lisent le texte contenu dans un document et le renvoient sous forme de champs nommés plutôt que d'image. Le nœud n8n en appelle deux : l'Invoice OCR API et la Receipt OCR API. Tu lui passes un fichier qui circule déjà dans le workflow en données binaires, il te rend des valeurs exploitables par le nœud suivant.
Deux opérations, deux ressources, et pas de nœud trigger côté Mindee.
Le premier cas, c'est la pile de factures fournisseurs. Une boîte mail reçoit les pièces jointes, un nœud Gmail les télécharge, invoice.predict lit chaque fichier, puis un nœud Google Sheets ajoute une ligne par document avec ce que Mindee a renvoyé. C'est la structure du modèle public 1466, qui associe les deux nœuds pour extraire des dépenses.
Deuxième cas : l'alerte. Les documents tombent dans une boîte partagée, le workflow les lit, et le résultat part dans un canal Slack où la personne qui suit la trésorerie voit passer les montants sans ouvrir une seule pièce jointe. Le modèle 1467 relie justement mail, Mindee et Slack. Utile quand le volume reste faible mais que la réaction doit être rapide.
Troisième cas : le fichier qui n'est pas une pièce jointe. Un nœud HTTP Request télécharge l'image d'un ticket depuis une URL, la transmet en binaire, et receipt.predict la lit. Le modèle 702 fait exactement ça. C'est le schéma à reprendre dès que le document dort dans un espace de stockage, dans un outil de tickets, ou derrière un formulaire d'upload.
Passe par HTTP Request plutôt que par le nœud dédié quand le produit Mindee dont tu as besoin n'est pas l'un des deux. Le nœud couvre la prédiction de facture et la prédiction de ticket, rien d'autre du catalogue Mindee. Le nœud HTTP Request atteint n'importe quel autre endpoint en réutilisant le même credential via l'authentification prédéfinie : tu gardes un seul endroit où faire tourner la clé.
Les limites méritent d'être posées avant de construire. Pas de trigger Mindee, donc un Schedule Trigger, un Webhook n8n ou le trigger d'un autre outil démarre l'exécution. Un seul champ binaire par item, donc un mail avec quatre pièces jointes se découpe en quatre items avant le nœud. Et le résultat lu mérite un contrôle humain sur les cas tordus, ce qui plaide pour un aiguillage vers une personne plutôt qu'un envoi direct en compta. Si c'est le branchement qui bloque plus que l'OCR, la Formation n8n traite le sujet, et l'Avis n8n dit où l'outil est à sa place.
Comment connecter Mindee à n8n ?
- 01
Crée le compte Mindee et choisis ton API
Mindee sépare ses produits d'OCR par type de document, et n8n reprend cette séparation. La documentation des credentials liste deux méthodes d'authentification : une Invoice API key, destinée à l'Invoice OCR API, et une Receipt API key, destinée à la Receipt OCR API. Décide quels documents le workflow va vraiment lire avant de créer quoi que ce soit, parce que la clé générée appartient à un produit.
- 02
Génère la clé d'API
Les deux types de credential demandent une seule valeur, une API Key. Mindee explique comment la produire dans sa page Create and Manage API Keys, et c'est le seul champ que n8n réclame, quelle que soit la méthode retenue. Copie la clé depuis Mindee au lieu de la retaper : un espace en trop suffit à faire échouer tous les appels ensuite, sans message qui aide.
- 03
Enregistre le credential une fois dans n8n
Un credential vit dans le menu Credentials de n8n, pas dans un workflow. Tu le crées là, tu colles la clé, tu enregistres, et chaque nœud Mindee te le propose ensuite dans sa liste déroulante. Même comportement sur n8n Cloud et sur une instance auto-hébergée : un workflow exporté d'un côté tourne tel quel de l'autre, une fois le credential présent des deux côtés.
Ce que le nœud Mindee sait faire
Le nœud Mindee expose 2 opérations sur 2 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.
Invoice
1 opérationPredict
invoice.predictCe que tu vois dans n8n
Notes & cas d'usage
Envoie le fichier porté par l'item courant à l'Invoice OCR API et renvoie la facture en données structurées, prêtes pour un tableur, une base ou un outil comptable.
Paramètres clés
- Input Binary Field : le nom du champ binaire d'entrée qui contient le fichier à envoyer, en général celui donné par le nœud précédent à la pièce jointe.
- API Version : la version de l'API Mindee visée par l'appel, entre
1,3et4. - RAW Data : activé, n8n rend les données exactement telles que reçues de l'API, utile quand un champ manque à la sortie courte.
Receipt
1 opérationPredict
receipt.predictCe que tu vois dans n8n
Notes & cas d'usage
Même appel, autre produit Mindee : la Receipt OCR API lit le reçu de taxi froissé ou l'addition photographiée au téléphone, et en ressort les valeurs sous forme de champs.
Paramètres clés
- Input Binary Field : désigne la propriété binaire qui porte le fichier du ticket, donc plusieurs fichiers par exécution se séparent d'abord en un item chacun.
- API Version :
1,3ou4, fixée quand un nœud plus loin attend une forme stable. - RAW Data : désactivé par défaut, activé quand le workflow archive la réponse complète de l'API.
Besoin d'aide pour automatiser Mindee avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.
