Guide ERP
Guide : connecter PrestaShop à un ERP
Connecter PrestaShop à un ERP, c’est décider quelles données circulent, dans quel sens, à quelle fréquence et qui fait foi. Ce guide détaille les modes d’intégration, les flux à synchroniser, la méthode, les erreurs fréquentes et une check-list, avec les différences utiles pour Magento 2.
Un connecteur, c’est d’abord des règles.
La technique compte, mais la plupart des projets ERP se jouent sur les règles de gestion : qui crée le produit, qui fixe le prix, quel stock afficher et que faire quand un échange échoue.
En bref
Connecter PrestaShop à un ERP consiste à échanger automatiquement les données entre la boutique et le logiciel de gestion : produits, prix et stocks descendent généralement de l’ERP vers le site, commandes et clients remontent du site vers l’ERP, puis factures et statuts d’expédition redescendent. L’échange passe par un connecteur d’éditeur, un middleware, un développement sur mesure ou des fichiers. La réussite tient à trois décisions : une source de vérité par donnée, une fréquence adaptée à chaque flux et une gestion des erreurs avec reprise. Le même raisonnement vaut pour Magento 2.
Définition
Qu’est-ce qu’une intégration entre PrestaShop et un ERP ?
Une intégration PrestaShop – ERP est un ensemble de flux automatisés qui évite de ressaisir les mêmes informations dans deux outils. L’ERP (progiciel de gestion intégré, par exemple Sage, Odoo, SAP, Cegid ou Microsoft Dynamics) gère les achats, le stock, la facturation et souvent la relation commerciale. PrestaShop gère la vitrine, le panier, le paiement et le compte client.
Sans intégration, quelqu’un recopie les commandes dans l’ERP et met à jour les stocks à la main. Les erreurs de saisie, les ventes de produits épuisés et les retards de facturation suivent. Avec une intégration, chaque donnée a un propriétaire et circule selon un calendrier connu.
Côté technique, PrestaShop expose un webservice (API REST) pour lire et écrire produits, stocks, clients ou commandes, et des hooks qui déclenchent un traitement lors d’un événement, comme la validation d’une commande ou un changement de statut. Magento 2 propose des API REST et GraphQL ainsi que des files de messages, utiles pour absorber de gros volumes d’échanges.
À distinguer : un outil de comptabilité n’est pas un ERP. Envoyer les factures PrestaShop vers un logiciel comptable, comme le fait Pennylane Connect, ne couvre ni le stock, ni le catalogue, ni la gestion commerciale.
Les flux
Quelles données synchroniser, dans quel sens et à quelle fréquence ?
Chaque donnée a une source de vérité unique : l’outil qui la crée et la modifie. L’autre outil la reçoit en lecture. Voici le schéma le plus courant, à adapter à votre organisation.
| Donnée | Sens habituel | Fréquence courante | Source de vérité |
|---|---|---|---|
| Produits (référence, désignation, déclinaisons, poids) | ERP vers PrestaShop | Par lots, plusieurs fois par jour ou chaque nuit | ERP pour les données de gestion ; PrestaShop ou un PIM pour les textes et images marketing |
| Prix et remises | ERP vers PrestaShop | Par lots, plus souvent en période de promotion | ERP, y compris les tarifs par groupe de clients en B2B |
| Stocks | ERP vers PrestaShop | Au plus près du temps réel : à chaque mouvement ou toutes les quelques minutes | ERP ou logiciel d’entrepôt ; PrestaShop décrémente entre deux synchronisations |
| Clients et adresses | PrestaShop vers ERP, parfois dans les deux sens | À la création du compte ou à la première commande | PrestaShop pour les particuliers ; ERP pour les comptes B2B, encours et conditions de paiement |
| Commandes | PrestaShop vers ERP | À la validation ou au paiement, en temps réel ou par courts lots | PrestaShop jusqu’à l’export, ERP ensuite pour la préparation |
| Factures | ERP vers PrestaShop, ou générées par PrestaShop | À l’émission | Un seul outil numérote les factures : jamais les deux |
| Statuts et suivi d’expédition | ERP ou entrepôt vers PrestaShop | À chaque changement de statut | ERP ou logiciel d’entrepôt, avec le numéro de suivi du transporteur |
Schéma de référence le plus répandu, pas une règle : certaines entreprises créent les produits dans PrestaShop ou gèrent leurs clients dans un CRM. Ce qui compte est d’écrire la règle et de ne jamais avoir deux sources de vérité pour la même donnée.
Modes
Les quatre modes d’intégration et ce qui les distingue
Il existe quatre grandes façons de relier PrestaShop à un ERP. Elles se combinent souvent : un connecteur pour les commandes, des fichiers pour un catalogue fournisseur.
Connecteur d’éditeur
Un module prêt à l’emploi, proposé par l’éditeur de l’ERP ou par un tiers. Rapide à mettre en place si vos règles restent standard ; à vérifier sur les déclinaisons, les tarifs B2B et le multiboutique.
Middleware ou iPaaS
Une plateforme intermédiaire reçoit, transforme et route les données entre les outils. Utile quand plusieurs systèmes sont en jeu : ERP, PIM, CRM, marketplaces, logiciel d’entrepôt.
Développement sur mesure
Un module ou un service écrit pour vos règles, branché sur le webservice et les hooks de PrestaShop et sur l’API de l’ERP. Plus d’effort au départ, un contrôle complet sur les cas particuliers.
Échanges de fichiers
Des fichiers CSV ou XML déposés sur un serveur SFTP puis importés par une tâche planifiée. Simple et robuste avec un ERP ancien sans API, mais par nature en différé.
Temps réel ou par lots
Le temps réel (appel d’API sur événement) convient aux commandes et aux stocks sensibles. Les lots (export planifié) conviennent aux catalogues et aux prix. La plupart des projets mélangent les deux.
Et avec Magento 2 ?
Magento 2 offre des API REST et GraphQL, des files de messages pour traiter les échanges en asynchrone et une gestion multisite (website, store, store view) à reporter dans le mapping des prix et des stocks.
Comparatif
Quel mode d’intégration choisir selon votre situation ?
Le bon mode dépend de l’ERP, du volume, de la complexité des règles et des compétences dont vous disposez pour maintenir l’ensemble.
| Critère | Connecteur éditeur | Middleware / iPaaS | Sur mesure | Fichiers |
|---|---|---|---|---|
| Mise en place | Rapide si le besoin est standard | Moyenne : paramétrage des flux | Plus longue : spécification et développement | Rapide pour des flux simples |
| Règles spécifiques | Limitées à ce que prévoit le module | Bonnes, via les transformations | Toutes, par construction | Limitées au format des fichiers |
| Proche du temps réel | Selon le connecteur | Oui, si les deux outils exposent une API | Oui | Non, en différé |
| Plusieurs systèmes | Un connecteur par paire d’outils | Point fort | Possible, à concevoir | Un format par échange |
| Supervision des erreurs | Selon le connecteur | Souvent intégrée à la plateforme | À prévoir dans le développement | À prévoir : fichiers rejetés, journaux |
| Coût récurrent | Licence ou abonnement du module | Abonnement à la plateforme | Maintenance du code | Faible, hors maintenance des scripts |
Tendances générales, à vérifier pour chaque solution : les fonctions et les tarifs varient d’un connecteur et d’une plateforme à l’autre.
Méthode
Les étapes pour connecter PrestaShop à un ERP
01
1. Cartographier les données et les règles
Listez chaque donnée échangée, sa source de vérité, son sens et sa fréquence. Précisez les règles métier : tarifs par groupe, déclinaisons, taxes, frais de port, statuts de commande, avoirs et retours. Ce document est la base du projet.
02
2. Choisir le mode et faire correspondre les champs
Choisissez le mode d’intégration, puis établissez le mapping champ par champ : référence produit, identifiants clients, codes de taxe, transporteurs, statuts. Choisissez une clé commune stable, en général la référence article, jamais un identifiant interne qui diffère d’un environnement à l’autre.
03
3. Développer et tester sur un environnement de recette
Branchez une copie de la boutique sur une base de test de l’ERP. Testez les cas courants et les cas limites : produit sans stock, commande annulée, remboursement partiel, client B2B avec encours, caractères spéciaux, gros volumes.
04
4. Reprendre l’existant, basculer et superviser
Préparez la reprise initiale des données, fixez une date de bascule hors période de forte activité et gardez un plan de retour. Après la mise en production, surveillez les journaux et les alertes de près pendant les premières semaines.
Erreurs et reprise
Gérer les erreurs et la reprise des échanges
Un échange finira par échouer : ERP indisponible, champ obligatoire manquant, délai dépassé. Une intégration fiable ne se juge pas à l’absence d’erreurs mais à la façon dont elle les traite.
- Journaliser chaque échange : date, donnée concernée, contenu envoyé, réponse reçue. Sans journal, une commande manquante ne s’explique pas.
- Mettre en file d’attente les messages qui échouent au lieu de les perdre, puis les rejouer automatiquement avec un délai croissant entre deux tentatives.
- Rendre les traitements idempotents : renvoyer deux fois la même commande ne doit pas créer deux commandes dans l’ERP. Une clé unique, comme la référence de commande, sert de garde-fou.
- Isoler les messages en échec après plusieurs tentatives, pour qu’une commande bloquée n’empêche pas les suivantes de passer.
- Alerter une personne nommée par courriel ou messagerie quand un seuil est dépassé, avec un lien vers le message en cause.
- Prévoir une resynchronisation complète du stock et des prix, à lancer à la demande ou chaque nuit, pour corriger les écarts accumulés.
- Contrôler les écarts régulièrement : comparer le nombre de commandes et les stocks des deux côtés, et traiter toute différence.
Pièges
Les erreurs fréquentes d’un projet PrestaShop – ERP
Ces erreurs reviennent dans la plupart des projets d’intégration. Elles se corrigent mieux avant le développement qu’après la mise en production.
- Deux sources de vérité pour la même donnée : le prix est modifié dans PrestaShop puis écrasé par l’ERP à la synchronisation suivante.
- Une clé de correspondance fragile : identifiants internes au lieu de références, doublons de références, déclinaisons sans référence propre.
- Un stock synchronisé une fois par jour sur des produits qui se vendent vite, d’où des ventes de produits épuisés.
- Des statuts de commande mal mappés : une commande remboursée ou annulée dans PrestaShop reste à préparer dans l’ERP.
- Des taxes, arrondis et frais de port calculés différemment : les totaux de commande ne correspondent plus à la facture.
- Aucune supervision : les erreurs s’accumulent en silence et l’écart n’apparaît qu’à l’inventaire ou à la réclamation d’un client.
- Des modules qui modifient le stock ou les prix en parallèle du connecteur, sans que personne ne sache qui écrit quoi.
- Une bascule sans recette sur des données réelles, ou en pleine période de soldes.
Check-list
Check-list avant de connecter PrestaShop à votre ERP
Cochez chaque point avant le lancement du développement, puis avant la mise en production.
- Une source de vérité écrite pour chaque donnée : produits, prix, stocks, clients, commandes, factures, expéditions.
- Le sens et la fréquence de chaque flux validés par les équipes métier, pas seulement par la technique.
- Une clé commune unique et stable pour les produits, les déclinaisons, les clients et les commandes.
- Un mapping complet des statuts de commande, des taxes, des transporteurs et des moyens de paiement.
- La règle de numérotation des factures fixée dans un seul outil.
- Les API ou les formats de fichiers de l’ERP documentés, avec des accès de test.
- Un environnement de recette relié à une base de test de l’ERP.
- Des journaux, une file de reprise, des alertes et une personne responsable du suivi.
- Une procédure de resynchronisation complète et un plan de retour en cas d’échec de la bascule.
- Une date de bascule hors période de forte activité.
Pour aller plus loin
Pour aller plus loin
- ERP, PIM, CRM : quel rôle dans un e-commerce connecté ? : le rôle de chaque logiciel et la répartition des données entre eux.
- Portail e-commerce B2B : cahier des charges complet : les besoins B2B à prévoir : tarifs par client, encours, commandes rapides.
- Magento 2 pour un catalogue complexe : les cas où Magento 2 répond mieux à un catalogue et à des flux volumineux.
- Besoin spécifique PrestaShop : un connecteur ou un module développé pour vos règles de gestion.
- Développement sur mesure en méthode agile : notre façon de spécifier, livrer et tester un développement par étapes.
- Connecter PrestaShop à Business Central : flux, méthode et points de vigilance avec Dynamics 365 Business Central.
- Connecter PrestaShop à Odoo : synchroniser produits, stocks, commandes et factures avec Odoo.
- Connecter PrestaShop à Dolibarr : relier la boutique à l’ERP open source Dolibarr.
Questions fréquentes
Vos questions sur la connexion entre PrestaShop et un ERP
Qu’est-ce qu’un e-commerce B2B connecté à un ERP ?
C’est une boutique professionnelle qui lit dans l’ERP les tarifs, les stocks et les conditions de chaque client, et qui lui transmet automatiquement les commandes. Le client voit ses prix négociés, son encours et la disponibilité réelle, et ses commandes entrent dans l’ERP sans ressaisie. L’ERP reste la source de vérité pour les comptes, les tarifs et la facturation.
Comment connecter PrestaShop ou Magento à un ERP ?
Vous passez par un connecteur d’éditeur, un middleware, un développement sur mesure ou des échanges de fichiers. Côté boutique, PrestaShop s’appuie sur son webservice et ses hooks, Magento 2 sur ses API REST et GraphQL et ses files de messages. Dans tous les cas, commencez par définir la source de vérité, le sens et la fréquence de chaque flux, puis testez sur un environnement de recette.
Comment synchroniser les stocks magasins avec un site e-commerce ?
Il faut remonter les mouvements de stock de chaque magasin, depuis la caisse ou l’ERP, vers un stock consolidé que le site lit au plus près du temps réel. Prévoyez un stock de sécurité par magasin, car les ventes en boutique et en ligne se croisent entre deux synchronisations. Pour le retrait en magasin, le site doit lire le stock du point de vente choisi, pas seulement le stock total. Magento 2 gère nativement plusieurs sources de stock ; avec PrestaShop, cette logique passe le plus souvent par l’ERP ou par un module.
Faut-il synchroniser les stocks en temps réel ?
Pas toujours. Le temps réel se justifie pour les produits à rotation rapide ou en faible quantité. Pour un catalogue au stock confortable, une synchronisation toutes les quelques minutes, complétée d’une resynchronisation complète chaque nuit, suffit souvent.
Qui doit être la source de vérité pour les prix entre PrestaShop et l’ERP ?
En général l’ERP, surtout en B2B avec des tarifs par client ou par groupe. Si l’équipe e-commerce gère des promotions propres au site, définissez précisément ce qui est fixé dans PrestaShop et ce qui vient de l’ERP, pour qu’aucune synchronisation n’écrase l’autre.
Que se passe-t-il si l’ERP est indisponible ?
Une intégration bien conçue met les commandes en file d’attente et les envoie dès que l’ERP répond de nouveau. La boutique continue de vendre sur le dernier stock connu. Sans file de reprise, les commandes envoyées pendant la coupure risquent d’être perdues ou ressaisies à la main.
Combien de temps dure un projet de connexion à un ERP ?
Un projet de connexion à un ERP se compte généralement en semaines, selon le nombre de flux, la qualité des données et l’API de l’ERP. Un connecteur standard bien adapté se met en place plus vite qu’un développement sur mesure, mais tout projet demande une phase de cadrage, de recette et de suivi après bascule.
Un projet de connexion entre votre boutique et votre ERP ?
Agillia intervient sur PrestaShop et Magento 2 pour cadrer les flux, développer des connecteurs sur mesure et auditer une intégration existante. Décrivez-nous votre ERP et vos flux.
