Aller au contenu
Intégration API

Webhook Business Central expiré : renouveler l’abonnement et reprendre les données

Jérémy Chomel Dawap
  • Publié le : 24 octobre 2026
  • Mis à jour le : 16 novembre 2026
  • Temps de lecture : 8 minutes
Portrait de Jérémy Chomel

À 8 h, le portail B2B reprend la collecte des changements de Business Central. Le support voit pourtant encore la commande C-741 à la révision 2 alors que l’ERP est à la révision 3. Dans ce cas fictif, le récepteur a répondu aux contrôles de santé pendant les 22 heures où son abonnement était expiré. Le nouvel abonnement rétablit la collecte. L’équipe doit encore retrouver les documents restés en retard.

Retrouver l’abonnement de la bonne société

Partez du document signalé. Relevez la société, l’environnement et la collection qui le contient. Une commande lue dans la société de production A doit être rapprochée du chemin de cette société et de la bonne version d’API. Le guide des sociétés, objets et webhooks de l’API Business Central aide à retrouver le chemin. Contrôlez ensuite les droits du compte par société si la lecture échoue. Si l’abonnement est valide et que l’incident suit un import en masse, vérifiez aussi la prise en charge des notifications de collection par le flux Power Automate.

Vérifier les conditions de renouvellement

Le guide Microsoft des webhooks Business Central documente une expiration après trois jours sans renouvellement. Sur une installation sur site, l’administrateur peut configurer cette durée avec ApiSubscriptionExpiration. Dans les deux cas, lisez expirationDateTime dans l’abonnement. La création et le renouvellement déclenchent une validation de l’URL de réception. Elle doit renvoyer la valeur reçue dans validationToken dans le corps de la réponse HTTP 200.

Pour une API personnalisée, reprenez l’éditeur, le groupe et la version d’API dans le chemin des abonnements et dans celui de la ressource. Testez la validation à travers le proxy exposé. Une route qui demande un corps JSON métier avant de traiter validationToken peut répondre au contrôle de santé tout en faisant échouer le renouvellement.

Lire l’échéance et l’heure d’observation

Affichez séparément la disponibilité du récepteur, l’accès du compte API et la prochaine échéance confirmée. Pour chaque observation, enregistrez l’environnement, la société, la ressource, subscriptionId, notificationUrl et l’heure de lecture. Une ancienne lecture dont l’échéance est encore future déclenche une vérification. Si l’échéance connue est déjà atteinte, ouvrez un incident et relisez l’état. Une lecture indisponible laisse la prolongation indéterminée.

Renouveler avec un eTag courant

La référence Microsoft du PATCH d’abonnement demande If-Match avec l’eTag de la ressource. La réponse de réussite contient l’objet mis à jour. Enregistrez l’échéance renvoyée après contrôle de l’identité et de l’URL. Si un autre travailleur a modifié l’abonnement, relisez avant d’agir de nouveau. Conservez un seul propriétaire du renouvellement par flux pour éviter deux tentatives sur le même eTag.

Suivre 22 heures d’interruption dans un cas fictif

Dans l’exercice, une observation datant d’une heure au plus permet de déclencher le renouvellement à 24 heures de l’expiration. Les heures du tableau sont en UTC. Le journal du portail prouve un traitement complet jusqu’à 9 h 40 le 25 octobre et fige le périmètre de l’inventaire à 8 h le lendemain.

Observations et décisions pour l’abonnement fictif sub-A
Moment UTCObservationDécision
24 octobre, 9 hL’échéance lue est le 25 à 10 h.Surveiller les 25 heures restantes.
24 octobre, 10 hLa lecture a exactement une heure.Tenter le renouvellement à 24 heures de l’échéance.
25 octobre, 10 hAucune prolongation confirmée. L’échéance est atteinte.Ouvrir l’incident.
26 octobre, 8 hL’équipe constate un nouvel abonnement après 22 heures.Rapprocher les documents sur 22 h 20, depuis le dernier point de traitement complet à 9 h 40.

Relire l’état après un timeout

Si le PATCH du 24 octobre à 10 h ne répond pas, utilisez la lecture de l’abonnement par son identifiant avant de retenter. Dans une variante de l’exercice, la lecture de 10 h 02 retrouve la même ressource et le même récepteur avec une expiration au 27 à 10 h 01. Enregistrez cette prolongation observée. Si l’échéance est identique, la prolongation reste à confirmer. Une erreur d’accès appelle d’abord une vérification des droits. Avant toute recréation, recherchez les abonnements du même flux que le compte peut voir et faites confirmer le périmètre par son exploitant.

Rapprocher les trois documents du portail

Établissez l’inventaire avec les filtres et la pagination que supporte la ressource. Dans l’exercice, il contient trois références et une révision métier par commande observable. Comparez les révisions dans le portail. Si une notification reçue après le redémarrage et le rattrapage proposent la même mise à jour, dédupliquez l’effet aval sur la société, l’identifiant de commande et la révision. Si le portail a déjà reçu une révision plus récente que celle de l’inventaire, vérifiez l’écart et conservez sa révision.

Décision par commande au point de contrôle de 8 h
CommandeBusiness CentralPortailDécision
C-741Révision 3Révision 2Rapprocher et vérifier la révision 3 côté portail.
C-742Révision 5Révision 5Conserver l’état sans répéter l’effet aval.
C-743Révision non observableRévision 1Faire qualifier l’absence. Une suppression reste à établir.

Après le rejeu de C-741, C-743 maintient l’incident ouvert. L’équipe métier peut vérifier la suppression avec une trace disponible dans son installation, ou documenter un autre traitement si l’objet est sorti du périmètre. Si le métier exige toutes les transitions, cherchez une source qui contient cet historique. La comparaison des états courants produit une preuve limitée au point de contrôle.

Exécuter la recette Python

Téléchargez surveillance_abonnement.py puis lancez la commande. Les 28 contrôles utilisent des données fictives et la bibliothèque standard Python. Ils couvrent les deux seuils horaires, les réponses perdues, le mauvais récepteur et la clôture après rapprochement. Le programme simule les observations de l’exploitant. Les appels Microsoft et le handshake se testent en sandbox.

python3 surveillance_abonnement.py

Choisir la prochaine action

  • Échéance proche et observation fraîche. Lancez le renouvellement et contrôlez la nouvelle échéance.
  • Échéance encore future et observation ancienne. Rétablissez la lecture avant de qualifier l’abonnement.
  • Échéance atteinte. Ouvrez l’incident, délimitez le rattrapage et restaurez la collecte.
  • Abonnement valide avec des objets aval anciens. Examinez les messages en file, les rejets de mapping et la preuve de traitement par référence.

Repérer une perte de marge avant expiration

Une heure silencieuse sur une collection peu utilisée peut être normale. Surveillez la marge restante par abonnement, y compris lorsque le cron sort avec un code 0. L’alerte indique le périmètre, la dernière échéance lue, son heure de lecture et le nom de la personne qui peut intervenir. Les valeurs des jetons restent dans les systèmes qui en ont besoin.

Qualifier le parcours en sandbox

Rejouez un PATCH accepté et une validation dont le corps est incorrect à travers le proxy prévu. Provoquez ensuite une réponse perdue et relisez l’abonnement. Gardez les résultats du PATCH, le résultat de la validation et l’expiration observée dans le dossier de recette. Faites rejouer le rattrapage par l’exploitation sur des commandes dont vous connaissez la révision, avec un chevauchement volontaire entre notification et reprise. Un second passage doit laisser une seule mise à jour par révision du document.

Clôturer l’incident après rapprochement

Demandez à l’exploitation l’échéance nouvellement observée et au métier la liste des documents rapprochés ou encore en enquête. Dans le scénario, la collecte revenue à 8 h et le rejeu de C-741 permettent de réduire la liste à C-743. Gardez cette référence et son responsable dans le ticket jusqu’à décision. Dawap peut vérifier le registre des abonnements et le chemin de reprise avec votre installateur ERP dans le cadre d’une intégration Microsoft Business Central.

Portrait de Jérémy Chomel

Préparer la reprise d’un flux Business Central

Dawap vérifie avec votre installateur ERP les abonnements, les validations et la reprise des documents.

Intégrateur Microsoft Business Central

Articles recommandés

API Business Central : companies, items, sales orders et webhooks Intégration API API Business Central : objets et webhooks Lire l'article
  • 23 juin 2026
  • Lecture ~16 minutes

Business Central API doit être cadrée par companies, customers, items, sales orders, invoices, API pages, OData et webhooks avant de connecter e-commerce, marketplace, BI ou portail B2B. Authentification limitée, mapping versionné, idempotence, rapprochement financier et reprise par dossier protègent ensuite l’ERP des doubles effets et des corrections silencieuses.

Illustration du contrôle des accès d’un connecteur Business Central entre plusieurs sociétés Intégration API Business Central : le compte API lit trop de sociétés Lire l'article
  • 16 août 2025
  • Lecture ~14 minutes

Le connecteur doit lire les clients de la société A, mais une fiche de B reste accessible. Une URL contenant la bonne société ne démontre pas ses droits réels. Construisez une matrice de lectures et de refus, examinez les API d’audit de 2026 et exécutez 37 contrôles locaux sans modifier les permissions.

Illustration de la collecte des clients Business Central après un import non déclenché dans Power Automate Intégration API Business Central : Power Automate ne part pas Lire l'article
  • 17 août 2025
  • Lecture ~15 minutes

Les clients sont modifiés dans Business Central, mais aucune exécution Power Automate ne démarre pour transmettre leurs nouvelles conditions commerciales au portail. Distinguez une notification de collection d’un abonnement expiré, puis rapprochez 1 203 clients fictifs sur trois pages avec 39 contrôles locaux.