平日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の形式エラーをなくすために、まずはじめにCSVデータの編集時に注意することはありますか?をご覧ください。


  1. まず、登録したい項目をセットしたCSVテンプレートを、商品>一括出力>一括出力(テンプレート)にて設定します。(登録済みの場合は不要)

  2. 商品>一括出力の「項目選択肢」セクション内「項目選択肢」行のプルダウンから、利用したいテンプレートを選択し[ファイル出力]を押下します。

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

  4. 商品>一括追加・変更の「項目選択肢」セクション内「項目選択肢」行の[ファイルを選択する]を押下します。

  5. 表示されたモーダル上で、CSVファイルをアップロードし、[アップロード]ボタンを押下します。

  6. アップロードのエラー・成功のステータス確認は、商品>一括追加・変更履歴>一括追加・変更履歴(CSV)をご覧ください。

基本仕様について

基本的なCSV仕様・制限事項など

項目仕様・制限事項など備考
文字コードUTF-8(BOMあり)
区切り文字カンマ
改行コードCRLF
ヘッダ行
ファイル制限(容量)30MB超過する場合は、複数回に分けて登録してください。
レコード数制限50,000レコード(※ヘッダー除く)超過する場合は、複数回に分けて登録してください。
商品制限1,000商品超過する場合は、複数回に分けて登録してください。
ファイル命名規則productSelection-{テンプレートコード}_yyyyMMddHHmmss.csv<テンプレートコードとは>

商品>一括出力にてテンプレートを作成する際に、指定したコードです。
本コードをもって、登録項目を識別しますので、変更しないでください。
※初期テンプレートには、本コードはありません。

ファイル名は500文字以内にしてください。
「標準CSV(従来項目版)」を利用中(「標準CSV」切替え前)の店舗様の場合

文字コードやファイル命名規則が異なります。こちら(モーダルが開きます)をご覧ください。

  • ファイル名の命名規則は、必ず順守してください。
  • 機種依存文字はご利用いただけません。
  • お使いのPCがMacの場合、改行コードのエラーがでる場合があります。作成後のCSVファイルをテキストエディタなどで再度開き、改行コードを 「CR」から「CR+LF」に変更してください。
  • 設定>メール>メール設定一覧>商品データ一括登録完了メール設定で設定されたメールアドレスへ登録状況をお知らせするメールを送付できます。

CSV入力仕様

基本的な入力仕様について

各行の1列目「コントロールカラム」に入力する値に従って更新・削除が行われます。
CSV仕様表とあわせてご確認ください。

新規登録(追加)する場合

コントロールカラムの入力

「n」 を入力します。

必須 項目の入力

「商品URLコード」と「選択肢タイプ」を指定して、項目選択肢を設定します。

「任意」項目の入力
  • 値を入力すると、指定値で登録されます。
  • 「空欄」指定すると、一部の項目では「初期値」が登録されます。

削除する場合

「商品URLコード」と「セレクト/ラジオボタン用項目名」を指定して、該当の項目選択肢を削除します。
指定した商品の、すべての項目選択肢を削除するのではありません。

コントロールカラムの入力

「d」 を入力します。一度削除されたデータは、復元できません。

必須 項目の入力

既定値を入力します。

「任意」項目の入力

CSV仕様表

<基本的なエラー>

  • 同一「商品URLコード」のコントロールカラムで、「n」と「d」が混在している場合、エラー
  • CSVファイル内に、同じ組み合わせの「商品URLコード」「セレクト/ラジオボタン用項目名」「セレクト/ラジオボタン用選択肢」が複数存在している場合、エラー
  • 「d」指定時は、「商品URLコード」と「セレクト/ラジオボタン用項目名」を指定することで、その項目名に属するすべての選択肢を削除します。
    • 指定した商品の、すべての項目選択肢を削除するのではありません。
「標準CSV(従来項目版)」を利用中(「標準CSV」切替え前)の店舗様の場合

CSV項目についてはこちら(モーダルが開きます)をご覧ください。

項目名 形式 文字数 許容値と
区分説明
コントロールカラム入力値別 制御仕様 補足・注意事項
n(新規登録) d(削除)
必須 「空欄」
設定時
必須
コントロールカラム 半角英字 1 n:新規登録
d:削除
n必須 基本的なエラー参照
商品URLコード 32 「空欄」指定不可
既定値入力
基本的なエラー参照
選択肢タイプ 半角文字列 2 s:セレクトボックス
c:ラジオボタン
t :テキスト
tr:テキスト(必須)
「空欄」指定不可
既定値入力
- CSVファイル内の、同じ組み合わせの「商品URLコード」「セレクト/ラジオボタン用項目名」の「選択肢タイプ」に以下が混在している場合、エラー
 ・「s:セレクトボックス」
 ・「c:ラジオボタン」
 ・「t :テキスト」
 ・「tr:テキスト(必須)」

新規登録時の注意事項
セレクト/ラジオボタン用項目名 文字列 100 「空欄」指定不可
既定値入力
基本的なエラー参照

- 以下のフォーム関連のHTMLタグを含んでいる場合、エラー
 FORMタグ
 INPUTタグ
 TEXTAREAタグ
 SELECTタグ
 OPTIONタグ
 BUTTONタグ
 SCRIPTタグ

- 「チルダ(~)」を含んでいる場合、エラー

- 半角スラッシュを含んでいる場合、エラー

- 新規登録の場合
 指定した商品の「セレクト/ラジオボタン用項目名」が21項目以上になる場合、エラー
セレクト/ラジオボタン用選択肢 文字列 100 ※補足・注意事項参照 「空」で登録 ※補足・注意事項参照 基本的なエラー参照

-「選択肢タイプ」にて 「s:セレクトボックス」「c:ラジオボタン」を指定している場合
 値が設定されていない場合、エラー

- 以下のフォーム関連のHTMLタグを含んでいる場合、エラー
 FORMタグ
 INPUTタグ
 TEXTAREAタグ
 SELECTタグ
 OPTIONタグ
 BUTTONタグ
 SCRIPTタグ

- 半角スラッシュを含んでいる場合、エラー

- チルダ(~)を含んでいる場合、エラー

-新規登録時の注意事項
項目選択肢表示 半角数字 1 0:表示する
1:表示しない
「0:表示する」で登録 - CSVファイル内の、同じ組み合わせの「商品URLコード」「セレクト/ラジオボタン用項目名」の「項目選択肢表示」に「空欄」「0」「1」に混在している場合、エラー
最終更新日時 アップロード時には利用しない項目

【新規登録時の注意事項】特定項目の補足

※表内の「補足・注意事項」欄に入りきらない補足を記載しています(特定項目のみ)。必ず表とあわせてご確認ください。

コントロールカラム【n】を入力時に注意を要する項目です。

項目名説明
選択肢タイプ「t :テキスト」「tr:テキスト(必須)」指定時、該当の「商品URLコード」の「セレクト/ラジオボタン用項目名」の項目選択肢情報となる「セレクト/ラジオボタン用選択肢」が2項目以上になる場合、エラー 
セレクト/ラジオボタン用選択肢- 「選択肢タイプ」にて「s:セレクトボックス」「c:ラジオボタン」を指定している場合
 指定した商品の「セレクト/ラジオボタン用項目名」の「セレクト/ラジオボタン用選択肢」が301項目以上になる場合、エラー

- 指定した商品の「セレクト/ラジオボタン用項目名」の「セレクト/ラジオボタン用選択肢」を、すべて「チルダ(~)」で結合した際、16001文字以上になる場合、エラー