Skip to main content
L’intégration Shopify relie votre boutique à Bonx dans les deux sens. Lorsque Bonx alimente le catalogue, il reste maître des données produit qu’il pousse vers Shopify. Les visuels marketing sont gérés dans Shopify, puis importés dans Bonx.

Authentification : jeton d'API Admin

Vous générez un jeton d’accès Admin dans Shopify et le collez dans Bonx, avec le domaine de la boutique et la version d’API. Voir les méthodes d’authentification.

​
Permissions de l’application Shopify

Accordez à l’application personnalisée les autorisations d’accès (scopes) correspondant à ce que vous synchronisez. Une autorisation manquante se traduit par une erreur sur l’écran concerné (par exemple, la liste des canaux de vente de l’onglet Intégration d’un article ne se charge pas sans read_publications).

​
Données synchronisées

​
Comportements métier

  • L’export d’articles se choisit article par article. Un interrupteur sur la fiche article décide si elle part vers Shopify, et sur quels canaux de vente elle est publiée.
  • Deux notions Shopify ne se confondent pas : les canaux de vente servent à publier un produit, les emplacements servent au stock. Les emplacements Shopify se rattachent à vos emplacements de stock Bonx.
  • La synchronisation du stock s’active explicitement. Une fois active, Bonx pousse le disponible ; un échec de cette étape n’annule pas l’export des articles, il est réessayé au cycle suivant.
  • Les produits supprimés sur Shopify sont réconciliés une fois par jour, pour que votre catalogue Bonx ne garde pas de références fantômes.
  • Les commandes reprennent le régime de taxe de la boutique (prix TTC ou HT) et l’emplacement d’origine de la commande.

​
Répartir la responsabilité des données produit

Lorsque Bonx alimente le catalogue Shopify, Bonx reste le système de référence pour les données produit (la master data). Les noms, les références, la structure des variantes et les prix sont gérés dans Bonx, puis poussés vers Shopify. Les visuels ont une fonction marketing liée à la présentation de la boutique. Ils sont donc gérés dans Shopify, au plus près du canal de vente, puis importés dans Bonx.
Données produit : Bonx → Shopify. Visuels produit : Shopify → Bonx. Bonx reste maître de la master data produit ; Shopify reste maître des médias marketing.

​
Ce qui est géré dans chaque outil

Bonx ne crée, ne remplace, ne supprime et ne réordonne aucun média Shopify. Un visuel ajouté directement dans Bonx n’est donc pas exporté vers Shopify. Dans Shopify, vous gérez séparément :
  • la galerie partagée du produit ;
  • les images, les vidéos et les modèles 3D ;
  • l’ordre des médias ;
  • le média principal du produit ;
  • l’image associée à chaque variante.
Lors de l’import suivant, Bonx récupère les images du produit depuis Shopify. La première image de la galerie devient le visuel principal dans Bonx. Pour une variante, l’image qui lui est associée dans Shopify est utilisée en priorité ; à défaut, Bonx utilise la première image de la galerie du produit. Les vidéos et les modèles 3D restent gérés dans Shopify.

​
Ajouter les médias d’un produit

1

Synchroniser l'article

Créez ou mettez à jour le produit Shopify depuis Bonx.
2

Ouvrir le produit dans Shopify

Dans l’interface d’administration Shopify, ouvrez le produit synchronisé.
3

Ajouter et organiser les médias

Ajoutez les médias dans la section Médias, puis faites-les glisser dans l’ordre souhaité. Consultez la documentation Shopify pour connaître les formats pris en charge.
4

Associer les images aux variantes

Pour un produit avec des variantes, choisissez dans Shopify l’image à afficher pour chaque variante.
5

Importer les images dans Bonx

Lors de la synchronisation suivante, Bonx importe les images Shopify et met à jour le visuel principal des articles concernés.

​
Choisir le média principal

Le premier média de la galerie Shopify est le média principal du produit. C’est le visuel utilisé par défaut dans les listes de produits et les collections. Le thème de la boutique peut appliquer un autre comportement, par exemple afficher une deuxième image au survol ou l’image de la variante sélectionnée. Ces règles se configurent dans Shopify ou dans le thème.

​
Modifier une galerie existante

Vous pouvez ajouter, supprimer ou réordonner les médias directement dans Shopify. Un export ultérieur des données produit depuis Bonx conserve ces modifications. La synchronisation suivante importe les images dans Bonx et tient compte de l’image principale et des associations aux variantes définies dans Shopify.
Si le produit est supprimé dans Shopify puis recréé depuis Bonx, Shopify crée une nouvelle fiche avec une galerie vide. Les médias de la fiche supprimée ne sont pas restaurés par Bonx.