À 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.
| Moment UTC | Observation | Décision |
|---|---|---|
| 24 octobre, 9 h | L’échéance lue est le 25 à 10 h. | Surveiller les 25 heures restantes. |
| 24 octobre, 10 h | La lecture a exactement une heure. | Tenter le renouvellement à 24 heures de l’échéance. |
| 25 octobre, 10 h | Aucune prolongation confirmée. L’échéance est atteinte. | Ouvrir l’incident. |
| 26 octobre, 8 h | L’é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.
| Commande | Business Central | Portail | Décision |
|---|---|---|---|
| C-741 | Révision 3 | Révision 2 | Rapprocher et vérifier la révision 3 côté portail. |
| C-742 | Révision 5 | Révision 5 | Conserver l’état sans répéter l’effet aval. |
| C-743 | Révision non observable | Révision 1 | Faire 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.