Connecter votre boutique Adobe Commerce

Le module Bruxel_Sync garde votre catalogue Adobe Commerce et votre contenu Bruxel alignés : la boutique envoie les produits, Bruxel renvoie les descriptions.

Ce tutoriel a une vidéo dans d'autres langues : en espagnol · en anglais

Comment ça marche

Un module s'installe dans votre boutique. C'est lui qui appelle Bruxel ; Bruxel n'entre jamais dans votre Magento. Deux choses circulent, chacune dans un sens :

De votre boutique vers Bruxel : les produits — SKU, nom, catégorie et les attributs que vous choisissez. C'est la matière première pour générer.
De Bruxel vers votre boutique : le contenu déjà publié, écrit dans la fiche produit, dans la vue de magasin qui correspond à chaque langue.

Votre boutique est propriétaire du catalogue. Ce qu'elle envoie (nom, marque, catégorie, attributs) écrase ce qui se trouve dans Bruxel ; si vous modifiez ces champs dans Bruxel, le prochain envoi depuis la boutique les écrase. Ce que Bruxel envoie, c'est le contenu généré, rien d'autre.

Ce qu'il faut

Adobe Commerce ou Magento Open Source 2.4.7, 2.4.8 ou 2.4.9 — Cloud PaaS ou serveur propre.
Une clé d'API Bruxel (Compte → Clés d'API) avec les permissions catalogue, attributs et export. Elle se crée avec un rôle admin ou propriétaire.
Quelqu'un avec un accès technique à la boutique : le module s'installe avec Composer et se configure depuis le panneau d'administration de Magento.
Les langues que Bruxel synchronise sont l'espagnol, l'anglais, le français et le portugais.

Les quatre étapes de configuration

Tout se passe dans le panneau Magento, sous Stores → Configuration → Bruxel → Synchronisation. Le module s'installe désactivé : rien ne bouge tant que vous ne l'activez pas.

Collez la clé d'API. Le bouton « Tester la connexion » confirme qu'elle répond et indique à quel compte elle accède.
Associez chaque langue à ses vues de magasin. Une langue sans vue associée n'est tout simplement pas écrite : ce n'est pas une erreur, c'est une décision.
Choisissez quels attributs de votre catalogue partent vers Bruxel comme contexte pour générer.
Associez les champs de contenu : quel champ Bruxel s'écrit dans quel attribut Magento. Les noms des champs sont ceux de votre propre configuration de génération.

L'avis en temps réel

Pour que la boutique soit prévenue au moment où vous publiez du contenu, on enregistre un webhook dans Bruxel (Compte → Webhooks) pointant vers l'adresse du module, abonné à l'événement de description mise à jour. Cet enregistrement est manuel dans cette version.

Enregistrez-le APRÈS avoir activé le module et collé le secret, pas avant : si l'endpoint échoue plusieurs fois de suite, Bruxel le désactive tout seul, et la réactivation se fait ici. Même si le webhook échoue, le contenu arrive quand même : le module vérifie de son côté toutes les heures.

Le premier sync, sans mauvaise surprise

La première fois que Bruxel écrit dans un catalogue qui a déjà des descriptions est le moment délicat. Le module arrive avec deux freins serrés :

Un mode d'essai qui montre exactement ce qui changerait — produit, champ, vue de magasin, valeur actuelle et nouvelle — sans rien écrire.
Une option activée par défaut qui n'écrase PAS les champs qui ont déjà du texte et que Bruxel n'a jamais touchés. On la désactive une fois le diff examiné et la décision prise.

En plus, avant d'écrire un champ pour la première fois, le module sauvegarde la valeur qui s'y trouvait. Une commande de restauration la remet, exactement telle qu'elle était.

Quels produits partent

Ceux qui sont activés et visibles dans le catalogue. Cela laisse dehors, volontairement, les variantes masquées d'un produit configurable : leur générer du contenu dépenserait des crédits sur des fiches que votre boutique n'affiche pas. Le configurable parent part bien, et une variante visible par elle-même part aussi, en indiquant quel est son parent.

Ce qu'il écrit dans votre boutique, et ce qu'il n'écrit pas

Il n'écrit que les attributs que vous avez associés, et seulement s'ils sont de type texte et que leur portée est « vue de magasin » — un attribut global ne peut pas avoir une valeur par langue.
Il n'écrit jamais l'URL du produit. La changer d'ici laisserait l'ancienne adresse sans redirection, et c'est une façon silencieuse de perdre du trafic.
Il ne supprime jamais. Un champ qui arrive vide, un produit sans contenu publié ou dépublié dans Bruxel laissent votre fiche telle quelle.

Chaque écriture invalide le cache de cette fiche. C'est pourquoi le module écrit par lots et uniquement ce qui a réellement changé ; et avant un premier sync important, mieux vaut passer les indexeurs en « Update on Schedule ».

Ce que cette version ne couvre pas

Les boutiques à plusieurs sites web : le module écrit par vue de magasin, donc cette association demande une revue manuelle.
Adobe Commerce as a Cloud Service (la version SaaS).
Les images ne partent pas vers la boutique.

Si vous utilisez Content Staging, une campagne programmée qui s'applique écrase ce que Bruxel a écrit, sans prévenir. Republiez depuis Bruxel après avoir appliqué des campagnes.

Quand quelque chose cloche

Le module apporte deux écrans de diagnostic dans Magento, sous System, et son propre fichier de journal. Presque tout s'y explique :

Ce que vous voyez	Ce que c'est en général	Quoi faire
Rien n'arrive à Bruxel	Le module est désactivé, ou le cron de Magento ne tourne pas	Vérifiez l'interrupteur et que le cron est actif
La file se remplit et rien n'avance	La clé ne fonctionne plus et le module s'est mis en pause	Corrigez la clé, testez-la et reprenez avec la commande de file
Une ligne échoue et les autres continuent	Cette langue n'a pas de vues de magasin associées	Associez-la, ou ignorez-la si vous ne vendez pas dans cette langue
Toutes les lignes échouent avec la même erreur	Le mappage des champs contient un attribut inexistant, non textuel ou pas par vue de magasin	Le message indique quelle ligne et quoi changer
Le contenu arrive mais ne s'affiche pas	Il manque une réindexation ou un vidage de cache	Attendez le cron des indexeurs ou lancez-le à la main
Les avis n'arrivent plus depuis des jours	Bruxel a désactivé le webhook après plusieurs échecs	Réactivez-le dans Compte → Webhooks ; le module vous prévient sur son écran de file