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.

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.

FluxSensSource de vérité habituellePoint de vigilance
Articles et produits configurablesBusiness Central vers Magento 2Business Central pour la gestion ; Magento 2 ou un PIM pour les textes, images et attributs marketingUn 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 clientsBusiness Central vers Magento 2Business CentralLes 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ôtBusiness Central vers Magento 2Business Central, ou un logiciel d’entrepôtAvec 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 B2BMagento 2 vers Business Central à la création ; Business Central vers Magento 2 pour les conditionsMagento 2 pour le compte web ; Business Central pour le compte de facturationEn 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
CommandesMagento 2 vers Business CentralMagento 2 à la création, Business Central ensuiteTransmission asynchrone après paiement, avec un identifiant unique pour éviter les doublons lors d’un rejeu
Factures et avoirsBusiness Central vers Magento 2Business CentralUne seule numérotation légale : désactivez ou encadrez la facturation native de Magento 2 si l’ERP fait foi
Expéditions et suiviBusiness Central vers Magento 2Business Central ou le logisticienLes expéditions partielles doivent créer des envois Magento 2 ligne par ligne, avec le bon numéro de suivi
PaiementsMagento 2 vers Business CentralLe prestataire de paiement, relayé par Magento 2Le 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 :

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 :

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

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.

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.

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.

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.

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.

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.

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.

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.