オプション価格(選択肢)一括登録・更新・削除(CSV仕様)
こちらは 「商品管理(upgrade版)」 ご利用店舗様用の新仕様(upgrade版)のCSVマニュアルになります。(「商品管理(upgrade版)」とは?)
商品メニューを利用する「商品管理(upgrade版)」で利用可能なCSVは、「標準CSV(従来項目版)」と「標準CSV」の2種類があります。
詳しくは、 商品CSVデータの仕様刷新と制限をご覧ください。
本マニュアルは、「商品管理(upgrade版)」ご利用時に標準となる 「標準CSV」 に関して解説しています。
「標準CSV(従来項目版)」を利用中(「標準CSV」切替え前)の場合は、各セクションの「標準CSV(従来項目版)」用のモーダルを開いてご確認ください。
<目次>
ご利用前の重要ご留意事項
商品の「オプション価格」の「選択肢」「価格」などを登録できます。
- 事前に商品登録が必須です。CSVの場合は、商品一括登録を利用してください。
- 事前に、オプション価格の「項目名」「表示タイプ」の登録が必須です。
CSVの場合は、オプション価格(基本)一括登録を利用してください。
一括登録・更新・削除手順
CSVのご利用は、以下の手順にておすすめください。
CSVの形式エラーをなくすために、まずはじめにCSVデータの編集時に注意することはありますか?をご覧ください。
- まず、 商品>一括出力の「オプション価格」セクション内「オプション価格(選択肢)」行の[ファイル出力]を押下します。
- ダウンロードされたCSVファイルのヘッダー(1行目)の項目を元に、基本仕様・CSV入力仕様に従って必要な情報を入力し、アップロード用のCSVファイルを作成します。ファイル名は、末尾の「yyyyMMddHHmmss(年日時)」部分以外は変更しないでください。
- 商品>一括追加・変更の「オプション価格」セクション内「オプション価格(選択肢)」行の[ファイルを選択する]を押下します。
- 表示されたモーダル上で、CSVファイルをアップロードします。
- 本CSVは、ファイル形式やデータのエラーについて「事前チェック」が可能です。登録時のエラーを防ぐためにご活用ください。
「チェックする」のチェックをONにして[アップロード]ボタンを押下します。

- 事前チェックのエラー・成功のステータス確認は、商品>一括追加・変更履歴>一括追加・変更履歴(CSV)をご覧ください。
事前チェックの場合、「種類」欄に「事前チェック」と表示されます。
エラーの場合はエラー内容(ログ)がダウンロードできます。チェックしてエラーがなければ、「完了」と表示されます。

- 事前チェックに問題がなければ、手順[3][4]を再度行い、「チェックする」のチェックをOFFにし、[アップロード]ボタンを押下します。
- アップロードのエラー・成功のステータス確認は、商品>一括追加・変更履歴>一括追加・変更履歴(CSV)をご覧ください。
基本仕様について
基本的なCSV仕様・制限事項など
| 項目 | 仕様・制限事項など | 備考 |
|---|---|---|
| 文字コード | UTF-8(BOMあり) | |
| 区切り文字 | カンマ | |
| 改行コード | CRLF | |
| ヘッダ行 | 有 | |
| ファイル制限(容量) | 30MB | 超過する場合は、複数回に分けて登録してください。 |
| レコード数制限 | 50,000レコード(※ヘッダー除く) | 超過する場合は、複数回に分けて登録してください。 |
| 商品制限 | 1,000商品 | 超過する場合は、複数回に分けて登録してください。 |
| ファイル命名規則 | productOptionPriceSelection_yyyyMMddHHmmss.csv | ファイル名は500文字以内にしてください。 |
「標準CSV(従来項目版)」を利用中(「標準CSV」切替え前)の店舗様の場合
文字コードやファイル命名規則が異なります。こちら(モーダルが開きます)をご覧ください。
- ファイル名の命名規則は、必ず順守してください。
- 機種依存文字はご利用いただけません。
- お使いのPCがMacの場合、改行コードのエラーがでる場合があります。作成後のCSVファイルをテキストエディタなどで再度開き、改行コードを 「CR」から「CR+LF」に変更してください。
- 設定>メール>メール設定一覧>商品データ一括登録完了メール設定で設定されたメールアドレスへ登録状況をお知らせするメールを送付できます。
CSV入力仕様
基本的な入力仕様について
各行の1列目「コントロールカラム」に入力する値に従って更新・削除が行われます。
CSV仕様表とあわせてご確認ください。
新規登録(追加)する場合
コントロールカラムの入力
「n」 を入力します。
必須 項目の入力
「商品URLコード」「項目名【基本情報】」により、処理を行う商品を決定します。
「任意」項目の入力
- 値を入力すると、指定値で登録されます。
- 許容値欄をご参照ください。
- あらかじめ登録されている「表示タイプ【基本情報】」の値により入力条件が異なります。
更新する場合
コントロールカラムの入力
「u」 を入力します。
必須 項目の入力
「商品URLコード」「項目名【基本情報】」「選択肢コード【選択肢・価格設定/価格設定】」により、処理を行う商品を決定します。
「選択肢コード【選択肢・価格設定/価格設定】」は更新(変更)できません。
「任意」項目の入力
- 値を入力すると、指定値で更新されます。
- 許容値欄をご参照ください。
- あらかじめ登録されている「表示タイプ【基本情報】」の値により入力条件が異なります。
- 「空欄」指定すると、一部の項目は 既存の登録値のままとなります(更新されません) が、一部の項目は、「空」となり、既定値が削除されますのでご注意ください。
削除する場合
「商品URLコード」「項目名【基本情報】」「選択肢コード【選択肢・価格設定/価格設定】」により、により、処理を行う商品を決定します。
指定した商品の「項目名【基本情報】」「選択肢コード【選択肢・価格設定/価格設定】」が全削除となります。
「価格」「表示順」など、特定の項目値の削除ではありません。
コントロールカラムの入力
「d」 を入力します。一度削除されたデータは、復元できません。
必須 項目の入力
既定値を入力します。
「任意」項目の入力
- 入力不要です。
CSV仕様表
<基本的なエラー>
- CSVファイル内の同じ組み合わせの「商品URLコード」「項目名【基本情報】」のコントロールカラムで、「n / u」と「d」が混在している場合、エラー
- 指定された「商品URLコード」が存在しない場合、エラー
- 一つの「項目名」に登録できる「選択肢(s:セレクトボックス/c:ラジオボタン)」は、最大300項目までです。超える場合、エラー
- 一つの「項目名」に登録できる「選択肢(t:テキスト/tr:テキスト(必須))」は、最大1項目までです。超える場合、エラー
「標準CSV(従来項目版)」を利用中(「標準CSV」切替え前)の店舗様の場合
CSV項目についてはこちら(モーダルが開きます)をご覧ください。
| 項目名 | 形式 | 文字数 | 許容値と 区分説明 |
コントロールカラム入力値別 制御仕様 | 補足・注意事項 | |||||
|---|---|---|---|---|---|---|---|---|---|---|
| n(新規登録) | u(更新) | d(削除) | ||||||||
| 必須 | 「空欄」 設定時 |
必須 | 更新しない (既定値のまま) |
削除する (「空」にする) |
必須 | |||||
| コントロールカラム | 半角英字 | 1 | n:新規 u:更新 d:削除 |
〇 | n必須 | 〇 | u必須 | u必須 | 〇 | ※基本的なエラー参照 |
| 商品URLコード | 32 | 〇 | 「空欄」指定不可 既定値入力 |
〇 | 更新不可 既定値入力 |
削除不可 既定値入力 |
〇 | ※基本的なエラー参照 | ||
| 項目名【基本情報】 | 文字列 | 100 | 〇 | 「空欄」指定不可 既定値入力 |
〇 | 更新不可 既定値入力 |
削除不可 既定値入力 |
〇 | - 指定された「商品URLコード」と「項目名【基本情報】」の組み合わせが存在しない場合、エラー | |
| 表示タイプ【基本情報】 | 半角文字列 | 2 | s:セレクトボックス c:ラジオボタン t:テキスト tr:テキスト(必須) |
ー | ー | ー | ー | ー | アップロード時、更新しない項目 - 新規登録・更新の場合 管理画面やオプション価格(基本)CSVで登録した設定で処理されます。「表示タイプ【基本情報】(本項目)」の設定によりエラー制御される、以下の項目にご注意ください。意図せずエラーとなる可能性があります。 ・選択肢【選択肢・価格設定】 ・価格【選択肢・価格設定】 ・表示順【選択肢・価格設定】 ・価格【価格設定】 |
|
| 選択肢コード【選択肢・価格設定/価格設定】 | 半角文字列 | 50 | 0-9, a-z, A-Z, -(ハイフン), _(アンダーバー) |
〇 | 「空欄」指定不可 既定値入力 |
〇 | 更新不可 既定値入力 |
削除不可 既定値入力 |
〇 | - 新規登録時の注意事項 - 更新・削除の場合 指定された「商品URLコード」「項目名【基本情報】」「選択肢コード」の組み合わせが存在しない場合、エラー - 更新の場合 「選択肢コード」の変更不可(必ず既定値を入力) 更新したい場合の手順は、更新時の注意事項を参照 |
| 選択肢【選択肢・価格設定】 | 文字列 | 100 | ※補足参照 | ※補足参照 | ※補足参照 | 「空欄」指定 | 削除不可 | - 以下のフォーム関連HTMLタグを含む場合はエラー FORMタグ INPUTタグ TEXTAREAタグ SELECTタグ OPTIONタグ BUTTONタグ SCRIPTタグ - 新規登録時の注意事項 - 更新の場合 「表示タイプ【基本情報】」が「t:テキスト」「tr:テキスト(必須)」の場合に、値が指定されている場合、エラー |
||
| 価格【選択肢・価格設定】 | 半角数字 | 9 | -999,999,999~999,999,999 | ※補足参照 | ※補足参照 | ※補足参照 | 既定値入力 | 「空欄」指定 | - 新規登録・更新の場合 「表示タイプ【基本情報】」が「t:テキスト」「tr:テキスト(必須)」の場合に、値が指定されている場合、エラー |
|
| 表示順【選択肢・価格設定】 | 半角数字 | 3 | 0~299 | ※補足参照 | ※補足参照 | ※補足参照 | 「空欄」指定 | 削除不可 | - 新規登録・更新の場合 「表示タイプ【基本情報】」が「t:テキスト」「tr:テキスト(必須)」の場合に、値が指定されている場合、エラー |
|
| 価格【価格設定】 | 半角数字 | 9 | -999,999,999~999,999,999 | ※補足参照 | ※補足参照 | ※補足参照 | 既定値入力 | 「空欄」指定 | - 新規登録・更新の場合 「表示タイプ【基本情報】」が「s:セレクトボックス」「c:ラジオボタン」の場合に、値が設定されている場合、エラー |
|
| 最終更新日時 | ー | ー | ー | ー | ー | ー | ー | ー | ー | アップロード時、更新しない項目 |
【新規登録時の注意事項】特定項目の補足
※表内の「補足・注意事項」欄に入りきらない補足を記載しています(特定項目のみ)。必ず表とあわせてご確認ください。
コントロールカラム【n】を入力時に注意を要する項目です。
| 項目名 | 説明 |
|---|---|
| 選択肢コード【選択肢・価格設定/価格設定】 | - 指定された「商品URLコード」「項目名【基本情報】」「選択肢コード【選択肢・価格設定/価格設定】」の組み合わせが存在しない場合、エラー - 「選択肢コード【選択肢・価格設定/価格設定】」が既に存在している場合、エラー - 表示タイプ【基本情報】が「s:セレクトボックス」「c:ラジオボタン」の場合、以下に該当する場合、エラー ・指定された「商品URLコード」「項目名【基本情報】」の組み合わせの「選択肢コード【選択肢・価格設定/価格設定】」が 301項目以上になる場合 ・既に登録済みの「選択肢コード【選択肢・価格設定/価格設定】」が既に300項目存在している場合 - 表示タイプ【基本情報】が「t:テキスト」「tr:テキスト(必須)」の場合、以下に該当する場合、エラー ・ 指定された「商品URLコード」「項目名【基本情報】」の組み合わせの「選択肢コード【選択肢・価格設定/価格設定】」が 2項目以上になる場合 ・既に登録済みの「選択肢コード【選択肢・価格設定/価格設定】」が既に1項目存在している場合 |
| 選択肢【選択肢・価格設定】 | - 「表示タイプ【基本情報】」が「s:セレクトボックス」「c:ラジオボタン」の場合、値が指定されていない場合、エラー - 「表示タイプ【基本情報】」が「t:テキスト」「tr:テキスト(必須)」の場合、値が指定されている場合、エラー |
【更新時の注意事項】特定項目の補足
※表内の「補足・注意事項」欄に入りきらない補足を記載しています(特定項目のみ)。必ず表とあわせてご確認ください。
コントロールカラム【u】を入力時に注意を要する項目です。
| 項目名 | 説明 |
|---|---|
| 選択肢コード【選択肢・価格設定/価格設定】 | 更新(変更)ができません。変更したい場合は以下の方法で行ってください。 1. 変更したいオプション価格自体を、本CSVを利用して一度削除(コントロールカラム「d」) 2. 本CSVを利用して再度登録(コントロールカラム「n」) |
