# マスター商品と構成商品間の同期トリガー

このガイドでは、バンドルグループで同期を引き起こす操作と、Tipoアプリがマスター（バンドル）商品と構成商品の間で何を更新するかを説明します。

## ✅ 「同期トリガー」とは？

**同期トリガー**とは、Shopifyの在庫を変化させ、Tipo Syncにバンドルの再計算を実行させるイベントのことです。

簡単に言うと：

> **何かが在庫を変える → Tipoが検知する → マスター商品や構成商品を更新する**

***

## 🧩 同期の仕組み

### 1. マスター → 構成商品への同期

**マスター**商品に変更が生じると、システムはそれに応じて**構成商品**商品を更新します。

これにより、**マスター**が売れたときに、その**構成商品**も差し引かれます。

#### 1.1. 注文の作成

注文にマスター商品が含まれている場合、対応する数量の各構成商品が差し引かれます。

**例：**\
マスターバンドル「ギフトボックス」に次のものが含まれているとします。

* キャンドル1個
* 石鹸1個

お客様が**ギフトボックスを2つ**注文すると、システムは在庫から**キャンドル2個**と**石鹸2個**を自動的に差し引きます。

#### **1.2. 注文の返金／キャンセル**

マスター商品を含む注文が返金またはキャンセルされ、**在庫を戻す（Restock）**オプションが有効な場合、構成商品の数量はそれに応じて元に戻ります。

**例：**\
「在庫を戻す」を有効にして「ギフトボックス」1つが返金された場合、キャンドルと石鹸の数量がそれぞれ1ずつ増えます。

#### **1.3. 注文のロケーション変更**

注文のロケーションが変更されると、整合性を保つため、システムは変更前と変更後の両方のロケーションの在庫を更新します。

**例：**\
注文が倉庫Aから倉庫Bに移動した場合、倉庫Aの構成商品在庫は増え、倉庫Bの在庫は減ります。

#### **1.4. 注文の編集**

マスター商品を含む注文が編集された場合：

* **新しい商品を追加：** 構成商品の数量がそれに応じて調整されます。
* **商品の数量を更新：** 新しい注文数量に基づいて構成商品の数量が再計算されます。

**例：**\
最初の注文でギフトボックスが1つで、それが2つに更新された場合、構成商品の在庫はそれぞれさらに1ずつ減ります。

***

### **2. 構成商品 → マスターへの同期**

この方向の同期は、**「構成商品からマスターへ同期（Sync Component to Master）」**設定を有効にした場合に適用されます。\
構成商品の数量が変わると、関連するマスターの数量が自動的に更新されるようになります。

#### **2.1. バンドルの作成または更新時**

バンドルグループを作成または編集すると、すべての構成商品の販売可能な在庫に基づいてマスターの在庫が再計算されます。

**例：**\
「ギフトボックス」= キャンドル1個 + 石鹸1個 の場合

* キャンドル = 10個
* 石鹸 = 20個\
  → マスター「ギフトボックス」の在庫 = 10（最も少ない構成商品の数量に基づく）。

#### **2.2. 「マスター在庫を更新（Update Master Inventory）」をクリックしたとき**

アプリでこのボタンをクリックすると、いつでも手動でマスターの在庫を更新できます。\
現在の構成商品の数量からマスターの販売可能数が再計算されます。

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

#### **2.3. 注文の作成**

注文に（マスターではなく）構成商品が含まれている場合、システムはマスターの販売可能数を再計算します。

**例：**\
お客様がキャンドル（「ギフトボックス」の構成商品）を1つ購入すると、構成商品の1つが減るため、「ギフトボックス」の販売可能数も減ります。

#### **2.4. 注文の返金／キャンセル**

構成商品を含む注文が「在庫を戻す」を有効にして返金またはキャンセルされると、マスターの数量はそれに応じて増えます。

#### **2.5. 注文のロケーション変更**

構成商品の注文ロケーションが変更されると、システムは変更前後のロケーションの変化を反映するようにマスターの在庫を調整します。

#### **2.6. 注文の編集**

注文が編集された場合（数量の変更、構成商品の追加・削除など）、マスターの在庫はそれに応じて再計算されます。

***

### 同期されないイベント

#### 1. 手動での在庫編集

Shopify管理画面で商品の在庫を直接手動で変更した場合、アプリはこの変更を関連する他の商品に自動的には同期しません。\
**理由：**

* アプリの外で行われた手動編集（例：Shopify → **商品（Products）** → 在庫の編集で在庫を調整する）は、同期イベントとして記録されません。
* アプリが追跡するのは、注文、返金、アプリの操作による変更のみです。

**例：**\
Shopifyで「キャンドル」（「ギフトボックス」の構成商品）の在庫を手動で10 → 20に増やしたとします。\
→ アプリは「ギフトボックス」の数量を自動的には更新しません。\
手動編集の後にマスターの在庫を更新するには、アプリを開いて**「マスター在庫を更新」**をクリックしてください。

#### 2. サードパーティアプリによる更新

別のアプリ（フルフィルメント、倉庫、在庫管理アプリなど）が商品の数量を変更しても、Tipoアプリの同期は実行されません。

**理由**：

* Tipoアプリは、Shopifyの特定のイベント（注文の作成、返金、編集など）を検知したときにのみ在庫を同期します。\
  \- サードパーティアプリは、APIやカスタムスクリプトで在庫を更新することがあり、Shopifyはこれを標準の在庫イベントとして分類しません。

**例：**\
出荷用に梱包されると「石鹸」の在庫を自動的に減らす倉庫管理アプリを使用しているとします。\
→ Tipo Syncはこの変更を検知せず、マスター「ギフトボックス」の在庫を調整しません。\
この場合は、**「マスター在庫を更新」**をクリックするか、バンドルグループを再保存することで、手動で同期を更新できます。

#### 3. 下書き注文

Shopifyで下書き注文を作成しても、注文が実際に完了または支払い済みになるまで在庫は減りません。\
そのため、アプリは下書き注文に対して在庫同期を実行しません。

**理由：**

* Shopifyは下書き注文を「未確定」として扱うため、在庫は変わりません。
* この段階で同期すると、在庫数が不正確になる可能性があります。

**例：**\
ギフトボックス2つの下書き注文を作成したものの、まだ支払い済みにしていないとします。\
→ 下書き注文が確定した注文になるまで、Tipoは構成商品（「キャンドル」と「石鹸」）の在庫を更新しません。\
下書き注文が支払い済みになるか変換されると、同期は通常どおり実行されます。

**🙋 サポートが必要ですか？**

解決しない場合は、<hi@tipo.io>までお気軽にご連絡ください。引き続きサポートいたします。
