> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bonx.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Shopify
> Synchronisez commandes, articles et stock avec votre boutique Shopify.
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.
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](/fr/integrations/authentication-methods).
## 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`).
| Fonctionnalité | Autorisations |
| - | - |
| Import des produits, clients, commandes et retours | `read_products`, `read_customers`, `read_orders`, `read_returns` |
| Rattachement des emplacements Shopify aux sites Bonx | `read_assigned_fulfillment_orders` ou `read_merchant_managed_fulfillment_orders` |
| Export des articles | `write_products` |
| Canaux de vente (liste et publication) | `read_publications`, `write_publications` |
| Export des expéditions | `write_fulfillments`, `write_merchant_managed_fulfillment_orders` ou `write_assigned_fulfillment_orders` |
## Données synchronisées
| Donnée | Sens | Création | Mise à jour |
| - | - | - | - |
| Articles et variantes | Shopify ↔ Bonx | ✅ | ✅ |
| Images des produits | Shopify → Bonx | ✅ | ✅ |
| Commandes | Shopify → Bonx | ✅ | ✅ |
| Retours | Shopify → Bonx | ✅ | ✅ |
| Clients et contacts | Shopify → Bonx | ✅ | ✅ |
| Adresses | Shopify → Bonx | ✅ | ✅ |
| Stock disponible | Bonx → Shopify | — | ✅ (option) |
## 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
Créez ou mettez à jour le produit Shopify depuis Bonx.
Dans l'interface d'administration Shopify, ouvrez le produit synchronisé.
Ajoutez les médias dans la section **Médias**, puis faites-les glisser dans l'ordre souhaité. Consultez la
[documentation Shopify](https://help.shopify.com/fr/manual/products/product-media/add-media) pour connaître les
formats pris en charge.
Pour un produit avec des variantes, choisissez dans Shopify l'image à afficher pour chaque variante.
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.