バリエーション選択肢一括登録・更新・削除（CSV仕様）
こちらは 「商品管理（upgrade版）」 ご利用店舗様用の新仕様（upgrade版）のCSVマニュアルになります。（「商品管理（upgrade版）」とは？）
商品メニューを利用する「商品管理（upgrade版）」で利用可能なCSVは、「標準CSV（従来項目版）」と「標準CSV」の2種類があります。
詳しくは、 商品CSVデータの仕様刷新と制限をご覧ください。
本マニュアルは、「商品管理（upgrade版）」ご利用時に標準となる 「標準CSV」 に関して解説しています。
「標準CSV（従来項目版）」を利用中（「標準CSV」切替え前）の場合は、各セクションの「標準CSV（従来項目版）」用のモーダルを開いてご確認ください。
＜目次＞
ご利用前の重要ご留意事項
商品バリエーションの「横軸」「縦軸」を一括登録・更新・削除できるファイルです。
- 事前に商品登録が必須です。CSVの場合は、商品一括登録を利用してください。
- バリエーション商品の登録に利用するCSVファイルは、項目ごとに異なりますので、本ファイルと併せて以下をご利用ください。
- 代表バリエーションやJANコードなどの登録：バリエーション詳細一括登録
- バリエーション価格の登録：価格（バリエーション）登録用ファイル
- バリエーション在庫の登録：在庫数（バリエーション）一括登録
- バリエーションには「縦軸」「横軸」があります。登録数は、「縦軸」「横軸」いずれも最大50項目までです。
- ただし両軸のバリエーションの場合、「縦軸」「横軸」それぞれのバリエーション数を掛けて計400項目までとなります。（例：「縦軸」が20バリエーションの場合、「横軸」は20バリエーションまで）
- ただし両軸のバリエーションの場合、「縦軸」「横軸」それぞれのバリエーション数を掛けて計400項目までとなります。（例：「縦軸」が20バリエーションの場合、「横軸」は20バリエーションまで）
- 予約商品のバリエーションの場合は、一部利用するCSVファイルが異なります。
- 予約設定一括更新（CSV仕様）- ご利用前の重要ご留意事項をご覧ください。
一括登録・更新・削除手順
CSVのご利用は、以下の手順にておすすめください。
CSVの形式エラーをなくすために、まずはじめにCSVデータの編集時に注意することはありますか？をご覧ください。
- まず、商品＞一括出力の「バリエーション」セクション内「バリエーション選択肢」行の［ファイル出力］を押下し、CSV登録用ファイルをダウンロードします。
- ダウンロードされたCSVファイルのヘッダー（1行目）の項目を元に、基本仕様・CSV入力仕様に従って必要な情報を入力し、アップロード用のCSVファイルを作成します。ファイル名は、末尾の「yyyyMMddHHmmss（年日時）」部分以外は変更しないでください。
- 商品＞一括追加・変更の「バリエーション」セクション内「バリエーション選択肢」行の［ファイルを選択する］を押下します。
- 表示されたモーダル上で、CSVファイルをアップロードし、［アップロード］ボタンを押下します。
- アップロードのエラー・成功のステータス確認は、商品＞一括追加・変更履歴＞一括追加・変更履歴（CSV）をご覧ください。
基本仕様について
基本的なCSV仕様・制限事項など
| 項目 | 仕様・制限事項など | 備考 |
|---|---|---|
| 文字コード | UTF-8（BOMあり） | |
| 区切り文字 | カンマ | |
| 改行コード | CRLF | |
| ヘッダ行 | 有 | |
| ファイル制限（容量） | 30MB | 超過する場合は、複数回に分けて登録してください。 |
| レコード数制限 | 50,000レコード（※ヘッダー除く） | 超過する場合は、複数回に分けて登録してください。 |
| 商品制限 | 1,000商品（※ヘッダー除く） | 超過する場合は、複数回に分けて登録してください。 |
| ファイル命名規則 | productVariationBasic_yyyyMMddHHmmss.csv | ファイル名は500文字以内にしてください。 |
「標準CSV（従来項目版）」を利用中（「標準CSV」切替え前）の店舗様の場合
文字コードやファイル命名規則が異なります。こちら（モーダルが開きます）をご覧ください。
- ファイル名の命名規則は、必ず順守してください。
- 機種依存文字はご利用いただけません。
- お使いのPCがMacの場合、改行コードのエラーがでる場合があります。作成後のCSVファイルをテキストエディタなどで再度開き、改行コードを 「CR」から「CR+LF」に変更してください。
- 設定＞メール＞メール設定一覧＞商品データ一括登録完了メール設定で設定されたメールアドレスへ登録状況をお知らせするメールを送付できます。
CSV入力仕様
基本的な入力仕様について
各行の1列目「コントロールカラム」に入力する値に従って登録・更新・削除が行われます。
CSV仕様表とあわせてご確認ください。
新規登録（追加）する場合
コントロールカラムの入力
「n」 を入力します。
必須 項目の入力
「商品URLコード」により、処理を行う商品を決定します。
「任意」項目の入力
- 値を入力すると、指定値で登録されます。
- 許容値欄をご参照ください。
- 「空欄」指定すると、基本「空」で登録されますが、一部「初期値」で登録、また一部ではエラーとなる項目があります。
- コントロールカラム「空欄（新規登録）」-「空欄」指定欄をご覧ください。
更新する場合
コントロールカラムの入力
「u」 を入力します。
必須 項目の入力
「商品URLコード」により、処理を行う商品を決定します。
「任意」項目の入力
- 値を入力すると、指定値で登録されます。
- 許容値欄をご参照ください。
- 「空欄」指定すると、既存の登録値のまま（更新されない）項目と、エラーとなる項目があります。
- コントロールカラム「空欄（更新）」-更新しない（既定値のまま）欄をご覧ください。
- 「バリエーション別選択肢」「バリエーション別枝番」の変更方法については、バリエーションを更新（変更）したい場合も参照してください。
削除する場合
「商品URLコード」により、処理を行う商品を決定します。
バリエーション自体の削除ではありません。
バリエーションの軸ごとに、「選択肢」「枝番」を削除できます。
削除方法については、バリエーションを削除したい場合も参照してください。
コントロールカラムの入力
「d」 を入力します。一度削除されたデータは、復元できません。
必須 項目の入力
既定値を入力します。
「任意」項目の入力
- バリエーションの軸ごとに、「選択肢」「枝番」を削除できます。
- 「バリエーション別選択肢」「バリエーション別枝番」の削除方法については、バリエーションを削除したい場合も参照してください。
CSV仕様表
＜基本的なエラー＞
- CSVファイル内において、コントロールカラム（「n」「u」「d」）が混在している場合、エラー
- 指定された「商品URLコード」が存在しない場合、エラー
- 指定された「商品URLコード」がバリエーション商品ではない（バリエーション軸が未登録の）場合、エラー
- CSVファイル内に、同じ組み合わせの「商品URLコード」と「バリエーション別枝番（横軸）」あるいは、「商品URLコード」と「バリエーション別枝番（縦軸）」が複数存在している場合、エラー
- 1行に入力できるバリエーション軸は、片方のみ（1行に「縦」「横」いずれかの軸のみを登録可能）。「縦」「横」両軸を１行に入力すると、エラー
【正】１行につき、１軸のみを登録
【誤】１行に「縦」「横」両軸を登録
| 項目名 | 形式 | 文字数 | 許容値と 区分説明 |
コントロールカラム入力値別 制御仕様 | 補足・注意事項 | ||||
|---|---|---|---|---|---|---|---|---|---|
| n（新規登録） | u（更新） | d（削除） | |||||||
| 必須 | 「空欄」 設定時 |
必須 | 更新しない （既定値のまま） |
必須 | |||||
| コントロールカラム | 半角英字 | 1 | n：登録 u：更新（変更） d：削除 |
〇 | n必須 | 〇 | u必須 | 〇 | ※基本的なエラー参照 |
| 商品URLコード | 32 | 〇 | 「空欄」指定不可 既定値入力 |
〇 | 更新不可 既定値入力 |
〇 | ※基本的なエラー参照 | ||
| バリエーション別選択肢（横軸） | 文字列 | 100 | ※補足・注意事項参照 | 更新方法 | ※補足・注意事項参照 | 削除方法 | - 以下のフォーム関連のHTMLタグを含んでいる場合、エラー FORMタグ INPUTタグ TEXTAREAタグ SELECTタグ OPTIONタグ BUTTONタグ SCRIPTタグ - 新規登録・更新の場合 「バリエーション別枝番（横軸）」の指定がある場合、入力必須 |
||
| バリエーション別枝番（横軸） | 文字列 | 100 | ※補足・注意事項参照 | 更新方法 | 既定値入力 | 削除方法 | ※基本的なエラー参照 - 以下のフォーム関連のHTMLタグを含んでいる場合、エラー FORMタグ INPUTタグ TEXTAREAタグ SELECTタグ OPTIONタグ BUTTONタグ SCRIPTタグ - 「バリエーション別枝番（横軸）」「バリエーション別枝番（縦軸）」がいずれも指定されていない場合、エラー - 1行に、バリエーション別枝番「縦軸」「横軸」の両方を入力している場合、エラー（基本的なエラー参照） - 新規登録時の注意事項 - 更新・削除の場合 「バリエーション別枝番（横軸）」にバリエーション登録がない場合、エラー |
||
| バリエーション別選択肢（縦軸） | 文字列 | 100 | ※補足・注意事項参照 | 更新方法 | ※補足・注意事項参照 | 削除方法 | - 以下のフォーム関連のHTMLタグを含んでいる場合、エラー FORMタグ INPUTタグ TEXTAREAタグ SELECTタグ OPTIONタグ BUTTONタグ SCRIPTタグ - 新規登録・更新の場合 「バリエーション別枝番（縦軸）」の指定がある場合、入力必須 |
||
| バリエーション別枝番（縦軸） | 文字列 | 100 | ※補足・注意事項参照 | 更新方法 | 既定値入力 | 削除方法 | ※基本的なエラー参照 - 以下のフォーム関連のHTMLタグを含んでいる場合、エラー FORMタグ INPUTタグ TEXTAREAタグ SELECTタグ OPTIONタグ BUTTONタグ SCRIPTタグ - 「バリエーション別枝番（横軸）」「バリエーション別枝番（縦軸）」がいずれも指定されていない場合、エラー - 1行に、バリエーション別枝番が「縦軸」「横軸」の両方を入力している場合、エラー（基本的なエラー参照） - 新規登録時の注意事項 - 更新・削除の場合 「バリエーション別枝番（縦軸）」にバリエーション登録がない場合、エラー |
||
| 表示順 | 半角数字 | 2 | 0~99 | 「99」で登録 | 「空欄」指定 | ||||
| 商品番号 | ー | ー | ー | ー | ー | ー | ー | ー | アップロード時には利用しない項目 |
| 商品名 | ー | ー | ー | ー | ー | ー | ー | ー | アップロード時には利用しない項目 |
| 最終更新日時 | ー | ー | ー | ー | ー | ー | ー | ー | アップロード時には利用しない項目 |
【新規登録時の注意事項】特定項目の補足
※表内の「補足・注意事項」欄に入りきらない補足を記載しています（特定項目のみ）。必ず表とあわせてご確認ください。
コントロールカラム【n】を入力時に注意を要する項目です。
| 項目名 | 説明 |
|---|---|
| バリエーション別枝番（横軸） バリエーション別枝番（縦軸） | - 同じ組み合わせの「商品URLコード」と「バリエーション別枝番（横軸）」あるいは、「商品URLコード」と「バリエーション別枝番（縦軸）」が既に存在している場合、エラー - 「横軸」あるいは「縦軸」を50項目以上指定している場合、エラー - 「縦軸×横軸」の組み合わせが400件を超える場合、エラー（※ご利用前の重要ご留意事項参照） |
バリエーションを更新（変更）したい場合
「バリエーション別選択肢（縦軸）・（横軸）」を変更したい場合
「バリエーション別枝番（縦軸）・（横軸）」に変更がない場合のみ、更新（変更）可能です。
指定した値で、上書き更新されます。
「バリエーション別枝番（縦軸）・（横軸）」を変更したい場合
変更できません。
「バリエーション別枝番（縦軸）・（横軸）」を含めて更新（変更）したい場合は、既存のバリエーション登録を削除する必要があります。
それぞれ、以下を参考に対応してください。
［例］バリエーション商品の「縦軸」の「枝番」を変更したい場合の手順
- 対象商品の「商品URLコード（必須項目）」と、「バリエーション別枝番（縦軸）」の既定値を1行ずつ入力
- データ行の「コントロールカラム」に 「d」 を入力
- アップロードする
- 別ファイルで、 対象商品の「商品URLコード（必須項目）」と、「変更後」の「バリエーション選択肢（縦軸）」「バリエーション別枝番（縦軸）」を1行ずつ入力
- データ行の「コントロールカラム」に 「n」 を入力
- アップロードする
＜補足＞
- 変更したいバリエーションが「横軸」の場合は、「横軸」を入力してください。
「片軸バリエーション」を「両軸バリエーション」に変更したい場合
新たに登録したい「軸」のデータを登録します。
以下を参考に対応してください。
［例］「縦軸」バリエーション商品に、新たに「横軸」を追加したい場合の手順
- 対象商品の「商品URLコード（必須項目）」と、新たに登録したい「バリエーション別選択肢 （横軸）」と「バリエーション別枝番 （横軸）」を1行ずつ入力
- データ行の「コントロールカラム」に 「n」 を入力
- アップロードする
＜補足＞
- 新に登録したいバリエーションが「縦軸」の場合は、「縦軸」を入力してください。
バリエーションを削除したい場合
片方の軸のみを削除したい場合
以下を参考に対応してください。
なおアップロード後は、次のような商品となります。
- 「縦軸・横軸」両軸のバリエーション商品であった場合、「片軸のバリエーション商品」となります。
- 「片軸のバリエーション商品」であった場合、「バリエーションなし商品」となります。
［例］「縦軸」のバリエーションを削除したい場合の手順
- 対象商品の「商品URLコード（必須項目）」と、「バリエーション別枝番 （縦軸）」を1行ずつ入力
- 「バリエーション別選択肢 （横軸）」と「バリエーション別枝番 （横軸）」には何も入力しない。
- データ行の「コントロールカラム」に 「d」 を入力
- アップロードする
＜補足＞
- 削除したいバリエーションが「横軸」の場合は、上記の「縦軸/横軸」を逆にしてください。
- 「商品URLコード」×「バリエーション別枝番（縦軸/横軸）」でバリエーションを判別するので、「バリエーション別選択肢（縦軸/横軸）」の入力は不要です。
バリエーション（縦軸・横軸）双方を削除したい場合
「縦・横」双方のバリエーションを登録している商品のバリエーション情報を削除する場合は、以下を参考に対応してください。
なおアップロード後は、次のような商品となります。
- 「縦軸」「横軸」共に削除され、「バリエーションなし商品」となります。
［例］バリエーション（縦軸・横軸）双方を削除したい場合の手順
- 対象商品の「商品URLコード（必須項目）」と、「バリエーション別枝番 （縦軸）」を1行ずつ入力
- さらに対象商品の「商品URLコード（必須項目）」と、「バリエーション別枝番 （横軸）」を行をかえて1行ずつ入力
- データ行の「コントロールカラム」に 「d」 を入力
- アップロードする
＜補足＞
- 「商品URLコード」×「バリエーション別枝番（縦軸/横軸）」でバリエーションを判別するので、「バリエーション別選択肢（縦軸/横軸）」の入力は不要です。