CSV取り込みが通らない時｜項目ズレを最短で直す確認順

CSV取り込みが通らない時｜項目ズレを最短で直す確認順

人事労務システムのCSV取り込みで『通らない』『エラーになる』原因は、必須項目不足・項目名ズレ・区切りや改行・社員番号などの整合が多い。項目ズレを最短で直す確認順と、失敗しにくい作り方を解説。

CSV取り込みが通らない時｜項目ズレを“最短で直す”確認順

CSV取り込みエラーって、原因が一つに見えて、実は小さいズレが積み重なっていることが多いです。

しかも「どこが悪いか分からない」まま時間が溶けやすい。ここは順番が大事です。


よくある症状はこんな感じ。


  • アップロードしたら「形式が違います」「項目が不足しています」と出る


  • 途中まで取り込めるが、特定行で止まる


  • エラーが曖昧で、どの列が悪いか分からない


  • 同じCSVなのに、別の環境では通る/通らない


結論：CSVは「サンプルを土台にする」と最短で通る


CSVをゼロから作るほど、ズレが増えます。

最短ルートはこれです。


  • システムが用意するサンプルCSVを必ず使う


  • 列の増減・並び替えをしない（できるだけ）


  • 社員番号などキー項目を最初に固める


ポイント

「項目ズレ」は、だいたい“列の作り方”で起きます。

サンプルCSVを土台にすると、ズレる確率が一気に下がります。


最短で直す確認順（ここだけ見れば迷いにくい）






































順番 確認すること よくあるミス 直し方の方向
1 サンプルCSVと同じ形式か 列の追加・削除・並び替え サンプルに戻す
2 必須項目が埋まっているか 空欄、0扱い、未選択 必須だけ先に埋める
3 社員番号などキーが重複/欠けてないか 重複、空欄、桁違い キーのルール統一
4 区切り文字・改行・引用符の崩れ カンマ混入、改行混入 テキストで確認
5 文字コード（UTF-8/Shift-JIS） Excel保存で変わる 指定に合わせる

コツ

いきなり全件で試すと、エラーの場所が追いにくくなります。

まずは10行だけで通る形を作って、そこから増やす方が早いです。


①サンプルCSVに戻す（“通る形”を先に作る）


一番多いのが「自分で列を作った」「列を並べ替えた」パターン。

まずは潔く、サンプルCSVに戻すのが近道です。



  • 列名は変えない


  • 列の順番は変えない


  • 不要な列でも消さない（空欄で残す）


この状態で10行だけ入れて通るか確認すると、次の作業が一気に楽になります。


②必須項目は“必須だけ”埋める（最初から完璧を狙わない）


取り込みが通らない時、全部の項目を埋めようとして余計に崩れることがあります。

最初は、必須項目だけでOK。



























よく必須になりやすい項目 例 注意
社員番号 000123 桁・ゼロ埋めのルールを統一
氏名 山田花子 異体字は置換ルールが必要な場合あり
所属 営業部 マスタ名と一致が必要なことがある
雇用形態 正社員 選択肢が固定の場合、表記がズレると弾かれる

ポイント

「未選択」が許されない項目は、空欄にすると止まりやすいです。

まずは必須を埋めて“通る形”を作るのが先です。


③社員番号（キー）が壊れると、全部がズレる


CSV取り込みで一番痛いのが、社員番号などのキーが揺れること。

ここが揺れると「同じ人が二人になる」「更新されない」などの事故が起きやすいです。



  • 空欄がないか


  • 重複がないか


  • ゼロ埋め（000123）を統一しているか


  • 数値扱いになって桁が落ちていないか（Excelがやりがち）


小さな事故あるある

Excelで社員番号を開いたら、先頭のゼロが消えて「123」になってしまい、別人扱いになった。

こういうの、気づくのが遅いほど直しが大変です。


④区切り・改行・引用符：住所や備考に“カンマ”が入ると崩れる


CSVはカンマ区切りが多いので、データの中にカンマが混ざると列がズレます。

住所や備考欄が原因になりやすいです。






















原因になりやすい欄 例 起きること
住所 〇〇ビル, 3F 列が1つずれて以降全部が崩れる
備考 要確認, 次回面談 途中行でエラーになる
改行混入 メモが複数行 行が割れて別レコード扱い

ポイント

テキストエディタでCSVを見ると、列ズレや改行混入が見つけやすいです。

Excelだけで追うと見えにくいことがあります。


⑤文字コード：最後に合わせる（先にいじると混乱しやすい）


文字コードは大事ですが、項目ズレの原因としては「最後」に来ることが多いです。

まず形（列）を揃えて、最後に文字コードを指定に合わせる方が、作業が短くなります。


通るCSVを作る手順（Step1-3）



  1. Step1：サンプルCSVを土台にして10行で通す


  2. Step2：必須項目と社員番号（キー）を先に固める


  3. Step3：問題が起きやすい欄（住所・備考）を最後に入れる


質問と回答


Q1. エラーが曖昧で原因が分かりません

まず10行のテストCSVで通る形を作るのが早いです。全件で試すほど原因の切り分けが難しくなります。


Q2. 途中の行だけ止まります

住所や備考のカンマ混入、改行混入が多いです。テキストでCSVを見て、列や行が崩れていないか確認すると見つかりやすいです。


Q3. 社員番号が勝手に変わります

Excelが数値として扱って先頭ゼロを落とすことがあります。社員番号は文字列扱いで統一すると安全です。


Q4. マスタ名（所属など）が合いません

取り込み側が“選択肢固定”の場合、表記が一致しないと弾かれます。マスタの名称を先に揃えるのが近道です。


Q5. システム選びでCSV移行は見た方がいい？

見た方がいいです。サンプルCSV、エラー表示、取り込みプレビューがしっかりしていると導入負担が減ります。


まとめ：項目ズレは順番で直すと早い



  • サンプルCSVを土台にする（列を動かさない）


  • 必須項目と社員番号（キー）を先に固める


  • 住所・備考のカンマ/改行混入に注意


  • 10行テスト→通ったら増やす



人事・労務管理システムおすすめランキングを見る

次の記事：権限設定ミスで見える事故が起きる（最小権限の決め方）へ