設定画面：商品管理 / 商品一覧 / CSV一括処理 / バリエーション一括登録・修正
商品のバリエーションを、CSVファイルで一括登録・更新する方法をご案内します。
1. はじめに
バリエーションの一括登録・更新は、「ダウンロード」→「CSVの編集」→「アップロード」の流れで行います。
旧管理画面の「オプション一括登録」「オプション一括修正」は、この1つの機能に統合されています。
1-1. やりたいこと別のフォーマット
ダウンロード時に選ぶ「フォーマット」で、CSVに出力される項目が決まります。
やりたいことに合わせて、次の既定のフォーマットをお選びください。
| やりたいこと | 使うフォーマット | 新規追加 |
|---|---|---|
| バリエーションを新規追加する（登録済みのものは更新） | バリエーション登録・修正用 | できる |
| 旧「オプション一括登録」と同じ形式（項目名・並び順）で登録・更新する | 旧オプション一括登録（全項目・旧項目名） | できる |
| 登録済みバリエーションの価格・在庫・独自コード・JANコードを更新する | 旧オプション一括修正（全項目・新項目名） | できない（更新のみ） |
| 在庫数だけを更新する | 旧オプション一括修正（数量のみ・新項目名） | できない（更新のみ） |
| バリエーションの項目名を変更する | バリエーション項目名修正用 | できない（更新のみ） |
| 新規追加するには、アップロード時に「未登録のバリエーションを新規追加する」をオンにしてください（4-1参照）。 出力する項目や並び順を自分で決めたい場合は、「5. フォーマット管理」でショップ独自のフォーマットを登録できます。 |
2. ダウンロード
2-1. ダウンロードの手順
- CSV一括処理の画面で、「バリエーション一括登録・修正」カードの「ダウンロード」をクリックします。
- 「フォーマット」を選びます（1-1参照）。
ショップで登録したフォーマットも選べます。 - 必要に応じて「カテゴリ」を選びます。
未選択の場合は全商品が対象です。 - 「文字コード」をShift-JIS / UTF-8 から選びます。
- 「ダウンロード」ボタンをクリックします。
件数が多い場合などは「ダウンロードを受け付けました。」と表示されます。「ダウンロードページへ」から「ダウンロード一覧」に移動し、処理の完了後にファイルを取得してください。
2-2. 注意事項
- カテゴリを選択したままだと、一部の商品だけが出力されます。全件が必要な場合はカテゴリが未選択かご確認ください。
- 対象データが0件の場合も、1行目（項目名）だけのCSVが出力されます。記入用のひな形としてご利用いただけます。
- フォーマットのプルダウンの下に「※このフォーマットで出力したCSVはアップロードには使用できません」などの警告が出た場合は、5-3をご覧ください。
- 「ダウンロード一覧」のファイルは、最終更新から5日を過ぎると削除されます。
3. CSVの編集
ダウンロードしたCSVを編集します。
変更したい値だけを書き換え、それ以外のセル（特に項目名やコード）は編集せずにお使いください。
3-1. 項目一覧
CSVの各行がどのバリエーションを指すかは、1行目の列で自動的に決まります（アップロード画面の設定では切り替わりません）。
- 商品IDで指定：
1行目に「商品ID」または「バリエーション１ID」の列がある場合です。商品ID・バリエーション１ID・バリエーション２IDで特定します。登録済みのバリエーションの更新のみで、新規追加はできません。 - 商品コードで指定：
上記の列がない場合です。システム商品コードまたは独自商品コードと、バリエーション１項目・バリエーション２項目（またはバリエーション独自コード）で特定します。新規追加もできます。
かっこ内は旧管理画面での項目名です。旧名称のままでも読み取ります。
文字数は、全角・半角の区別なく1文字として数えます。
| 項目名 | 入力ルール | 説明 |
|---|---|---|
| 商品特定コード指定 | 0 または 1 | 商品をどのコードで特定するかを行ごとに指定します。 0＝システム商品コード / 1＝独自商品コード（1の行は独自商品コードが必須） 旧管理画面との互換用の列のため、省略できます。省略した場合は、「システム商品コード」の列があればシステム商品コード、「独自商品コード」の列だけならば独自商品コードで特定します。 |
| バリエーション特定コード指定 （オプション特定コード指定） |
0 または 1 | バリエーションをどのように特定するかを行ごとに指定します。 0＝項目名で探し、見つからなければバリエーション独自コードで探す（バリエーション独自コード必須） / 1＝項目名で探す 0の行で独自コードで見つかった場合、項目名が書かれていれば、そのバリエーションの項目名をCSVの値に変更します。 旧管理画面との互換用の列のため、省略できます。 ※商品特定コード指定とは、独自コードを使うときの値（0と1）が逆です。 |
| 商品ID | 半角数字 | 商品IDで指定する場合に、商品の特定に使います。 |
| システム商品コード | 半角数字12文字以内 | 商品コードで指定する場合に、商品の特定に使います。12桁より短い場合は先頭を0で埋めて扱います。 「商品特定コード指定」の列がなく「独自商品コード」の列も一緒にある場合は、システム商品コードで特定し、独自商品コードは読み取られません。 |
| 独自商品コード | 50文字以内 | 商品コードで指定する場合に、商品の特定に使います。 |
| バリエーション１ID / バリエーション２ID （オプション１ID / オプション２ID） |
半角数字64文字以内 | 商品IDで指定する場合に、バリエーションの特定に使います。バリエーション2がある商品では、バリエーション２IDも必要です。 |
| バリエーション１項目 / バリエーション２項目 （オプション１項目 / オプション２項目） |
64文字以内 | 商品コードで指定する場合：バリエーションの特定に使います。書き換えても項目名は変わらず、書き換えた項目名のバリエーションが更新（未登録なら新規追加）されます。 商品IDで指定する場合：項目名の変更になります（3-3参照）。NULLは指定できません。 |
| バリエーション独自コード （オプション独自コード） |
100文字以内 | バリエーション独自コードを登録・更新します。 「バリエーション１項目」の列がないCSVでは、バリエーションの特定に使います（登録済みのバリエーションのみ。新規追加はされません）。 |
| 販売価格 | 半角数字9文字以内（符号・カンマ不可） | バリエーションの販売価格です。 |
| 数量 | 半角数字9文字以内 | 在庫数です。「0」で品切れ、「NULL」で在庫無制限になります。 「+10」「-5」のように入力すると、現在の在庫数から増減できます（結果は0〜999,999,999の範囲）。 ※CSVエディタによっては「+」「-」の符号が外れる場合がありますのでご注意ください。 |
| JANコード | 13文字以内 | JANコードです。13文字以内であれば、数字以外も入力できます（商品編集画面と同じ）。 |
| ASIN | 半角英数字10文字以内 | Amazon上の掲載商品と紐づけるためのASINです。Amazon連携の契約があるショップのみ。 |
| Amazon出品者SKU | 半角英数字・ハイフン・アンダースコア40文字以内 | Amazon上で掲載商品と出品情報を紐づけるためのSKUです。Amazon連携の契約があるショップのみ。 |
| Amazon出品価格 | 半角数字9文字以内 | Amazon上での出品価格です。税込（軽減税率適用可）で入力してください。Amazon連携の契約があるショップのみ。 |
| 属性:（属性名） | － | 商品属性の値です。商品に設定されている商品属性グループに含まれない属性に値を入力すると、その行はエラーになります。 |
| 商品名 / 基本カテゴリーパス / ネームラベル | － | 参考情報です。アップロードしても更新されません。 ただし「商品名」は、255文字を超えるとエラーになります。 |
| printio商品では「数量」とAmazon連携の項目（ASIN / Amazon出品者SKU / Amazon出品価格）を更新できません。値を変更するとその行がエラーになります。 printio商品を更新する場合は、5-2の「printioで更新できない項目を非表示」ボタンで作成したフォーマットをご利用ください。 |
3-2. 空欄と「NULL」の扱い
| 書き方 | 意味 |
|---|---|
| 空欄 | その項目は変更しません。 |
| NULL | 値を消去します。「数量」の場合は在庫無制限になります。 |
| 値あり | その値で上書きします。 |
| 「NULL」は半角大文字のみが対象です。「null」と小文字で入力すると、文字列の「null」として登録されます。 全角スペースは値の一部として扱われます。全角スペースだけのセルは空欄にならず（「数量」の場合は「数値ではありません。」のエラー）、項目名などに全角スペースが混ざると別の値として扱われますのでご注意ください。 |
3-3. バリエーションの項目名を変更する
項目名を変更するときは、「バリエーション項目名修正用」フォーマットでダウンロードしたCSVの「バリエーション１項目」「バリエーション２項目」を書き換えてアップロードします。
バリエーションの項目名は、組み合わせ（行）ごとではなく、バリエーション1・バリエーション2それぞれで登録されています。
そのため1行で項目名を変更すると、同じ項目名を使うほかの組み合わせもすべて変わります。
例：「S・青」の行のバリエーション１項目を「XS」に変更した場合
| 変更前 | 変更後 |
|---|---|
| S・青 | XS・青 |
| S・赤 | XS・赤（CSVで変更していなくても変わります） |
| S・白 | XS・白（CSVで変更していなくても変わります） |
| 同じバリエーション１ID（またはバリエーション２ID）の行に異なる項目名を入力した場合は、後の行の項目名で上書きされます。 例：「S・青」の行で「S」を「XS」に変更しても、同じIDの「S・赤」「S・白」の行が「S」のままだと、後の行の「S」で上書きされ、最終的に「S」に戻ります。 項目名を変更するときは、同じIDのすべての行を同じ項目名に書き換えてください。 このフォーマットには「販売価格」「数量」なども含まれます。 ダウンロードした値のままなら変更されませんが、書き換えた場合は一緒に更新されます。 |
3-4. CSV作成時の注意
- 1行目は項目名として必須です。2行目以降にデータを入力してください。
- 列の順番は自由です。必要な列だけのCSVでも取り込めます（例：行を特定する項目＋「数量」だけ）。
- 「バリエーション１項目」などの「１」「２」は全角で書きます。半角で書くと読み取られません。
- 値に「,（カンマ）」や改行を含める場合は、その値を「"（ダブルクォーテーション）」で囲んでください。
値に「"」自体を含める場合は、続けてもう1つ「"」を入力してください（例：「1"2」は「1""2」と指定）。
1行目より列が多い行は、列ずれを防ぐためエラーになります。1行目より列が少なく、取り込みに使う列の値が欠けている行もエラーになります。 - Excelで作成する場合は、「ファイル」→「名前を付けて保存」→「ファイルの種類」で「CSV（カンマ区切り）（*.csv）」を選択して保存してください。
文字コード（UTF-8 / Shift-JIS）はアップロード時に自動で判別します。
4. アップロード
4-1. アップロードの手順
| バリエーションを新規追加する場合は、あらかじめ「商品情報一括アップロード」で「バリエーション1名称」「バリエーション2名称」を登録しておく必要があります。 |
- 「未登録のバリエーションを新規追加する」を確認します（初期状態はオン）。
オン：CSVにあるバリエーションを更新し、未登録のものは新規追加します。
オフ：登録済みのバリエーションの更新だけを行います。
※商品IDで指定するCSV（3-1参照）を選ぶと、自動的にオフ（グレー表示）になります。 - 「完了お知らせメール」に、取り込み完了を知らせるメールアドレスを入力します。
不要な場合は空にできます。 - CSVファイルを選択します（ドラッグ＆ドロップ、またはファイル選択）。
- 自動で書式チェックが実行されます。
エラーがある行（「行」「項目名」「エラー内容」）と、取り込まれない列（「スキップされた項目」）が表示されます。
「CSVの読み取り方」に、商品の特定・バリエーションの特定に使う項目と、新規追加を行うかどうかが表示されますので、意図どおりか確認します。 - 「アップロード」ボタンをクリックします。
- 「アップロードが完了しました」の画面に切り替わります。
続けて別のファイルをアップロードする場合は「アップロードに戻る」をクリックします。
|
ファイルサイズは最大14MBです。超える場合はファイルを分割してください。10バイト未満のファイルは選択できません。 ▼エラー行がある場合 |
次の構成のCSVでは、ファイルを確認すると「未登録のバリエーションを新規追加する」が自動的に無効（グレー表示）になり、画面に理由と直し方が表示されます。
| CSVの構成 | 取り込みの結果 |
|---|---|
| 「商品ID」「バリエーション１ID」がある（商品IDで指定） | 登録済みのバリエーションの更新だけをおこないます |
| 「バリエーション１項目」の列がない（「バリエーション独自コード」だけで特定するなど） | 登録済みのバリエーションの更新だけをおこないます |
| 「商品ID」はあるが「バリエーション１ID」がない | 1行も取り込めません（すべての行が「バリエーション1の指定が不正です。」になります） |
| 「バリエーション１ID」「バリエーション１項目」「バリエーション独自コード」がどれもない | 1行も取り込めません（すべての行が「バリエーション1の指定が不正です。」になります） |
| 下の2つの構成は、「アップロード」ボタンを押せますが、実行するとすべての行がエラーになります。画面の案内に従ってフォーマットを作り直してから（5. フォーマット管理参照）、アップロードしてください。 |
4-2. 取り込み結果の確認
アップロードは順番に処理されます。処理の状況と結果は「CSV処理ジョブ管理」で確認します。
- アップロード完了画面の「CSV処理ジョブを確認」をクリックします。
あとから確認する場合は、CSV一括処理の画面の「CSV処理ジョブ管理」から開きます。 - 「アップロード一覧」で、ステータス（処理待ち / 処理中 / 完了 / 失敗 / キャンセル）・進捗・エラー件数を確認します。
処理種別は、新規追加を行う場合は「バリエーション登録・更新」、それ以外は「バリエーション更新」と表示されます。 - ジョブIDをクリックすると、成功件数・失敗件数と、エラーの「行数」「項目名」「エラー内容」を確認できます。
| エラーの行番号は、1行目（項目名の行）から数えます。最初のデータ行は2行目です。 旧管理画面（最初のデータ行が1行目）より1つ大きい番号になりますのでご注意ください。 |
4-3. 主なエラーメッセージ
CSVの書式に関するエラーはファイルを確認した時点で、商品・バリエーションが見つからないなどのエラーはアップロードを実行したあとに表示されます。
| メッセージ | 原因と対処 |
|---|---|
| 1行目から取込できる項目名が見つかりません。 | 1行目に「商品ID」「システム商品コード」「独自商品コード」のいずれもありません。ファイル全体が取り込めません |
| 1行目に「商品ID」がありません。 | 「バリエーション１ID」の列があるのに「商品ID」の列がありません。ファイル全体が取り込めません |
| 取り込むデータ行がありません。 | 2行目以降にデータがありません。ファイル全体が取り込めません |
| '属性:カラー'と'属性: カラー'は同じ属性を指しています。どちらか一方にしてください | 同じ商品属性を指す列が2つあります。どちらか一方の列を削除してください。すべての行が取り込めません |
| 「商品ID」と「バリエーション１ID」を入力してください。 | 商品IDで指定するCSVで、商品ID・バリエーション１IDが空の行です。バリエーション2がある商品は「バリエーション２ID」も必要です |
| 一致する商品データが存在しません。 | 指定した商品ID・システム商品コード・独自商品コードの商品が見つかりません |
| バリエーションが指定できない商品です。 | 「バリエーション1名称」が登録されていない商品です（4-1参照） |
| 対象のバリエーションが存在しません。 | 指定したバリエーションが登録されていません。商品IDで指定する場合、または「未登録のバリエーションを新規追加する」がオフの場合に発生します |
| バリエーション1の指定が不正です。／バリエーション2の指定が不正です。 | バリエーションを特定できません。バリエーション2がある商品で、バリエーション２ID・２項目が空の場合などに発生します |
| バリエーション独自コードが不正です。（既に別のコードが設定されています） | 「バリエーション特定コード指定」が0の行で、見つかったバリエーションに別の独自コードが登録されています |
| 変更後の在庫数が0以上になるよう「数量」を入力してください など | 「+10」「-5」などの増減指定で、在庫数が0〜999,999,999の範囲を超えます。在庫無制限のバリエーションや新規登録の行には、増減指定はできません |
| 1商品に登録できるバリエーションは30,000件までです。 | 1商品のバリエーションの組み合わせが30,000件を超えます |
| この商品の商品属性グループに含まれない属性です。 など | 商品に設定されていない商品属性の列に値（NULLを含む）を入力しています。空欄なら問題ありません |
| 「バリエーション１項目」にNULLは指定できません。 | 商品IDで指定するCSVで、項目名にNULLを入力しています（項目名は消去できません） |
| 項目数が一致しません。項目数を確認してください。 | 1行目より列が多い行です。カンマを含む値をダブルクォーテーションで囲んでいるか確認してください |
| 項目が見つかりません。ヘッダーと項目数の一致を確認してください | 1行目より列が少なく、取り込みに必要な列の値が欠けている行です |
| 同じ商品の取込中にエラーが発生したため、この行は保存されませんでした。 | 同じ商品の別の行でエラーが発生しました。原因の行を修正して、再度アップロードしてください |
| エラーで取り込めなかった行は、同じ行のほかの項目（販売価格・JANコードなど）も取り込まれません。 「一致する商品データが存在しません。」などのエラーでは、特定に使った項目と値がかっこ内に表示されます。 |
5. フォーマット管理
ダウンロード時の出力項目（どの項目を、どの順番で、どの項目名で出力するか）を、フォーマットとして登録できます。
CSV一括処理の画面で、「バリエーション一括登録・修正」カードの「フォーマット管理」をクリックすると、フォーマット一覧が開きます。
5-1. フォーマットの登録
- フォーマット一覧の右上「フォーマットを登録」をクリックします。
- 「フォーマット名」（必須）と「説明」を入力します。
- 「プリセットの反映」で既定のフォーマットを選び、「反映」をクリックします。
選んだフォーマットの項目構成が読み込まれます。既定のフォーマットの出力項目は下表のとおりです。 - 「出力項目」で、表示 / 非表示や並び順を調整します（5-2参照）。
- 「登録」をクリックします。
| 既定のフォーマット | 出力される項目（この順番で出力） |
|---|---|
| バリエーション登録・修正用 | 商品特定コード指定 / バリエーション特定コード指定 / システム商品コード / 独自商品コード / 商品名 / 基本カテゴリーパス / バリエーション独自コード / バリエーション１項目 / バリエーション２項目 / 販売価格 / 数量 / JANコード |
| 旧オプション一括登録（全項目・旧項目名） | 商品特定コード指定 / オプション特定コード指定 / システム商品コード / 独自商品コード / 商品名 / 基本カテゴリーパス / オプション独自コード / オプション１項目 / オプション２項目 / 販売価格 / 数量 / JANコード |
| 旧オプション一括修正（全項目・新項目名） | 商品特定コード指定 / ネームラベル / 商品ID / バリエーション１ID / バリエーション２ID / 販売価格 / 数量 / バリエーション独自コード / JANコード |
| 旧オプション一括修正（数量のみ・新項目名） | 商品特定コード指定 / ネームラベル / 商品ID / バリエーション１ID / バリエーション２ID / 数量 |
| バリエーション項目名修正用 | 商品特定コード指定 / ネームラベル / 商品ID / バリエーション１ID / バリエーション２ID / 販売価格 / 数量 / バリエーション独自コード / JANコード / バリエーション１項目 / バリエーション２項目 |
| 「バリエーション登録・修正用」「旧オプション一括登録（全項目・旧項目名）」では、Amazon連携の契約があるショップのみ、JANコードの後ろにASIN / Amazon出品者SKU / Amazon出品価格が出力されます。 既定のフォーマットでダウンロードしたCSVの「商品特定コード指定」「バリエーション特定コード指定」には、全行に同じ値が入ります。独自コードで特定したい場合は、行ごとに値を書き換えてください（3-1参照）。 登録できるフォーマットは20件までです。 |
5-2. 出力項目の設定
- 表示 / 非表示：
各項目の右端のスイッチで切り替えます。表示にした項目だけが出力されます。 - 並び順：
各項目の左端のドラッグアイコンで変更します。この順番がCSVの列の順番になります。 - 旧名称を使用する：
チェックを入れると、旧「オプション◯◯」の項目名で出力します。 - 商品属性：
ショップで定義した商品属性も、「属性:（属性名）」の項目名で出力できます。 - 「すべて表示」「すべて非表示」「printioで更新できない項目を非表示」：
まとめて表示 / 非表示を切り替えます。「printioで更新できない項目を非表示」は、数量とAmazon連携の3項目を非表示にします。
5-3. 「アップロードには使用できません」の警告が出たとき
行の特定に必要な項目が足りない、または商品IDとコードが混ざっているなど、そのままアップロードするとエラーになる組み合わせの場合に、警告が表示されます。
警告が出ていても登録・ダウンロードはできますが、アップロードにも使う場合は、「プリセットの反映」で既定のフォーマットを読み込んでから、必要な項目だけを追加・非表示にしてください。
| 警告 | 意味 |
|---|---|
| ※このフォーマットで出力したCSVはアップロードには使用できません | アップロードすると、すべての行がエラーになります |
| ※バリエーション2がある商品はアップロードでエラーになります | 「バリエーション２ID」または「バリエーション２項目」が非表示です。バリエーション2を使っていない場合は影響ありません |
5-4. 編集・コピー・削除
- 編集：
フォーマット一覧でフォーマット名をクリックし、内容を変更して「保存」します。 - コピーして新規登録・削除：
編集画面の「その他」ボタンから行います。削除したフォーマットは元に戻せません。
6. 旧管理画面からの主な変更点
- 「オプション一括登録」「オプション一括修正」が1つの画面に統合されました（4-1の「未登録のバリエーションを新規追加する」で切り替えます）。
- CSVの1行目を項目名として読み取るようになりました。列の順番は自由で、必要な列だけのCSVでも取り込めます。旧管理画面で出力したCSVも、旧項目名のままアップロードできます。
- 「商品特定コード指定」「オプション特定コード指定」の列は必須ではなくなりました（3-1参照）。
- アップロード前に書式チェックが行われ、エラーやCSVの読み取り方を確認してから実行できるようになりました。
- アップロードは順番に処理され、結果は「CSV処理ジョブ管理」で確認します。完了お知らせメールも受け取れます。
- 旧管理画面のダウンロードボタンは、既定のフォーマットに次のとおり対応しています。
オプションデータ → バリエーション登録・修正用 / 現在のオプションデータ → 旧オプション一括修正（全項目・新項目名） / 現在の数量データ → 旧オプション一括修正（数量のみ・新項目名） - 文字数は、全角・半角の区別なく1文字として数えるようになりました。
- 「販売価格」は9桁までになりました。旧「オプション一括修正」で10〜11桁の販売価格を入力していた行はエラーになります。
- 「JANコード」は、13文字以内であれば数字以外も入力できるようになりました。
- 「数量」の増減指定（+10など）で、在庫数が999,999,999を超える行はエラーになるようになりました。
- 2行目以降のデータがないファイルは、「取り込むデータ行がありません。」のエラーになるようになりました。
- エラーの行番号が、旧管理画面より1つ大きくなりました（4-2参照）。
- 文字コードはShift-JISのほか、UTF-8も使えるようになりました（自動判別）。
- サンプルCSVはご用意しておりません。既定のフォーマットでダウンロードしたCSVをご利用ください。