Connecter une boutique e-commerce à un ERP : API, connecteur
Pour connecter une boutique e-commerce à un ERP, trois voies existent : un connecteur prêt à l'emploi, un middleware qui orchestre les échanges, ou une intégration par API développée sur mesure. La meilleure dépend de vos volumes et de vos règles, mais les bonnes pratiques sont les mêmes partout : décider quel logiciel fait foi pour chaque donnée, prévoir les doublons, surveiller les erreurs et rattraper les messages perdus. C'est ce travail, plus que le choix de l'outil, qui évite les stocks faux et les commandes en double.
Je développe ce type d'intégration, j'ai donc un intérêt dans le sujet. Les comportements techniques cités viennent de documentations d'éditeurs consultées le 1er novembre 2026. Les recommandations d'organisation sont mon avis de praticien.
Commencez par une question : quel logiciel fait foi ?
La plupart des intégrations ratées ne le sont pas à cause de l'API, mais parce que deux logiciels modifient la même information. Avant toute technique, remplissez un tableau comme celui-ci, avec votre responsable administratif.
| Donnée | Référence habituelle | Sens du flux | Fréquence à discuter |
|---|---|---|---|
| Prix et remises | ERP | ERP vers boutique | À chaque changement ou plusieurs fois par jour |
| Stock | ERP ou logistique | ERP vers boutique | Proche du temps réel si les ruptures coûtent cher |
| Fiche marketing du produit | Boutique ou PIM | Reste côté boutique | Sans objet |
| Commande | Boutique à la création, ERP ensuite | Boutique vers ERP | Immédiate |
| Statut, suivi, facture | ERP | ERP vers boutique | À chaque étape |
Ce tableau n'est qu'un point de départ. Un marchand qui vend aussi en magasin ou qui expédie depuis un entrepôt tiers aura des réponses différentes. L'essentiel est que chaque ligne ait une seule réponse, écrite noir sur blanc.
API, connecteur ou middleware : comparer les trois voies
| Voie | Quand elle convient | Sa limite |
|---|---|---|
| Connecteur prêt à l'emploi | Logiciels courants, règles standard | Dépend de son éditeur, et s'arrête où commencent vos exceptions |
| Middleware ou iPaaS | Plusieurs logiciels à relier, besoin de tableaux de suivi | Un abonnement et un outil de plus à maîtriser |
| API sur mesure | Règles propres à votre métier, lien central pour l'entreprise | Code à maintenir à chaque évolution d'un logiciel |
Le mot iPaaS désigne, selon Gartner, un service cloud géré par son fournisseur, qui permet de réaliser des intégrations entre applications, services et sources de données. Les éditeurs de boutique en proposent parfois directement : BigCommerce cite par exemple Celigo et Patchworks parmi ses intégrations préparées.
Vérifiez aussi ce que votre ERP autorise. La documentation d'Odoo indique que l'API externe est réservée aux plans Custom, et non aux plans One App Free ou Standard. Elle annonce aussi la suppression des points d'accès XML-RPC et JSON-RPC, prévue pour Odoo 22 (automne 2028) et Odoo Online 21.1 (hiver 2027). Un connecteur ou un développement bâti sur ces anciens points d'accès aura donc une date de fin : demandez à votre prestataire comment il s'y prépare. Pour Sage, faites confirmer ce qui existe pour votre produit et votre version en France.
Les bonnes pratiques qui évitent les doublons
Un message peut arriver deux fois, arriver dans le désordre, ou ne pas arriver du tout. Ce n'est pas une hypothèse pessimiste : c'est ce qu'écrivent les éditeurs. Shopify précise que l'ordre des webhooks (ces notifications automatiques envoyées à chaque événement) n'est pas garanti, que leur livraison non plus, et qu'il faut écarter les doublons avec l'identifiant de chaque envoi, puis lancer des tâches de rapprochement régulières. Sa documentation HTTPS mentionne huit nouvelles tentatives sur quatre heures en cas d'échec.
La réponse technique s'appelle l'idempotence : répéter une opération ne doit pas la produire deux fois. Stripe l'explique bien avec sa clé d'idempotence, qui permet de renvoyer une requête après une erreur réseau sans créer un second objet. Pour vos commandes, l'équivalent consiste à conserver le numéro de commande de la boutique dans l'ERP et à vérifier qu'il n'existe pas avant de créer quoi que ce soit.
Un autre point concerne les opérations en plusieurs étapes. Chez Odoo, la même documentation précise que chaque appel à l'API JSON-2 s'exécute dans sa propre transaction SQL, et qu'on ne peut pas en enchaîner plusieurs dans une seule. Si la création d'une commande demande plusieurs appels et que le dernier échoue, vous obtenez une commande à moitié créée, sauf si l'intégration a prévu ce cas, par exemple avec une méthode unique qui fait tout d'un coup.
À cela s'ajoutent trois habitudes que je considère comme indispensables : une file d'attente, pour que l'ERP ne soit pas saturé un jour de soldes ; un journal lisible, pour retrouver ce qui est arrivé à une commande ; une alerte quand un message reste bloqué, adressée à une personne nommée.
Quand ne pas connecter tout de suite
Si vous traitez quelques commandes par jour et que votre ERP change peu, un export de fichier régulier, bien cadré, peut suffire pendant longtemps. L'intégration n'a de sens que si le coût des ressaisies et des erreurs dépasse le coût de sa création et de sa maintenance. De même, si votre ERP est sur le point d'être remplacé, attendez. Et si votre projet touche un ERP lourd de type SAP, avec des règles propres à votre groupe, un intégrateur spécialisé de cet ERP sera souvent plus légitime qu'un développeur e-commerce seul.
Ce qu'il faut demander à un prestataire
Que se passe-t-il si l'ERP est indisponible pendant deux heures ? Comment une commande bloquée est-elle signalée, et à qui ? Comment rejouer un message sans créer de doublon ? Qui met à jour l'intégration quand l'un des logiciels change de version ? Une démonstration avec une panne provoquée vous en dira plus qu'une présentation.
Pour avancer, faites-moi la liste de vos logiciels et de ce qui se fait encore à la main, depuis la page application web ou site e-commerce. Vous aurez une réponse sous 24 heures ouvrées, de la personne qui écrirait le code, et si un simple connecteur suffit, je vous le dirai.