Magento 2 et Business Central
Connecter Magento 2 à Business Central : flux, architecture et points de vigilance
Relier Magento 2 à Microsoft Dynamics 365 Business Central évite la double saisie du catalogue, des prix, des stocks et des commandes. Ce guide présente les flux, les architectures possibles, les pièges de correspondance et la méthode de projet.
Deux modèles de données, un seul référentiel.
Website et store view d’un côté, sociétés et magasins de l’autre : un connecteur Magento Business Central fiable commence par une table de correspondance écrite, avant la première ligne de code.
En bref
Connecter Magento 2 à Business Central consiste à automatiser les échanges entre la boutique et l’ERP de Microsoft : articles, prix et stocks par magasin partent en général de Business Central vers Magento 2 ; clients et commandes remontent de Magento 2 vers Business Central ; factures, avoirs et expéditions reviennent ensuite vers le compte client. Les deux outils disposent d’API : REST et GraphQL pour Magento 2, avec des points d’entrée asynchrones et en masse ; REST et services web OData pour Business Central, sécurisés par Microsoft Entra ID (OAuth 2.0) dans la version cloud. Le connecteur prend le plus souvent la forme d’un module Magento 2, d’un middleware avec files de messages, ou des deux. La règle de base : aucun appel synchrone à l’ERP pendant le tunnel de commande.
Les bases
Magento 2 et Business Central : ce que chaque outil apporte à l’intégration
Une intégration Magento Dynamics 365 Business Central repose sur les points d’entrée techniques des deux outils. Magento 2 (Magento Open Source ou Adobe Commerce) expose des API REST et GraphQL, accessibles par jeton ou par une intégration OAuth déclarée dans le back-office. Il propose aussi des API asynchrones et en masse, traitées via une file de messages (RabbitMQ ou MySQL), et des tâches cron.
Business Central gère les articles, leurs variantes et leurs unités de mesure, les clients, les commandes et factures de vente, les prix et le stock par magasin. Un environnement contient une ou plusieurs sociétés, et Microsoft distingue les environnements sandbox et de production. L’accès se fait par API REST ou services web OData ; dans la version cloud, l’authentification passe par Microsoft Entra ID avec OAuth 2.0.
Le travail du connecteur est de traduire un modèle dans l’autre. Magento 2 raisonne en websites, stores et store views, en produits configurables avec des produits simples enfants, en groupes de clients et prix par quantité, et, avec Multi-Source Inventory, en sources et stocks. Business Central raisonne en sociétés, articles, variantes et magasins.
Voir aussi ERP, PIM, CRM dans un e-commerce connecté et, pour une boutique PrestaShop, connecter PrestaShop à Business Central.
Les flux
Quels flux prévoir entre Magento 2 et Business Central ?
Huit flux structurent la plupart des projets. Sens et source de vérité indiqués sont les plus fréquents, à valider avec vos équipes.
| Flux | Sens | Source de vérité habituelle | Point de vigilance |
|---|---|---|---|
| Articles et produits configurables | Business Central vers Magento 2 | Business Central pour la gestion ; Magento 2 ou un PIM pour les textes, images et attributs marketing | Un configurable Magento regroupe des produits simples enfants ; il faut décider comment chaque variante Business Central devient un simple, et qui crée le parent |
| Prix et tarifs clients | Business Central vers Magento 2 | Business Central | Les conditions négociées doivent trouver leur place dans les prix de base, les groupes de clients ou les prix par quantité de Magento 2, selon la portée de prix choisie |
| Stocks par site et par dépôt | Business Central vers Magento 2 | Business Central, ou un logiciel d’entrepôt | Avec Multi-Source Inventory, chaque magasin Business Central peut devenir une source ; la quantité vendable dépend ensuite du stock rattaché à chaque website |
| Clients et comptes B2B | Magento 2 vers Business Central à la création ; Business Central vers Magento 2 pour les conditions | Magento 2 pour le compte web ; Business Central pour le compte de facturation | En B2B, les comptes société et catalogues partagés d’Adobe Commerce, s’ils sont utilisés, doivent rester cohérents avec les clients de l’ERP |
| Commandes | Magento 2 vers Business Central | Magento 2 à la création, Business Central ensuite | Transmission asynchrone après paiement, avec un identifiant unique pour éviter les doublons lors d’un rejeu |
| Factures et avoirs | Business Central vers Magento 2 | Business Central | Une seule numérotation légale : désactivez ou encadrez la facturation native de Magento 2 si l’ERP fait foi |
| Expéditions et suivi | Business Central vers Magento 2 | Business Central ou le logisticien | Les expéditions partielles doivent créer des envois Magento 2 ligne par ligne, avec le bon numéro de suivi |
| Paiements | Magento 2 vers Business Central | Le prestataire de paiement, relayé par Magento 2 | Le rapprochement comptable a besoin de la référence de transaction, du moyen de paiement et des remboursements partiels |
Répartition indicative : un PIM ou un logiciel d’entrepôt peut aussi faire foi pour le contenu ou le stock.
Architecture
Six options d’architecture pour un connecteur Magento Business Central
Le choix dépend du nombre de flux, des volumes et des autres systèmes à relier. Ces options se combinent souvent.
API directe
Un module Magento 2 appelle les API de Business Central, et inversement. Simple pour quelques flux, elle lie fortement les deux outils et exige une gestion soignée des reprises.
Middleware ou plateforme d’intégration
Un service intermédiaire orchestre les échanges, transforme les données et journalise chaque message. Il devient pertinent quand d’autres outils consomment les mêmes données : PIM, logisticien, marketplaces.
Files de messages Magento
Les événements de la boutique, comme une commande payée, sont publiés dans une file puis traités par des consommateurs. Le site reste réactif et un message en échec se rejoue sans bloquer les suivants.
Échanges de fichiers planifiés
Des exports et imports à heures fixes, en CSV ou XML. Robuste pour les tarifs qui changent peu, elle convient mal au stock ou aux statuts qui doivent circuler vite.
API asynchrones et en masse
Magento 2 accepte des envois groupés traités en arrière-plan. Utile pour pousser beaucoup de produits ou de stocks sans saturer le serveur web, en suivant le statut de chaque opération.
Connecteur existant
Des solutions du marché couvrent une partie des flux standard. Elles se vérifient flux par flux face à vos règles : configurables, multi-sites, tarifs B2B, avoirs. L’adaptation d’une solution choisie avec vous reste une option sérieuse.
Mapping
Les pièges de mapping entre Magento 2 et Business Central
La plupart des anomalies viennent d’une correspondance mal définie, pas d’un défaut technique. Points à trancher par écrit :
- Taxes : les classes de taxe de Magento 2 et les paramètres de TVA de Business Central ne se recouvrent pas ; chaque combinaison produit, client et pays doit donner le même montant des deux côtés.
- Références : un SKU Magento 2 et un numéro d’article Business Central doivent former une clé stable, jamais réutilisée, y compris pour les produits simples enfants.
- Configurables et variantes : un produit configurable combine plusieurs attributs (taille, couleur), alors qu’une variante Business Central est un code rattaché à un article ; la règle de passage de l’un à l’autre doit être unique.
- Unités de mesure : vente à l’unité sur le site, par carton ou au mètre dans l’ERP ; la conversion doit s’appliquer aux quantités, aux prix et au stock.
- Multi-sites et sociétés : un website Magento 2 peut correspondre à une société Business Central, à un magasin ou à un simple canal ; ce choix décide où arrivent les commandes et quel stock chaque site lit.
- Devises : la devise de base par website, les devises d’affichage et celles de facturation dans l’ERP doivent être alignées.
- Arrondis : calcul par ligne ou sur le total, prix saisis TTC ou HT ; quelques centimes d’écart suffisent à bloquer l’intégration d’une commande.
- Remises et règles de prix : les règles de panier et les règles de prix catalogue de Magento 2 doivent arriver dans l’ERP sous une forme exploitable, en remise de ligne ou en ligne dédiée.
- Statuts : états et statuts de commande Magento 2 d’un côté, documents de vente Business Central de l’autre ; une table de correspondance évite les commandes bloquées dans un état intermédiaire.
Performance
Préserver la performance de Magento 2 pendant la synchronisation
La première règle est de ne jamais appeler Business Central de façon synchrone dans le tunnel de commande. Stock et prix affichés viennent des données déjà importées ; la commande part vers l’ERP après coup, par une file de messages.
La deuxième concerne l’indexation. Chaque import de produits, de prix ou de stocks invalide des index : prix, stock, catalogue, recherche. Préférez l’envoi des seules variations, l’indexation planifiée plutôt qu’à l’enregistrement, et des fenêtres d’import adaptées au trafic.
La troisième porte sur la taille des lots : trop gros, ils saturent la mémoire ; trop petits, ils multiplient les appels. La bonne taille se mesure sur un environnement de test, selon la volumétrie et les capacités réelles des API de chaque outil. Notre page sur la surveillance des performances Magento 2 détaille les indicateurs à suivre.
Méthode
La méthode pour connecter Magento 2 à Business Central
01
1. Cadrage et cartographie
Inventaire des flux, des sources de vérité, des volumes et des règles métier, consigné dans une table de correspondance validée par les équipes.
02
2. Maquette sur environnement de test
Une copie de Magento 2 reliée à une sandbox Business Central. On y valide les cas difficiles : configurables, TVA, devises, remises, expéditions partielles, avoirs.
03
3. Développement et tests de bout en bout
Développement par itérations courtes, flux par flux. Chaque flux est testé de la boutique à l’ERP et retour, y compris les pannes, les doublons et les rejeux.
04
4. Mise en production progressive et supervision
Reprise initiale des données, activation flux par flux, surveillance rapprochée au démarrage, puis maintenance au fil des mises à jour.
Supervision
Supervision et gestion des erreurs : ce qu’un connecteur doit prévoir
Un connecteur fiable est un connecteur qui signale ses échecs. À prévoir dès la conception :
- Un journal de chaque échange : objet concerné, sens, horodatage, résultat, message d’erreur lisible
- Une file des messages en échec, avec rejeu manuel ou automatique et protection contre les doublons
- Des alertes envoyées à une personne identifiée, par exemple pour une commande non transmise ou un stock non mis à jour
- Un écran de suivi dans le back-office Magento 2 ou dans le middleware, compréhensible par les équipes métier
- La surveillance des consommateurs de files et des tâches cron, qui peuvent s’arrêter sans bruit
- Des tests de non-régression à rejouer avant chaque mise à jour de l’un ou l’autre outil
Cette surveillance s’intègre naturellement dans une TMA Magento 2 ou un contrat de maintenance Magento 2. Avant toute montée de version Magento 2, le connecteur fait partie du périmètre à tester.
Agillia
Pourquoi confier votre connexion Magento 2 Business Central à Agillia ?
Agillia réunit des experts seniors qui maintiennent des sites e-commerce depuis plus de 16 ans, et plus de 20 ans d’expérience du web. L’agence développe et maintient ses propres extensions Magento 2, comme Sirdata CMP et KeepInHead : nous connaissons le cycle de vie d’un module Magento 2 dans la durée, mises à jour comprises.
Notre expertise PHP et Symfony couvre aussi les middlewares et services d’intégration. Agillia ne vend pas de connecteur Business Central tout fait : nous développons le connecteur à la demande, ou nous adaptons une solution existante choisie avec vous, selon vos flux et vos règles. Le travail suit notre méthode de développement sur mesure agile, et l’équipe est présentée sur la page experts seniors pour votre maintenance e-commerce.
Magento 2 ralentit pendant les imports ? Un audit de performance Magento 2, un audit global ou une mission pour optimiser votre site Magento 2 prépare le terrain.
Pour aller plus loin
Pour aller plus loin
- ERP, PIM, CRM : quel rôle dans un e-commerce connecté ? : la place de Business Central parmi les autres briques du système d’information.
- Magento 2 pour un catalogue complexe : les configurables, le multisite et les règles de prix qui compliquent la synchronisation.
- Portail e-commerce B2B : cahier des charges : les besoins B2B à intégrer au cadrage : tarifs clients, encours, catalogues restreints.
- Connecter Magento 2 à Sage X3 : la même démarche appliquée à un autre ERP.
- Connecter PrestaShop à un ERP : les principes généraux d’intégration, valables quelle que soit la plateforme.
- Demande de devis : décrire votre projet de connexion et recevoir une proposition.
Questions fréquentes
Vos questions sur la connexion entre Magento 2 et Business Central
Comment connecter Magento 2 à Business Central ?
Vous reliez les API REST de Magento 2 aux API REST ou services web OData de Business Central, via un module Magento 2, un middleware ou les deux. Les échanges passent de préférence par des files de messages, pour que la boutique ne dépende jamais de la disponibilité de l’ERP. Le projet commence par une cartographie des flux, puis une validation sur sandbox.
Quelles données synchroniser entre Magento 2 et Business Central ?
Les flux courants sont les articles et produits configurables, les prix et tarifs clients, les stocks par magasin, les clients, les commandes, les factures et avoirs, les expéditions et les paiements. Catalogue, prix et stocks viennent généralement de Business Central, commandes et comptes web de Magento 2. Votre organisation peut justifier une autre répartition.
Existe-t-il un connecteur Magento 2 Business Central prêt à l’emploi ?
Oui, des solutions existent, mais aucune ne couvre d’office toutes les règles d’une entreprise. Configurables, multi-sites, tarifs B2B et gestion des erreurs sont les points à vérifier avant d’en adopter une. Agillia développe le connecteur à la demande ou adapte une solution existante choisie avec vous.
Comment relier les sites Magento 2 aux sociétés Business Central ?
Il faut décider si chaque website Magento 2 correspond à une société Business Central, à un magasin ou à un canal de vente. Ce choix détermine où arrivent les commandes, quels prix et quel stock chaque site affiche.
Comment gérer les produits configurables Magento 2 avec les variantes Business Central ?
Chaque variante Business Central devient en général un produit simple Magento 2, rattaché à un produit configurable parent. Il faut définir quels attributs portent la variation et qui crée le parent : l’ERP, un PIM ou Magento 2.
Multi-Source Inventory est-il utile avec Business Central ?
Oui, quand le stock est réparti entre plusieurs magasins Business Central. Chaque magasin peut devenir une source Magento 2, rattachée aux stocks des websites concernés. Pour un seul dépôt, une quantité globale suffit souvent.
La synchronisation avec Business Central ralentit-elle Magento 2 ?
Elle ne le ralentit pas si elle est conçue en asynchrone et par lots maîtrisés. Les points sensibles sont les appels synchrones pendant la commande, les imports massifs qui relancent l’indexation et les tâches cron en concurrence.
Que faire si une commande Magento 2 n’arrive pas dans Business Central ?
Le connecteur doit l’avoir journalisée et placée dans une file d’échec, avec une alerte à une personne identifiée. Après correction de la cause, souvent un mapping de TVA, d’article ou de client, la commande est rejouée sans créer de doublon.
Un projet de connexion entre Magento 2 et Business Central ?
Décrivez-nous vos flux, vos sites Magento 2 et votre organisation Business Central : nous vous proposons un connecteur sur mesure ou l’adaptation d’une solution existante.
