# Sync events in Inventory Sync Groups

本指南說明什麼是 **Sync Events**，以及它們如何讓您的 **Inventory Sync Groups** 自動保持更新。

## ℹ️  什麼是 Sync Events？

**Sync Event** 是指會改變 Shopify 庫存的動作，並會觸發 Tipo 更新同一個 Inventory Sync Group 內的其他商品。

簡單來說：

> **庫存有變動 → Tipo 偵測到 → Tipo 同步群組。**

***

## 🔄 同步如何發生（Sync events）

每當發生下列其中一種事件時，Tipo 就會建立一個 **Sync Event**，並更新相關 **Inventory Sync Group** 內商品的庫存。\
以下是可觸發同步的主要事件：

### 🧩 1) 群組建立或更新

每當建立或更新群組時，應用程式會依該群組中的設定自動同步庫存。&#x20;

**觸發時機**

**a) 群組建立／編輯：** 您建立新群組，或更新群組設定／款式

**b) 批次更新：** 您使用批次編輯器更新多個群組

**c) 匯入：** 您透過 CSV 匯入群組

**會發生什麼事**

Tipo 會依據新的設定重新計算群組庫存，然後更新所有連動的項目。

**範例：**\
您建立了一個群組，將紅色 T 恤與藍色 T 恤連動，因為它們共用相同的庫存。\
點選 **Save** 後，Tipo Sync 會觸發「群組建立／更新」的 sync event，並重新計算群組庫存。\
例如，若庫存為 100 件，Tipo Sync 會設定：

* 紅色 T 恤 = 100
* 藍色 T 恤 = 100

***

### 🛒 2) 訂單建立

**觸發時機**

當顧客對同步群組中的商品下訂單時，就會發生此事件。

**會發生什麼事**

Shopify 扣減庫存 → Tipo 更新群組中的其他項目，以維持庫存一致。

**範例：**

您的群組連動了紅色 T 恤與藍色 T 恤，兩者都顯示 100 件。\
顧客購買了 3 件藍色 T 恤。\
Tipo Sync 偵測到庫存變動，並更新群組：

* 藍色 T 恤 = 97
* 紅色 T 恤 = 97

### &#x20;↩️ 3) 訂單退款或取消

**觸發時機**

當訂單被退款／取消，且庫存退回（依 Shopify 設定而定）時，就會發生此事件。

**會發生什麼事**

Shopify 的庫存增加 → Tipo 將新的數量同步到群組中的其他項目。

**注意**：只有在 Shopify 中勾選「Restock」的項目，才會同步回可售庫存。

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

**範例：**<br>

銷售之後，兩件襯衫都顯示 **97 件**。\
您退款了 **2** 件商品，並將庫存退回。\
Tipo Sync 會同步群組：

* 紅色 T 恤 = 99
* 藍色 T 恤 = 99

***

### 📍4)  訂單地點變更

**觸發時機**

當訂單項目的出貨／庫存地點變更時（適用於使用多個地點的商店），就會發生此事件。

**會發生什麼事**

Tipo 會依據更新後的地點重新計算庫存，並據此更新群組中的項目。

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

**範例：**\
一筆銷售原本從 **Warehouse A** 扣庫存，之後訂單地點改為 **Warehouse B**。\
Tipo 應用程式會依據新地點重新計算庫存，並使用該地點的可售庫存更新群組中的項目。

***

### ✏️ 5) 訂單編輯

**觸發時機**

當訂單建立後，訂單中的明細項目被更改時，就會發生此事件。&#x20;

包括：

**a. 新增商品：** 新加入的商品會被同步，並扣減其庫存。

**b. 更新數量：** 應用程式會調整庫存，以反映訂單中更新後的商品數量。

**會發生什麼事**

Shopify 再次調整庫存 → Tipo 將更新後的庫存套用到整個群組。

**範例：**\
顧客原本訂購 **1** 件，之後您將訂單編輯為 **3** 件。\
Shopify 再次調整庫存，Tipo Sync 會更新群組，讓所有連動項目符合新的庫存水準。

***

### 摘要

| 事件類型                    | 觸發條件                                             | 執行動作                                                        | 範例                                                    |
| ----------------------------- | --------------------------------------------------- | ------------------------------------------------------------------- | ---------------------------------------------------------- |
| **群組建立／更新**   | 群組被建立、編輯、批次更新或匯入    | 重新計算並同步群組內所有款式的庫存      | 您連動紅色與藍色 T 恤 → 兩者都更新為相同庫存 |
| **訂單建立**             | 下了新訂單                                    | 在所有連動款式中扣除訂購數量                 | 賣出 1 件紅色 → 1 件藍色也被扣除                          |
| **訂單退款／取消** | 退款或取消，且勾選「Restock items」 | 將商品數量補回群組庫存                              | 退款 1 件紅色 → 1 件藍色也被補回庫存                     |
| **訂單地點變更**    | 訂單移至另一個出貨地點         | 調整新舊地點的庫存                         | 從 Warehouse A 移至 B → 庫存已調整                 |
| **訂單編輯**              | 訂單被修改                                      | 新增商品或變更數量時更新庫存 | 多加 1 件紅色 → 1 件藍色也被扣減                     |

**🙋 還需要協助嗎？**

如果您仍需要協助，歡迎隨時寄信至 <hi@tipo.io> 與我們聯繫，我們很樂意為您提供進一步的協助。
