Sync triggers between Master and Component Products
In Tipo Sync, the inventory of a Master Product and its component products are automatically synchronized whenever a relevant event occurs. This ensures that bundle stock and component stock always match accurately across your Shopify store.
There are two sync directions, depending on your configuration.
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.
Last updated