Cette page définit vers quels systèmes destinataires les notifications sont relayées, et pour quels événements. Chaque abonnement associe une application source (par exemple l'intégration iopole) à un système destinataire (un autre ERP, un environnement Navision, un flux Power Automate, un outil interne).

À quoi sert un abonnement ?

La page Configuration Webhook active l'envoi ; la page Abonnements Webhook indique à qui envoyer et pour quels événements. Sans abonnement actif couvrant un événement, la notification n'a pas de destinataire et n'est pas relayée.

Comment c'est organisé

Un abonnement se compose de deux parties :

• L'en-tête — le destinataire : son adresse, son mode d'authentification, son activation.

• Les événements souscrits — une sous-grille listant les types d'événements que ce destinataire doit recevoir (par exemple EDOCUMENT_RECEIVED).

La sous-grille des événements est affichée directement sous la liste des abonnements et se met à jour automatiquement quand vous sélectionnez un autre abonnement.

Avant de commencer

• Un rôle d'administrateur dans Business Central.

• L'adresse (URL) HTTPS du système destinataire, fournie par l'équipe qui le gère.

• Le cas échéant, un secret d'authentification convenu avec ce système (inutile si l'authentification est None).

Créer un abonnement

1. Cliquez sur Nouveau.

2. Renseignez l'en-tête :

   • Source App : l'application source, par exemple iopole.

   • Subscription Code : un code unique pour ce destinataire, par exemple NAVISION ou POWERAUTOMATE.

   • Description : un libellé lisible, par exemple « Environnement Navision du client ».

   • Target URL : l'adresse HTTPS du destinataire (une adresse non HTTPS est refusée).

   • Auth Type : le mode d'authentification (None, Signature HMAC, Jeton Bearer, Basic).

3. Dans la sous-grille Subscribed Events, ajoutez une ligne par événement souhaité.

4. Cochez Enabled pour activer l'abonnement.

Choisir les événements

Dans la sous-grille Subscribed Events, chaque ligne = un type d'événement relayé à ce destinataire. Le champ Event Type propose une liste des événements déclarés par l'application source (pour iopole : EDOCUMENT_RECEIVED, EDOCUMENT_STATUS_CHANGED, INVOICE_INBOUND_INVALID). La colonne Enabled de chaque ligne permet de couper temporairement un événement sans supprimer la ligne.

Un même destinataire peut donc s'abonner à plusieurs événements : ajoutez autant de lignes que nécessaire.

Plusieurs destinataires pour un même événement

Un même événement peut être relayé à plusieurs destinataires. Créez un abonnement par destinataire (chacun avec son propre Subscription Code et sa propre adresse), et ajoutez le même type d'événement dans la sous-grille de chacun. Par exemple, une facture reçue peut être notifiée à la fois à Navision et à un flux Power Automate : chaque destinataire est livré et suivi indépendamment (l'un peut réussir pendant que l'autre est réessayé).

Authentification vers le destinataire

Le champ Auth Type indique comment la plateforme s'authentifie auprès du destinataire :

• None : aucun secret. À utiliser quand l'adresse s'authentifie elle-même — c'est le cas d'un flux Power Automate, dont l'URL de déclenchement contient déjà un jeton SAS. Rien à saisir.

• HMAC / Bearer / Basic : un secret est nécessaire. Ouvrez l'abonnement, cliquez sur Set Subscriber Secret, saisissez le secret et validez. Il est conservé de façon sécurisée et ne peut plus être relu ; Subscriber Secret Configured passe à « activé ».

L'action Set Subscriber Secret est désactivée lorsque Auth Type vaut None, puisqu'aucun secret n'est attendu.

À noter : l'authentification entre Business Central et la plateforme DyXit est distincte et assurée automatiquement par l'enregistrement d'application réalisé à l'installation. Le secret ci-dessus ne concerne que la liaison entre la plateforme et votre système destinataire.

Bon à savoir

• Un abonnement désactivé ne reçoit aucune notification, sans être supprimé.

• L'adresse du destinataire doit être en HTTPS.

• Le suivi des envois se consulte sur la page Webhook Outbox.