Magento 2 et Sage X3
Connecter Magento 2 à Sage X3 : flux, architecture et points de vigilance
Relier Magento 2 à Sage X3, c’est faire dialoguer une plateforme e-commerce multisite et un ERP multisociété sans ressaisie ni écart de données. Ce guide présente les flux, les architectures possibles, les pièges de correspondance et une méthode de mise en production.
Deux outils structurés, deux logiques.
Websites et store views d’un côté, sociétés, sites et dépôts de l’autre : une intégration Sage X3 Magento réussie commence par faire correspondre ces deux organisations.
En bref
Connecter Magento 2 à Sage X3 consiste à synchroniser automatiquement les données de gestion et les données de vente entre la boutique et l’ERP de Sage destiné aux entreprises de taille moyenne et plus grande. En général, articles, tarifs et stocks par site partent de Sage X3 vers Magento 2, tandis que clients, commandes et paiements remontent vers Sage X3. L’échange s’appuie sur les API REST de Magento 2 et sur les services web de Sage X3, le plus souvent via un module Magento et un middleware avec files de messages. La règle d’or : aucun appel synchrone à l’ERP pendant la commande, et une seule source de vérité par donnée. Agillia développe le connecteur sur demande ou adapte une solution existante choisie avec vous.
Les bases
Magento 2 et Sage X3 : ce qu’il faut savoir avant de les relier
Sage X3, anciennement Sage ERP X3, est un ERP conçu pour les entreprises de taille moyenne et plus grande. Il gère notamment les articles, les sites et dépôts, les tiers clients, les commandes de vente, les factures et les tarifs. Il est multisociété et multisite : une même installation peut porter plusieurs sociétés, chacune avec ses sites. Pour échanger avec d’autres logiciels, Sage X3 expose des services web SOAP et, selon les versions, des API plus récentes.
Magento 2, en version Magento Open Source ou Adobe Commerce, expose des API REST et GraphQL, accessibles par jeton ou par intégration OAuth. Il propose aussi des API asynchrones et des points d’accès en masse (bulk), des files de messages sur MySQL ou RabbitMQ, et un cron pour les traitements planifiés. Son organisation en website, store et store view, ses produits configurables, ses groupes de clients et son stock multisource (MSI) sont à aligner avec Sage X3.
Le rôle de chaque brique d’un système connecté est détaillé dans notre guide ERP, PIM, CRM : quel rôle dans un e-commerce connecté ?. Cette page se concentre sur ce qui est propre au couple Magento 2 et Sage X3.
Les flux
Les flux à synchroniser entre Magento 2 et Sage X3
Huit flux reviennent dans la plupart des projets. Le sens et la source de vérité indiqués sont les plus fréquents ; ils se valident avec vos équipes métier.
| Flux | Sens | Source de vérité habituelle | Point de vigilance |
|---|---|---|---|
| Articles et produits configurables | Sage X3 vers Magento 2 | Sage X3 pour les données de gestion ; Magento 2 ou un PIM pour les contenus marketing | Un produit configurable Magento regroupe des produits simples : il faut décider comment les articles Sage X3 s’assemblent en parents et enfants. |
| Prix et tarifs clients | Sage X3 vers Magento 2 | Sage X3 | Tarifs par client, par groupe ou par quantité : choisir entre prix par groupe de clients, prix par palier ou prix calculés à part. |
| Stocks par site et dépôt, sources MSI | Sage X3 vers Magento 2 | Sage X3 ou le logiciel d’entrepôt | Faire correspondre dépôts Sage X3 et sources MSI, puis décider quels stocks alimentent chaque website. |
| Clients et comptes B2B | Magento 2 vers Sage X3 pour les particuliers ; Sage X3 vers Magento 2 pour les professionnels | Sage X3 pour les tiers professionnels | Éviter les doublons de tiers et rattacher chaque compte web au bon code client. |
| Commandes | Magento 2 vers Sage X3 | Magento 2 jusqu’à la transmission, Sage X3 ensuite | Créer la commande de vente une seule fois, même si le message est rejoué. |
| Factures et avoirs | Sage X3 vers Magento 2 | Sage X3, qui numérote | Une seule numérotation de factures ; prévoir les avoirs partiels et leur lien avec la commande web. |
| Expéditions et suivi | Sage X3 ou entrepôt vers Magento 2 | Sage X3 ou le logiciel d’entrepôt | Gérer les livraisons partielles et transmettre le numéro de suivi sur l’expédition Magento. |
| Paiements | Magento 2 vers Sage X3 | Magento 2 ou le prestataire de paiement | Rapprocher le règlement en ligne de la facture et distinguer les paiements à échéance des clients professionnels. |
Schéma de référence établi par Agillia, à adapter : un PIM, un CRM ou un logiciel d’entrepôt peut reprendre certains flux.
Architecture
Quelle architecture pour un connecteur Magento Sage X3 ?
Le choix dépend des volumes, de la fréquence des échanges et des autres logiciels à relier. Ces options se combinent souvent.
API directe
Un module Magento 2 appelle les services web de Sage X3, ou l’inverse. Peu de briques à exploiter, mais la reprise sur erreur repose entièrement sur ce module.
Middleware ou plateforme d’intégration
Un service intermédiaire transforme et route les données entre Magento 2, Sage X3 et d’autres outils. Il isole les deux systèmes, au prix d’une brique de plus à superviser.
Files de messages Magento
Les événements de la boutique, comme une commande validée, sont publiés dans une file et traités par des consommateurs. Le client n’attend pas l’ERP, et un message en échec peut être rejoué.
Échanges de fichiers planifiés
Des fichiers déposés puis importés par une tâche planifiée. Robuste pour des tarifs mis à jour peu souvent ; trop lent pour des stocks qui bougent dans la journée.
API asynchrones et bulk
Les points d’accès asynchrones et en masse de Magento 2 reçoivent de gros lots, traités ensuite en file. Adaptés aux gros imports d’articles ou de prix.
Connecteur existant
Une solution du marché, choisie avec vous, paramétrée puis adaptée. À vérifier sur les configurables, les tarifs B2B et le multisite.
Agillia ne vend pas de connecteur Sage X3 prêt à l’emploi : nous développons le connecteur sur demande ou adaptons une solution existante sélectionnée avec vous.
Mapping
Les pièges de correspondance entre Magento 2 et Sage X3
La majorité des incidents d’une intégration Sage X3 Magento viennent de règles de correspondance implicites. Chacune s’écrit avant le développement :
- Taxes : les classes de taxe Magento 2 et les règles de taxation de Sage X3 ne se recouvrent pas toujours. Chaque combinaison article, client et pays doit mener au même montant de TVA des deux côtés.
- Références : la clé partagée est généralement la référence article Sage X3, reprise en SKU Magento. Les identifiants techniques de Magento ne doivent pas servir de clé.
- Configurables et variantes ERP : un configurable Magento est un parent sans stock propre, ses enfants simples portent la référence vendue. Il faut savoir quel article Sage X3 correspond à chaque enfant et d’où viennent les attributs de déclinaison.
- Unités : un article peut se vendre à la pièce en ligne et se gérer par colis dans Sage X3. Fixez l’unité échangée et les conversions.
- Multisite et sociétés ou sites ERP : un website Magento peut correspondre à une société Sage X3, à un site de vente ou à plusieurs. Ce choix décide où arrivent les commandes, quels tarifs et quels stocks chaque website lit.
- Comptes B2B : les comptes entreprise et catalogues partagés d’Adobe Commerce, ou les groupes de clients de Magento Open Source, doivent correspondre aux tiers et tarifs Sage X3. Le besoin se précise avec notre cahier des charges d’un portail B2B.
- Devises : précisez la devise de chaque commande transmise et l’outil qui fait référence pour les taux de change.
- Arrondis : calcul par ligne ou sur le total, en HT ou en TTC, les écarts de quelques centimes sont fréquents. Désignez l’outil qui fait foi pour que la facture égale le montant encaissé.
- Remises et règles de prix : règles de prix panier, codes promotionnels et prix par palier de Magento n’ont pas toujours d’équivalent direct dans Sage X3. Ils se transmettent souvent en lignes de remise ou en prix nets.
- Statuts : les statuts de commande Magento et l’avancement d’une commande de vente Sage X3 suivent des logiques différentes. Une table de correspondance évite qu’une commande expédiée reste « en cours » sur le site.
Performance
Garder un Magento 2 rapide pendant la synchronisation
Une intégration bien conçue ne ralentit ni la boutique ni le back-office. Trois règles y contribuent :
- Aucun appel synchrone à Sage X3 pendant le checkout : la commande est enregistrée dans Magento 2, puis transmise par une file de messages. Une lenteur de l’ERP reste invisible pour le client.
- Indexation après les imports : chaque mise à jour d’articles, de prix ou de stocks invalide des index. Avec les index en mode planifié, le cron les reconstruit par lots au lieu de bloquer chaque enregistrement.
- Taille des lots : des lots trop gros saturent la mémoire et verrouillent des tables, des lots trop petits multiplient les appels. La bonne taille se mesure en test, sur des volumes réels.
Si votre boutique ralentit déjà lors des imports, un audit de performance Magento 2 identifie la part de l’indexation, du cache et de la base de données, et notre prestation pour optimiser un site Magento 2 traite les points relevés.
Méthode
La méthode pour connecter Magento 2 à Sage X3
01
1. Cadrage et cartographie
Recensez chaque flux, son sens, sa fréquence et sa source de vérité, puis les règles de gestion : taxes, configurables, unités, tarifs, statuts, avoirs. Notez les sociétés et sites Sage X3 et les websites Magento concernés.
02
2. Maquette sur environnement de test
Reliez un environnement de test Sage X3 à une copie de la boutique. Validez les points délicats : commande de vente, TVA, configurable, tarif professionnel.
03
3. Développement et tests de bout en bout
Livrez flux par flux. Testez le parcours entier, de la commande en ligne à la facture et au suivi d’expédition, ainsi que les cas limites : annulation, avoir partiel, rupture, ERP indisponible.
04
4. Mise en production progressive et supervision
Reprenez les données initiales, activez les flux un à un, en dehors des pics de vente et avec un plan de retour arrière.
Supervision
Supervision et gestion des erreurs
Un connecteur fiable n’est pas un connecteur sans erreur, c’est un connecteur qui les rend visibles et rattrapables. Sage X3 peut refuser une commande incomplète : le connecteur doit le prévoir.
- Traçabilité : chaque message conserve la donnée concernée, le contenu envoyé et la réponse reçue, pour comprendre pourquoi une commande manque.
- Rejeu contrôlé : un message en échec est retenté automatiquement à intervalles croissants, puis mis de côté après plusieurs échecs pour ne pas bloquer la file.
- Consommateurs surveillés : les consommateurs de files de messages et le cron Magento sont supervisés ; un consommateur arrêté se détecte avant que les commandes ne s’accumulent.
- Idempotence : le numéro de commande Magento, enregistré dans la commande de vente Sage X3, empêche de créer deux fois la même commande.
- Contrôle des écarts : une comparaison régulière des stocks, des prix et des commandes entre les deux outils corrige ce que les échanges unitaires ont laissé passer.
Cette supervision s’intègre à une TMA Magento 2 ou à une maintenance Magento 2 organisée, avec une surveillance des performances qui couvre aussi les files et le cron.
Agillia
Pourquoi confier votre intégration Sage X3 Magento à Agillia ?
Agillia réunit des experts seniors qui maintiennent des sites e-commerce depuis plus de 16 ans, dans une agence présente sur le web depuis plus de 20 ans. Nous intervenons sur Magento 2 au quotidien : audit, développement, montées de version et maintenance. Notre équipe est présentée sur la page experts seniors de la maintenance e-commerce.
Nous développons et maintenons nos propres extensions Magento 2, comme Sirdata CMP et KeepInHead. Nous en connaissons donc les exigences, qui valent aussi pour un connecteur : compatibilité avec les mises à jour, code testable et maintenable.
Notre expertise PHP et Symfony nous permet d’écrire aussi bien un module Magento qu’un middleware dédié. Nous travaillons par itérations courtes, selon notre méthode de développement sur mesure en agile.
Votre catalogue est particulièrement riche ? Notre guide Magento 2 pour un catalogue complexe aide à mesurer ce que cela implique pour l’intégration.
Pour aller plus loin
Pour aller plus loin
- Connecter Magento 2 à Business Central : la même démarche appliquée à l’ERP de Microsoft.
- Connecter PrestaShop à un ERP : les principes généraux d’une connexion ERP : sources de vérité, modes d’échange, check-list.
- ERP, PIM, CRM : quel rôle dans un e-commerce connecté ? : la répartition des données entre Sage X3 et les autres briques du système.
- Demande de devis : décrire votre projet de connexion et recevoir une proposition.
- Audit de performance Magento 2 : un diagnostic de l’indexation, des files et de la base avant ou après l’intégration.
Questions fréquentes
Vos questions sur la connexion entre Magento 2 et Sage X3
Comment connecter Magento 2 à Sage X3 ?
On relie les API REST de Magento 2 aux services web de Sage X3, via un module Magento, un middleware ou les deux. Les commandes passent par une file de messages pour ne jamais ralentir le checkout. Le projet commence par la cartographie des flux et des règles métier.
Quelles données synchroniser entre Magento 2 et Sage X3 ?
Les flux habituels couvrent articles, tarifs, stocks par site, clients, commandes, factures et avoirs, expéditions et paiements. Articles, tarifs et stocks viennent en général de Sage X3 ; commandes et paiements partent de Magento 2. Chaque donnée doit avoir une seule source de vérité.
Existe-t-il un connecteur Magento 2 Sage X3 prêt à l’emploi ?
Oui, des solutions existent sur le marché. Le choix entre l’une d’elles et un connecteur sur mesure dépend de vos flux et de vos règles métier : configurables, tarifs B2B, multisite, gestion des erreurs. Agillia vous aide à choisir puis développe ou adapte la solution retenue.
Faut-il un middleware entre Magento 2 et Sage X3 ?
Pas toujours, mais il devient utile dès que plusieurs outils échangent avec Sage X3 ou que les volumes sont importants. Il isole les deux systèmes et centralise la supervision. Pour quelques flux simples, un module Magento 2 peut suffire.
Comment gérer les stocks multisites de Sage X3 dans Magento 2 ?
Associez chaque dépôt ou site Sage X3 utile à une source MSI de Magento 2, puis regroupez ces sources en stocks rattachés aux websites. Le stock vendable de chaque site reflète ainsi les dépôts choisis.
Que devient une commande Magento 2 si Sage X3 est indisponible ?
Elle reste dans la file de messages et part dès que Sage X3 répond à nouveau. La boutique continue de vendre sur le dernier stock connu.
Combien de temps prend une intégration entre Magento 2 et Sage X3 ?
Il faut compter en général plusieurs semaines à plusieurs mois, selon le nombre de flux, la volumétrie et la complexité des règles. Le cadrage et la maquette en test permettent de l’estimer. Une mise en production flux par flux réduit le risque.
Qui peut maintenir un connecteur Magento 2 Sage X3 dans la durée ?
Une équipe qui maîtrise Magento 2, ses files de messages et ses montées de version, et qui dialogue avec vos interlocuteurs Sage X3. Agillia assure ce suivi dans le cadre d’une TMA Magento 2.
Un projet pour connecter Magento 2 à Sage X3 ?
Décrivez-nous vos flux, vos sociétés et sites Sage X3 et vos websites Magento : nous vous proposons une approche sur mesure ou à partir d’une solution existante.
