# CSV 파일로 가져오기

CSV 가져오기를 사용하면 스프레드시트 파일로 Shopify 스토어의 상품(및 재고)을 빠르게 만들거나 업데이트할 수 있습니다.

## ✅ 시작하기 전에(요구 사항)

#### 📌 CSV 파일 준비하기

CSV에 다음이 포함되어 있는지 확인하세요.

* 첫 번째 행의 **열 머리글**(예: `Handle`, `Title`, `Vendor`)
* 레코드를 일치시키는 데 사용할 수 있는 **고유 키**(권장: **Handle**)
* 올바른 형식(CSV 파일)

#### 🔑 권장 기본 키

* **Product Handle** (대부분의 가져오기에 가장 적합)
* 데이터에 따라 다른 키가 표시될 수도 있습니다(예: Product ID, Variant SKU)

***

## 🛠️ 파일 업로드 단계&#x20;

### Tipo 앱에서 CSV Uploads 열기

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

1. Shopify Admin에서 **Apps → Tipo Sync**를 엽니다
2. **CSV uploads**를 클릭합니다
3. **Add csv file**을 클릭합니다

가져오기 마법사(**1/3 progress**)로 이동합니다.

***

### 📤 1/3단계 — CSV 업로드&#x20;

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

#### **업로드 소스 선택**

다음에서 CSV를 업로드할 수 있습니다.

* **CSV Import** (컴퓨터에서 파일 업로드)
* Import from Web Link (URL)
* FTP Server Upload
* SFTP Server Upload

#### **CSV 옵션 선택**

**Separator**

* Comma (가장 일반적)
* Semicolon
* Other

**CSV Data**

* **Product** (제목, 설명, 공급업체 등 상품 필드용)
* **Inventory** (재고 수량용)

그런 다음 **Next Step**을 클릭합니다.

<figure><span class="missing-media" role="note">이 스크린샷은 원본 문서에서 제공되지 않습니다.</span><figcaption></figcaption></figure>

***

### 🧩 2/3단계 — 필드 매핑&#x20;

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

**A) Primary Key 매핑**

앱이 CSV의 행을 Shopify의 상품과 어떻게 일치시킬지 알려 줍니다.

* **Primary Key**: Shopify 스토어에서 일치시킬 기준을 선택합니다\
  예시: **Product Handle**
* **Column heading**: CSV에서 사용할 열을 선택합니다\
  예시: **Handle**

> Primary Key가 일치하지 않으면 앱이 중복 항목을 만들거나 올바른 상품을 업데이트하지 못할 수 있습니다.

**B) CSV 열을 Shopify 필드에 매핑하기**

다음과 같은 탭이 표시됩니다.

* **Product**
* **Variant**
* **Image**
* **Metafield**
* **Inventory**

각 행에 대해:

* **Import to Shopify** = Shopify 필드(예: Title)
* **Column heading** = CSV 열(예: Title)

**➕ Add mapping**을 클릭하여 더 많은 필드를 가져올 수 있습니다.

그런 다음 **Next Step**을 클릭합니다.

***

### ⚙️ 3/3단계 — 가져오기 설정&#x20;

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

#### **3.1단계. Matching & Imports (Shopify 업데이트 방식)**

하나를 선택하세요.

✅ **Create new items**

* 새 상품만 만듭니다(기존 상품은 업데이트하지 않음)

✅ **Only update current items that have the same primary key**

* 기존 상품만 업데이트합니다
* 새 상품은 만들지 **않습니다**

✅ **Create new items if not exist and update current items that have the same primary key** *(일반적인 선택)*

* 없는 상품은 만듭니다
* 일치하는(Handle/SKU 등) 기존 상품은 업데이트합니다

***

#### **3.2단계. Upload specification (가져올 양)**

* **Import All**: 파일의 모든 항목을 가져옵니다
* **Specify import**: 선택한 행 범위만 가져옵니다(테스트할 때 유용)

***

#### **3.3단계. Filter data (선택 사항)**

* **Only import data containing …** (포함 규칙)
* **Exclude data containing …** (제외 규칙)

특정 행만 가져오고 싶을 때 사용하세요(예: `SYNC`가 포함된 행만).

***

#### **3.4단계. Image data (CSV에 이미지가 포함된 경우)**

하나를 선택하세요.

* **Add new images** (기존 이미지를 삭제하지 않고 이미지를 추가)
* **Upon creation product only** (새 상품에만 이미지를 추가)
* **Overwrite current images** (기존 이미지를 교체)

***

#### **3.5단계. Email notifications (선택 사항)**

이메일을 받을 시점을 선택하세요.

* On upload start
* On upload completion
* On upload error

***

#### **3.6단계. Schedule upload**&#x20;

* **Run now** (즉시 가져오기)\
  (플랜/설정에 따라 다른 일정 옵션이 표시될 수 있습니다.)

마지막으로 (오른쪽 상단의) **Save**를 클릭합니다.

***

## 🧪 예시: 기존 상품 업데이트 + 새 상품 만들기

**CSV 샘플**

| Handle | Title | Vendor |
| --- | --- | --- |
| ceramic-table-lamp | Ceramic Table Lamp | ModernHome |
| wooden-floor-mirror | Wooden Floor Mirror | ModernHome |

**선택할 설정**

* **Primary Key**: Product Handle
* **Column heading**: Handle
* **Matching & Imports**: Create new items if not exist and update current items that have the same primary key

**결과**

* `ceramic-table-lamp`가 이미 있으면 → 업데이트됩니다
* `wooden-floor-mirror`가 없으면 → 새로 만들어집니다

***

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

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