Brancher un ERP sur une boutique en ligne : connecteur, API ou flux sur mesure ?
Une boutique en ligne et un ERP finissent toujours par devoir se parler : les commandes doivent devenir des ventes, les paiements des encaissements, et le stock doit redescendre vers le site. Trois chemins existent pour y arriver. Le bon choix dépend moins de la boutique que de ce que l'ERP accepte, et de la façon dont le flux réagira le jour où un appel échoue.
Trois façons de relier boutique et ERP
- Le connecteur prêt à l'emploi. Un module ou une application, publié par l'éditeur de l'ERP, celui de la boutique ou un tiers. Il couvre les cas courants (commandes, clients, produits, stock) et se paramètre plus qu'il ne se développe.
- L'outil d'automatisation. n8n, Make ou un équivalent orchestre des appels entre les deux API à partir de briques prêtes. Plus souple qu'un connecteur, il reste lisible pour quelqu'un qui ne code pas.
- Le flux sur mesure. Un programme qui reçoit les événements de la boutique et appelle l'API de l'ERP selon vos règles. C'est la seule option qui gère sans compromis des cas particuliers, et aussi la seule qu'il faudra maintenir vous-même.
Ces trois options ne s'excluent pas. Un connecteur peut faire l'essentiel pendant qu'un petit flux maison traite un cas qu'il ignore, par exemple les ventes d'une deuxième boutique. Pour situer l'ERP dans l'ensemble de vos outils, notre guide pour choisir un logiciel de gestion d'entreprise pose les bases.
Première question : l'ERP ouvre-t-il son API ?
Avant de comparer des connecteurs, vérifiez ce que votre formule d'abonnement autorise. C'est un point que l'on découvre souvent trop tard. Chez Odoo, la documentation de l'API externe est explicite : l'accès aux données par l'API n'existe que sur les formules Custom, et il n'est pas disponible sur les formules One App Free et Standard.
Conséquence pratique : une entreprise sur une formule Standard ne pourra ni installer certains connecteurs tiers, ni faire appeler son ERP par un script ou par n8n. Le choix de l'architecture commence donc par une ligne de contrat, pas par une ligne de code.
Authentification et appels : l'exemple d'Odoo
Odoo illustre bien ce qui a changé ces dernières années. Dans la documentation de la version 19, l'API externe décrite s'appelle JSON-2. Chaque appel est une requête POST vers /json/2/<modèle>/<méthode>, avec une clé d'API passée dans l'en-tête Authorization: bearer. L'en-tête X-Odoo-Database n'est nécessaire que si plusieurs bases répondent sur le même domaine.
POST /json/2/res.partner/search_read
Authorization: bearer <clé API>
Content-Type: application/json; charset=utf-8
{"domain": [["email", "=", "client@exemple.fr"]],
"fields": ["id", "name"]}
Trois détails de la documentation pèsent sur la conception :
- les clés d'API ont une durée de vie, et Odoo ne permet pas d'en créer une qui dure plus de trois mois. Un flux qui tourne seul doit donc prévoir la rotation de sa clé, sinon il s'arrêtera un matin sans prévenir ;
- les anciennes API XML-RPC et JSON-RPC (
/xmlrpc,/jsonrpc) sont annoncées comme supprimées dans Odoo 22 (automne 2028) et dans Odoo Online 21.1 (hiver 2027). Un connecteur encore bâti sur elles a une date de péremption ; - tous les arguments sont nommés : on ne passe plus de liste positionnelle comme avec
execute_kw.
Webhooks, doublons et reprise sur erreur
Côté boutique, les commandes arrivent en général par webhook : la plateforme appelle votre URL à chaque événement. Vérifiez systématiquement la signature HMAC que les grandes plateformes joignent à ces appels, sans quoi n'importe qui peut fabriquer une fausse commande. Répondez vite (un simple accusé de réception) et traitez la commande ensuite, dans une file d'attente : un webhook qui attend la réponse de l'ERP finira par expirer et sera renvoyé.
Ce renvoi est la source de doublons la plus courante. La parade est l'idempotence : chaque commande porte une clé stable (son identifiant dans la boutique), enregistrée dans l'ERP, et le flux cherche cette clé avant de créer quoi que ce soit. Rejouer dix fois le même événement doit produire une seule vente.
Odoo ajoute une contrainte à connaître : chaque appel JSON-2 s'exécute dans sa propre transaction SQL, et il est impossible d'enchaîner plusieurs appels dans une seule transaction. Si votre flux crée le client, puis la commande, puis la confirme, une erreur au troisième appel laisse les deux premiers en place. La documentation recommande d'appeler une méthode unique qui fait tout, quitte à l'écrire dans un module dédié. C'est typiquement le genre de choix qui se règle avant le développement : pour relier Odoo à une boutique en ligne par son API, la page de l'agence Newp détaille ces décisions côté e-commerce, de la formule d'hébergement à l'émission de la facture.
Enfin, prévoyez la reprise : chaque échec est journalisé avec la commande concernée, rejoué automatiquement s'il est passager (délai dépassé, serveur indisponible), et signalé à un humain s'il est permanent (taxe inconnue, produit introuvable). Réessayer en boucle une erreur de validation ne fait que remplir les journaux.
Comment trancher
| Situation | Option la plus adaptée |
|---|---|
| Une boutique, des cas standards, un connecteur qui couvre votre version d'ERP | Connecteur prêt à l'emploi |
| Quelques règles propres à l'entreprise, volumes modérés, équipe non développeuse | Outil d'automatisation (n8n, Make) |
| Plusieurs boutiques ou entrepôts, logique métier forte, besoin de garanties transactionnelles | Flux sur mesure |
| Formule d'ERP sans accès API | Changer de formule, ou se limiter aux échanges de fichiers |
Dans tous les cas, demandez qui surveille le flux une fois en production, et qui le corrige quand l'une des deux plateformes change sa version d'API.
Avant d'écrire la première ligne
- Confirmer l'accès à l'API dans la formule de l'ERP.
- Décider qui émet la facture légale : la boutique ou l'ERP, jamais les deux.
- Choisir la clé d'idempotence de chaque objet (commande, client, remboursement).
- Lister les erreurs à rejouer et celles à signaler.
- Prévoir la rotation des clés d'API et un environnement de test.
Source : documentation Odoo 19, « External JSON-2 API », consultée le 19 novembre 2026.