# CSVファイルでインポートする

CSVインポートを使うと、スプレッドシートファイルからShopifyストアの商品（と在庫）をすばやく作成・更新できます。

## ✅ 始める前に（要件）

#### 📌 CSVファイルを準備する

CSVに次の内容が含まれていることをご確認ください。

* 1行目に**列見出し**（例: `Handle`、`Title`、`Vendor`）
* レコードを照合するための**固有のキー**（おすすめ: **ハンドル（Handle）**）
* 正しい形式（CSVファイル）

#### 🔑 推奨のプライマリキー

* **商品ハンドル（Product Handle）**（ほとんどのインポートに最適です）
* データによっては、他のキーが表示される場合もあります（例: 商品ID、バリエーションSKU）

***

## 🛠️ ファイルをアップロードする手順

### TipoアプリでCSVアップロードを開く

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

1. Shopify管理画面で、**アプリ（Apps） → Tipo Sync**を開きます
2. **CSVアップロード（CSV uploads）**をクリックします
3. **CSVファイルを追加（Add csv file）**をクリックします

インポートウィザード（**進捗 1/3**）が表示されます。

***

### 📤 ステップ1/3 — CSVをアップロードする

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

#### **アップロード元を選択する**

CSVは次の方法でアップロードできます。

* **CSVインポート（CSV Import）**（お使いのコンピューターからファイルをアップロード）
* **Webリンクからインポート（Import from Web Link）**（URL）
* **FTPサーバーアップロード（FTP Server Upload）**
* **SFTPサーバーアップロード（SFTP Server Upload）**

#### **CSVオプションを選択する**

**区切り文字（Separator）**

* カンマ（最も一般的）
* セミコロン
* その他

**CSVデータ（CSV Data）**

* **商品（Product）**（タイトル、説明、ベンダーなどの商品フィールド用）
* **在庫（Inventory）**（在庫数用）

その後、**次のステップ（Next Step）**をクリックします。

<figure><span class="missing-media" role="note">This screenshot is unavailable in the original documentation.</span><figcaption></figcaption></figure>

***

### 🧩 ステップ2/3 — フィールドをマッピングする

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

**A) プライマリキーのマッピング**

CSVの行をShopifyの商品とどのように照合するかをアプリに指定します。

* **プライマリキー（Primary Key）**: Shopifyストアが照合に使う項目を選択します\
  例: **商品ハンドル**
* **列見出し（Column heading）**: CSV内の列を選択します\
  例: **Handle**

> プライマリキーが一致しない場合、アプリが重複を作成したり、正しい商品を更新できなかったりする可能性があります。

**B) CSVの列をShopifyのフィールドにマッピングする**

次のようなタブが表示されます。

* **商品**
* **バリエーション（Variant）**
* **画像（Image）**
* **メタフィールド（Metafield）**
* **在庫**

各行について:

* **Shopifyにインポート（Import to Shopify）** = Shopifyのフィールド（例: タイトル）
* **列見出し** = CSVの列（例: Title）

**➕ マッピングを追加（Add mapping）**をクリックすると、さらに多くのフィールドをインポートできます。

その後、**次のステップ（Next Step）**をクリックします。

***

### ⚙️ ステップ3/3 — インポート設定

<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）（任意）**

メールを受け取るタイミングを選択します。

* アップロード開始時
* アップロード完了時
* アップロードエラー時

***

#### **ステップ3.6. アップロードのスケジュール（Schedule upload）**

* **今すぐ実行（Run now）**（すぐにインポートします）\
  （プランや設定によっては、他のスケジュールオプションが表示される場合があります。）

最後に、右上の**保存（Save）**をクリックします。

***

## 🧪 例: 既存の商品を更新し、新しい商品を作成する

**CSVのサンプル**

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

**選択する設定**

* **プライマリキー**: 商品ハンドル
* **列見出し**: Handle
* **照合とインポート**: 存在しない場合は新規作成し、同じプライマリキーを持つ既存アイテムを更新

**結果**

* `ceramic-table-lamp`がすでに存在する場合 → 更新されます
* `wooden-floor-mirror`が存在しない場合 → 作成されます

***

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

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