Visuel illustrant l’API Odoo pour connecter et automatiser la gestion

API Odoo : le guide pour connecter et automatiser votre gestion

Dans un monde professionnel où les outils numériques se multiplient, faire communiquer vos différentes plateformes logicielles n'est plus une option, mais une nécessité. Si vous utilisez Odoo, la suite logicielle de gestion tout-en-un, vous avez probablement déjà touché du doigt la puissance de l'intégration. Mais comment aller plus loin ? Comment connecter Odoo à votre site e-commerce, votre application mobile ou d'autres outils métier spécifiques ? La réponse tient en trois lettres : API. Voyons comment elle fonctionne et ce qu'elle peut changer dans votre gestion d'entreprise. Ce guide pratique est écrit par turnK, partenaire officiel Odoo, pour les DAF, DSI et dirigeants de PME et ETI qui veulent relier Odoo à leurs autres outils.

Qu'est-ce que l'API Odoo ?

Imaginez l'API (Application Programming Interface) comme un messager ou un traducteur universel pour les logiciels. C'est un ensemble de règles et de protocoles qui permet à différentes applications de communiquer entre elles, d'échanger des données et de déclencher des actions sans intervention humaine directe. L'API Odoo est donc la passerelle qui permet à des applications externes d'interagir de manière sécurisée et structurée avec votre base de données et les fonctionnalités de votre instance Odoo. Elle ouvre un champ de possibilités immense pour automatiser vos processus et enrichir votre écosystème logiciel.

Les Différents Types d'API Odoo

Les API d'Odoo évoluent d'une version à l'autre : la documentation officielle d'Odoo pour votre version fait foi. Deux protocoles sont historiquement utilisés pour interagir avec ses modules, et une API plus récente, JSON-2, les remplace progressivement :

XML-RPC : Le Standard Historique

XML-RPC (Remote Procedure Call via XML) est le protocole historique de l'API Odoo. Il utilise le format XML pour structurer les requêtes et les réponses échangées entre l'application externe et Odoo. Il est plus verbeux que JSON-RPC. De nombreuses intégrations existantes reposent dessus : contrôlez ce qu'il devient dans votre version avant d'y construire quelque chose de nouveau. La documentation officielle d'Odoo le déclare obsolète et annonce son retrait dans Odoo 22 (automne 2028).

JSON-RPC : L'Alternative Moderne

JSON-RPC (Remote Procedure Call via JSON) est une alternative plus moderne et souvent plus légère. Il utilise le format JSON (JavaScript Object Notation), plus concis et généralement plus facile à parser pour les applications web modernes (notamment celles utilisant JavaScript). Là aussi, vérifiez ce que prévoit la documentation de votre version avant de démarrer une nouvelle intégration : le retrait de JSON-RPC est annoncé en même temps que celui de XML-RPC.

L'API JSON-2 : Celle à Privilégier pour un Nouveau Projet

Depuis Odoo 19, la documentation officielle décrit l'API externe JSON-2. Le principe : vous envoyez une requête POST à l'adresse /json/2/<modèle>/<méthode>, avec un corps JSON qui contient les identifiants des enregistrements concernés (ids), un contexte facultatif et les paramètres de la méthode. L'authentification se fait par une clé API, transmise dans l'en-tête Authorization, précédée de bearer. L'en-tête X-Odoo-Database indique la base à utiliser quand le serveur en héberge plusieurs.

Voici à quoi ressemble la recherche de contacts, d'après l'exemple de la documentation d'Odoo :

POST /json/2/res.partner/search_read HTTP/1.1
Host: mycompany.example.com
X-Odoo-Database: mycompany
Authorization: bearer <votre clé API>
Content-Type: application/json; charset=utf-8

La documentation d'Odoo prévoit le retrait de XML-RPC et de JSON-RPC dans Odoo 22 (automne 2028), et dès Odoo Online 21.1 (hiver 2027). Elle fournit un guide de migration des services historiques (commun, base de données, objet) vers JSON-2. Une intégration neuve a donc intérêt à partir directement sur JSON-2, et une intégration existante à planifier sa migration.

Et l'API REST ?

Si votre projet demande une API REST, regardez d'abord ce que votre version d'Odoo propose. Des modules développés par la communauté Odoo ou des partenaires peuvent aussi exposer une API REST au-dessus des méthodes existantes. Ils ajoutent une brique à maintenir à chaque montée de version.

Votre Version d'Odoo Change la Donne

Une intégration écrite pour une version d'Odoo n'est pas garantie sur la suivante. Si vous préparez un passage à Odoo 19 ou 20, listez vos intégrations existantes et contrôlez chacune d'elles avant la bascule : c'est un point à cadrer dans toute migration Odoo. La documentation d'Odoo 19 et celle d'Odoo 20 décrivent toutes deux l'API JSON-2. Vous hésitez encore sur le périmètre de votre ERP ? Reprenez le point de départ sur notre page ERP.

Pourquoi Utiliser l'API Odoo ? Les Avantages Clés

Intégrer l'API Odoo dans votre stratégie digitale offre de multiples bénéfices :

  • Automatisation des tâches : Éliminez les saisies manuelles répétitives entre Odoo et d'autres systèmes (ex : création automatique de commandes depuis un site e-commerce).
  • Intégration transparente : Connectez Odoo à vos outils préférés (CRM externe, plateforme marketing, outils BI, etc.) pour une vue unifiée de vos opérations.
  • Centralisation des données : Assurez la cohérence et la mise à jour en temps réel de vos informations critiques (clients, produits, stocks) sur toutes les plateformes.
  • Personnalisation poussée : Développez des fonctionnalités sur mesure ou des applications spécifiques qui interagissent directement avec vos données Odoo.
  • Efficacité accrue : Optimisez vos flux de travail et réduisez les erreurs en faisant communiquer vos systèmes de manière fluide.

Comment Débuter avec l'API Odoo : Guide Pratique

Se lancer avec l'API Odoo demande quelques prérequis et la compréhension de certains concepts clés :

Prérequis

Vous aurez besoin d'un accès administrateur ou technique à votre instance Odoo et de connaissances de base dans un langage de programmation capable d'effectuer des requêtes HTTP (Python, PHP, JavaScript, Java, etc.).

Authentification

La première étape est de s'authentifier de manière sécurisée. Odoo propose plusieurs méthodes, les plus courantes étant :

  • Login / Mot de passe : Utilisation des identifiants d'un utilisateur Odoo dédié à l'API.
  • Clés API (API Keys) : Méthode plus sécurisée et recommandée, où une clé unique est générée pour l'application externe. C'est la seule méthode prévue par l'API JSON-2.

Opérations Courantes (CRUD)

Une fois authentifié, vous interagirez avec les 'modèles' Odoo (équivalents des tables de base de données, comme res.partner pour les contacts, sale.order pour les commandes, product.product pour les produits) via des méthodes spécifiques :

  • search_read : Rechercher et lire des enregistrements selon des critères spécifiques.
  • create : Créer de nouveaux enregistrements dans un modèle.
  • write : Mettre à jour des enregistrements existants.
  • unlink : Supprimer des enregistrements.

Quelques Conseils

  • Sécurité avant tout : Utilisez des clés API, limitez les droits de l'utilisateur API au strict nécessaire et utilisez HTTPS.
  • Gestion des erreurs : Implémentez une logique robuste pour gérer les éventuelles erreurs de connexion ou de traitement retournées par l'API.
  • Documentation : Référez-vous toujours à la documentation officielle d'Odoo pour les détails des modèles et des méthodes.
  • Tests : Testez intensivement vos intégrations dans un environnement de développement ou de staging avant de passer en production.

Cas d'Usage Concrets de l'API Odoo

Les possibilités offertes par l'API Odoo sont vastes. Voici quelques exemples concrets :

  • Synchronisation E-commerce : Mettez à jour automatiquement les commandes, clients et niveaux de stock entre Odoo et votre boutique en ligne (PrestaShop, Shopify, WooCommerce...).
  • Connexion CRM Externe : Synchronisez les contacts, leads et opportunités entre Odoo CRM et un autre CRM que votre équipe commerciale utilise.
  • Automatisation Comptable : Intégrez Odoo avec des plateformes de paiement ou des logiciels bancaires pour automatiser la réconciliation.
  • Reporting Personnalisé : Extrayez des données spécifiques d'Odoo pour les analyser dans des outils de Business Intelligence externes (Power BI, Tableau...).
  • Application Mobile Sur Mesure : Créez une application mobile pour vos employés ou clients qui interagit en temps réel avec les données Odoo (ex: suivi de commandes, validation de congés).

L'API Odoo est un outil incroyablement puissant pour décupler les capacités de votre ERP et l'intégrer au cœur de votre écosystème digital. Maîtriser son utilisation, c'est ouvrir la porte à une automatisation poussée et à une meilleure circulation de l'information. Pour un cas fréquent, voyez aussi comment connecter Odoo à Shopify.

Un projet d’intégration Odoo ? Parlons-en

Prêt à exploiter tout le potentiel de l’API Odoo ? L’intégration d’API peut sembler complexe, mais c’est exactement le cœur de métier de turnK : nous concevons, intégrons et opérons des ERP Odoo connectés à votre CRM, votre e-commerce et vos outils métiers, de l’audit initial à la mise en production.

Voyez aussi nos pages agence Odoo à Bordeaux et agence Odoo à Lille, ainsi que nos pages agence Odoo à Paris et agence Odoo à Lyon.

Pour cadrer le périmètre de votre projet, consultez notre page ERP.

Les questions les plus fréquentes

Quels langages de programmation peut-on utiliser avec l'API Odoo ?

Vous pouvez utiliser pratiquement n'importe quel langage capable d'effectuer des requêtes HTTP et de traiter du XML ou du JSON, comme Python, PHP, Java, JavaScript (Node.js), Ruby, C#, etc. Python est souvent privilégié car Odoo est lui-même écrit en Python.

L'API Odoo est-elle gratuite ?

L'accès à l'API dépend de votre version et de votre offre Odoo, à vérifier sur le site officiel d'Odoo avant de lancer un projet. Le coût d'une intégration vient surtout de son développement, de sa maintenance et, le cas échéant, de modules tiers.

Comment trouver les noms des modèles et des champs Odoo pour l'API ?

Vous pouvez activer le mode développeur dans Odoo. Ensuite, en survolant les champs dans l'interface utilisateur, une infobulle affichera le nom technique du modèle (`object`) et du champ (`field`). La documentation Odoo et l'introspection via l'API sont aussi des ressources clés.

Quelle est la différence entre XML-RPC, JSON-RPC et l'API JSON-2 d'Odoo ?

XML-RPC et JSON-RPC sont les protocoles historiques, qui échangent du XML ou du JSON. L'API externe JSON-2 est documentée par Odoo depuis la version 19, avec un guide de migration depuis les deux anciens protocoles. Odoo annonce le retrait de XML-RPC et de JSON-RPC dans Odoo 22 (automne 2028). Pour votre version, la documentation officielle d'Odoo fait foi.