SAKUシンプル食品表示 csv-import-export

【シンプル食品表示】CSVで一括登録・書き出しする方法

  • 食品表示・アレルゲンを商品ページに見やすく表示

  • 「卵・乳不使用」などの条件で商品検索

  • CSVでまとめて登録・更新・書き出し

NEW
NEW
【シンプル食品表示】CSVで一括登録・書き出しする方法

アプリの特徴

【Basicプラン】
・食品表示(名称・原材料・内容量・保存方法など)と栄養成分を商品ページに表示
・特定原材料等29品目のアレルゲンに対応
・「卵・乳不使用」など複数条件での商品検索
・CSVでの一括登録・更新・書き出し
・原材料マスターで共通の原材料を複数商品に追加
・$4.99/月 または $49.9/年(7日間の無料体験あり)

※注意
表示内容の最終確認はショップ側で行ってください。法令適合の判定・保証や栄養計算は行いません。

商品が多いショップ向けに、食品表示・アレルゲン・栄養成分をCSVファイルでまとめて登録する方法です。この記事の手順どおりに進めれば、そのまま登録できます。

この記事でわかること

  • CSVの流れ(ダウンロード → 入力 → アップロード)
  • 列ごとの書き方と、使える言葉
  • Excel/Googleスプレッドシートでの開き方・保存のしかた
  • 結果の見方と、よくあるエラーの直し方

操作する場所:Shopify管理画面 → アプリ → SAKUシンプル食品表示 → 「CSV一括登録・書き出し」

CSV一括登録・書き出し画面

全体の流れ

  1. 「商品入りCSVをダウンロード」でファイルを取得
  2. Excel またはGoogleスプレッドシートで開いて入力
  3. CSV形式で保存
  4. 「ファイルを選択」→「読み込んで登録」でアップロード
  5. 結果を確認(エラーの行だけ直して再アップロード)


1️⃣ 商品入りCSVをダウンロードする

「1. 商品入りCSVをダウンロード」の「商品入りCSVをダウンロード」を押します。ストアの全商品の商品名・handle・SKUと、登録済みの食品表示が入ったファイル(saku-food-products-1.csv)が保存されます。

  • 1ファイルは最大5,000行・5MBです。商品が多い場合は「次のCSV(2)をダウンロード」が表示されるので、続けてダウンロードしてください。
  • 入力済みの商品だけ欲しい場合は、「列の説明・文字コード・その他の書き出し」の「入力済みだけを書き出し」を使います。
  • 書き方の見本が欲しい場合は、同じ場所の「記入例をダウンロード」で1行の記入例が入ったファイルを取得できます。


2️⃣ ファイルを開く

  • Excel:ダウンロードしたファイルをダブルクリックで開けます(文字化けしない形式で書き出しています)。
  • Googleスプレッドシート:「ファイル」→「インポート」→「アップロード」でファイルを選び、「新しいスプレッドシートを作成」で開きます。

1行目が列名、2行目以降が1行=1商品です。


3️⃣ 入力する(ここが一番大切です)

守ってほしい3つのルール

  1. 1行目(列名)と、A〜C列(商品名(参照用)・handle・sku)は変えない。
  2. 決まった言葉の列は、表のとおりの言葉だけを書く。(違う言葉の行はエラーになり、取り込まれません)
  3. 入力しない項目は空欄のままでOK。ただし、すでに入力済みの商品で空欄にした項目は消えます。

列ごとの書き方(太字の列は、決まった言葉しか使えません)

列 列名 書き方 例
A 商品名(参照用) 変更しない(取り込まれません) バタークッキー 6枚入り
B handle 変更しない(商品の特定に使います) butter-cookie
C sku 変更しない COOKIE-001
D 名称 自由入力 焼菓子
E 原材料名 自由入力(「、」区切り) 小麦粉、バター、砂糖、卵
F 添加物 自由入力 膨張剤
G アレルゲン 29品目の正式名を「、」区切り 小麦、乳、卵
H アレルゲン確認範囲 空欄/9品目/29品目 29品目
I 原料原産地名 自由入力 小麦粉(国内製造)
J 内容量 自由入力 8個入
K 期限種別 消費期限/賞味期限 賞味期限
L 期限表記 自由入力 枠外下部に記載
M 保存温度帯 常温/冷蔵/冷凍 常温
N 保存方法テキスト 自由入力 直射日光・高温多湿を避けて保存
O 原産国名 自由入力 日本
P 表示責任者区分 製造者/加工者/販売者/輸入者 製造者
Q 表示責任者名称 自由入力 株式会社サンプル
R 表示責任者所在地 自由入力 東京都〇〇区…
S アレルゲン注意喚起 自由入力(任意) 本品製造工場では落花生を含む製品を製造しています
T 栄養_基準 100g/100ml/1個/1袋/1本/1食(「あたり」付きも可) 1個
U 栄養_推定値 推定値なら「推定」、違えば「false」、未設定は空欄 推定
V 栄養成分 「項目名=数値単位」を半角「;」で区切る 熱量=120kcal; たんぱく質=2.1g; 脂質=7.5g


アレルゲン列の書き方

  • 次の29品目の正式名だけが使えます:えび、カシューナッツ、かに、くるみ、小麦、そば、卵、乳、落花生、アーモンド、あわび、いか、いくら、オレンジ、キウイフルーツ、牛肉、ごま、さけ、さば、大豆、鶏肉、バナナ、ピスタチオ、豚肉、マカダミアナッツ、もも、やまいも、りんご、ゼラチン
  • 「たまご」「鶏卵」「乳成分」「エビ」「海老」などはエラーになります。「卵」「乳」「えび」のように書いてください。
  • 区切りは「、」がおすすめです(半角「,」「・」「/」、スペースも使えます)。全角の「,」は使えません。

アレルゲン確認範囲の書き方

  • 空欄:未確認(不使用の検索・コレクションには表示されません)
  • 9品目:特定原材料9品目の使用の有無を確認済み(「9」だけでも可)
  • 29品目:29品目すべての使用の有無を確認済み(「29」だけでも可)

栄養成分の書き方

  • 1つの「栄養成分」列に、熱量=120kcal; たんぱく質=2.1g; 脂質=7.5g; 炭水化物=12g; 食塩相当量=0.1g; 食物繊維=2g のように書きます。
  • 項目と項目の間は半角の「;」で区切ります。
  • 数値に桁区切りのカンマは使えません(×1,000kcal → ○1000kcal)。マイナスの値も使えません。
  • この列がある行では、栄養項目が書いた内容に丸ごと置き換わります。

よくある書き方の例

やりたいこと 書き方
アレルゲンを小麦・卵・乳にしたい アレルゲン:小麦、卵、乳
29品目すべて確認済みにしたい アレルゲン確認範囲:29品目
賞味期限で、記載場所を案内したい 期限種別:賞味期限/期限表記:枠外下部に記載
ある項目だけ消したい その項目のセルを空欄にする
ある列は触りたくない その列ごと削除してもOK(削除した列の項目は変更されません)


4️⃣ CSV形式で保存する

  • Excel:「ファイル」→「名前を付けて保存」で、ファイルの種類を「CSV UTF-8(コンマ区切り)」にして保存します(「CSV(コンマ区切り)」でも読み込めますが、絵文字など一部の文字が消えることがあります)。
  • Googleスプレッドシート:「ファイル」→「ダウンロード」→「カンマ区切り形式(.csv)」で保存します。
  • Excelで開くと、SKUの先頭の「0」が消えることがあります。handle列を残しておけば handle で商品を特定するので問題ありません(handle は変更しないでください)。


5️⃣ アップロードして登録する

  1. 「3. CSVをアップロードして登録」の「ファイルを選択」で、保存したCSVを選びます(1回に1ファイル、最大5,000行・5MB)。
  2. 「読み込んで登録」を押します。
  3. 処理が終わるまで、そのままお待ちください(ボタンが読み込み中の表示になります)。

文字コードは「自動判定(推奨)」のままで大丈夫です。文字化けする場合だけ、「列の説明・文字コード・その他の書き出し」の「取り込み時の文字コード」で UTF-8 か ShiftJIS を選んでください。


6️⃣ 結果を確認する

読み込み後、画面に結果が表示されます。

表示 意味
登録 N 件 正しく登録できた商品の数
スキップ N 件 食品欄がすべて空で、変更しなかった行(スキップが無いときは表示されません)
エラー N 件 登録できなかった行。その行だけ保存されていません(ほかの行は登録済み)
登録済み・要確認 登録はできたが、確認してほしい点がある行(例:原材料名に「乳」があるのにアレルゲン列に無い)

エラーや要確認の行は「行N」と handle・メッセージで表示されます。エラーの行だけ直して、もう一度アップロードすれば大丈夫です。


よくあるエラーと直し方

メッセージ 原因と直し方
不明なアレルゲン: 〇〇(29品目の表記のみ可) アレルゲン名が正式名ではありません。「たまご」→「卵」、「エビ」→「えび」のように直します。
〇〇: 「△△」は使えません(…のいずれかで入力してください) 決まった言葉の列に違う言葉が入っています。表の言葉に直します(全角の「100g」もエラーになります)。
handle「〇〇」の商品が見つかりません handle が変わっています。ダウンロードしたCSVの handle をそのまま使ってください。
SKU「〇〇」の商品が見つかりません SKUの先頭の0が消えた可能性があります。handle 列に正しい handle を入れてください。
栄養成分「〇〇」: 「△△」を数値として読み取れません 数値の書き方が違います。「120kcal」「0.5g」のように書き、カンマは使いません。
CSVの解析で問題がありました ファイル全体が取り込まれていません。列の数がずれていたり、引用符が閉じていない行があります。CSV形式で保存し直してください。
列名が重複しています 同じ列名が2つあります。片方を削除してください。
handle か sku のいずれかが必要です handle と sku が両方空の行があります。


よくある質問

  • Q. 商品名を変えたら名称に反映されますか?
    A. いいえ。「商品名(参照用)」は取り込まれません。名称は「名称」列に書きます。
  • Q. 食品表示を丸ごと消したい。
    A. CSVではなく、商品の編集画面の「この商品の入力データを削除」を使ってください。
  • Q. 商品ページの表示順などの設定も消えますか?
    A. いいえ。CSVに無い設定はそのまま残ります。
  • Q. 同じ商品が2行あったら?
    A. 後の行の内容で上書きされ、「要確認」が表示されます。


※本アプリは食品表示の整理・表示・入力補助を行う運用支援ツールです。食品表示法等への準拠を保証・判定するものではありません。表示内容の最終確認はショップ側で行ってください。