# Déclencheurs de synchronisation entre produit principal et produits composants

Ce guide explique quelles actions déclenchent la synchronisation dans les groupes de bundles, et ce que l’application Tipo met à jour entre le produit principal (bundle) et ses produits composants.

## ✅ Que sont les « déclencheurs de synchronisation » ?

Un **déclencheur de synchronisation** est un événement qui modifie le stock dans Shopify et amène Tipo Sync à recalculer le bundle.

En termes simples :

> **Quelque chose modifie le stock → Tipo le détecte → met à jour le produit principal et/ou les composants**

***

## 🧩 Fonctionnement de la synchronisation&#x20;

### 1. Synchronisation du produit principal → produits composants

Lorsqu’une modification survient sur le **produit principal**, le système met à jour les **produits composants** en conséquence.

Cela garantit que lorsqu’un **produit principal** est vendu, ses **composants** sont également déduits.

#### 1.1. Commande créée

Lorsqu’une commande inclut un produit principal, la quantité correspondante de chaque produit composant est soustraite.

**Exemple :**\
Si un bundle principal « Coffret cadeau » comprend :

* 1 Bougie
* 1 Savon

Lorsqu’un client commande **2 Coffrets cadeau**, le système déduit automatiquement **2 Bougies** et **2 Savons** du stock.

#### **1.2. Remboursement / annulation de commande**

Si une commande contenant un produit principal est remboursée ou annulée, et que l’option **Réapprovisionner (Restock)** est activée, les quantités des composants sont rétablies en conséquence.

**Exemple :**\
Si 1 « Coffret cadeau » a été remboursé avec le réapprovisionnement activé, les quantités de Bougie et de Savon augmentent chacune de 1.

#### **1.3. Changement d’emplacement de commande**

Si l’emplacement d’une commande est modifié, le système met à jour le stock à l’ancien et au nouvel emplacement afin de garantir la cohérence.

**Exemple :**\
Si une commande passe de l’Entrepôt A à l’Entrepôt B, le stock des composants dans l’Entrepôt A augmente et celui de l’Entrepôt B diminue.

#### **1.4. Modification de commande**

Si la commande contenant des produits principaux est modifiée :

* **Ajout de nouveaux produits :** les quantités des composants sont ajustées en conséquence.
* **Mise à jour des quantités de produits :** les quantités des composants sont recalculées selon la nouvelle quantité commandée.

**Exemple :**\
Si la commande comptait initialement 1 Coffret cadeau et passe à 2, le stock des composants est réduit de 1 supplémentaire pour chacun.

***

### **2. Synchronisation des composants → produit principal**

Ce sens s’applique lorsque vous activez le paramètre **« Synchroniser les composants vers le produit principal (Sync Component to Master) »**.\
Il garantit que lorsque les quantités des composants changent, la quantité du produit principal associé est automatiquement mise à jour.

#### **2.1. Lors de la création ou de la mise à jour d’un bundle**

Lorsque vous créez ou modifiez un groupe de bundles, le stock du produit principal est recalculé à partir du stock disponible de tous les composants.

**Exemple :**\
Si « Coffret cadeau » = 1 Bougie + 1 Savon

* Bougie = 10 unités
* Savon = 20 unités\
  → Stock du produit principal « Coffret cadeau » = 10 (selon la quantité de composant la plus basse).

#### **2.2. Lors du clic sur « Mettre à jour le stock principal (Update Master Inventory) »**

Vous pouvez actualiser manuellement le stock du produit principal à tout moment en cliquant sur ce bouton dans l’application.\
Cela recalcule la quantité disponible du produit principal à partir des quantités actuelles des composants.

<figure><img src="/media/663a702e186e0a0b780d.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

#### **2.3. Commande créée**

Si une commande inclut des produits composants (au lieu du produit principal), le système recalcule la quantité disponible du produit principal.

**Exemple :**\
Si un client achète 1 Bougie (un composant de « Coffret cadeau »), la quantité disponible de « Coffret cadeau » diminue aussi, car l’un de ses composants est désormais plus bas.

#### **2.4. Remboursement / annulation de commande**

Lorsqu’une commande contenant des composants est remboursée ou annulée avec le réapprovisionnement activé, la quantité du produit principal augmente en conséquence.

#### **2.5. Changement d’emplacement de commande**

Lorsque l’emplacement de commande des produits composants est modifié, le système ajuste le stock du produit principal pour refléter les changements aux nouveaux et anciens emplacements.

#### **2.6. Modification de commande**

Si la commande est modifiée (par ex. changement de quantité ou ajout/suppression d’un composant), le stock du produit principal est recalculé en conséquence.

***

### Événements non synchronisés

#### 1. Modifications manuelles du stock

Si vous modifiez manuellement le stock d’un produit directement dans votre Shopify Admin, l’application ne synchronisera pas automatiquement cette modification vers les autres produits associés.\
**Raison :**&#x20;

* Les modifications manuelles effectuées en dehors de l’application (par ex. ajuster le stock dans Shopify → **Produits (Products)** → Modifier l’inventaire) ne sont pas enregistrées comme des événements de synchronisation.
* L’application ne suit que les modifications effectuées via les commandes, les remboursements ou les actions de l’application.

**Exemple :**\
Vous augmentez manuellement le stock de « Bougie » (un composant de « Coffret cadeau ») de 10 → 20 dans Shopify.\
→ L’application ne mettra pas automatiquement à jour la quantité de « Coffret cadeau ».\
Pour actualiser le stock du produit principal après des modifications manuelles, allez dans l’application et cliquez sur **« Mettre à jour le stock principal »**.

#### 2. Mises à jour par des applications tierces

Si une autre application (comme une application d’exécution, d’entrepôt ou de gestion des stocks) modifie la quantité d’un produit, cela ne déclenchera pas de synchronisation dans l’application Tipo.

**Raison** :&#x20;

* L’application Tipo ne synchronise le stock que lorsqu’elle détecte des événements Shopify spécifiques (comme la création, le remboursement ou la modification d’une commande).\
  \- Les applications tierces peuvent mettre à jour le stock via l’API ou des scripts personnalisés que Shopify ne classe pas comme des événements de stock standard.

**Exemple :**\
Vous utilisez une application de gestion d’entrepôt qui diminue automatiquement le stock de « Savon » lorsqu’il est emballé pour l’expédition.\
→ Tipo Sync ne détectera pas cette modification et n’ajustera pas le stock du produit principal « Coffret cadeau ».\
Dans ce cas, vous pouvez actualiser manuellement la synchronisation en cliquant sur **« Mettre à jour le stock principal »** ou en enregistrant à nouveau le groupe de bundles.

#### 3. Commandes brouillon (Draft Orders)

Lorsque vous créez des commandes brouillon dans Shopify, le stock n’est pas réduit tant que la commande n’est pas finalisée ou payée.\
Par conséquent, l’application ne déclenche pas de synchronisation du stock pour les commandes brouillon.

**Raison :**

* Shopify considère les commandes brouillon comme « non finalisées », ce qui signifie que le stock reste inchangé.
* Synchroniser à ce stade pourrait entraîner des niveaux de stock inexacts.

**Exemple :**\
Vous créez une commande brouillon pour 2 Coffrets cadeau mais ne l’avez pas encore marquée comme payée.\
→ Tipo ne met pas à jour le stock des composants (« Bougie » et « Savon ») tant que la commande brouillon n’est pas devenue une commande confirmée.\
Une fois la commande brouillon payée ou convertie, la synchronisation s’exécutera normalement.

**🙋 Besoin d’aide ?**

Si vous avez encore besoin d’aide, n’hésitez pas à nous écrire à <hi@tipo.io>. Nous serons ravis de vous accompagner.
