# Master 상품과 구성품 간 동기화 트리거

이 가이드에서는 번들 그룹에서 어떤 작업이 동기화를 트리거하는지, 그리고 Tipo 앱이 Master(번들) 상품과 구성품 사이에서 무엇을 업데이트하는지 설명합니다.

## ✅ "동기화 트리거"란?

**동기화 트리거**는 Shopify의 재고를 변경하여 Tipo Sync가 번들을 다시 계산하게 만드는 이벤트입니다.

간단히 말하면:

> **재고가 변경됨 → Tipo가 감지 → Master 및/또는 구성품 업데이트**

***

## 🧩 동기화가 작동하는 방식&#x20;

### 1.Master → 구성품 동기화

**Master** 상품에 변경이 발생하면 시스템이 그에 맞춰 **Component** 상품을 업데이트합니다.

이를 통해 **Master**가 판매될 때 **Components**도 함께 차감됩니다.

#### 1.1. 주문 생성

주문에 Master 상품이 포함되면 각 구성품의 해당 수량이 차감됩니다.

**예시:**\
Master 번들 "Gift Box"에 다음이 포함되어 있다면:

* Candle 1개
* Soap 1개

고객이 **Gift Box 2개**를 주문하면 시스템이 재고에서 **Candle 2개**와 **Soap 2개**를 자동으로 차감합니다.

#### **1.2. 주문 환불 / 주문 취소**

Master 상품이 포함된 주문이 환불 또는 취소되고 **Restock** 옵션이 활성화되어 있으면 구성품 수량이 그에 맞춰 복구됩니다.

**예시:**\
재입고를 활성화한 상태로 "Gift Box" 1개가 환불되면 Candle과 Soap의 수량이 각각 1씩 증가합니다.

#### **1.3. 주문 위치 변경**

주문의 위치가 변경되면 시스템이 일관성을 유지하기 위해 이전 위치와 새 위치의 재고를 모두 업데이트합니다.

**예시:**\
주문이 Warehouse A에서 Warehouse B로 이동하면 Warehouse A의 구성품 재고는 증가하고 Warehouse B의 재고는 감소합니다.

#### **1.4. 주문 편집**

Master 상품이 포함된 주문이 편집되는 경우:

* **새 상품 추가:** 구성품 수량이 그에 맞춰 조정됩니다.
* **상품 수량 변경:** 새 주문 수량을 기준으로 구성품 수량이 다시 계산됩니다.

**예시:**\
주문에 원래 Gift Box가 1개였다가 2개로 변경되면 구성품 재고가 각각 1개씩 더 감소합니다.

***

### **2. 구성품 → Master 상품 동기화**

이 방향은 **"Sync Component to Master"** 설정을 활성화한 경우에 적용됩니다.\
구성품 수량이 변경되면 관련된 Master의 수량이 자동으로 업데이트되도록 보장합니다.

#### **2.1. 번들을 만들거나 업데이트할 때**

번들 그룹을 만들거나 편집하면 모든 구성품의 사용 가능한 재고를 기준으로 Master의 재고가 다시 계산됩니다.

**예시:**\
"Gift Box" = Candle 1개 + Soap 1개인 경우

* Candle = 10개
* Soap = 20개\
  → Master "Gift Box" 재고 = 10 (가장 적은 구성품 수량 기준).

#### **2.2. "Update Master Inventory"를 클릭할 때**

앱에서 이 버튼을 클릭하면 언제든지 Master의 재고를 수동으로 새로고침할 수 있습니다.\
현재 구성품 수량을 기준으로 Master의 구매 가능 수량을 다시 계산합니다.

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

#### **2.3. 주문 생성**

주문에 (Master 대신) 구성품이 포함되면 시스템이 Master의 구매 가능 수량을 다시 계산합니다.

**예시:**\
고객이 Candle 1개("Gift Box"의 구성품)를 구매하면 구성품 중 하나의 수량이 줄어들었으므로 "Gift Box"의 구매 가능 수량도 감소합니다.

#### **2.4. 주문 환불 / 주문 취소**

구성품이 포함된 주문이 재입고가 활성화된 상태로 환불 또는 취소되면 Master 수량이 그에 맞춰 증가합니다.

#### **2.5. 주문 위치 변경**

구성품 상품의 주문 위치가 변경되면 시스템이 새 위치와 이전 위치의 변경 사항을 반영하도록 Master의 재고를 조정합니다.

#### **2.6. 주문 편집**

주문이 편집되면(예: 수량 변경 또는 구성품 추가/제거) Master의 재고가 그에 맞춰 다시 계산됩니다.

***

### 동기화되지 않는 이벤트

#### 1.수동 재고 편집

Shopify 관리자에서 상품의 재고를 직접 수동으로 변경하면 앱은 이 변경 사항을 관련된 다른 상품에 자동으로 동기화하지 않습니다.\
**이유:**&#x20;

* 앱 외부에서 이루어진 수동 편집(예: Shopify → **Products** → Edit inventory에서 재고 조정)은 동기화 이벤트로 기록되지 않습니다.
* 앱은 주문, 환불 또는 앱 작업을 통해 이루어진 변경 사항만 추적합니다.

**예시:**\
Shopify에서 "Candle"("Gift Box"의 구성품)의 재고를 10 → 20으로 수동으로 늘립니다.\
→ 앱은 "Gift Box" 수량을 자동으로 업데이트하지 않습니다.\
수동 편집 후 Master 재고를 새로고침하려면 앱으로 이동하여 **"Update Master Inventory"**를 클릭하세요.

#### 2.타사 앱의 업데이트

다른 앱(예: 풀필먼트, 창고 또는 재고 관리 앱)이 상품 수량을 변경해도 Tipo 앱에서 동기화가 트리거되지 않습니다.

**이유**:&#x20;

* Tipo 앱은 Shopify의 특정 이벤트(주문 생성, 환불, 편집 등)를 감지했을 때만 재고를 동기화합니다.\
  \- 타사 앱은 API나 맞춤 스크립트를 통해 재고를 업데이트할 수 있으며, Shopify는 이를 표준 재고 이벤트로 분류하지 않습니다.

**예시:**\
배송을 위해 포장될 때 "Soap"의 재고를 자동으로 줄이는 창고 관리 앱을 사용하고 있습니다.\
→ Tipo Sync는 이 변경을 감지하지 못하며 Master "Gift Box" 재고를 조정하지 않습니다.\
이 경우 **"Update Master Inventory"**를 클릭하거나 번들 그룹을 다시 저장하여 동기화를 수동으로 새로고침할 수 있습니다.

#### 3.임시 주문

Shopify에서 임시 주문을 만들면 주문이 실제로 완료되거나 결제될 때까지 재고가 차감되지 않습니다.\
따라서 앱은 임시 주문에 대해 재고 동기화를 트리거하지 않습니다.

**이유:**

* Shopify는 임시 주문을 "확정되지 않은 주문"으로 취급하므로 재고가 변경되지 않습니다.
* 이 단계에서 동기화하면 재고 수준이 부정확해질 수 있습니다.

**예시:**\
Gift Box 2개에 대한 임시 주문을 만들었지만 아직 결제 완료로 표시하지 않았습니다.\
→ 임시 주문이 확정된 주문이 될 때까지 Tipo는 구성품("Candle"과 "Soap")의 재고를 업데이트하지 않습니다.\
임시 주문이 결제되거나 전환되면 동기화가 정상적으로 실행됩니다.

**🙋 아직 도움이 필요하신가요?**

여전히 도움이 필요하시면 언제든지 <hi@tipo.io>로 문의해 주세요. 기꺼이 도와드리겠습니다.
