# 库存同步分组中的同步事件

本指南介绍什么是 **Sync Events**，以及它们如何自动保持您的 **Inventory Sync Groups** 为最新状态。

## ℹ️  什么是 Sync Events？

**Sync Event** 是指在 Shopify 中更改库存的操作，它会触发 Tipo 更新同一库存同步分组中的其他商品。

简单来说：

> **库存发生变化 → Tipo 检测到变化 → Tipo 同步分组。**

***

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

每当下列任一事件发生时，Tipo 都会创建一个 **Sync Event**，并更新相关 **Inventory Sync Group** 内商品的库存。\
以下是可触发同步的主要事件：

### 🧩 1) 分组被创建或更新

每当分组被创建或更新时，应用都会根据该分组中的配置自动同步库存。&#x20;

**触发时机**

**a) 分组创建/编辑：** 您创建新分组，或更新分组设置/变体

**b) 批量更新：** 您使用批量编辑器更新多个分组

**c) 导入：** 您通过 CSV 导入分组

**会发生什么**

Tipo 会根据新设置重新计算分组库存，然后更新所有关联项目。

**示例：**\
您创建了一个分组，将红色 T 恤和蓝色 T 恤关联起来，因为它们共享同一库存。\
点击 **Save** 后，Tipo Sync 会触发“分组已创建/更新”同步事件并重新计算分组库存。\
例如，如果库存为 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> 联系我们。我们很乐意为您提供进一步协助。
