Un connecteur permet à Odoo d'échanger automatiquement des données avec un autre outil : boutique en ligne, tableur, logiciel métier. Voici comment en construire un en Python avec JSON-RPC, quelles précautions prendre, et comment vous faire aider si le code n'est pas votre métier.
L'API Odoo en Python permet à un petit programme de lire et d'écrire dans votre Odoo sans passer par l'écran. Une API est une porte d'entrée officielle par laquelle un logiciel peut en interroger un autre. JSON-RPC est la manière de lui parler : vous envoyez par internet un message texte structuré qui demande à Odoo d'exécuter une action, et il vous répond de la même façon. Python est le langage de programmation, lisible et très répandu, dans lequel Odoo lui-même est écrit.
À quoi sert un connecteur, concrètement ?
Un connecteur est un script qui fait le lien entre Odoo et le reste de votre activité. Quelques exemples de situations courantes :
- recopier dans Odoo les contacts reçus par un formulaire de votre site ;
- créer des fiches clients à partir d'un fichier envoyé par un partenaire ;
- extraire chaque soir la liste des devis en attente pour l'envoyer par e-mail à l'équipe commerciale ;
- mettre à jour des informations dans Odoo quand un autre logiciel les modifie.
L'intérêt est de supprimer les ressaisies, source d'oublis et d'erreurs. Avant de vous lancer, posez-vous une question simple : la fonction existe-t-elle déjà dans Odoo ? Un import de fichier ou une action automatisée suffisent parfois, sans aucun code.
Ce qu'il faut préparer avant d'écrire une ligne
Quelques éléments à rassembler, et à vérifier dans votre version d'Odoo, car les menus et les noms de champs changent d'une version à l'autre :
- l'adresse de votre Odoo, par exemple `https://mon-entreprise.odoo.com` ;
- le nom de la base de données, c'est-à-dire l'espace qui contient toutes vos données ;
- un utilisateur dédié au connecteur, avec uniquement les droits nécessaires : ainsi, si quelque chose tourne mal, les dégâts restent limités ;
- une clé d'API pour cet utilisateur. C'est un mot de passe réservé aux programmes, que vous révoquez à tout moment sans toucher au vrai mot de passe. Elle se crée en général dans les préférences de l'utilisateur, rubrique sécurité, mais le chemin exact dépend de votre version ;
- une base de test, copie de votre base réelle, pour essayer sans risque.
Une précaution importante : le mécanisme décrit ici (le point d'accès `/jsonrpc`) est celui documenté pour les versions courantes d'Odoo. Les versions les plus récentes introduisent une autre API externe, et l'ancienne peut être appelée à disparaître. Consultez la documentation « API externe » de votre version avant de bâtir un projet durable.
Se connecter à l'API Odoo en Python
Vous avez besoin de Python et de la bibliothèque `requests`, qui sert à envoyer des messages par internet (installation : `pip install requests`). Voici un premier script qui se connecte :
```python import requests
URL = 'https://mon-entreprise.odoo.com/jsonrpc' BASE = 'ma_base' UTILISATEUR = 'connecteur@mon-entreprise.fr' CLE_API = 'collez-ici-votre-cle'
def appeler(service, methode, *arguments): message = { 'jsonrpc': '2.0', 'method': 'call', 'params': {'service': service, 'method': methode, 'args': arguments}, 'id': 1, } reponse = requests.post(URL, json=message, timeout=30) reponse.raise_for_status() donnees = reponse.json() if 'error' in donnees: raise RuntimeError(donnees['error']['data']['message']) return donnees['result']
uid = appeler('common', 'login', BASE, UTILISATEUR, CLE_API) print('Connecté, identifiant utilisateur :', uid) ```
Ce que fait ce code, en clair : la fonction `appeler` fabrique le message, l'envoie à Odoo et renvoie la réponse, ou s'arrête avec le texte de l'erreur si Odoo en signale une. La dernière ligne demande à Odoo de vérifier vos identifiants et de vous donner votre numéro d'utilisateur (`uid`). Si ce numéro s'affiche, la connexion fonctionne. Le délai de 30 secondes (`timeout`) évite que le script reste bloqué indéfiniment si le serveur ne répond pas.
Votre clé d'API est un secret : ne la publiez jamais dans un document partagé et ne l'écrivez pas en dur dans un fichier que d'autres personnes peuvent lire. Le plus simple est de la stocker dans une variable d'environnement, un réglage conservé en dehors du code.
Lire, créer et modifier des fiches
Une fois connecté, toutes les opérations passent par la méthode `execute_kw`. Vous indiquez le modèle (le type de fiche : `res.partner` pour les contacts, `sale.order` pour les commandes et devis, `crm.lead` pour les pistes ou opportunités), puis l'action à effectuer. Ajoutez cette petite fonction à la suite du script précédent :
```python def odoo(modele, methode, args, options=None): return appeler('object', 'execute_kw', BASE, uid, CLE_API, modele, methode, args, options or {})
# Lire cinq sociétés (nom et e-mail) societes = odoo('res.partner', 'search_read', [[['is_company', '=', True]]], {'fields': ['name', 'email'], 'limit': 5}) print(societes)
# Créer un contact nouveau_id = odoo('res.partner', 'create', [{'name': 'Dupont Menuiserie', 'email': 'contact@exemple.fr'}])
# Modifier ce contact odoo('res.partner', 'write', [[nouveau_id], {'phone': '0102030405'}]) ```
Quelques repères pour comprendre :
- `search_read` cherche des fiches selon un filtre (ici : celles qui sont des sociétés) et renvoie les champs demandés ;
- `create` crée une fiche et renvoie son numéro ;
- `write` modifie les fiches dont vous donnez les numéros ;
- `limit` borne le nombre de résultats, ce qui évite de ramener toute la base par erreur.
Les noms de champs (`name`, `email`, `phone`…) existent dans la plupart des versions, mais certains évoluent. Pour connaître ceux de votre base, activez le mode développeur d'Odoo et survolez un champ à l'écran : l'infobulle affiche son nom technique. Vous pouvez aussi interroger la méthode `fields_get` du modèle.
Les pièges à éviter
Un connecteur touche à vos vraies données. Gardez ces réflexes :
- Testez d'abord sur la copie de votre base, jamais directement en production.
- Évitez les doublons : avant de créer un contact, cherchez s'il existe déjà avec le même e-mail.
- Traitez par lots modestes plutôt que d'envoyer des milliers de fiches d'un coup.
- Gérez les erreurs : si Odoo refuse une opération (droit manquant, champ obligatoire vide), le script doit le consigner, pas l'ignorer.
- Prudence avec la suppression (`unlink`) : elle est définitive. Archiver une fiche, quand le modèle le permet, est presque toujours préférable.
- Notez ce que fait le script dans un fichier journal, pour savoir quoi corriger en cas de problème.
Héberger et planifier le connecteur
Un script qui ne tourne que sur votre ordinateur s'arrête dès que vous l'éteignez. Pour qu'il s'exécute chaque nuit ou chaque heure, il faut l'héberger sur un serveur. PythonAnywhere est un service qui permet d'exécuter du Python en ligne et de programmer des tâches à heure fixe. Selon votre offre, l'accès sortant vers des sites externes peut être restreint : vérifiez que l'adresse de votre Odoo est autorisée avant de déployer.
Le faire sans écrire le code vous-même
Tout cela est accessible, mais cela demande du temps, surtout si vous n'êtes pas développeur. C'est précisément le travail que CARONNA Odoo confie à l'intelligence artificielle : vous branchez votre Odoo, vous décrivez votre besoin en français (« chaque soir, créer les contacts du fichier reçu de tel partenaire »), et l'IA développe le connecteur en Python, l'héberge sur PythonAnywhere et le règle avec vous. Elle peut aussi, via l'extension Chrome, voir votre écran pour comprendre ce que vous faites.
Les garde-fous correspondent à ceux de la section précédente : un mode test et un mode production, un accord explicite de votre part avant toute action irréversible, et un journal complet de ce qui a été fait, avec possibilité d'annuler. L'IA est incluse dans l'abonnement. Pour estimer ce que cela change pour votre équipe, consultez la section Gain, puis regardez la démonstration.
Par quoi commencer dès aujourd'hui
- Choisissez une seule tâche répétitive qui vous fait perdre du temps.
- Vérifiez si un import ou une action automatisée d'Odoo ne la règle pas déjà.
- Sinon, créez un utilisateur dédié et sa clé d'API sur une base de test.
- Lancez le script de connexion ci-dessus et vérifiez que l'identifiant s'affiche.
- Ajoutez une lecture, puis une création, et contrôlez le résultat dans Odoo.
Si vous préférez déléguer la mise en œuvre, ouvrez l'application CARONNA, connectez votre Odoo et décrivez votre besoin : vous pourrez tout valider en mode test avant de passer en production.
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. IA incluse, dès 149 € par mois.