Connecter Dynamics 365 Business Central : recevoir commandes et clients, consulter le stock

Enregistrez une app dans Microsoft Entra, créez l’enregistrement correspondant dans Business Central, collez Tenant ID, Client ID et Client Secret dans Integration, testez, mappez, activez.

Le connecteur Dynamics 365 Business Central importe les commandes de vente et les clients de votre société Business Central dans OMS et lit la quantité de stock de vos articles Business Central, pour vérifier le stock avant de vous engager. Les ajustements de stock ne sont pas réécrits dans Business Central par cette connexion : faites les corrections de stock dans Business Central même.

Prérequis#

• Un environnement Microsoft Dynamics 365 Business Central que vous utilisez : production, ou un environnement bac à sable comme Sandbox pour un premier test.
• Droit d’enregistrer une application dans Microsoft Entra pour votre tenant (centre d’administration Microsoft Entra / portail Azure).
• Droit, dans Business Central, de créer un enregistrement d’application Microsoft Entra et de lui attribuer un jeu d’autorisations. L’enregistrement dans Entra n’est que la moitié de la configuration : le côté Business Central est également requis.

Obtenir les identifiants#

1. Dans Microsoft Entra, allez dans App registrations et ouvrez votre app (ou enregistrez-en une nouvelle). Sur la page de présentation, copiez le Directory (tenant) ID — c’est votre tenant_id — et l’Application (client) ID — c’est votre client_id.
2. Accordez à l’app l’autorisation d’API Business Central dont elle a besoin pour appeler l’API Business Central au nom de votre tenant.
3. Toujours sur la page de l’app, allez dans Certificates & secrets → New client secret, créez un secret et copiez sa valeur immédiatement : c’est votre client_secret, et la valeur n’est affichée qu’une fois.
4. Maintenant la moitié Business Central : connectez-vous à Business Central, créez un enregistrement d’application Microsoft Entra pour cette même app et attribuez-lui un jeu d’autorisations pouvant lire sociétés, commandes de vente, clients et articles. Sans cet enregistrement, le test de connexion échoue avec un 403 (voir la FAQ).

Remplir dans Integration#

1. Ouvrez Integration → Marketplace → Dynamics 365 Business Central → Nouvelle connexion.
2. tenant_id, obligatoire : collez le Directory (tenant) ID de la page de votre app dans Microsoft Entra. C’est un GUID, au format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
3. environment, facultatif : le nom de votre environnement Business Central, exactement comme il apparaît dans Business Central. Vide, la connexion utilise production ; pour un bac à sable, saisissez son nom, par exemple Sandbox.
4. company, facultatif : le nom de la société dans Business Central que cette connexion doit lire. Vide, la connexion utilise la première société renvoyée par Business Central.
5. client_id, obligatoire : collez l’Application (client) ID de la même page d’app dans Microsoft Entra. Il est stocké comme un secret et n’est jamais réaffiché.
6. client_secret, obligatoire : collez la valeur du client secret copiée depuis Certificates & secrets. Elle est chiffrée au repos et n’est jamais réaffichée.

Tester la connexion#

Cliquez sur Tester la connexion. Le test vérifie d’abord que tenant_id, client_id et client_secret sont tous remplis : s’il en manque un, il s’arrête là et nomme la valeur manquante (MISSING_TENANT_ID ou MISSING_CLIENT_SECRET) sans envoyer aucune requête. Il échange ensuite vos identifiants client contre un token sur login.microsoftonline.com, puis utilise ce token pour lire la liste des sociétés Business Central sur api.businesscentral.dynamics.com, pour le tenant et l’environnement saisis (jusqu’à 5 sociétés).

Si le test réussit, il affiche le nom de la première société trouvée et le nombre de sociétés renvoyées : vérifiez que cette société est bien celle dont vous attendez les commandes. Le test abandonne après environ 12 secondes si Business Central ne répond pas ; un délai dépassé signifie donc généralement que le nom d’environnement est incorrect ou que Business Central est injoignable à ce moment-là.

Mapping / choisir un modèle#

Choisissez le modèle standard Business Central. Il mappe le numéro de commande de vente, les lignes avec numéros d’article et quantités, et le client de la commande, vers une commande standard. Avant d’activer, lancez l’aperçu de mapping avec une vraie commande de vente et vérifiez deux choses : la société d’origine des commandes est bien celle prévue, et chaque numéro d’article Business Central des lignes est associé à un produit de votre côté. Si vous avez plusieurs sociétés, renseignez d’abord le champ company de la connexion pour que l’aperçu lise la bonne société.

Activer#

Après activation, Integration récupère les nouvelles commandes de vente et les clients de la société visée par cette connexion, selon la fréquence définie, et lit le stock des articles dans Business Central lorsqu’il faut vérifier le stock. Les ajustements de stock ne sont pas renvoyés vers Business Central : continuez à faire les corrections de stock dans Business Central, où elles restent la référence. Surveillez les premières commandes dans Runs / Logs avant de laisser la connexion sans surveillance.

FAQ#

Le test échoue avec 403 — MISSING_SCOPE

Vos identifiants sont acceptés, mais l’app n’a aucun jeu d’autorisations dans Business Central. C’est l’échec le plus fréquent de ce connecteur : l’app a été enregistrée dans Microsoft Entra, mais personne n’a créé pour elle l’enregistrement d’application Microsoft Entra dans Business Central ; Business Central la laisse donc se connecter, puis refuse de la laisser lire quoi que ce soit.

Connectez-vous à Business Central, créez un enregistrement d’application Microsoft Entra pour cette app s’il n’existe pas encore, attribuez-lui un jeu d’autorisations pouvant lire sociétés, commandes de vente, clients et articles, puis relancez le test.

Le test échoue avec INVALID_CREDENTIALS

La demande de token elle-même a été rejetée : Microsoft Entra n’accepte pas le couple client_id et client_secret pour le tenant_id saisi. Les causes habituelles : un client_secret expiré ou copié incomplet, un client_id d’une autre app, ou un tenant_id d’un tenant différent de celui de l’app.

Retournez dans Microsoft Entra → App registrations → votre app et recopiez le Directory (tenant) ID et l’Application (client) ID depuis cette même page d’app. Si le secret a pu expirer, créez un nouveau client secret dans Certificates & secrets, collez la nouvelle valeur dans client_secret et retestez.

Le test échoue avec INVALID_TOKEN lors de la lecture des sociétés

Un token a été émis, donc les identifiants fonctionnent — mais Business Central rejette ce token quand le test essaie de lire la liste des sociétés. Cela pointe vers les autorisations de l’app côté Microsoft Entra : il manque à l’app l’autorisation d’API Business Central requise, ou elle n’a jamais été accordée pour votre tenant.

Dans Microsoft Entra, ouvrez l’app et vérifiez ses autorisations d’API : ajoutez l’autorisation d’API Business Central requise par le connecteur et accordez-la pour le tenant, puis relancez le test. Si l’échec persiste, confirmez aussi le côté Business Central en suivant l’entrée 403 ci-dessus : les deux côtés doivent être en place.

Nous avons plusieurs sociétés — laquelle la connexion utilise-t-elle ?

Cela dépend du champ company. Si vous avez laissé company vide, la connexion utilise la première société renvoyée par Business Central — qui n’est pas forcément celle depuis laquelle vous vendez. Le test de connexion vous dit laquelle : réussi, il affiche le nom de la première société trouvée.

Pour verrouiller la connexion sur une société, renseignez le champ company avec le nom exact de cette société tel qu’il apparaît dans Business Central, enregistrez et retestez : le résultat doit maintenant afficher cette société. Utilisez une connexion distincte pour chaque société supplémentaire à importer.