NetSuiteのCSVインポート・一括データ更新の方法｜よくあるエラーと対処

「CSVで一括登録したら、同じ顧客が2件になった。どこを間違えたのか」

NetSuiteにデータをまとめて入れる担当者から、よく受ける質問です。

文字化けや日付のエラーも、同じくらい多く聞きます。

NetSuiteのCSVインポートとは、CSVファイルから顧客や品目などのレコードを、まとめて登録・更新できる標準機能です。

画面の案内（Import Assistant）に沿って、5つの手順で進めます。

重複の原因は、ほとんどの場合、操作ミスではありません。

更新のときに、どのレコードかを示すIDを対応づけていないことです。

エラーの多くは、取り込む前のIDの決め方とデータの整え方で起きています。

では、取り込む前に何を決めておけば、エラーの出ない取り込みになるのか。

この記事で分かること

• CSVインポートの5つの手順と、1ファイルあたりの上限
• CSVインポートとMass Update（一括更新）の使い分け
• 文字化け・日付・重複など、よくあるエラーの原因と対処
• CSVで足りる会社と、連携の仕組みにしたほうがよい会社の見分け方
• 移行前の会社と、運用中の会社それぞれの進め方

言葉の整理：CSVは、項目をカンマで区切ったテキストファイルです。

レコードは、顧客や品目など、NetSuiteの中の1件1件のデータです。

CSVインポートの基本

できること

CSVインポートでは、次の3つの扱いを選べます。

扱い	意味	使う場面
Add	新しく登録するだけ	初めて入れるマスタ
Update	既存のレコードを直すだけ	単価や担当者の一括の変更
Add or Update	あれば更新、なければ登録	旧システムとの定期の同期

顧客・品目・仕訳・在庫など、多くのレコードに使えます。

使える範囲は、ロール・権限・有効な機能で変わります。

CSVインポートはテンプレート不要です。

NetSuiteが配る決まった様式はなく、手元のCSVをそのまま使えます（出典：Oracle NetSuiteのヘルプ）。

最初に押さえる2つのID

• 内部ID（Internal ID）：NetSuiteが自動で振る、レコードごとの番号
• 外部ID（External ID）：旧システムの番号など、外から持ち込む識別子

更新するときは、どちらかのIDで「どのレコードか」を指定します。

冒頭の重複も、この2つのどちらも対応づけなかったことから起きます。

CSVインポートの5つの手順

場所は「Setup > Import/Export > Import CSV Records」です（出典：Oracle NetSuiteのヘルプ）。

画面はバージョンで変わるため、操作中は画面の案内もあわせて見てください。

5つの手順を図にすると、次のとおりです。

1. データを準備する：列に項目を並べ、必須の項目の空欄をなくす。文字コードを決める
2. 扱いを選ぶ：Add／Update／Add or Update。更新なら内部IDか外部IDの列を用意する
3. 項目を対応づける：CSVの列とNetSuiteの項目を結ぶ。列名を項目名に合わせると自動で結ばれやすい
4. 設定を保存する：対応づけに名前を付けて保存する。次回から再利用でき、他のユーザーとも共有できる
5. 実行して結果を見る：ステータスのページで処理の状況を見る

1ファイルは25,000件まで

公式ヘルプでは、1ファイルあたり25,000件が上限とされています。

大きなファイルは分けて、別のジョブとして取り込むと速くなると案内されています（出典：Oracle NetSuite公式ヘルプ、2026年9月確認）。

実行したら、会社ごとの順番待ちに入る

実行したインポートは、会社ごとのキュー（順番待ちの列）に入ります。

先に別のジョブがあれば、終わるまで待機します（出典：Oracle NetSuite公式ヘルプ、2026年9月確認）。

月末のように取り込みが重なる時期は、時間に余裕を持たせてください。

エラーの見方

エラーがあると、内容をまとめたファイルがメールで届きます。

送り先は、インポートを始めたユーザーのアドレスです。

ファイルには、エラーのある列名と行が書かれています（出典：Oracle NetSuiteのヘルプ）。

一括データ更新（Mass Update）との使い分け

既存のデータをまとめて直す方法は、2つあります。

方法	やり方	向く場面	注意
CSVインポート（Update）	ファイルで外のデータを持ち込む	旧システムの値を反映する	IDで突合しないと重複する
Mass Update	条件を指定し、NetSuiteの中で一括で変える	条件に合うレコードに同じ変更をかける	実行後は止められない

Mass Updateは「Lists > Mass Update > Mass Updates」から使います。

実行の前にプレビューで、変わるレコードを見られます。

ただし「Perform Update」を押した後は、止めることも取り消すこともできません。

定義するには、Mass Updatesの権限が要ります（出典：Oracle NetSuite公式ヘルプ、2026年9月確認）。

目安は、外のデータを持ち込むならCSV、中の条件で一括に変えるならMass Updateです。

よくあるエラーと対処

エラー	主な原因	対処
文字化け	CSVの文字コードと選んだ文字コードが違う	保存した文字コードと、取り込むときの選択をそろえる
日付のエラー	アカウントの日付の形式とCSVの値が違う	先頭のゼロを外す（08/01→8/1）。表計算の書式を合わせる
必須の項目の不足	空欄、または対応づけの漏れ	必須の項目を埋め、対応づけを見直す
重複・誤った更新	更新でIDの突合をしていない	更新ではID列を必ず対応づける
国名の参照エラー	国を「コード」で入れている	コードではなく国名で入れる
子会社が不正	OneWorldで子会社の指定が漏れる・表記が違う	子会社を「親：子」の階層名で書く
選択肢の値が合わない	大文字・小文字・空白が違う	既存の値と完全に一致させる
権限のエラー	ロールにインポートの権限がない	必要な権限を付ける

OneWorldは、複数の子会社を1つのNetSuiteで管理する版のことです。

これらのエラーを防ぐために、取り込む前に確かめることを図にまとめます。

日本語の環境で気をつける3点

日本語の環境では、エラーが文字コード・日付・金額に集まります。

• 文字コード：選べる文字コードにUTF-8とShift-JISがあります。既定は言語の設定で変わり、日本語の設定ではShift-JISです（出典：Oracle NetSuite公式ヘルプ、2026年9月確認）
• 日付：アカウントの日付の形式に合わせます
• 金額：日本円は整数で扱い、小数を付けません（出典：Oracle NetSuiteのヘルプ）

表計算ソフトで保存し直すと、文字コードが意図せず変わることがあります。

文字化けしたら、まず保存した形式と取り込むときの選択を見比べてください。

エラーの文面は、AIに読ませて原因を絞る

エラーのファイルとCSVを生成AIに渡すと、原因の候補を行ごとに出せます。

上の表にない、取引の取り込みで多いエラーを3つ挙げます。

エラーの文面	AIに頼むこと	人が確かめること
一意キーが設定されていません	一意キーにする列を選び、外部ID列を作る	今後も重複しない付け方か
既に存在します	CSV内と取込済みで外部IDが重なる行を抜く	同じ取引か、別の取引か
金額を入力してください	単価の空欄と、カンマや円記号の混入を分ける	品目の基本価格の設定

（出典：Oracle NetSuite公式ヘルプ「General Transaction Import Errors」、2026年9月確認）

（出典：NetSuite Professionals「7 Common NetSuite CSV Import Errors」、2026年9月確認）

例を1つ挙げます（サンプルは架空です）。

外部ID「LEG-101」が2行あるCSVと、取込済みの外部ID「LEG-103」の一覧を渡す。

AIは、LEG-101をCSV内の重複、LEG-103を「既に存在」の原因と判定した。

AIの答えは下書きです。

重なった外部IDは保存検索で開き、同じ取引かを人が見てから入れ直します。

取り込む前の整形は、CSVインポート前の整形はAIに任せるで扱っています。

取り込み方法の選び方

方法	向く件数・頻度	手間	やり直しやすさ
画面から手入力	数件・まれ	件数に比例して増える	1件ずつ直せる
CSVインポート	数百〜数万件・移行や月次	ファイルの準備が中心	保存した対応づけで入れ直せる
Mass Update	NetSuiteの中の条件で一括	条件の定義だけ	実行後は止められない
API・iPaaSの連携	毎日・常時	設計と保守が要る	仕組みで再実行できる

iPaaSは、複数のシステムをつなぐクラウドの仲介サービスです。

決め手になるのは、件数より頻度です。

常時の連携はNetSuiteの連携方法まとめで扱っています。

判断の物差し｜CSVで足りる会社・足りない会社

CSVインポートが合う会社

• 導入時の移行など、一度きりか月に数回の取り込み
• 取り込む元のデータの形が、毎回ほぼ同じ
• 担当者が、表計算でデータを整えられる

ほかの方法が合う会社

• 毎日取り込む、または件数が多い：APIやiPaaSでの連携が向く。CSVの手作業は、担当者が替わると止まりやすい
• NetSuiteの中の条件で一括に直したい：Mass Updateが向く
• 数件だけ：画面から直したほうが早く、確認も簡単
• 元のデータが整っていない：いまは入れない選択もある。先に旧システム側で整理するほうが、結果として早く終わる

これから移行する会社と、いま運用している会社

これからNetSuiteに移行する会社

初期の移行は、次の順で進めます。

1. 移すデータと、移さないデータを仕分ける
2. 外部IDの付け方を決める（旧システムの番号を使うかなど）
3. 顧客・品目などの「親」を先に、取引などの「子」を後に入れる
4. 数件で試し、結果を見てから本番に入れる

サンドボックス（本番に影響しない試験環境）が使えるなら、先にそこで試します。

詳しくはNetSuiteのサンドボックスをご覧ください。

移行全体の進め方は基幹システムのデータ移行ガイドで扱っています。

いま運用していて、取り込みを見直したい会社

次のサインがあれば、見直しの時期です。

• 毎月、同じCSVを手で整えてから取り込んでいる
• 取り込みの担当者が1人しかいない
• エラーのたびに、前任者やパートナーに聞かないと直せない

まず、保存した対応づけに何が決めてあるかを書き出します。

頻度が高い取り込みは、連携の仕組みに置き換える候補です。

いまのパートナーで見直しが進まないなら、別のパートナーに相談する道もあります。

よくある3つの失敗

失敗1：IDのルールを決めずに、本番に入れる

起きること：更新したはずのレコードが新しく追加され、顧客が重複する。

原因：内部IDと外部IDの使い方を決めず、突合しないまま取り込んだ。

避け方：外部IDの付け方を先に決めます。数件で試してから、本番に入れてください。

失敗2：旧システムのデータを、丸ごと移す

起きること：使わない項目や古いデータで、稼働の前から画面が複雑になる。

原因：「なぜこの列が要るか」を仕分けないまま移した。

避け方：移行を、業務の棚卸しの機会にします。

使うデータと、惰性で残してきたデータを分けるのは、経営の判断です。

進め方は、次の章の「整理整頓してから移す」で示します。

失敗3：大量のデータを、一度に入れる

起きること：一部が失敗しても、どこで失敗したのか追えない。

原因：親と子のデータを同じファイルに入れ、件数でも分けていなかった。

避け方：種類と件数で分けます。1ファイル25,000件の上限より小さく分けると、処理も速くなります。

3つに共通するのは、CSVの取り込みを「入れる作業」と捉えていることです。

実際には、どのデータをどう持つかを決める、会社の情報の土台づくりです。

ベンチャーネットならこう見る

NetSuite認定パートナー（Solution Provider）であるベンチャーネットは、取り込みの相談を2つの型で受けています。

NetSuite・Odoo・AIスクラッチ開発を扱い、SAPからのリプレイスにも対応しているため、移す前の業務から見ます。

整理整頓してから移す｜見える化→整理整頓→Fit&Gap

移行のCSVを作り始める前に、いまの業務フローを現場に聞いて描きます。

次に、やめる・まとめる・そろえる業務を決めます。

移すデータが決まるのは、この整理整頓の後です。

そのうえで、NetSuiteの標準機能と照らし合わせます。

標準の項目に収まらないデータは、3つから選びます。

標準に合わせる、開発する、残す。

この選択が決まれば、CSVの列も決まります。

失敗2の「丸ごと移す」は、この順番を飛ばしたときに起きます。

頻度で方法を決め、直す人を2人にする

ベンチャーネットの仕事は、ゼロからの導入より、他社のあとの引き継ぎと、他のシステムとの連携が多くを占めます。

引き継ぎでは、取り込みの手順が前任者の頭の中にしかないことがあります。

そこで、最初の打ち合わせでは次の3つを伺います。

1. その取り込みはどのくらいの頻度か：一度きりか、毎月か、毎日か
2. IDは決まっているか：外部IDの付け方と、更新の突合の方法
3. 失敗したとき誰が直すか：担当者が1人に偏っていないか

頻度が低く、形が決まっているならCSVで十分です。

毎日の取り込みなら、連携の仕組みを勧めます。

逆に、連携を作る費用に見合わない量なら、CSVのままを勧めることもあります。

今日できること｜取り込みの棚卸し表を作る

いまNetSuiteに取り込んでいるデータを、次の表に書き出してみてください。

取り込むデータ	頻度・件数	担当者	使うID
（例）品目の単価	月1回・約800件	購買の担当	外部ID

あわせて、保存した対応づけの名前も横に書いておきます。

担当者が1人しかいない行と、IDの欄が空の行が、先に手を打つ場所です。

頻度が「毎日」の行は、連携の仕組みに置き換える候補になります。

よくある質問

Q1. 一括登録と一括更新の違いは何ですか

外から持ち込むならCSVインポートです。中の条件で直すならMass Updateです。

CSVインポートではAdd・Update・Add or Updateを選べます。

ファイルを使わず、条件で既存のレコードを変えるならMass Updateが向きます（第3章）。

Q2. 更新したら、レコードが重複しました

内部IDか外部IDで突合していない可能性が高いです。

IDがないと、NetSuiteは同じレコードだと判断できず、新しく追加します。

更新ではID列を必ず対応づけてください（第4章）。

Q3. 日本語が文字化けします

CSVの文字コードと取り込むときの選択をそろえます。

選べる文字コードにUTF-8とShift-JISがあり、日本語の設定の既定はShift-JISです。

表計算ソフトで保存し直したときに、文字コードが変わっていないかも見てください（第4章）。

Q4. 一度に何件まで取り込めますか

公式ヘルプでは1ファイル25,000件までです。

大きなファイルは分けて、別のジョブで取り込むと速くなります。

毎日の大量の取り込みは、APIなどの連携も検討します（第2章・第5章）。

Q5. 失敗したときは、どうやり直しますか

届いたエラーのファイルで原因を直し入れ直します。

保存した対応づけを使えば、同じ設定のまま入れ直せます。

Mass Updateは実行後に止められないため、必ずプレビューで変わるレコードを見てから実行します（第2章・第3章）。

Q6. 取り込みの権限は、誰に付ければよいですか

取り込みを担う人に絞って付けます。

多くの人が取り込めると、誰がいつ変えたか追いにくくなります。

権限の考え方はNetSuiteの権限・ロール設計で扱っています。

Q7. エラーの原因は、AIで調べられますか

エラーのファイルとCSVを渡せば候補を出せます。

直してよいかの判断と、入れ直す操作は人が行います（第4章4-2）。

まとめ

• CSVインポートは、CSVからレコードをまとめて登録・更新する標準機能
• 更新は内部IDか外部IDで突合する。しないと重複する
• 公式の上限は1ファイル25,000件。小さく分けると速い
• 日本語の環境は文字コード・日付・金額に注意
• 毎日の取り込みは連携、中の条件での変更はMass Update、数件なら画面

取り込む前に決めておくのは、IDの付け方と、移すデータの範囲です。

この2つが決まれば、冒頭の重複はまず起きません。

次の取り込みでは、数件で試してから本番に入れてください。

もう少し詳しく知りたい方へ

取り込みをCSVのままにするか、連携の仕組みにするか。

頻度と件数を伺ったうえで、見合う方法をお伝えします。

• NetSuite開発・カスタマイズ・連携の支援
• SaaS型クラウドERP NetSuite導入支援サービス
• お問い合わせ

あわせて読みたい

• ネクストエンジン×NetSuite連携ガイド｜API・CSV・iPaaS 3方式の選び方
• NetSuiteのハンディ連携、純正で足りない時どうする？
• ExcelからNetSuiteへ移行すべきタイミング