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.

FluxSensSource de vérité habituellePoint de vigilance
Articles et produits configurablesSage X3 vers Magento 2Sage X3 pour les données de gestion ; Magento 2 ou un PIM pour les contenus marketingUn 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 clientsSage X3 vers Magento 2Sage X3Tarifs 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 MSISage X3 vers Magento 2Sage X3 ou le logiciel d’entrepôtFaire correspondre dépôts Sage X3 et sources MSI, puis décider quels stocks alimentent chaque website.
Clients et comptes B2BMagento 2 vers Sage X3 pour les particuliers ; Sage X3 vers Magento 2 pour les professionnelsSage X3 pour les tiers professionnelsÉviter les doublons de tiers et rattacher chaque compte web au bon code client.
CommandesMagento 2 vers Sage X3Magento 2 jusqu’à la transmission, Sage X3 ensuiteCréer la commande de vente une seule fois, même si le message est rejoué.
Factures et avoirsSage X3 vers Magento 2Sage X3, qui numéroteUne seule numérotation de factures ; prévoir les avoirs partiels et leur lien avec la commande web.
Expéditions et suiviSage X3 ou entrepôt vers Magento 2Sage X3 ou le logiciel d’entrepôtGérer les livraisons partielles et transmettre le numéro de suivi sur l’expédition Magento.
PaiementsMagento 2 vers Sage X3Magento 2 ou le prestataire de paiementRapprocher 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 :

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 :

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.

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

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.

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é.

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.

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.

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.

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.

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.

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.