Connecter Microsoft Dynamics 365 Business Central à votre logiciel métier

Que peut-on lire et écrire dans Business Central par l'API ?

Par l'API standard v2.0, un logiciel métier peut lire, créer, modifier et supprimer les fiches centrales de Business Central (tiers, articles, documents de vente et d'achat) et lire les écritures comptables, que l'API expose en lecture seule. Parmi les services web pris en charge (REST, SOAP, OData), Microsoft recommande la pile d'API REST dès qu'une autre application doit se connecter. En ligne, l'API est activée par défaut ; chaque appel vise un environnement nommé puis une société : api.businesscentral.dynamics.com/v2.0/{environnement}/api/v2.0/companies({id})/{objet}.

Une commande de vente (salesOrder) expose ses lignes, son PDF (pdfDocument), ses pièces jointes et l'action shipAndInvoice, qui expédie et facture en un seul appel. Quand un champ propre à votre activité manque, Microsoft est clair : on n'ajoute pas de champ à une API standard. Il faut copier son code AL et publier une API personnalisée, appelée par un chemin api/{éditeur}/{groupe}/{version}.

Comment Business Central prévient-il votre logiciel d'un changement ?

Business Central prévient votre logiciel par des webhooks : le programme abonné reçoit un appel HTTP quand une fiche est créée, modifiée ou supprimée. Microsoft liste 22 entités standard compatibles, dont customers, items, salesOrders, salesInvoices et purchaseInvoices ; modifier une ligne déclenche une notification sur l'en-tête du document.

• Poignée de main : à l'inscription, Business Central envoie un paramètre validationToken que votre service renvoie tel quel avec un code 200.
• Trois jours de validité : sans renouvellement, l'abonnement expire.
• Une référence, pas les données : le message donne la ressource et le type de changement (created, updated, deleted) ; votre logiciel relit la fiche par l'API.
• Regroupement : Business Central attend 30 secondes ; si plus de 1 000 enregistrements changent entre-temps, il envoie une seule notification collection, avec un filtre à interroger.
• Nouvelles tentatives : sur une réponse 408, 429 ou 5xx, Business Central réessaie pendant 36 heures ; toute autre erreur supprime l'abonnement.
• Plafond : 200 abonnements par environnement.

Une API personnalisée peut aussi notifier, si c'est une page (pas une requête) sans clé composite.

Quelle authentification, quelles limites d'appels et quel bac à sable ?

Business Central en ligne impose OAuth 2.0 avec Microsoft Entra ID : selon Microsoft, les clés d'accès aux services web (Basic Auth) sont dépréciées et ne sont plus prises en charge en ligne depuis octobre 2022. Pour une synchronisation sans utilisateur connecté, Microsoft prévoit l'authentification de service à service (flux client credentials) : application enregistrée dans Microsoft Entra avec la permission API.ReadWrite.All, puis déclarée dans la page « Applications Microsoft Entra » de Business Central avec ses autorisations. L'ensemble SUPER est interdit aux applications, et ce compte d'application ne demande pas de licence selon Microsoft.

Pour tester, les abonnements Essentials et Premium incluent trois bacs à sable. Créé comme copie de la production, un bac à sable a ses webhooks désactivés ; Microsoft le déconseille pour mesurer les performances.

Quels flux relier en priorité dans une PME ?

Les flux à relier en premier sont ceux qui font recopier une donnée d'un écran à l'autre, les doubles saisies. Cinq exemples pas à pas :

1. Commande prise chez le client. Le commercial valide sur sa tablette, dans une application de prise de commande ; la salesOrder est créée avec les numéros d'articles Business Central ; à l'expédition, shipAndInvoice produit la facture, dont le numéro revient dans l'application.
2. Client ouvert par la comptabilité. La comptable crée le client ; la notification customers arrive ; le logiciel de planning relit la fiche et garde l'identifiant Business Central, sans second code client.
3. Facture dans l'espace client. Une salesInvoice est validée ; le portail client télécharge son PDF et le dépose dans le compte du client, qui n'appelle plus pour un duplicata.
4. Intervention clôturée. Pièces consommées et temps passé saisis dans l'application terrain deviennent des lignes de commande ; une référence inconnue part dans une liste d'anomalies au lieu d'être forcée.
5. Marge de la veille. Un traitement de nuit lit les écritures (generalLedgerEntries) du jour pour le tableau de bord de direction, sans export Excel retouché.

Comment se déroule une intégration Business Central ?

Une intégration Business Central se déroule en cinq étapes.

1. Cadrage : liste des flux, logiciel maître pour chaque donnée, table de correspondance des codes.
2. Accès : l'application est créée dans votre locataire Microsoft Entra, avec les seules autorisations nécessaires.
3. Construction flux par flux contre un bac à sable copié de la production.
4. Champ manquant : l'API personnalisée en AL se décide avec votre partenaire Business Central, qui maintient vos paramétrages.
5. Mise en service en double circuit avant bascule, puis chaque mise à jour repasse par le bac à sable.

Ce qui fait échouer une synchronisation Business Central

• Abonnement expiré en silence : sans renouvellement planifié, les notifications cessent sans erreur visible. Une tâche quotidienne renouvelle et vérifie.
• Récepteur qui répond mal : une erreur 400 coûte l'abonnement. Le récepteur accuse réception tout de suite et traite ensuite, depuis une file d'attente.
• Doublons : une commande renvoyée après une coupure ne doit pas exister deux fois ; l'identifiant de chaque document créé est vérifié avant écriture.
• Erreurs 429 : une reprise de 30 000 articles dépasse vite le débit. Lecture par pages, lots de 100 opérations au plus, nouveaux essais espacés.
• Modifications de masse : après un changement de tarif général, une seule notification collection arrive ; le connecteur Business Central de Power Automate ne la traite pas.
• Secret client : affiché une seule fois par Microsoft Entra, il se range dans un coffre, jamais dans le code.
• Données personnelles : clients particuliers et salariés relèvent du RGPD ; le journal garde l'identifiant et le statut de chaque échange, pas la fiche (voir notre guide RGPD).

Power Automate, Dataverse ou service d'intégration sur mesure ?

Power Automate suffit quand le flux est court et reste dans l'univers Microsoft, par exemple prévenir une personne quand une facture est validée. Microsoft propose aussi une intégration native entre Business Central et Dataverse : synchronisation, tables virtuelles et événements de modification. Ces outils sont à essayer avant tout développement.

Un service sur mesure se justifie dans quatre cas : le logiciel métier n'est pas un produit Microsoft ; le flux touche la facturation ou le stock et doit être rejoué sans perte ; les volumes dépassent le seuil des notifications collection ; la correspondance des codes demande des règles métier (regroupements, contrôles, exceptions). Les principes généraux de ces architectures sont décrits sur notre page pour connecter ses logiciels par API.

Ce que YMHB Web vous remet à la fin

YMHB Web livre un service d'intégration dont le code, les accès et l'hébergement sont à votre nom : application Entra dans votre locataire, dépôt de code remis au paiement intégral, documentation de chaque flux et de chaque correspondance de champ. Un journal et un écran des anomalies montrent quand une commande est partie, avec quelle réponse, et permettent de relancer un envoi (voir API et intégrations).

Par transparence : les intégrations publiées par YMHB Web portent sur d'autres systèmes, les services web Chronopost et l'API Dealer Parts de Peugeot Motocycles pour APARO. Sur Business Central, le cadrage commence par la lecture de votre environnement et de vos extensions.