Systèmes connectés
Enregistrez les systèmes de votre activité —votre boutique, SAP, l'entrepôt, l'ERP— avec la clé avec laquelle ils appellent et l'endpoint que Bruxel prévient, et vérifiez si leur canal est en bonne santé.
Qu'est-ce qu'un système connecté et à quoi sert-il ?
C'est la fiche d'un système de votre entreprise qui échange avec Bruxel : votre boutique en ligne, SAP, l'entrepôt (WMS), l'ERP ou un middleware. Elle se trouve dans Canaux → Systèmes connectés et indique deux choses : avec quelle clé d'API Bruxel ce système appelle, et quel endpoint de webhook Bruxel prévient.
Grâce à cela, Bruxel sait à qui appartient chaque notification et chaque appel. Les flux s'en servent pour considérer comme faites les étapes du couloir de ce système (guide « Flux et parcours »), et le rapprochement par source, pour savoir quel système a déclaré chaque valeur (guide « Rapprochement par source »).
Qui peut voir et enregistrer des systèmes connectés ?
Voir la liste demande le rôle Opérateur ou plus ; un Lecteur ou un Éditeur voit un avis indiquant que son rôle ne suffit pas. Enregistrer, changer la clé et l'endpoint, diagnostiquer, mettre en pause, réactiver et supprimer demandent le rôle Administrateur ou Propriétaire. Un fournisseur ne voit pas cet écran.
Si l'écran indique « Cette fonctionnalité n'est pas encore disponible sur votre compte », votre organisation l'a désactivée.
Comment enregistrer un système ?
Dans « Enregistrer un système », remplissez ces champs et cliquez sur « Enregistrer » :
- Nom : comment votre équipe le reconnaît, par exemple « SAP middleware ».
- Type : SAP, Entrepôt (WMS), ERP, Autre boutique en ligne, Middleware ou Autre système. Adobe Commerce n'apparaît que si votre organisation dispose de cette connexion (guide « Connecter votre boutique Adobe Commerce »).
- Code (facultatif) : le nom du système dans les flux. En minuscules, commençant par une lettre, avec chiffres et tiret bas, jusqu'à 40 caractères. Laissé vide, il vient du nom (« SAP middleware » → sap_middleware).
- Clé d'API avec laquelle il appelle et Endpoint que nous prévenons (ci-dessous).
- Adresse de la boutique (facultatif) : seuls les types boutique la demandent.
Comment associer la clé d'API et l'endpoint d'un système ?
La clé se crée dans Canaux → Clés API et l'endpoint dans Canaux → Webhooks : créez-les d'abord là. Seules les clés valides sont proposées, ni révoquées ni expirées, et seul le domaine de l'endpoint est affiché. Une clé et un endpoint appartiennent à un seul système : ceux qu'un autre système a déjà n'apparaissent pas.
Un système qui n'est pas une boutique peut n'avoir que la clé (s'il ne fait qu'appeler Bruxel) ou que l'endpoint (s'il ne fait que recevoir des notifications). Pour les changer ensuite, « Changer la clé et l'endpoint », choisissez puis « Enregistrer ». Ce qui est déjà arrivé reste au système qu'il avait à ce moment-là : changer une association ne déplace que ce qui arrive ensuite.
Une clé non associée compte par son nom : ce qui arrive avec une clé nommée « SAP » appartient à sap, sauf si sap a déjà sa propre clé associée.
Que signifie l'état de chaque système ?
Chaque système indique avec quelle clé il appelle et qui nous prévenons, quand il a appelé pour la dernière fois et qui a appelé, combien de notifications restent à livrer, combien d'échecs consécutifs il cumule et la dernière erreur. En haut à droite, son état :
| État | Ce que cela signifie |
|---|---|
| À jour | Le canal est en bonne santé. Pour une boutique, cela veut dire qu'elle est venue chercher le contenu, pas qu'elle l'a écrit : si quelque chose n'y apparaît pas, vérifiez-le dans l'administration de votre boutique. |
| Livraison | Tout est sain, mais des notifications attendent d'être livrées. Quelques secondes, c'est normal ; si cela dure, vérifiez le système. |
| En échec | L'endpoint est toujours actif, mais cumule des échecs consécutifs. À 20, il se désactive tout seul. |
| Sans canal | Son endpoint s'est désactivé tout seul après trop d'échecs ou, pour une boutique, il n'a pas d'endpoint : aucune notification ne lui parvient. |
| En pause | Quelqu'un de votre équipe l'a mis en pause sur cet écran. |
| Non associé | Il n'a ni clé ni endpoint : les flux ne peuvent pas reconnaître ce qui lui appartient. |
Que faire si un système ne reçoit pas de notifications ou affiche des échecs ?
« Diagnostiquer » vérifie, dans l'ordre, qu'il y a une clé valide, qu'il a déjà appelé avec elle, qu'il y a un endpoint, qu'il est actif et qu'au moins une notification est arrivée. Pour une boutique, il vérifie les cinq ; pour un autre système, seulement ce qui est associé. Il indique la première vérification qui échoue et quoi faire. Il ne fait que lire : il n'envoie rien nulle part.
Si l'endpoint s'est désactivé tout seul, réparez le système et cliquez sur « Réactiver le canal » : il le rallume et son compteur d'échecs repart de zéro. Si vous avez déjà le maximum d'endpoints actifs, désactivez ou supprimez-en un autre dans Webhooks d'abord. Chaque tentative de livraison est listée dans Webhooks (guide « Webhooks »).
Que se passe-t-il si je mets en pause ou supprime un système ?
« Mettre en pause » le marque « En pause » sur cet écran et « Reprendre » le rétablit. Cela ne désactive pas son webhook et ne révoque pas sa clé : cela se fait dans Webhooks et dans Clés API.
« Supprimer » puis « Oui, supprimer » effacent seulement la fiche du système : son webhook et sa clé restent tels quels. Un système dont un flux lit les notifications ne peut pas être supprimé : modifiez d'abord cette étape ou archivez le flux.