# 문제 해결: 번들 그룹

### ✅ 시작하기 전에(빠른 체크리스트)

먼저 다음을 확인하세요

* 번들이 **Bundle Group**으로 설정되어 있습니다(Master + Components 저장됨)
* 상품 제목만이 아니라 올바른 옵션 조합을 선택했습니다
* Shopify에서 모든 구성품 옵션 조합에 **Track quantity**가 활성화되어 있습니다
* 구성품 수량이 올바릅니다(×1, ×2, ×3…)
* 올바른 Shopify 위치를 확인하고 있습니다(여러 위치를 사용하는 경우)

***

### 🛠 사례 1: 번들 그룹을 만들 수 없음

번들 또는 재고 동기화 그룹을 만들 수 없다면 필요한 모든 정보가 올바르게 설정되어 있는지 확인하세요.

**체크리스트:**

* 그룹에는 옵션 조합이 최소 2개 포함되어야 합니다.

**예시**:&#x20;

상품 옵션 조합이 하나뿐인 번들(예: "T-shirt Blue – Small"만 있는 경우)은 만들 수 없습니다. 최소 두 개(예: "T-shirt Blue – Small"과 "T-shirt Blue – Large")가 필요합니다.

그룹에는 활성 위치가 하나 이상 있어야 하며, 해당 위치의 재고가 비어 있으면 안 됩니다.

**예시***:*&#x20;

"Main Warehouse" 위치에 재고 수량이 입력되어 있지 않으면 시스템이 그룹의 초기 재고를 계산할 수 없습니다.

각 옵션 조합은 하나의 그룹에만 속할 수 있습니다.

***

### 🛠  **사례 2: 스캔, 가져오기, 내보내기 또는 보고서가 작동하지 않음**

스캔, 가져오기, 내보내기 또는 보고서 기능이 시작되지 않거나 멈춘 것 같은 경우:

| 한 번에 하나의 작업만 실행할 수 있습니다. | 현재 백그라운드 프로세스가 끝날 때까지 기다린 후 새 작업을 시작하세요. | 이미 큰 CSV 파일을 가져오는 중이라면 "Scan"을 동시에 실행해도 가져오기가 끝날 때까지 실패합니다. |
| --- | --- | --- |
| 이러한 작업은 백그라운드에서 실행됩니다. | 작업이 완료되면 이메일 알림을 받게 됩니다. | "Export Inventory Groups"를 실행한 후 받은편지함을 확인하세요. 준비되면 시스템이 다운로드 링크를 보내 드립니다. |
| 이메일을 받지 못하셨나요? | <p>1. 앱의 <strong>Settings</strong> 탭에서 이메일 주소가 올바른지 확인하세요.<br> 2. <strong>스팸</strong> 또는 <strong>프로모션</strong> 폴더를 확인하세요. 일부 이메일 서비스는 작업 알림을 필터링합니다.</p> | 내보내기 보고서 이메일이 보이지 않으면 스팸 폴더를 확인하거나 Settings에서 주소를 확인하세요. |

***

### 🛠 사례 3: 예상치 못한 재고 변경

Master와 구성품 상품 사이에서 재고 수량이 예상치 못하게 변경되었다면 대개 동기화 이벤트가 트리거되었기 때문입니다.

앱의 **History** 탭을 열어 어떤 이벤트가 변경을 일으켰는지 확인해 보세요.\
**예시***:* "Master Product A"가 포함된 주문이 생성되어 "Bundle A"의 재고가 감소한 것을 확인할 수 있습니다.

**참고:**\
기록은 **2개월** 후 자동으로 삭제되므로 오래된 변경 사항은 더 이상 표시되지 않습니다.

동기화 루프나 예상치 못한 조정이 의심된다면 최근 주문이나 재고 수량을 수정했을 수 있는 타사 앱을 통해 이루어진 편집을 검토해 보세요.

***

### 🛠  사례 4: 번들(Master) 재고가 0인데 구성품에는 재고가 있음

#### 발생 원인

**발생 원인(가장 흔한 경우)**

* 추적 중인 위치에서 구성품이 품절된 경우
* 구성품 수량이 잘못 설정된 경우(예: ×2여야 하는 경우)
* 구성품 옵션 조합의 재고 추적이 비활성화된 경우

**해결 방법**

1. Bundle Group을 열고 각 **구성품 옵션 조합**을 확인합니다
2. Shopify에서 구성품 재고를 확인하고 **Track quantity**가 활성화되어 있는지 확인합니다
3. 번들당 필요한 수량이 올바른지 확인합니다
4. **Update Master Inventory**를 실행하여 다시 계산합니다

✅ 예시: 번들에 **Product A 2개**가 필요하면 Product A의 재고가 번들 수량을 제한합니다.

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

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