nous contacter

Blog · Technique & intégrations

n8n et Odoo : connecter votre ERP au reste des outils

n8n Odoo : reliez votre ERP à la messagerie, à la compta et à un agent IA via l'API JSON-2. Connexion, webhooks, 3 workflows et calendrier de XML-RPC.

Publié le 16 novembre 2026

Illustration n8n et Odoo : l'ERP Odoo échange avec n8n, qui relie la messagerie, la comptabilité et Teams via l'API JSON-2
Illustration : GetBatch

Avec n8n et Odoo, votre ERP cesse d’être une île : une commande confirmée prévient l’équipe sur Teams, une facture échue déclenche une relance préparée, une demande de prix reçue par email devient un devis brouillon dans Odoo. Le tout sans développer de module dans l’ERP, donc sans code à porter à chaque montée de version d’Odoo. Le branchement a changé en 2026 : Odoo pousse sa nouvelle API JSON-2 et a fixé la fin des anciennes API XML-RPC et JSON-RPC, et le nœud Odoo de n8n a suivi. Voici comment connecter les deux proprement, ce que le nœud sait faire, et les trois workflows que nous mettons le plus souvent en place.

Pourquoi connecter Odoo à n8n plutôt que tout faire dans l’ERP ?

Odoo couvre beaucoup : ventes, achats, stock, facturation, CRM. Il a aussi ses propres règles d’automatisation, très bien faites pour ce qui reste dans Odoo (changer une étape, assigner une activité, envoyer un email modèle). Il devient moins à l’aise quand la règle sort de l’ERP :

  • prévenir une équipe sur Teams ou Slack avec le contexte d’une commande ;
  • croiser Odoo avec une boîte mail, un outil de comptabilité externe ou un site e-commerce qui n’a pas de connecteur ;
  • confier à un modèle d’IA la lecture d’un email ou d’un PDF avant de créer l’enregistrement ;
  • garder une trace de chaque échange et une alerte en cas d’échec.

La voie classique est un module Odoo sur mesure. Il fonctionne, mais il vit dans l’ERP : il faut le migrer à chaque nouvelle version, et il n’est pas possible partout (Odoo Online limite fortement le code personnalisé). n8n prend la place de ce module à l’extérieur : il parle à Odoo par son API, et une montée de version d’Odoo ne touche pas vos workflows tant que les champs utilisés ne changent pas. C’est le travail de notre agence n8n : écrire ces règles avec vous, puis les faire tourner sur un serveur n8n hébergé en France.

Quelle API Odoo utiliser avec n8n en 2026 ?

Odoo a introduit avec la version 19 une API externe appelée JSON-2. On envoie une requête POST sur /json/2/<modèle>/<méthode>, avec une clé d’API dans l’en-tête Authorization. Les anciennes API XML-RPC (/xmlrpc/2) et JSON-RPC (/jsonrpc), utilisées par tous les connecteurs jusqu’ici, sont dépréciées. La documentation officielle de l’API externe donne le calendrier de leur retrait :

Calendrier de l'API Odoo pour n8n : JSON-2 dans Odoo 19, service db supprimé dans Odoo 20, XML-RPC et JSON-RPC coupés sur Odoo Online 21.1 puis Odoo 22 Odoo Online sera concerné bien avant les versions installées sur vos serveurs.

Version d’OdooCe qui change pour les intégrations
Odoo 19Arrivée de l’API JSON-2 et des clés d’API comme mode d’accès
Odoo 20 (automne 2026)Suppression du service db (gestion des bases) des anciennes API
Odoo Online 21.1 (hiver 2027)Suppression de XML-RPC et JSON-RPC sur Odoo Online
Odoo 22 (automne 2028)Suppression de XML-RPC et JSON-RPC sur les versions installées

Deux conséquences pratiques. Si vous êtes sur Odoo Online, vos intégrations construites sur les anciennes API ont environ un an devant elles : c’est le moment de les migrer, pas en catastrophe le mois de la mise à jour. Et la même documentation précise que l’accès aux données par l’API externe est réservé aux formules Custom : les formules One App Free et Standard d’Odoo n’y ont pas accès. Une installation Community ou Enterprise sur votre propre serveur, ou sur Odoo.sh, n’est pas concernée par cette restriction.

Comment connecter n8n à Odoo pas à pas ?

Côté n8n, le nœud Odoo existe désormais en deux versions. La version 2, arrivée avec n8n 2.23 en mai 2026 et posée par défaut sur un nouveau workflow, sait utiliser l’API JSON-2 ; la version 1 et l’ancien identifiant passent par /jsonrpc, et n8n affiche lui-même un avertissement de dépréciation sur cet identifiant (on le voit dans le code source du nœud). Il est bien présent dans la version stable du moment, la 2.47.7, publiée le 13 novembre 2026 selon le registre npm ; pour monter de version sans risque, nous suivons la routine décrite dans mettre à jour n8n. Pour Odoo 19 et au-delà :

  1. Créer un utilisateur technique dans Odoo. La documentation d’Odoo recommande un « bot » dédié : on lui donne uniquement les droits nécessaires (Ventes en lecture, Facturation en lecture, par exemple), on lui retire le mot de passe pour bloquer la connexion classique, et chaque écriture de n8n apparaît sous son nom dans l’historique. Vérifiez avec vous ce que ce siège coûte dans votre formule.
  2. Générer la clé d’API. Connecté avec ce compte : Préférences > Sécurité du compte > Nouvelle clé API. Odoo demande une description et une durée de validité. Attention : une clé ne peut pas durer plus de trois mois. La rotation n’est pas une option, il faut la prévoir dès le départ.
  3. Créer l’identifiant dans n8n. Type « Odoo API (API Key) » : l’adresse de votre Odoo, la clé, et le nom de la base. Pour mon-entreprise.odoo.com, n8n déduit la base de l’adresse ; sur un serveur qui héberge plusieurs bases, renseignez-la, elle part dans l’en-tête X-Odoo-Database.
  4. Tester. n8n vérifie l’identifiant en lisant un contact. Un refus en 401 signifie une clé invalide ou expirée ; un refus d’accès sur un modèle signifie que l’utilisateur technique n’a pas les droits.

Pour la rotation, nous posons une alerte quinze jours avant l’expiration de la clé, avec la marche à suivre : générer la nouvelle clé, la coller dans l’identifiant n8n, puis supprimer l’ancienne. Une clé expirée un vendredi soir, c’est un week-end de commandes non transmises. Si votre Odoo est encore en version 18 ou antérieure, l’identifiant classique (utilisateur et clé d’API saisie à la place du mot de passe) reste la seule option ; il faudra basculer à la montée en version 19.

Que sait faire le nœud Odoo de n8n ?

Le nœud Odoo v2 propose quatre ressources : Contact, Opportunity (opportunités du CRM), Activity (notes et activités) et Custom Resource, qui donne accès à n’importe quel modèle Odoo (sale.order, account.move, stock.picking…). Sur chacune, les opérations sont les mêmes : créer, lire, lister avec filtres, modifier, supprimer.

C’est suffisant pour lire et écrire des données. Ce n’est pas suffisant pour faire agir Odoo. Confirmer un devis, valider une facture, déclencher une livraison : dans Odoo, ces gestes passent par des méthodes métier (action_confirm, action_post…) qui vérifient les règles de l’ERP avant d’agir. Écrire directement state = "sale" dans une commande contourne ces vérifications ; ne le faites jamais. Pour appeler une méthode métier, nous utilisons un nœud HTTP Request avec le même identifiant « Odoo API (API Key) » :

POST https://mon-entreprise.odoo.com/json/2/sale.order/action_confirm
Content-Type: application/json

{ "ids": [{{ $json.order_id }}] }

Odoo répond en 200 si la commande est confirmée, et en 4xx avec le message de l’erreur métier sinon (un produit sans prix, un client bloqué). Deux règles tirées de la documentation d’Odoo, qui évitent bien des incohérences :

  • Chaque appel JSON-2 est une transaction séparée. Enchaîner trois appels qui doivent réussir ensemble (créer une commande, ajouter des lignes, la confirmer) laisse des commandes à moitié créées si le deuxième échoue. Préférez un seul appel qui fait tout : create avec les lignes incluses, puis action_confirm.
  • search_read plutôt que search puis read. La méthode combinée lit dans la même transaction et ne plante pas si un enregistrement disparaît entre les deux appels.

Chaque base Odoo publie la liste de ses modèles, champs et méthodes sur sa page /doc, champs personnalisés compris. C’est la première page que nous ouvrons en atelier.

Comment Odoo peut-il déclencher un workflow n8n ?

n8n n’a pas de déclencheur Odoo. Deux solutions, que nous combinons.

Le webhook sortant d’Odoo. Une règle d’automatisation Odoo (dans Studio, ou dans Paramètres > Technique en mode développeur) peut avoir pour action « Send Webhook Notification » : quand l’événement survient, Odoo envoie un POST avec les champs choisis vers une adresse. Cette adresse, c’est celle d’un nœud Webhook de n8n. Exemple : règle sur le modèle Commande, déclencheur « l’état passe à Bon de commande », champs envoyés : référence, client, montant, commercial. Par prudence, nous plaçons l’adresse n8n derrière un chemin long et imprévisible, et le workflow relit la commande par l’API avant d’agir : il ne se fie jamais au seul contenu reçu, qu’un tiers connaissant l’adresse pourrait imiter.

La lecture planifiée. Un Schedule Trigger lit toutes les dix minutes, ou chaque nuit, les enregistrements modifiés depuis le dernier passage, avec un filtre sur le champ write_date. Attention : Odoo stocke ces dates en UTC, pas à l’heure de Paris. Ce flux sert de filet de sécurité derrière le webhook : si n8n redémarre au moment où Odoo envoie, la commande est rattrapée au passage suivant.

Quels workflows n8n Odoo mettre en place ?

Trois workflows n8n Odoo : commande confirmée qui prévient l'équipe, factures échues relancées chaque matin, email de demande de prix transformé en devis brouillon dans Odoo Les trois flux n8n Odoo que nous livrons le plus souvent. Rien ne part chez un client sans relecture.

1. Commande confirmée : lancer la suite sans ressaisie

La règle Odoo envoie la commande confirmée à n8n. Le workflow relit la commande et ses lignes par search_read, crée le dossier du projet dans SharePoint ou Google Drive, poste un message dans le canal Teams de l’équipe concernée (« Commande S00142, 12 400 € HT, livraison souhaitée le 4 décembre ») et planifie l’appel de lancement dans le calendrier du chef de projet. Personne ne recopie plus la commande dans trois outils.

2. Chaque matin : préparer les relances de factures échues

Un Schedule Trigger à 8 h lit dans account.move les factures clients validées, non payées, dont l’échéance est dépassée. Pour chacune, n8n vérifie dans le CRM qu’aucun litige n’est en cours, puis dépose un brouillon de relance dans la boîte du comptable, au ton qui correspond au retard. La logique des relances graduées est détaillée dans notre article sur l’agent IA de relance des factures. Si votre comptabilité est tenue dans Pennylane plutôt que dans Odoo, c’est le flux décrit dans n8n et Pennylane qui s’applique.

3. Email entrant : un devis brouillon dans Odoo

Une demande de prix arrive sur contact@. Un nœud d’IA extrait le client, les produits et les quantités ; n8n retrouve le client dans res.partner (ou le crée), cherche les articles dans product.product, puis crée un devis brouillon dans sale.order avec ses lignes, en un seul appel. Le commercial reçoit le lien, vérifie, ajuste, envoie depuis Odoo. Le détail de l’extraction et du contrôle est dans notre article sur l’agent IA de devis. Quand le calcul devient lourd (un tarif dégressif sur plusieurs centaines de lignes, un fichier fournisseur à normaliser), nous le confions à un petit service Python à côté de n8n, comme expliqué dans n8n et Python.

Quels pièges éviter avec l’API Odoo ?

  • Les champs relationnels. Un champ « plusieurs vers un » (partner_id) s’écrit avec un simple identifiant, mais un champ de lignes (order_line) attend une liste de commandes Odoo : [[0, 0, { "product_id": 12, "product_uom_qty": 3 }]] pour créer une ligne. C’est la première source d’erreurs dans les workflows que l’on nous demande de reprendre.
  • Le multi-société. Si votre base gère plusieurs sociétés, l’utilisateur technique n’écrit que dans celles auxquelles il a accès. Passez allowed_company_ids dans le context de l’appel pour cibler la bonne.
  • La langue. Les noms de produits et les libellés sont traduits : "context": { "lang": "fr_FR" } évite des devis en anglais.
  • Les listes longues. Lisez par pages avec limit et offset plutôt que d’aspirer 40 000 enregistrements d’un coup.
  • Les montées de version d’Odoo. Un champ renommé ne fait pas toujours échouer le workflow, il renvoie parfois une valeur vide. Rejouez vos flux sur une copie de la base avant chaque mise à jour majeure.

Chaque workflow est rattaché à un workflow d’erreur qui prévient l’équipe avec le message renvoyé par Odoo. Les autres garde-fous que nous posons sur toutes les connexions entre outils sont décrits sur notre page intégrations aux outils métier. Quant à l’hébergement, un n8n auto-hébergé en France fait transiter vos données Odoo par votre seul serveur ; les questions de RGPD que cela règle (et celles qui restent) sont traitées dans notre article IA et RGPD.

Combien de temps pour connecter Odoo à n8n ?

La connexion elle-même (utilisateur technique, clé, premier appel) prend moins d’une heure. Le temps se passe à cartographier les modèles et les champs réellement utilisés dans votre base, souvent personnalisée au fil des années, et à décider avec l’équipe qui doit être prévenu de quoi. Pour un premier flux comme la commande confirmée, comptez quelques jours entre l’atelier et la mise en production. Une automatisation ciblée de ce type se situe le plus souvent autour de 2 000 €, sur devis ; un agent IA qui prépare les devis relève plutôt de la fourchette de 4 000 à 8 000 €, toujours sur devis.

Questions fréquentes

Le nœud Odoo de n8n fonctionne-t-il avec Odoo Community ?

Oui. L’API externe fait partie du socle d’Odoo, elle est présente dans Community comme dans Enterprise. Sur une installation Community en version 19 ou plus, le nœud Odoo v2 fonctionne avec une clé d’API ; sur les versions antérieures, il passe par l’identifiant classique.

Mes workflows Odoo actuels vont-ils s’arrêter ?

Pas tout de suite. Les anciennes API restent disponibles jusqu’à Odoo Online 21.1 (hiver 2027) et Odoo 22 (automne 2028) pour les versions installées. Seul le service de gestion des bases a disparu avec Odoo 20. Faites l’inventaire des workflows qui utilisent l’ancien identifiant et migrez-les à votre rythme, en commençant par Odoo Online.

Faut-il passer par n8n si l’on a déjà Odoo Studio ?

Studio suffit pour automatiser ce qui reste dans Odoo. n8n devient utile dès qu’il faut parler à un autre outil, appeler un modèle d’IA ou centraliser les alertes. Les deux se complètent bien : la règle Studio envoie le webhook, n8n fait la suite.

Peut-on utiliser un agent IA directement sur les données Odoo ?

Oui, avec des garde-fous. Nous donnons à l’agent un utilisateur technique aux droits limités, il lit ce dont il a besoin et ne crée que des brouillons. La validation d’un devis ou d’une facture reste un geste humain dans Odoo.

Bien branché, le couple n8n et Odoo fait circuler les informations de l’ERP vers les bonnes personnes et les bons outils, sans module à maintenir à chaque version. Notre agence n8n cartographie votre base Odoo avec vous, construit les workflows sur l’API JSON-2 depuis un serveur en France et les surveille dans la durée. Parlons de votre ERP.

→À lire ensuite