# 문제 해결: Inventory Sync Groups

그룹 재고가 올바르지 않게 보이거나 예상대로 업데이트되지 않을 때 이 페이지를 참고하세요.

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

* 페이지를 새로고침하고 1~2분 기다려 보세요 (일부 업데이트는 즉시 반영되지 않습니다).
* 상품/variants가 같은 Inventory Sync Group에 있는지 확인하세요.
* **Smart Scan**을 사용하는 경우 SKU 형식이 올바르고 일관된지 확인하세요.

***

### 1) 재고가 업데이트되지 않는 경우

#### 증상

Shopify에서 재고가 변경되었지만 그룹에 속한 다른 상품이 업데이트되지 않습니다.

#### 가장 흔한 원인

* 하나 이상의 variants에서 재고 추적이 꺼져 있습니다.
* 사용하지 않는 위치(또는 의도한 위치가 아닌 곳)에서 재고가 업데이트되었습니다.
* 상품이 실제로 그룹화되어 있지 않습니다 (잘못된 variants를 선택함).
* 변경 사항이 아직 처리되지 않았습니다.

#### 해결 방법

1. Shopify **Products**를 열고 > 상품을 열어 > **Inventory** 섹션을 확인합니다
2. 그룹에 속한 variants에 대해 **Track quantity**가 활성화되어 있는지 확인합니다
3. 올바른 위치에서 재고를 업데이트했는지 확인합니다
4. **Tipo app > Inventory Sync Groups**로 이동하여 variants가 포함되어 있는지 확인합니다
5. 작은 테스트 변경(예: +1 조정)을 한 후 다시 확인합니다

***

### 2) 그룹화 후 수량이 잘못된 경우

#### 증상

그룹을 만든 후 재고 수치가 예상보다 높거나 낮게 보입니다.

#### 발생 원인

* 그룹이 생성될 때 앱은 그룹에 대해 **하나의 “공유 수량”**이 필요합니다.
* 그룹화 전에 variants의 재고가 서로 달랐다면 스토어 설정 방식에 따라 결과가 “잘못된” 것처럼 보일 수 있습니다.

#### 해결 방법

1. 올바른 공유 재고가 얼마인지 결정합니다 (예: “총 100개가 있음”)
2. **한** variant의 재고를 올바른 값으로 업데이트합니다
3. 그룹 동기화가 같은 수치를 다른 variants에 적용하도록 합니다
4. 모든 variants가 같은 재고를 표시하는지 다시 확인합니다

***

### 3) Smart Scan(SKU 기준 자동 그룹화)이 상품을 감지하지 못하는 경우

#### 증상

Smart Scan이 그룹을 만들지 않거나 예상한 상품을 놓칩니다.

#### 가장 흔한 원인

* 일부 variants의 SKU가 비어 있습니다
* SKU가 정확히 일치하지 않습니다 (공백, 소문자/대문자, 추가 문자)
* SKU가 모두 고유합니다 (중복이 없으면 그룹화할 항목이 없음)
* 일부 variants만 SKU를 공유합니다

#### 해결 방법

1. 상품 CSV를 내보내거나(또는 상품을 열어) SKU 값을 확인합니다
2. SKU 형식을 일관되게 맞춥니다 (예: `TSHIRT-RED-M`)
3. **Smart Scan**을 다시 실행합니다
4. SKU가 일치하도록 설계되지 않았다면 대신 [**Manual group creation**](/inventory-sync-groups/inventory-sync-groups/create-a-inventory-sync-group-manually)을 사용하세요&#x20;

***

### 4) 그룹 충돌 (상품/variant가 여러 그룹에 나타나는 경우)

#### 증상

variant가 이미 그룹화되어 다시 추가할 수 없거나 동기화가 일관되지 않게 동작합니다.

#### 발생 원인

재고 업데이트 충돌을 방지하려면 하나의 variant는 **하나의** Inventory Sync Group에만 속해야 합니다.

#### 해결 방법

1. **Inventory Sync Groups**에서 해당 상품/variant를 찾습니다
2. 현재 어떤 그룹에 포함되어 있는지 확인합니다
3. 이전 그룹에서 제거합니다 (또는 이전 그룹을 삭제합니다)
4. 올바른 그룹에 추가합니다
5. 저장한 후 재고를 다시 확인합니다

***

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

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