Sync triggers between Master and Component Products

This guide explains what actions trigger syncing in Bundle Groups, and what Tipo app updates between the Master (bundle) product and its Component products.

✅ What are “sync triggers”?

A sync trigger is an event that changes inventory in Shopify and causes Tipo Sync to recalculate the bundle.

In simple terms:

Something changes stock → Tipo detects it → updates Master and/or Components

---

🧩 How syncing works

1.Sync from Master → Component Products

When a change happens to the Master product, the system will update the Component products accordingly.

This ensures that when a Master is sold, its Components are also deducted.

1.1. Order Created

When an order includes a Master product, the corresponding quantity of each Component product is subtracted.

Example: If a Master bundle “Gift Box” includes:

• 1 Candle

• 1 Soap

When a customer orders 2 Gift Boxes, the system will automatically deduct 2 Candles and 2 Soaps from inventory.

1.2. Order Refund / Order Cancel

If an order containing a Master product is refunded or canceled, and the Restock option is enabled, the quantities of the Components are restored accordingly.

Example: If 1 “Gift Box” was refunded with restock enabled, both the Candle and Soap quantities increase by 1.

1.3. Order change Location

If the location of an order is changed, the system updates inventory at both the old and new locations to ensure consistency.

Example: If an order moves from Warehouse A to Warehouse B, the Component inventory in Warehouse A is increased, and the inventory in Warehouse B is decreased.

1.4. Order Edit

If the order containing Master products is edited:

• Add new products: Component quantities are adjusted accordingly.

• Update product quantities: The Component quantities are recalculated based on the new order quantity.

Example: If the order originally had 1 Gift Box and is updated to 2, the Components’ inventory will be reduced by 1 more each.

---

2. Sync from Component → Master Products

This direction applies when you enable the “Sync Component to Master” setting. It ensures that when Component quantities change, the related Master’s quantity is automatically updated.

2.1. When Creating or Updating a Bundle

When you create or edit a Bundle Group, the Master’s inventory is recalculated based on the available stock of all Components.

Example: If “Gift Box” = 1 Candle + 1 Soap

• Candle = 10 units

• Soap = 20 units → Master “Gift Box” inventory = 10 (based on the lowest Component quantity).

2.2. When clicking “Update Master Inventory”

You can manually refresh the Master’s inventory at any time by clicking this button in the app. This recalculates the Master’s available quantity from the current Component quantities.

2.3. Order created

If an order includes Component products (instead of the Master), the system recalculates the Master’s available quantity.

Example: If a customer buys 1 Candle (a Component of “Gift Box”), the available “Gift Box” quantity will also decrease since one of its Components is now lower.

2.4. Order refund / Order cancel

When an order containing Components is refunded or canceled with restock enabled, the Master quantity increases accordingly.

2.5. Order change Location

When the order location of Component products is changed, the system adjusts the Master’s inventory to reflect changes in the new and old locations.

2.6. Order edit

If the order is edited (e.g., changing quantity or adding/removing a Component), the Master’s inventory is recalculated accordingly.

---

Unsynced Events

1.Manual Inventory Edits

If you manually change the inventory of a product directly in your Shopify admin, the app will not automatically sync this change to other related products. Reason:

• Manual edits made outside the app (e.g., adjusting stock in Shopify → Products → Edit inventory) are not recorded as sync events.

• The app only tracks changes made through orders, refunds, or app actions.

Example: You manually increase the inventory of “Candle” (a Component of “Gift Box”) from 10 → 20 in Shopify. → The app will not automatically update the “Gift Box” quantity. To refresh the Master inventory after manual edits, go to the app and click “Update Master Inventory”.

2.Updates from third apps

If another app (such as a fulfillment, warehouse, or inventory management app) changes the product quantity, this will not trigger sync in the Tipo app.

Reason:

• The Tipo app only syncs inventory when it detects specific Shopify events (like order creation, refund, or edit). - 3rd-party apps may update inventory via API or custom scripts that Shopify does not classify as standard inventory events.

Example: You’re using a warehouse management app that automatically decreases the stock of “Soap” when it’s packed for shipment. → Tipo Sync will not detect this change and won’t adjust the Master “Gift Box” inventory. In this case, you can manually refresh the sync by clicking “Update Master Inventory” or re-saving the bundle group.

3.Draft Orders

When you create draft orders in Shopify, inventory is not reduced until the order is actually completed or paid. Therefore, the app does not trigger inventory sync for draft orders.

Reason:

• Shopify treats draft orders as “not finalized,” meaning the inventory remains unchanged.

• Syncing at this stage could cause inaccurate stock levels.

Example: You create a draft order for 2 Gift Boxes but haven’t marked it as paid yet. → Tipo does not update inventory for the Components (“Candle” and “Soap”) until the draft order becomes a confirmed order. Once the draft order is paid or converted, the sync will run normally.

🙋 Still need support?

If you still need help, please feel free to contact us at [e-mail]. We’ll be happy to assist you further.