平日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(従来項目版)」用のモーダルを開いてご確認ください。


<目次>

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

登録済み商品バリエーションの「代表バリエーション」「在庫閾値」「在庫切れメール閾値」「JANコード」「商品リードタイム」「梱包重量」などを一括更新できるファイルです。

一括更新手順

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商品(※ヘッダー除く)超過する場合は、複数回に分けて登録してください。
ファイル命名規則productVariationDetail-{テンプレートコード}_yyyyMMddHHmmss.csv<テンプレートコードとは>

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

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

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

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

CSV入力仕様

CSV仕様表

※本CSVにはコントロールカラムはありません。

<基本的なエラー>

  • 指定された「商品URLコード」が存在しない場合、エラー
  • 指定された「商品URLコード」がバリエーション商品ではない(バリエーション軸が未登録の)場合、エラー
  • CSVファイル内に、同じ組み合わせの「商品URLコード」と「バリエーション別枝番(横軸)」あるいは、「商品URLコード」と「バリエーション別枝番(縦軸)」が複数存在している場合、エラー
  • 「バリエーション別枝番(横軸)」「バリエーション別枝番(縦軸)」がいずれも指定されていない場合、エラー
  • 指定された「バリエーション別枝番(縦軸)」もしくは「バリエーション別枝番(横軸)」にバリエーション登録がない場合、エラー

<エラーとならないが更新されないケース>

  • 実在しないバリエーション別枝番(横軸)(縦軸)の組合せの場合、エラーになりません
    • 「成功」ステータスとなりますが、入力値では更新されません
    • (例)両軸バリエーションであるのに、片軸のみの指定である など
    • (例)両軸バリエーションであるが、入力されているバリエーション別枝番(横軸)(縦軸)の組み合わせが存在しない など
  • バリエーション別枝番(横軸)(縦軸)は正しいが、在庫データがない(更新する情報がない)場合、エラーになりません
    • 「成功」ステータスとなりますが、入力値では更新されません
項目名 形式 文字数 許容値と
区分説明
必須 更新しない
(既定値のまま)
削除する
(「空」にする)
補足・注意事項参照
商品URLコード 32 更新不可
既定値入力
削除不可 基本的なエラー参照
バリエーション別選択肢(横軸) 文字列 100 アップロード時には利用しない項目
バリエーション別枝番(横軸) 文字列 100 ※補足・注意事項参照 ※補足・注意事項参照 削除不可 基本的なエラー参照

- 両軸バリエーション商品で片方しか枝番を入力していない場合
 更新されず

- 両軸バリエーション商品で枝番の組み合わせが存在しない場合
 更新されず

- 枝番は正しいが既存の在庫データがない場合
 更新されず

- 以下のフォーム関連のHTMLタグを含んでいる場合、エラー
 FORMタグ
 INPUTタグ
 TEXTAREAタグ
 SELECTタグ
 OPTIONタグ
 BUTTONタグ
 SCRIPTタグ
バリエーション別選択肢(縦軸) 文字列 100 アップロード時には利用しない項目
バリエーション別枝番(縦軸) 文字列 100 ※補足・注意事項参照 ※補足・注意事項参照 削除不可 基本的なエラー参照

- 両軸バリエーション商品で片方しか枝番を入力していない場合
 更新されず

- 枝番は正しいが既存の在庫データがない場合
 更新されず

- 以下のフォーム関連のHTMLタグを含んでいる場合、エラー
 FORMタグ
 INPUTタグ
 TEXTAREAタグ
 SELECTタグ
 OPTIONタグ
 BUTTONタグ
 SCRIPTタグ
代表バリエーション 半角数字 1 1:代表バリエーション指定 ※補足・注意事項参照 「空欄」指定 削除不可 代表バリエーションとは?

- CSVファイル内において、一つの「商品URLコード」に複数の「代表バリエーション」が指定されている場合、エラー

- 既定値を含め、一つの「商品URLコード」に一つも「1:代表バリエーション指定」が指定されていない場合、最も小さいバリエーションNOのものを、自動的に代表バリエーションとする
在庫閾値 半角数字 9 0~999999999 「空欄」指定 -1指定
在庫切れメール閾値 半角数字 9 0~999999999 「空欄」指定 -1指定
商品番号 アップロード時には利用しない項目
商品管理番号 アップロード時には利用しない項目
商品名 アップロード時には利用しない項目
JANコード 文字列 30 「空欄」指定 -1指定
商品リードタイム( 半角数字 2 ※補足・注意事項参照 「空欄」指定 -1指定 - 通常商品(バリエーションあり)の場合
 「0~30」もしくは「-1」以外が指定されている場合、エラー

- 定期・頒布会商品(バリエーションあり)の場合
 「0~9」もしくは「-1」以外が指定されている場合、エラー
梱包重量 半角数字 6 0~999999 「空欄」指定 -1指定
最終更新日時 アップロード時には利用しない項目

(★)付の項目についてのご注意点