NetSuiteに大量のデータを登録・更新したいとき、画面から1件ずつ手入力するのは現実的ではありません。
そこで使うのが、CSVインポートです。CSV（カンマ区切りのテキストファイル）を使えば、たくさんのレコードを一度に登録・更新できます。
ただ、いざやってみると「文字化けする」「エラーで止まる」「更新したはずが重複した」とつまずく方が多いのも事実です。
この記事では、NetSuiteのCSVインポートの基本手順から、一括データ更新のやり方、よくあるエラーと対処までを、実務目線でまとめます。
この記事で分かること
- NetSuiteのCSVインポート（CSV Import Assistant）の基本手順
- 一括データ更新（Mass Update）との使い分け
- 文字化け・日付・ID重複など、よくあるエラーと対処法
- データ移行でつまずかないための、設計のコツ
読了目安：約7分
NetSuiteのCSVインポートとは
NetSuiteのCSVインポートは、CSVファイルからレコードをまとめて登録・更新できる標準機能です。
この機能は「CSV Import Assistant（インポートアシスタント）」と呼ばれ、画面の案内に沿って進められます。
CSVインポートでできること
- 新しいレコードの登録（Add）
- 既存レコードの更新（Update）
- 登録と更新の両方を一度に（Add or Update）
顧客・品目（アイテム）・仕訳・在庫など、多くのレコード種類に対応しています（対応範囲はロール・権限・有効な機能によって変わります）。
最初に押さえたい用語
- レコード：顧客や品目など、NetSuite上の1件1件のデータ
- 内部ID（Internal ID）：NetSuiteが自動で振る、レコード固有の番号
- 外部ID（External ID）：旧システムなど、外部の識別子をひもづけるための番号
この「ID」が、後ほど重要になります。
なお、CSVインポートはテンプレート不要です。NetSuiteが配る決まった様式は必要なく、任意のCSVファイルをそのまま使えます（出典：docs.oracle.com）。
CSVインポートの基本手順（5ステップ）
CSV Import Assistantは、5つのステップで進みます。場所は「Setup > Import/Export > Import CSV Records」です（出典：docs.oracle.com）。
ここでは流れを整理します。実際の画面はバージョンにより異なるため、操作中は画面の案内も合わせて確認してください。
① データを準備する
- 取り込みたい項目を列にしたCSVを用意する
- 文字コードを決める（日本語環境では特に重要。後述）
- 必須項目に空欄がないか確認する
② インポート種別（データの扱い）を選ぶ
- Add：新規登録のみ
- Update：既存レコードの更新のみ
- Add or Update：あれば更新、なければ登録
更新（Update／Add or Update）を選ぶ場合は、内部IDまたは外部IDを必ず項目として用意します。これがないと、どのレコードを更新すべきか特定できません（出典：docs.oracle.com）。
③ フィールドマッピング
CSVの列と、NetSuiteの項目を対応づけます。
列名をNetSuiteの項目名に合わせておくと、自動でマッピングされやすくなります。
④ 検証・マッピングの保存
マッピングに名前を付けて保存します。保存したマッピングは次回以降に再利用でき、他のユーザーと共有もできます。
⑤ 実行とジョブの確認
実行すると、処理状況はステータスページで確認できます。
エラーが出た場合は、その内容をまとめたファイルがメールで届きます。送り先は、インポートを開始したログインユーザーのアドレスです。ファイルには、エラーのある列名と該当行数が記載されます（出典：docs.oracle.com）。
一括データ更新（Mass Update）のやり方
「既存データをまとめて直したい」とき、方法は2つあります。
CSVインポート（Update）
- ファイルを使って、外部のデータで上書き・更新する
- 旧システムの値などを反映したいときに向く
Mass Update（一括更新）
- ファイルを使わず、条件を指定してNetSuite内で一括更新する
- 「特定条件のレコードに同じ変更をかける」ときに向く
どちらも既存レコードの更新に使えます（出典：docs.oracle.com）。
使い分けの目安は、外部のデータを持ち込むならCSV、NetSuite内で条件指定して一括変更ならMass Updateです。
CSVで更新するときの最重要ポイントは、内部IDか外部IDで突合することです。ここを省くと、更新のつもりが新規追加になり、レコードが重複します。
よくあるエラーと対処
CSVインポートでつまずきやすいエラーを、原因と対処で整理します。
| エラー | 主な原因 | 対処 |
|---|---|---|
| 文字化け | CSVの文字コードが環境と合っていない | 文字コードを統一して保存。日本語環境ではUTF-8またはShift-JISを選択 |
| 日付エラー（無効な値・日付の前後逆など） | アカウントの日付形式とCSVの値が不一致 | 先頭のゼロを外す（08/01→8/1）。Excelの「セルの書式設定」でNetSuiteの形式に合わせる |
| 必須項目の不足 | 必須フィールドが空、またはマッピング漏れ | 必須項目を埋め、マッピングを再確認 |
| レコードの重複・誤更新 | 更新時に内部ID／外部IDで突合していない | 更新はID列を必ずマッピング。種別（Add／Update／Add or Update）の意味を理解する |
| 国名の参照エラー（例：Invalid country reference key US） | 国名を「コード」で入れている | コードではなく国名で入力する |
| 子会社（Subsidiary）が不正 | OneWorld環境で子会社が未指定・表記不一致 | 該当レコードに子会社を指定。「親：子」の階層名で記述 |
| 値が一致しない（選択リスト等） | CSVの値がNetSuiteの選択肢と完全一致しない | 大文字小文字・スペースまで含めて既存値に一致させる |
| 権限エラー | ロールにインポート権限がない | 必要な権限（または管理者権限）を付与 |
💡 日本語環境での注意
日本語環境では、エラーの多くが「文字コード」「日付形式」「金額」に集中します。
日本円は整数で扱い、小数を付けません（¥123であって¥123.45ではない）。文字コードはShift-JISが使われる場面も多いため、保存形式を必ず確認しましょう（出典：docs.oracle.com）。
なお、環境によっては前提となる制約もあります。たとえば日本向けの税・請求機能（Japan Localization SuiteApp）は、SuiteTaxと現時点では併用できません。導入環境によって挙動が変わるため、設計段階での確認をおすすめします（出典：docs.oracle.com）。
データ移行・CSV取込でつまずくポイント
CSVインポートは便利な機能です。ですが、つまずく企業には共通点があります。
エラーの多くは、操作ミスではありません。その手前の「データ設計」でつまずいています。
ここでは、ベンチャーネットが現場でよく見る4つのパターンと、回避策をお伝えします。
これは、NetSuiteを売り込みたいからではありません。「失敗してほしくない」という思いから書いています。
データ設計をせず、いきなり本番に入れる
よくある現象
- テンプレートを埋めて、すぐ本番にインポート
- 内部ID・外部IDのルールを決めていない
- 数件での試し取込をしない
なぜつまずくか
NetSuiteは、レコードを「ID」で識別します。
IDの設計がないまま入れると、重複・上書き・参照切れが連鎖します。一度崩れたデータは、後から直すほうが大変です。
どう回避するか
まずは数件だけ入れて、結果を確認しましょう。検証してから本番に進む。「小さく試して、動かしながら直す」のが、結局いちばん速い道です。
業務の棚卸しをせず、現行データを丸ごと移行する
よくある現象
- 旧システムの全項目を、そのまま持ち込む
- 「なぜこの列が必要か」を誰も説明できない
- 使っていないデータも一緒に移行する
なぜつまずくか
不要・不整合なデータは、新しいNetSuiteを最初から汚します。
過去の「とりあえず残してきたもの」を引き継ぐと、運用が始まる前から複雑になります。
どう回避するか
データ移行は、業務を棚卸しする絶好の機会です。
「本当に使うデータ」と「惰性で残してきたデータ」を仕分ける。これは単なる作業ではなく、経営の仕事です。
大量データを一度に入れようとする
よくある現象
- 数万件を1ファイルで一括投入
- 親データと子データを同時に入れる
- 一部が失敗しても、原因を追えない
なぜつまずくか
一括投入は、エラーの切り分けが困難です。
どこで失敗したのか分からず、やり直しもしづらくなります。
どう回避するか
レコードの種類や件数で分割しましょう。
顧客や品目などの「親」を先に、取引などの「子」を後に。依存関係の順で段階的に入れると、つまずいても戻れます。
なお、件数が非常に多い移行や、継続的なデータ連携もあります。その場合は、CSVより外部連携（SOAP／REST Webサービス）が向くことがあります（出典：docs.oracle.com）。
自社だけで進め、日本固有の制約で詰まる
よくある現象
- 公式ドキュメントだけを頼りに進める
- 日本固有の検証ルールや表記で、想定外のエラー
- 原因が分からず、手が止まる
なぜつまずくか
日本固有の業務要件や、標準機能の制約は、ドキュメントだけでは判断しづらい部分があります。
特に日本語環境では、文字コード・金額・日付などでつまずきやすくなります。
どう回避するか
制約を知っているパートナーと、最初の設計だけでも一緒に進める。
遠回りに見えて、いちばん安全です。
ここまでの4つに共通するのは、ある一つの考え方です。
それは、CSV取込を「データを入れる作業」だと捉えてしまうこと。
実際には、どのデータをどう持つかは、会社の情報の土台づくりそのものです。
だからこそ、最初から完璧を目指さなくて大丈夫です。
完璧より、まず回す。動かしながら磨いていく。
少量で試し、検証し、段階的に広げる。この進め方なら、大きな失敗は避けられます。
「うちのデータ、少し複雑かも」と感じた方は、お気軽にご相談ください。最初の設計から、一緒に考えさせてください。
よくある質問（FAQ）
Q1. 新規登録と一括更新（Mass Update）の違いは？
新規登録は、まだNetSuiteにないレコードを追加することです。一括更新は、既にあるレコードをまとめて変更することです。
CSVインポートでは「Add（登録）」「Update（更新）」「Add or Update（両方）」を選べます。ファイルを使わず条件指定で既存レコードを変えたいときは、Mass Update機能が向いています。
Q2. 更新したらレコードが重複しました。なぜ？
更新時に、内部IDまたは外部IDで突合していない可能性が高いです。
IDで突合しないと、NetSuiteは「同じレコード」と認識できず、新規追加してしまいます。更新時はID列を必ずマッピングしてください。
Q3. 日本語や日付でエラーが出ます。どうすれば？
まず文字コードを確認しましょう。日本語環境ではUTF-8またはShift-JISが基本です。
日付は、先頭のゼロを外す、Excelの書式をNetSuiteの日付形式に合わせる、といった対処が有効です。金額（日本円）は整数で扱い、小数を付けないようにします。
Q4. 一度に何件までインポートできますか？
明確な「上限件数」を意識するより、分割して段階的に入れるのが安全です。
数万件規模や継続的な連携では、CSVより外部連携（Webサービス）が適する場合もあります。件数や頻度に応じて方式を選びましょう。
Q5. 失敗したときのやり直しはどうすれば？
エラー時は、メールで届くエラーレポート（列名・該当行）を確認し、原因を直してから再実行します。
保存したマッピングは再利用できるため、修正版CSVで同じ設定のまま入れ直せます。最初に少量でテストしておくと、本番のやり直しが減ります。
まとめ：CSV取込は「作業」ではなく「設計」
NetSuiteのCSVインポートは、大量データを効率よく登録・更新できる強力な機能です。
手順そのものは、5ステップでシンプルです。つまずきの多くは、操作ではなく「IDの設計」「データの棚卸し」「文字コードや日付の整え方」にあります。
ポイントを整理します。
- 更新は内部ID／外部IDで突合する（重複防止）
- 少量でテストしてから本番に進む
- 日本語環境は文字コード・日付・金額に注意
- 大量・継続のデータは、CSV以外の方式も検討する
そして何より、データ移行は業務の棚卸しの好機です。「どのデータをどう持つか」は、会社の情報基盤づくりそのもの。完璧より、まず回す——その姿勢が成功への近道です。
NetSuite認定パートナー（Solution Provider）であるベンチャーネットは、初期のデータ移行・構築設計から運用まで、伴走してご支援します。「自社のデータ移行、少し不安だ」という方は、お気軽にご相談ください。
【CTA・第1】初期データ移行・構築設計の無料相談 ＜確定URLはSEO担当へ申し送り＞
【CTA・第2】NetSuite導入支援サービス詳細ページ ＜確定URLはSEO担当へ申し送り＞
関連記事（内部リンク）
- ネクストエンジン×NetSuite連携（API・CSV・iPaaS）：https://www.venture-net.co.jp/netsuite/next-engine-netsuite/
- 外部ハンディ・現場システムのNetSuite連携：https://www.venture-net.co.jp/netsuite/netsuite-external-handy-integration/
- ExcelからNetSuiteへ移行すべきタイミング：https://www.venture-net.co.jp/netsuite/netsuite-vs-excel/
- NetSuite導入プロジェクトの全体像 ＜未公開・公開後にリンク／SEO担当へ申し送り＞
- NetSuite SuiteTaxとJapan Localizationの非互換 ＜未公開・公開後にリンク／SEO担当へ申し送り＞
