CARONNA OdooL'intégrateur Odoo par IA

CARONNA Odoo / Blog / Connecteurs et API

Connecteurs et API

L'API JSON-RPC d'Odoo expliquée simplement aux débutants

Publié le 22 novembre 2026 · 6 min de lecture

Vous entendez parler d'API, de REST ou de JSON-RPC et vous ne savez pas ce que cela change pour votre Odoo ? Cet article vous explique, sans jargon, ce que ces termes recouvrent, comment faire un premier essai en toute sécurité et quand il vaut mieux déléguer.

L'API JSON-RPC d'Odoo est la porte d'entrée qui permet à un programme de lire et d'écrire dans votre base de données sans passer par l'écran. Si vous gérez une PME sous Odoo, c'est elle qui permet de relier votre logiciel à une boutique en ligne, à un outil de paie ou à un simple tableur automatisé.

Vous n'avez pas besoin d'être développeur pour comprendre le principe. Ce guide vous donne les notions utiles, un exemple complet à lire (et à tester si vous êtes curieux) et les précautions à prendre.

Une API, c'est quoi, et pourquoi s'en préoccuper ?

Une API (interface de programmation) est un ensemble de portes d'accès officielles à un logiciel. Au lieu de cliquer dans Odoo pour créer un contact, un autre programme envoie une demande formatée, et Odoo la traite comme si un utilisateur l'avait saisie.

Cela sert concrètement à :

  • récupérer automatiquement les commandes d'un site marchand dans Odoo ;
  • envoyer les factures validées vers votre outil de comptabilité externe ;
  • mettre à jour des prix ou des stocks depuis un fichier fournisseur ;
  • alimenter un tableau de bord qui n'est pas dans Odoo.

Si vous refaites chaque semaine les mêmes copier-coller entre Odoo et un autre outil, c'est probablement un candidat à l'API. Vous pouvez d'ailleurs estimer le temps que ces tâches vous coûtent.

REST, XML-RPC, JSON-RPC : démêler les termes

Trois sigles reviennent sans cesse, et ils sont moins compliqués qu'il n'y paraît.

  • REST est un style d'API très répandu : chaque type de donnée a une adresse web, et l'on utilise des verbes simples (lire, créer, modifier, supprimer). Odoo n'a pas historiquement proposé d'API REST au sens strict dans ses versions courantes ; des modules tiers en ajoutent une. Vérifiez ce qu'il en est pour votre version.
  • XML-RPC et JSON-RPC sont les deux interfaces « externes » documentées par Odoo depuis longtemps. Le principe : votre programme appelle une fonction à distance (RPC signifie Remote Procedure Call, « appel de procédure à distance ») en lui passant des paramètres.
  • La différence entre les deux est seulement le format des messages : XML pour l'un, JSON pour l'autre. Le JSON est un format texte léger, très facile à lire et à produire dans la plupart des langages.

Point d'attention : les versions récentes d'Odoo font évoluer leur interface externe. Selon la documentation officielle, une nouvelle API est apparue et les anciennes interfaces RPC sont annoncées comme devant disparaître à terme. Consultez la documentation de votre version avant de bâtir un projet durable, car ce qui fonctionne sur votre Odoo actuel peut demander une adaptation plus tard.

Comment fonctionne l'API JSON-RPC d'Odoo, concrètement ?

Le fonctionnement tient en trois idées.

  1. Une adresse unique. Votre programme envoie ses demandes à une adresse de votre serveur Odoo, généralement terminée par `/jsonrpc`.
  2. Une identification. Vous fournissez le nom de la base, un identifiant utilisateur et une clé d'API, sorte de mot de passe dédié aux programmes, que vous pouvez révoquer sans toucher au vrai mot de passe de la personne.
  3. Un appel de méthode sur un modèle. Un modèle est le nom technique d'un type de fiche : `res.partner` pour les contacts, `sale.order` pour les devis et commandes, `product.product` pour les variantes d'article. Les méthodes courantes sont `search_read` (chercher et lire), `create` (créer), `write` (modifier) et `unlink` (supprimer).

La clé d'API se crée généralement depuis les préférences de l'utilisateur, dans l'onglet de sécurité du compte. L'emplacement exact varie selon la version, et selon votre offre Odoo l'accès externe peut être restreint : vérifiez auprès de votre administrateur ou de votre éditeur.

Un premier essai en lecture seule, pas à pas

Voici un exemple en Python, un langage courant pour ce genre de tâche. Il se connecte, puis lit cinq sociétés avec leur nom et leur e-mail. Il ne modifie rien.

```python import requests

URL = 'https://mon-entreprise.exemple.com/jsonrpc' BASE = 'ma_base_de_test' LOGIN = 'api@mon-entreprise.exemple.com' CLE = 'collez-ici-votre-cle-api'

def appel(service, methode, *args): reponse = requests.post(URL, json={ 'jsonrpc': '2.0', 'method': 'call', 'params': {'service': service, 'method': methode, 'args': args}, 'id': 1, }) donnees = reponse.json() if 'error' in donnees: raise Exception(donnees['error']) return donnees['result']

# 1. S'identifier : Odoo renvoie le numéro de l'utilisateur uid = appel('common', 'authenticate', BASE, LOGIN, CLE, {})

# 2. Lire cinq sociétés clients = appel('object', 'execute_kw', BASE, uid, CLE, 'res.partner', 'search_read', [[['is_company', '=', True]]], {'fields': ['name', 'email'], 'limit': 5})

print(clients) ```

Ce que fait chaque bloc :

  • la fonction `appel` emballe votre demande dans le format JSON-RPC et affiche l'erreur éventuelle renvoyée par Odoo ;
  • `authenticate` vérifie vos accès et renvoie votre numéro d'utilisateur ;
  • `execute_kw` est la méthode générique pour exécuter une action sur un modèle ; ici, `search_read` avec un filtre (les contacts qui sont des sociétés), la liste des champs voulus et une limite.

Les noms de modèles et de champs (`res.partner`, `is_company`, `email`) existent depuis longtemps, mais vérifiez-les dans votre version. Dans Odoo, le mode développeur permet d'afficher le nom technique d'un champ en survolant son libellé.

Les précautions avant d'écrire dans votre base

Lire est sans risque. Écrire, modifier ou supprimer l'est beaucoup moins : une boucle mal réglée peut modifier des milliers de fiches en quelques secondes. Quelques réflexes simples :

  • Travaillez d'abord sur une copie. Une base de test, dupliquée depuis la production, permet de se tromper sans conséquence.
  • Créez un utilisateur dédié aux échanges, avec uniquement les droits nécessaires, plutôt que d'utiliser un compte administrateur.
  • Ne collez jamais la clé d'API dans un document partagé ou un message. Stockez-la dans un coffre de mots de passe ou une variable d'environnement.
  • Limitez les volumes lors des premiers essais (paramètre `limit`, ou un seul enregistrement).
  • Gardez une trace de ce qui a été envoyé, pour pouvoir revenir en arrière si besoin.
  • Évitez `unlink` (suppression) tant que vous n'avez pas validé le comportement ; l'archivage est souvent préférable.

Que faire quand le sujet dépasse votre équipe ?

Un script de lecture se teste en une heure. Un connecteur fiable, lui, doit gérer les erreurs, les coupures réseau, les doublons, les changements de version d'Odoo et l'hébergement du programme. C'est là que beaucoup de PME s'arrêtent, faute de temps ou de compétence interne.

C'est précisément le travail que prend en charge CARONNA Odoo. Vous branchez votre Odoo, vous décrivez votre besoin en français, par exemple « récupérer chaque matin les commandes de ma boutique et créer les devis correspondants ». L'IA développe alors un connecteur en Python, hébergé sur PythonAnywhere, et paramètre ce qu'il faut dans la base : champs, actions automatisées, droits.

Les garde-fous sont ceux que nous recommandions plus haut :

  • un mode test et un mode production, pour valider avant d'agir sur vos vraies données ;
  • un accord explicite de votre part pour toute action irréversible ;
  • un journal complet des actions, avec possibilité d'annulation ;
  • un chantier supervisé par un intégrateur CARONNA, avec une assistance par e-mail du lundi au vendredi.

Le principe commercial est simple : un diagnostic gratuit, puis un prix fixe par tâche, sans abonnement. Le détail se trouve sur la section tarifs.

Ce que vous pouvez faire dès aujourd'hui

Sans rien développer, vous pouvez déjà préparer le terrain :

  1. Listez vos copier-coller répétitifs entre Odoo et d'autres outils, avec leur fréquence.
  2. Repérez votre version d'Odoo et lisez la page de documentation « API externe » correspondante.
  3. Demandez à votre administrateur si l'accès externe est disponible sur votre offre, et comment créer une clé d'API.
  4. Préparez une base de test pour toute expérience.
  5. Décrivez en une phrase le premier échange à automatiser : d'où viennent les données, où elles doivent arriver, à quel moment.

Si vous préférez voir le résultat avant de vous engager, regardez la démonstration pour comprendre comment se déroule un chantier. Et si vous êtes prêt à décrire votre besoin, vous pouvez ouvrir l'application, brancher votre Odoo et lancer le diagnostic gratuit.

L'API n'est pas réservée aux développeurs : c'est un outil de plus pour faire travailler Odoo à votre place. L'essentiel est de commencer petit, en lecture seule, sur une base de test, puis d'avancer étape par étape avec des garde-fous.

Votre intégrateur Odoo, disponible tout de suite

Branchez votre Odoo et décrivez votre besoin en français : l'IA paramètre, connecte et vérifie, avec votre accord pour chaque action sensible. Diagnostic gratuit, puis prix fixe par tâche dès 90 €.

À lire ensuite