ERP & Gestion · Intégration

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

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 :

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

SituationOption la plus adaptée
Une boutique, des cas standards, un connecteur qui couvre votre version d'ERPConnecteur prêt à l'emploi
Quelques règles propres à l'entreprise, volumes modérés, équipe non développeuseOutil d'automatisation (n8n, Make)
Plusieurs boutiques ou entrepôts, logique métier forte, besoin de garanties transactionnellesFlux sur mesure
Formule d'ERP sans accès APIChanger 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

  1. Confirmer l'accès à l'API dans la formule de l'ERP.
  2. Décider qui émet la facture légale : la boutique ou l'ERP, jamais les deux.
  3. Choisir la clé d'idempotence de chaque objet (commande, client, remboursement).
  4. Lister les erreurs à rejouer et celles à signaler.
  5. 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.

Les informations de cet article sont fournies à titre indicatif pour vous aider à cadrer votre projet et doivent être vérifiées auprès des éditeurs avant toute décision. Programmer Solutions peut percevoir une commission lorsque vous demandez une mise en relation via notre service, sans coût supplémentaire pour vous. Nous n'acceptons jamais de rémunération en échange d'une mention favorable.