ネクストエンジン(NE)でCSVを取り込もうとして「文字化けする」「エラーで弾かれる」「列がズレる」——。原因はほぼ 文字コード・項目マッピング(ヘッダー名)・必須列の欠け の3つに絞れます。まず結論を出し、そのまま直せる手順と、つまずき項目の早見表をまとめました。
Shift-JIS(CP932)。ExcelやスプレッドシートでUTF-8のまま保存すると文字化けします。商品コード のような主キー列が欠けている/空欄だと、その行ごと弾かれます。以下、つまずく具体項目を早見表にし、文字コード→マッピング→必須列の順で直していきます。
ネクストエンジンのCSV出力・取込で実際に多い詰まりどころと、原因・回避手順の対応表です。エラーが出たら、まずこの表で症状を探してください。
| 区分 | 症状 | 原因 | 回避手順 |
|---|---|---|---|
| 文字コード | 商品名が「譁�喧縺�」のように崩れる | UTF-8で保存/開いた | Shift-JIS(ANSI)で保存し直す |
| 文字コード | 先頭の列名が認識されない/先頭に変な記号 | UTF-8のBOM付き | BOMなし、または Shift-JIS で書き出す |
| マッピング | 取込時に項目が「未割当」になる | ヘッダー名が想定と不一致(全角空白・表記ゆれ) | NEの取込項目名に合わせる/前後の空白を除去 |
| マッピング | ヘッダー行ごとデータとして取り込まれる | 1行目をヘッダーに指定していない | 取込設定で「1行目は見出し」を指定 |
| 必須列 | 「商品コードが必要です」等で行が弾かれる | 主キー列の欠け/空欄 | 必須列を埋める(後述の必須列表) |
| 必須列 | 在庫が0や空欄で意図せず更新される | 空欄の扱いが「0」または「変更なし」 | 更新したい列だけ残し、空欄の挙動を確認 |
| 形式 | JANコード・電話番号の先頭0が消える | Excelが数値化(ゼロ落ち) | 列書式を「文字列」に/エディタで確認 |
| 形式 | 1行が途中で切れて列がズレる | 値にカンマやセル内改行が混入 | 値を " で囲む/改行を除去 |
ネクストエンジンが書き出すCSV、および取り込むCSVは原則 Shift-JIS(CP932)です。一方、Excelの「CSV UTF-8」やGoogleスプレッドシートの書き出しはUTF-8になりがちで、これがそのままだと文字化け・取込エラーの最大の原因になります。
ANSI を選ぶ(Windows日本語環境では ANSI=Shift-JIS相当)。Shift-JIS で保存されます。ANSI で保存し直すと安全です。ANSI で保存し直してから取り込むのが確実です。ネクストエンジンの取込は、CSVの列(ヘッダー名)とNE側の項目を1対1で対応づけて進みます。ヘッダー名が想定と違う・余分な空白が入っていると「未割当」になり、その列は取り込まれません。よくある表記ゆれと、合わせ先の例です。
| NEの取込項目(例) | CSV側でありがちなヘッダー | 対処 |
|---|---|---|
| 商品コード | 商品コード/item_code/SKU/商品ID | NEの項目名に統一。半角英数で揃える |
| 商品名 | 商品名/商品名称/タイトル/title | NEの項目名に統一 |
| 在庫数 | 在庫数/在庫/数量/stock | 半角整数。空欄の扱いを事前確認 |
| 売価(販売価格) | 売価/販売価格/価格/price | 半角数字のみ。カンマ・「円」「¥」を入れない |
| JANコード | JAN/JANコード/バーコード/GTIN | 文字列扱い。先頭0を保持 |
ポイントは2つ。(a) ヘッダー名はNEの取込項目名に合わせて統一する、(b) ヘッダー前後やセル内の全角・半角スペースを除去する。表記ゆれと不可視スペースが、未割当・別商品扱いの二大原因です。
商品マスタ系の取込では、主キーとなる 商品コード が欠けていたり空欄だと、その行が丸ごと弾かれます。代表的な列と形式の注意点を、実テーブルでまとめます(※実際の必須項目は契約・設定により異なるため、最終的にはNEの取込画面の項目を基準にしてください)。
| 列(代表例) | 必須度 | 形式・注意 |
|---|---|---|
| 商品コード | 必須(主キー) | 半角英数。重複不可。既存と一致→更新、なければ新規になる挙動が一般的 |
| 商品名 | 必須に近い | 全角可。カンマを含む場合は " で囲む |
| 在庫数 | 条件付き必須 | 半角整数。空欄が「0」か「変更なし」かは設定で挙動が変わる |
| 売価/販売価格 | 条件付き | 半角数字のみ。桁区切りカンマ・通貨記号を入れない |
| 区分・ステータス等 | 任意 | コード値(数値や決められた語)で指定する項目に注意 |
「全行が弾かれる」ときは必須列の欠け、「一部だけ弾かれる」ときはその行の必須セルが空欄か形式違反(全角数字・記号混入)を疑うと早いです。
" で囲み、不要な改行を除去する。上の項目は、取り込んでエラーが出てから直すより、送る(取り込む)前にまとめて点検するほうが圧倒的に速いです。文字コード(Shift-JIS / UTF-8 / BOM)の判定、ヘッダーの空白・表記ゆれ、必須列の欠け・空欄、ゼロ落ちの兆候、列数のズレ——このあたりは目視より機械で一括チェックするのが確実です。
ネクストエンジンに取り込む前のCSVを、文字コード・ヘッダー・必須列・列ズレまでまとめて検査したい方へ。ファイルをアップロードするだけで、ブラウザ内(ファイルは送信しません)で一括チェックできます。集計やエラー探しはツールで一発です。