Tous les cours

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 »).

Aucun mot de passe ni identifiant de votre système n'est stocké ici, et l'enregistrer ne connecte rien à lui seul : Bruxel n'entre jamais dans votre système. C'est lui qui appelle, avec sa clé Bruxel, et Bruxel ne fait que prévenir l'endpoint enregistré dans Webhooks.

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.
Chaque organisation peut avoir jusqu'à 10 systèmes. Le code et le type ne se modifient plus après l'enregistrement : un flux désigne le système par son code.

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.

Si un flux lit les notifications d'un système, vous ne pouvez pas lui retirer son endpoint ni le remplacer par un endpoint qui ne reçoit pas cette notification : modifiez d'abord cette étape ou archivez le flux.

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 :

ÉtatCe que cela signifie
À jourLe 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.
LivraisonTout est sain, mais des notifications attendent d'être livrées. Quelques secondes, c'est normal ; si cela dure, vérifiez le système.
En échecL'endpoint est toujours actif, mais cumule des échecs consécutifs. À 20, il se désactive tout seul.
Sans canalSon 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 pauseQuelqu'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.