> ## Documentation Index
> Fetch the complete documentation index at: https://guide.beenos-solutions.com/llms.txt
> Use this file to discover all available pages before exploring further.

# BuyeePartners CSVでの商品登録方法

> BuyeePartnersでCSVファイルを使って商品情報を一括登録する方法と、各カラムの入力ルールを解説します。

# BuyeePartners CSVでの商品登録方法

BuyeePartnersでは、**商品情報登録用のCSVファイルを管理画面からアップロードすることで、商品情報を一括登録できます。**

以下よりサンプルファイルをダウンロードしてご利用ください。

## 使用するCSVファイル

商品登録に使用するファイル名は、**`items_v2`** です。

### サンプルファイル

[Shift-JIS形式のサンプルCSVをダウンロード](https://marketing.beecruise.co.jp/hubfs/BP_CSV%E5%95%86%E5%93%81%E7%99%BB%E9%8C%B2%E7%94%A8/sample.csv_Shift-JIS.zip)

[UTF-8形式のサンプルCSVをダウンロード](https://marketing.beecruise.co.jp/hubfs/BP_CSV%E5%95%86%E5%93%81%E7%99%BB%E9%8C%B2%E7%94%A8/sample.csv_UTF-8.zip)

<Warning>
  PCで閲覧しやすいようShift-JIS形式のサンプルも用意されていますが、**商品登録に使用するCSVファイルは必ずUTF-8形式で作成してください。**
</Warning>

<Warning>
  ファイル名の\*\*「items\_v2」は変更しないでください。\*\*

  やむを得ず変更する場合は、`items_v2.000.csv` のように、`v2.` の後ろへ文字列を追加してください。
</Warning>

## 商品削除・在庫数登録に使用するCSV

サンプルCSVには、商品登録以外に商品削除や在庫数登録で使用するファイルも含まれています。

用途ごとに以下のファイルを使用してください。

| 用途 | ファイル名 |
| - | - |
| 商品登録 | `items_v2` |
| 商品削除 | `deleted_items_v2` |
| 在庫数登録（任意） | `item_quantities_v2` |

***

## CSVのカラム一覧

### code

**必須：〇**

商品コードを入力します。

* 半角英数字、ハイフン、アンダーバーのみ使用可能
* 99文字以内
* 大文字は小文字に変換されます
* ECサイトの商品コードと合わせておくと判別しやすくなります

***

### shop-code

**必須：※モール型のみ**

モール型ストアで使用するショップ識別コードです。

登録済みのショップコードを指定してください。

ショップコードについては以下をご確認ください。

[ショップ設定について](https://marketing.beecruise.co.jp/knowledge/buyeepartners1)

***

### name

**必須：〇**

日本語の商品名を入力します。

* 200文字以内

***

### name@言語コード

外国語の商品名を登録する場合に使用します。

追加したい言語分だけ列を追加してください。

例：

```text theme={null}
name@en
```

使用可能な言語コードは以下です。

| 言語 | 言語コード |
| - | - |
| 英語 | `en` |
| 繁体字 | `cht` |
| 簡体字 | `chs` |

* 200文字以内
* 外国語の商品名が登録されていない場合、サイトの言語を切り替えても日本語の商品名が表示されます

***

### variations

商品のバリエーションを登録します。

* バリエーション項目数：2個まで
* 選択肢：100個まで
* SKUの組み合わせ：400個まで

#### 色のみの場合

```text theme={null}
色:赤=red&色:青=blue
```

#### 色とサイズを設定する場合

例として、赤・青のカラーにS・Mサイズを設定する場合は以下のように入力します。

```text theme={null}
色:赤#サイズ:S=red-s&赤#サイズ:M=red-m&色:青#サイズ:S=blue-s&色:青#サイズ:M=blue-m
```

***

### price

**必須：〇**

通常価格を入力します。

* 連携するECサイトと同じ**税込価格**を入力してください

***

### description

日本語の商品説明文を入力します。

* 5,000文字以内

以下のHTMLタグを使用できます。

```html theme={null}
<b>
<bdo>
<blockquote>
<br>
<caption>
<col>
<colgroup>
<dd>
<div>
<dl>
<dt>
<em>
<hr>
<h4>
<h5>
<h6>
<i>
<li>
<ol>
<p>
<q>
<s>
<small>
<span>
<sub>
<sup>
<table>
<tbody>
<td>
<tfoot>
<th>
<thead>
<tr>
<u>
<ul>
```

***

### description@言語コード

外国語の商品説明文を登録する場合に使用します。

追加したい言語分だけ列を追加してください。

例：

```text theme={null}
description@en
```

使用可能な言語コードは以下です。

| 言語 | 言語コード |
| - | - |
| 英語 | `en` |
| 繁体字 | `cht` |
| 簡体字 | `chs` |

***

### meta-keywords

現在は使用していないため、入力不要です。

***

### meta-keywords@言語コード

現在は使用していないため、入力不要です。

***

### meta-description

現在は使用していないため、入力不要です。

***

### meta-description@言語コード

現在は使用していないため、入力不要です。

***

### visible

商品の公開状態を設定します。

| 値 | 状態 |
| - | - |
| `0` | 非表示 |
| `1` | 表示 |

デフォルトは `1` です。

***

### sale-price

セール価格を入力します。

* 連携するECサイトと同じ**税込価格**を入力してください

***

### sale-period-start

セール開始時刻を入力します。

入力形式：

```text theme={null}
YYYYMMDD[HH[MM]]
```

***

### sale-period-end

セール終了時刻を入力します。

入力形式：

```text theme={null}
YYYYMMDD[HH[MM]]
```

***

### buyable-quantities-at-once

一度に購入できる個数の上限を入力します。

<Note>
  空欄の場合は、上限500個として扱われます。
</Note>

***

### product-code

製造番号・型番を入力します。

* 50文字以内

***

### jan

JANコードを入力します。

* 数値のみ
* 13文字以内

***

### item-origin-url

**必須：〇**

貴社ECサイト上の同一商品の商品詳細ページURLを入力します。

* 半角英数字記号のみ
* 1,000文字以内

***

### category-codes

**必須：〇**

カテゴリコードを入力します。

複数のカテゴリを指定する場合は、**半角スペース区切り**で入力してください。

カテゴリ一覧は以下からダウンロードできます。

[カテゴリ一覧をダウンロード](https://marketing.beecruise.co.jp/hubfs/BP_CSV%E5%95%86%E5%93%81%E7%99%BB%E9%8C%B2%E7%94%A8/category_2018.11.zip)

入力例：

```text theme={null}
a10000 b10000
```

***

### sales-area-whitelist

販売を許可する国・地域を指定します。

国コードは以下の一覧をご確認ください。

[国コード一覧を見る](https://marketing.beecruise.co.jp/hubfs/%E3%83%8A%E3%83%AC%E3%83%83%E3%82%B8%E7%94%A8/%E5%9B%BD%E3%82%B3%E3%83%BC%E3%83%89%E3%83%AA%E3%82%B9%E3%83%88.pdf)

複数指定する場合は、**半角スペース区切り**で入力します。

日本とアメリカを指定する場合の例：

```text theme={null}
JP US
```

***

### sales-area-blacklist

販売を許可しない国・地域を指定します。

<Warning>
  `sales-area-whitelist` と `sales-area-blacklist` は併用できません。
</Warning>

***

### main-image-url

商品のメイン画像URLを入力します。

* 半角英数字記号のみ
* インターネット上で公開されている商品画像URLを入力してください

<Note>
  貴社ECサイト側で画像を変更した場合は、BuyeePartners側でも再度画像URLを変更して連携する必要があります。
</Note>

***

### sub-image-url-1 ～ 29

商品サブ画像のURLを入力します。

6枚目以降の画像を登録する場合は、必要な列を追加してください。

***

### copyright

日本語のコピーライトを入力します。

* 1,000文字以内

***

### copyright@言語コード

外国語のコピーライトを入力する場合に使用します。

追加したい言語分だけ列を追加してください。

例：

```text theme={null}
copyright@en
```

使用可能な言語コードは以下です。

| 言語 | 言語コード |
| - | - |
| 英語 | `en` |
| 繁体字 | `cht` |
| 簡体字 | `chs` |

* 1,000文字以内

***

### buyableperiod-start

商品の販売開始日時を入力します。

入力形式：

```text theme={null}
YYYYMMDD[HH[MM]]
```

***

### buyableperiod-end

商品の販売終了日時を入力します。

入力形式：

```text theme={null}
YYYYMMDD[HH[MM]]
```

***

### used

新品・中古の状態を設定します。

| 値 | 商品状態 |
| - | - |
| `0` | 新品 |
| `1` | 中古 |

未入力の場合は新品として扱われます。

***

### shipping-time

**予約商品など、購入から発送まで1か月以上かかる商品では入力が必要です。**

発送時期を指定してください。

2017年6月頃に発送する場合の入力例：

```text theme={null}
201706
```

<Warning>
  予約商品など、商品購入から発送まで1か月以上かかる場合は必ず入力してください。
</Warning>

***

### tags

パートナータグ・ブランドタグを入力します。

両方を併用できます。

複数指定する場合は、**半角スペース区切り**で入力してください。

タグは管理画面内の、

**「ブランドタグ」＞「タグ一覧」**

から確認できます。

入力例：

```text theme={null}
brand.XXXX partner.YYYY
```

***

## CSV作成時の主な注意点

商品登録用CSVを作成する際は、特に以下をご確認ください。

* CSVファイルは必ずUTF-8形式にする
* 商品登録ファイル名は`items_v2`を使用する
* 必須項目を入力する
* 商品価格は税込価格を登録する
* ECサイトの商品コードとBuyeePartnersの商品コードを揃える
* 商品詳細ページURLを正しく設定する
* カテゴリコードを設定する
* 予約商品など発送まで1か月以上かかる場合は`shipping-time`を入力する
* 販売可能国と販売不可国は同時に設定しない
* 商品画像を変更した場合は画像URLも更新する

CSVファイルの作成が完了したら、BuyeePartnersの管理画面からアップロードして商品情報を登録してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.