平日10:00~17:00
06-6485-6485
fshop-AI(研修中) AIチャットを開く

オプション価格(選択肢)一括登録・更新・削除(CSV仕様)

オプション価格(選択肢)一括登録・更新・削除(CSV仕様)

こちらは 「商品管理(upgrade版)」 ご利用店舗様用の新仕様(upgrade版)のCSVマニュアルになります。「商品管理(upgrade版)」とは?

商品メニューを利用する「商品管理(upgrade版)」で利用可能なCSVは、「標準CSV(従来項目版)」と「標準CSV」の2種類があります。

詳しくは、 商品CSVデータの仕様刷新と制限をご覧ください。

本マニュアルは、「商品管理(upgrade版)」ご利用時に標準となる 「標準CSV」 に関して解説しています。

「標準CSV(従来項目版)」を利用中(「標準CSV」切替え前)の場合は、各セクションの「標準CSV(従来項目版)」用のモーダルを開いてご確認ください。


<目次>

ご利用前の重要ご留意事項

商品の「オプション価格」の「選択肢」「価格」などを登録できます。

一括登録・更新・削除手順

CSVのご利用は、以下の手順にておすすめください。

CSVの形式エラーをなくすために、まずはじめにCSVデータの編集時に注意することはありますか?をご覧ください。


  1. まず、 商品>一括出力の「オプション価格」セクション内「オプション価格(選択肢)」行の[ファイル出力]を押下します。

  2. ダウンロードされたCSVファイルのヘッダー(1行目)の項目を元に、基本仕様CSV入力仕様に従って必要な情報を入力し、アップロード用のCSVファイルを作成します。ファイル名は、末尾の「yyyyMMddHHmmss(年日時)」部分以外は変更しないでください

  3. 商品>一括追加・変更の「オプション価格」セクション内「オプション価格(選択肢)」行の[ファイルを選択する]を押下します。

  4. 表示されたモーダル上で、CSVファイルをアップロードします。

  5. 本CSVは、ファイル形式やデータのエラーについて「事前チェック」が可能です。登録時のエラーを防ぐためにご活用ください。
    「チェックする」のチェックをONにして[アップロード]ボタンを押下します。

「チェックする」のチェック


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

「チェックする」のログ


  1. 事前チェックに問題がなければ、手順[3][4]を再度行い、「チェックする」のチェックをOFFにし、[アップロード]ボタンを押下します。

  2. アップロードのエラー・成功のステータス確認は、商品>一括追加・変更履歴>一括追加・変更履歴(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」)