投稿日:
更新日:
kintoneへCSVを自動で取り込む方法|cli-kintoneを使った基幹システム連携を実践解説

基幹システムから出力したCSVを、毎日手作業でkintoneへ取り込んでいる…
担当者が不在になるとCSVの取り込みが止まり、kintoneのデータが更新されない…
CSVの取り込みを自動化したいが、有料の連携ツールを導入する予算がない…
―――kintoneを活用する中で、このようなお悩みを感じていませんか?
kintone(キントーン)は、顧客管理や案件管理、売上管理など、さまざまな業務データを管理できるクラウドサービスです。販売管理システムや生産管理システムなどの「基幹システム」とkintoneを連携すれば、基幹システムで管理している売上情報や商品マスタなどをkintone上でも確認できるようになります。
しかし、kintoneの基本機能である「ファイルから読み込む」は、ユーザーが画面上でCSVファイルを選択して取り込む仕組みです。そのため、毎日CSVを取り込むような運用では、担当者がその都度操作する必要があり、取り込み忘れや更新の遅れが発生する原因にもなります。
こうした課題を解決する方法の一つが、サイボウズ株式会社が無料で提供する「cli-kintone(クリキントーン)」の活用です。
cli-kintoneは、コマンドを使ってkintoneのレコードを登録・更新できるツールです。Windowsのタスクスケジューラやバッチファイルと組み合わせることで、基幹システムから出力されたCSVを、決まった時刻にkintoneへ自動で取り込む仕組みを構築できます。
本記事では、cli-kintoneを使ったCSVの自動取り込みについて、基本的な仕組みから、実際のコマンドを用いた設定手順、基幹システムとの連携例、注意点まで詳しく解説します。
- 基幹システムのCSVをkintoneへ取り込む方法と課題
- kintone標準の「ファイルから読み込む」でできること
- 定期的な取り込みでは、作業が負担になる
- cli-kintoneで基幹システムのCSVを自動で取り込む仕組み
- cli-kintoneとは
- 自動取り込みの全体像
- CSVを境に基幹システムとkintoneの役割を分ける
- 取り込む前に準備すること
- ①cli-kintoneをインストールする
- ②CSVのヘッダーとkintoneのフィールドコードを対応させる
- ③更新キーにするフィールドを用意する
- ④CSVの文字コード・データ形式を確認する
- ⑤取り込み用のAPIトークンを発行する
- 【手順】cli-kintoneで基幹システムのCSVを自動取り込みする方法
- STEP1:cli-kintoneのコマンドでCSVを取り込む
- STEP2:バッチファイルでCSVの取り込みを自動化する
- STEP3:タスクスケジューラで定期実行する
- cli-kintoneによる基幹システム連携の活用例3選
- ①基幹システムの売上実績をkintoneへ反映する
- ②取引先マスタ・商品マスタを定期的に更新する
- ③複数拠点の売上・業務データをkintoneへ集約する
- cli-kintoneでCSVを自動取り込みする際の注意点
- ①CSVの出力完了を確認してから取り込む
- ②エラーの検知・通知方法を用意する
- ③ログの保存と定期的な確認が必要
- ④CSVの仕様変更や設定変更を管理する
- ⑤APIトークンの管理とアクセス権限に注意する
- cli-kintoneでの自動取り込みが向いているケース・向いていないケース
- cli-kintoneが向いているケース
- cli-kintoneが向いていないケース
- 外部のデータ連携サービスを利用する方法もある
- まとめ
- kintoneと基幹システムの連携ならルーブピークへ
基幹システムのCSVをkintoneへ取り込む方法と課題
kintone標準の「ファイルから読み込む」でできること
kintoneには、CSVやExcelなどのファイルから、アプリへレコードを一括登録できる「ファイルから読み込む」機能が標準で備わっています。アプリのレコード一覧画面からファイルを選択し、CSVの各列とkintoneのフィールドを対応付けることで、複数のレコードをまとめて登録できます。
また、「更新キー」を指定すれば、新規レコードの追加に加えて、既存レコードの更新も可能です。更新キーとは、CSVの各行とkintoneに登録されているレコードを照合するための項目です。
たとえば、基幹システムの「取引先コード」を更新キーに設定した場合、kintone側に同じ取引先コードのレコードが存在すれば、そのレコードを上書き更新できます。該当するレコードが存在しなければ、新規レコードとして追加されます。
このように、kintoneの基本機能でもCSVを使ったデータの一括登録・更新は可能です。
なお、ファイルの読み込みには、以下のような制限があります。
▼関連コラム
定期的な取り込みでは、作業が負担になる
kintone標準の「ファイルから読み込む」は、CSVをまとめて登録・更新する際には便利ですが、kintone外からCSVを自動で取り込む機能は備わっていません。そのため、基幹システムから毎日出力される売上データや在庫情報などをkintoneへ反映する場合、その都度担当者がファイルを選択して取り込む必要があります。
特に、定期的なCSVの取り込みでは、以下のような課題が発生します。
CSVの取り込み作業に工数がかかる:
CSVの選択や読み込み設定を毎回行う必要があり、更新頻度や対象アプリが増えるほど作業負担も大きくなります。また、担当者が不在の場合には取り込みが止まるなど、属人化にもつながります。CSVファイルの行数・容量に制限がある:
kintoneの基本機能では、CSVの読み込みに100MB・10万行までという制限があります。上限を超える場合はファイルを分割する必要があり、取り込み作業が増えてしまいます。CSVの加工・クレンジングが必要になる:
基幹システムから出力したCSVの列名や日付形式などがkintoneの設定と異なる場合、事前の加工が必要です。Excelなどで毎回加工すると、作業工数が増えるほか、操作ミスの原因にもなります。データの更新漏れ・重複登録が発生する可能性がある:
CSVの取り込み忘れや古いファイルの選択、更新キーの設定ミスなどにより、基幹システムとkintoneのデータに不整合が生じる可能性があります。
月に数回程度の取り込みであれば、kintoneの基本機能でも十分に対応できます。しかし、毎日CSVを取り込む場合や、大量のデータを複数のアプリへ反映する場合には、手作業による負担が大きくなります。
こうした課題を解決する方法の一つが、「cli-kintone」を活用したCSV取り込みの自動化です。

cli-kintoneをバッチファイルやタスクスケジューラと組み合わせることで、基幹システムから出力されたCSVを、決まった時刻にkintoneへ自動で取り込めるようになります。
cli-kintoneで基幹システムのCSVを自動で取り込む仕組み
cli-kintoneとは
cli-kintone(クリキントーン)は、サイボウズ株式会社が無料で提供している、kintoneのレコードをコマンド操作で登録・更新・書き出しできるコマンドラインツールです。通常、kintoneへCSVを取り込むには、アプリの画面からファイルを選択して操作する必要があります。
一方、cli-kintoneでは、コマンドプロンプトやターミナルから命令を実行することで、kintoneの画面を開かずにレコードを操作できます。
代表的な機能は、以下のとおりです。
レコードの一括登録:CSVファイルから複数のレコードをまとめて登録する
レコードの登録・更新:更新キーを使い、該当するレコードがあれば更新し、存在しなければ新規登録する
レコードの書き出し:kintoneに登録されているデータをCSV形式で出力する
添付ファイルの登録・ダウンロード:レコードに紐づく添付ファイルをアップロードしたり、kintoneからダウンロードしたりできる
また、cli-kintoneはコマンドによる操作を前提としているため、Windowsのバッチファイルやタスクスケジューラなどと組み合わせて、定期的な処理を自動化できる点が特徴です。たとえば、毎日決まった時刻に基幹システムの売上データを取り込む場合や、取引先マスタ・商品マスタを定期的に更新する場合などに活用できます。
自動取り込みの全体像
cli-kintoneを使ってCSVの取り込みを自動化する場合、基幹システムからのCSV出力と、cli-kintoneによるkintoneへの取り込みを組み合わせることで、下図のような構成になります。

たとえば、Windowsのタスクスケジューラを利用する場合、以下のような流れです。
基幹システムからCSVを出力:売上情報や商品マスタなどを、決められたフォルダへCSV形式で出力する
バッチファイルを自動実行:Windowsのタスクスケジューラを使い、指定した時刻にバッチファイルを実行する
cli-kintoneでCSVを取り込む:バッチファイルからcli-kintoneのコマンドを実行し、kintoneアプリへレコードを登録・更新する
取り込み結果を確認・記録:処理結果をログに残し、正常に取り込めたCSVを処理済みフォルダへ移動する
この構成であれば、担当者が毎日kintoneを開いてCSVを読み込む必要がなくなり、定期的に基幹システムの情報を反映できるようになります。
ただし、CSVの出力から取り込みまでを完全に自動化するには、基幹システム側でもCSVを定期的に出力できることが前提です。基幹システムにCSVの自動出力機能がない場合は、別途データを抽出する仕組みが必要になります。
たとえば、データベースへの接続が許可されている環境であれば、「DBeaver」などを使ってデータを取得し、CSVとして出力する方法もあります。定期的な出力を行う場合は、自動実行の設定も必要です。
▼関連コラム
DBeaverで基幹システムとkintoneを連携する方法|CSV出力の手順・自動化・注意点を解説
CSVを境に基幹システムとkintoneの役割を分ける
基幹システムとkintoneを連携する際は、CSVの出力側と取り込み側で、管理する範囲を明確にしておくことが重要です。
たとえば、基幹システムを管理する情報システム部門が「決められた形式のCSVを指定フォルダへ出力するところまで」を担当し、kintone管理者が「CSVの取り込み設定やアプリの管理」を担当する構成です。

このように役割を分けることで、連携に問題が発生した場合も、基幹システム側のCSV出力に問題があるのか、cli-kintoneによる取り込みに問題があるのかを切り分けやすくなります。
ただし、基幹システム側でCSVの列名やデータ形式を変更すると、kintone側の取り込み処理に影響する場合があるため、CSVの仕様を変更する際は双方の担当者が事前に確認できる運用にしておきましょう。
取り込む前に準備すること
①cli-kintoneをインストールする
はじめに、CSVの取り込み処理を実行するWindowsのPC・サーバーに、cli-kintoneをインストールします。
cli-kintoneのインストール方法は、主に以下の2つです。
npmを利用する方法:Node.jsをインストールした環境で、コマンドを実行してcli-kintoneを導入する
実行ファイル(ZIP)を利用する方法:公式サイトからZIPファイルをダウンロードし、展開した実行ファイルを利用する
npm版のインストール手順
npmは、Node.jsに付属するパッケージ管理ツールです。
Node.js公式サイトからインストーラーをダウンロードし、画面の案内に従ってインストールします。
コマンドプロンプトを開き、次のコマンドを実行します。
npm install -g @kintone/cli次のコマンドでバージョン番号が表示されれば、インストールは完了です。
cli-kintone --version
実行ファイル(ZIP)版のインストール手順
Node.jsを使用しない場合は、公式のGitHubからWindows向けのZIPファイルをダウンロードする方法があります。
cli-kintone公式リリースページ(GitHub)を開き、最新版の「Assets」から
cli-kintone_(バージョン)_win.zipをダウンロードします。ZIPファイルを展開し、「cli-kintone.exe」を任意のフォルダ(例:
C:\tools\cli-kintone)に配置します。コマンドプロンプトを開き、以下のように実行ファイルのパスを指定して、バージョン番号が表示されることを確認します。
C:\tools\cli-kintone\cli-kintone.exe --version
なお、cli-kintoneのインストール方法については、以下のコラムで詳しく解説しています。
▼関連コラム
cli-kintone(クリキントーン)でバックアップを自動化する方法
②CSVのヘッダーとkintoneのフィールドコードを対応させる
cli-kintoneでCSVを取り込む場合、CSVの1行目(見出し行)には、取り込み先となるkintoneアプリの「フィールドコード」を指定する必要があります。
たとえば、基幹システムから以下のような売上データを出力するとします。
このCSVをcli-kintoneで取り込む場合、kintoneアプリのフィールドコードをCSVの見出し行と一致させます。対応方法としては、基幹システムのCSV出力設定を変更するか、取り込み先となるkintoneアプリのフィールドコードを調整します。
なお、CSVの見出し行に存在しないフィールドは、通常の取り込みでは更新対象になりません。一方、CSVに含まれるフィールドの値が空欄の場合は、その値で更新されるため、既存レコードの上書きには注意が必要です。
③更新キーにするフィールドを用意する
基幹システムからCSVを定期的に取り込む場合、同じデータが重複登録されないように「更新キー」を設定することが重要です。
更新キーは、CSVの各行とkintoneに登録済みのレコードを照合するための項目です。cli-kintoneでは、更新キーが一致するレコードが存在すれば更新し、存在しなければ新規登録する「UPSERT(アップサート)」という処理を利用できます。
更新キーには、以下のフィールドを指定できます。
レコード番号
「値の重複を禁止する」を設定した文字列(1行)フィールド
「値の重複を禁止する」を設定した数値フィールド
たとえば、取引先マスタを取り込む場合は「取引先コード」、商品マスタであれば「商品コード」を更新キーとして利用する構成が考えられます。
ただし、売上明細のように1つの伝票に複数の明細が存在する場合、伝票番号だけでは各レコードを特定できません。この場合は、伝票番号と明細番号を組み合わせた一意のキーをCSV側に用意し、kintoneの文字列(1行)フィールドへ取り込む方法があります。
更新キーが重複していると正しくレコードを照合できないため、CSVを取り込む前にキーの重複や欠損がないか確認しておきましょう。
④CSVの文字コード・データ形式を確認する
cli-kintoneでCSVを取り込む際は、ファイルの文字コードやデータ形式も確認する必要があります。
cli-kintoneが対応する文字コードは、「UTF-8」と「Shift_JIS」です。初期設定ではUTF-8が使用されるため、Shift_JIS形式のCSVを取り込む場合は、コマンドに以下のオプションを指定します。
--encoding sjisまた、日付フィールドに値を取り込む場合は、「2026-11-09」のような YYYY-MM-DD 形式を使用します。
基幹システムから出力されるCSVの形式が異なる場合は、CSVの出力設定を変更するか、取り込み前にデータ形式を変換する処理が必要です。
⑤取り込み用のAPIトークンを発行する
最後に、cli-kintoneからkintoneへアクセスするための「APIトークン」を発行します。APIトークンとは、外部ツールがkintoneアプリへアクセスする際の認証情報です。
下図のように、アプリごとに発行でき、許可する操作(アクセス権)を設定できます。取り込み先となるkintoneアプリの設定画面から[APIトークン]を開き、新しいトークンを生成します。

今回のように、更新キーを利用してレコードの追加・更新を行う場合は、以下の権限を設定します。
レコード閲覧
レコード追加
レコード編集
なお、今回の用途ではレコード削除やアプリ管理の権限は不要です。APIトークンには、必要な操作だけを許可するようにしましょう。また、APIトークンは認証情報となるため、第三者に知られないように管理する必要があります。
特に、バッチファイルへ直接記載する場合は、ファイルの閲覧権限にも注意してください。
ここまでの準備が完了したら、実際にcli-kintoneのコマンドを実行し、CSVをkintoneへ取り込んでいきます。
【手順】cli-kintoneで基幹システムのCSVを自動取り込みする方法
ここからは、cli-kintoneを使って基幹システムから出力されたCSVファイルをkintoneへ自動で取り込む方法を解説します。
今回は、Windowsのタスクスケジューラとバッチファイルを組み合わせ、指定フォルダに保存されたCSVを毎日決まった時刻に取り込み、kintoneのレコードを登録・更新する構成を例に説明します。
STEP1:cli-kintoneのコマンドでCSVを取り込む
はじめに、cli-kintoneのコマンドを手動で実行し、CSVを正常に取り込めることを確認します。
たとえば、基幹システムから出力された売上明細CSVを、kintoneの「売上実績アプリ」に取り込む場合、以下のようなコマンドを使用します。
cli-kintone record import ^
--base-url https://example.cybozu.com ^
--api-token YOUR_API_TOKEN ^
--app 999 ^
--file-path "C:\kintone_import\in\sales_20261109.csv" ^
--encoding sjis ^
--update-key detail_key各オプションの意味は、以下のとおりです。
※コマンド内のURL・APIトークン・アプリID・ファイルパス・更新キーは例です。実際の環境に合わせて変更してください。
※^はWindowsのコマンドプロンプトでコマンドを複数行に分けるための記号です。
今回の例では、--update-key に detail_key というフィールドコードを指定しています。CSVに含まれる detail_key の値をもとに、kintoneの既存レコードを更新するか、新規登録するかを判断します。
なお、更新キーの値が重複していたり、CSVの見出し行とkintoneのフィールドコードが一致していなかったりすると、取り込みエラーが発生する場合があります。
実際の運用を始める前に、少量のテストデータを使って、レコードの新規登録・更新が正しく行われることを確認しておきましょう。
STEP2:バッチファイルでCSVの取り込みを自動化する
STEP1で正常に取り込めることを確認したら、次はバッチファイルを作成します。
バッチファイルとは、Windowsのコマンドをまとめて実行するためのファイルです。拡張子は「.bat」で、メモ帳などのテキストエディタで作成できます。
今回は、以下のフォルダを用意します。
バッチファイルでは、in フォルダにあるCSVを順番に読み込み、cli-kintoneを実行します。正常に処理できた場合は done フォルダへ、エラーが発生した場合は error フォルダへ移動する構成です。
以下は、バッチファイルの記述例です。
@echo off
setlocal
rem 基本設定
set "BASE_DIR=C:\kintone_import"
set "APP_ID=999"
set "UPDATE_KEY=detail_key"
set "LOG_FILE=%BASE_DIR%\logs\import.log"
rem APIトークンなどは環境変数に設定しておく
if not defined KINTONE_BASE_URL exit /b 1
if not defined KINTONE_API_TOKEN exit /b 1
rem ログフォルダがなければ作成
if not exist "%BASE_DIR%\logs" mkdir "%BASE_DIR%\logs"
set "HAS_ERROR="
rem CSVを順番に取り込む
for %%F in ("%BASE_DIR%\in\*.csv") do (
if exist "%%~fF" call :IMPORT_CSV "%%~fF"
)
if defined HAS_ERROR exit /b 1
exit /b 0
:IMPORT_CSV
echo Processing: %~1 >> "%LOG_FILE%"
cli-kintone record import ^
--app %APP_ID% ^
--file-path "%~1" ^
--encoding sjis ^
--update-key %UPDATE_KEY% ^
>> "%LOG_FILE%" 2>&1
if errorlevel 1 (
echo Import failed: %~1 >> "%LOG_FILE%"
move /Y "%~1" "%BASE_DIR%\error\" >> "%LOG_FILE%" 2>&1
set "HAS_ERROR=1"
) else (
echo Import succeeded: %~1 >> "%LOG_FILE%"
move /Y "%~1" "%BASE_DIR%\done\" >> "%LOG_FILE%" 2>&1
if errorlevel 1 set "HAS_ERROR=1"
)
exit /b※このコードは構成例です。
doneとerrorフォルダは事前に作成してください。ZIP版を利用する場合は、cli-kintoneを実行ファイルのフルパスに変更します。
※移動先に同名のCSVが存在すると上書きされます。過去のCSVを保存する場合は、ファイル名に日付を付けるか、処理日ごとに保存先フォルダを分けるなどの対応が必要です。
バッチファイルを実行する前に、kintoneの接続先URLとAPIトークンを環境変数に登録しておきます。Windowsの「環境変数」設定画面から、KINTONE_BASE_URL にkintoneのURL、KINTONE_API_TOKEN に取り込み先アプリのAPIトークンを設定します。
タスクスケジューラで実行する場合は、タスクの実行ユーザーがこれらの環境変数を参照できることも確認してください。
バッチファイルを実行すると、in フォルダ内のCSVを順番に取り込み、処理結果をログファイルに記録します。正常に取り込めたCSVは done フォルダへ、エラーが発生したCSVは error フォルダへ移動する仕組みです。

ただし、取り込み途中でエラーが発生した場合は、一部のレコードだけが登録・更新されている可能性があります。エラーになったCSVを再実行する際は、kintone側の登録状況を確認しましょう。また、基幹システムがCSVを出力している途中で取り込みが始まらないよう、CSVの出力が完了してからバッチファイルを実行する必要があります。
STEP3:タスクスケジューラで定期実行する
最後に、作成したバッチファイルをWindowsの「タスクスケジューラ」に登録します。
タスクスケジューラは、指定した時刻や条件でプログラムを自動実行できるWindowsの標準機能です。
設定手順は、以下のとおりです。
Windowsの検索から「タスクスケジューラ」を起動します。
「タスクの作成」を選択し、任意のタスク名を入力します。
「トリガー」から実行する曜日や時刻を設定します。
「操作」で「プログラムの開始」を選択し、作成したバッチファイルを指定します。
必要に応じて、ユーザーがログオンしていない場合も実行するように設定します。
タスクを保存し、手動実行で正常に動作することを確認します。
たとえば、基幹システムが毎日午前1時に売上CSVを出力する場合、出力が完了する時刻を確認したうえで、午前2時にバッチファイルを実行するように設定できます。ただし、基幹システムのCSV出力が遅延する場合もあるため、時刻だけに依存せず、出力完了後にファイルを取り込める仕組みにしておくと、より安定した運用につながります。
また、タスクスケジューラで自動実行する場合は、以下の点にも注意が必要です。
Windowsの実行環境:指定時刻にPC・サーバーが稼働していること
アクセス権限:タスクを実行するユーザーがCSVの保存先を参照できること
実行環境の設定:cli-kintoneの実行パスやAPIトークンなどの環境変数を利用できること
特に、共有フォルダにCSVを保存する場合、ログオン中のユーザーとタスクスケジューラの実行ユーザーでアクセス権限が異なることがあります。初回設定時には、タスクスケジューラからバッチファイルを実行し、CSVの読み込みからkintoneへの登録・更新、ログの保存まで正常に動作することを確認しておきましょう。
以上で、基幹システムから出力されたCSVを、Windows経由でkintoneへ定期的に取り込む仕組みが完成します。
cli-kintoneによる基幹システム連携の活用例3選
cli-kintoneを使ってCSVの取り込みを自動化すると、基幹システムで管理している情報を定期的にkintoneへ反映できます。
ここでは、「①売上実績の管理」、「②マスタ情報の更新」、「③複数拠点のデータ集約」という3つの業務を例に、具体的な活用方法を紹介します。
①基幹システムの売上実績をkintoneへ反映する
販売管理システムなどの基幹システムで管理している売上データを、毎日kintoneへ取り込む方法として活用できます。

基幹システムから売上日、取引先、商品、売上金額などの売上明細をCSVで出力し、cli-kintoneを使ってkintoneの売上実績アプリへ登録・更新します。これにより、kintone上で日別・月別の売上実績を確認できるようになります。また、営業担当者が社外からもこれらの情報を閲覧できるようになります。
基幹システムのライセンスを持たない営業担当者でも、kintoneから売上状況を確認できる構成を作れるため、営業部門への情報共有に活用できます。
②取引先マスタ・商品マスタを定期的に更新する
基幹システムで管理している取引先マスタや商品マスタを、kintoneへ定期的に取り込む方法として活用できます。

kintoneで案件管理を行っている場合、取引先名、住所、商品コード、商品名、単価などの情報をアプリで利用することがあります。こうしたマスタ情報を基幹システムとkintoneの両方で手作業で管理していると、担当者による更新漏れや、登録内容の不一致が発生する可能性があります。
cli-kintoneを使えば、基幹システムから出力されたCSVをもとに、kintoneのマスタアプリを定期的に更新できます。取引先マスタであれば「取引先コード」、商品マスタであれば「商品コード」を更新キーとして設定し、既存データの更新と新規データの追加を行う構成です。
③複数拠点の売上・業務データをkintoneへ集約する
複数の店舗や営業所などで管理しているデータを、kintoneへまとめて取り込む方法として活用できます。

各拠点で利用しているシステムからCSVを出力し、指定フォルダに保存する運用を用意します。Windowsのバッチファイルで複数のCSVを順番に処理すれば、各拠点のデータをkintoneの共通アプリへ集約できます。kintone側に「拠点コード」や「店舗名」などのフィールドを用意しておけば、一覧やグラフで拠点別の売上実績・業務状況を確認することも可能です。
各拠点からExcelやCSVをメールで収集し、本部の担当者が手作業で集計している業務では、CSVの出力と取り込みを自動化することで、転記や集計の手間を減らせます。
cli-kintoneでCSVを自動取り込みする際の注意点
cli-kintoneは無料で利用でき、バッチファイルやタスクスケジューラと組み合わせれば、CSVの定期的な取り込みを自動化できます。
ただし、cli-kintone自体には、CSVの出力完了を検知したり、取り込みエラーを管理者へ通知したりする機能はありません。自動取り込みを継続して運用するには、Windows側での処理制御やエラー管理、セキュリティ対策なども考慮する必要があります。
ここでは、導入・運用時に注意しておきたい5つのポイントを解説します。
①CSVの出力完了を確認してから取り込む
タスクスケジューラでCSVを定期的に取り込む場合は、基幹システム側のCSV出力が完了していることを確認する必要があります。指定した時刻にバッチファイルを実行するだけでは、CSVの出力やファイル転送が遅延した際に、書き込み途中のファイルを読み込んでしまう可能性があります。
対策としては、CSVの出力完了後にファイル名を変更する方法や、出力完了を示す別ファイルを作成し、その存在を確認してから取り込みを開始する方法があります。また、取り込み済みのCSVが再処理されないよう、正常終了したファイルは処理済みフォルダへ移動するなど、ファイル管理の仕組みも必要です。
②エラーの検知・通知方法を用意する
cli-kintoneでCSVの取り込みに失敗しても、管理者へ自動的にメールなどで通知されるわけではありません。タスクスケジューラで毎日処理を実行していても、エラーを確認する仕組みがなければ、数日間にわたってkintoneのデータが更新されていないことに気づかない可能性があります。
前章で紹介したバッチファイルでは、取り込みに失敗したCSVを error フォルダへ移動する構成にしています。ただし、ファイルが移動されるだけでは、担当者が確認するまでエラーを把握できません。
継続的に運用する場合は、コマンドの終了コードを確認し、エラーが発生した際に管理者へメールなどで通知する処理を追加する方法があります。また、Windows自体の停止やタスクの実行失敗も想定し、一定時間データが更新されていない場合に検知できる仕組みも検討しておきましょう。
③ログの保存と定期的な確認が必要
CSVの取り込みを自動化する場合は、正常に処理できたかどうかを後から確認できるようにしておく必要があります。cli-kintoneの実行結果は、バッチファイルなどからログファイルへ出力できます。取り込んだCSVのファイル名、実行日時、処理結果、エラー内容などを記録しておけば、問題が発生した際の原因調査に役立ちます。
ただし、ログを保存するだけでは、取り込みが正常に行われているかを把握できません。
管理者が定期的に確認できる運用や、エラーを検知して通知する仕組みと組み合わせることが必要です。また、毎日ログを出力し続けるとファイルサイズが大きくなるため、一定期間が経過したログの削除や、日付ごとのファイル分割なども検討しましょう。
④CSVの仕様変更や設定変更を管理する
基幹システム側でCSVの列名やデータ形式が変更されると、cli-kintoneによる取り込みに影響する場合があります。また、kintoneアプリのフィールドコードや、バッチファイルに指定しているアプリID・更新キーなどを変更した場合も、取り込み処理が正常に動作するか確認が必要です。
特に、バッチファイルを複数の担当者が編集できる環境では、設定内容の変更が原因でエラーが発生しても、何を変更したのか分からなくなる可能性があります。
バッチファイルや設定ファイルの変更履歴を残し、変更前にテストを行う運用を用意しておきましょう。Gitなどのバージョン管理ツールを利用する方法もあります。
⑤APIトークンの管理とアクセス権限に注意する
cli-kintoneでAPIトークンを利用する場合は、認証情報が第三者に漏れないように管理する必要があります。APIトークンをバッチファイルへ直接記載すると、ファイルを閲覧できるユーザーがトークンを取得できてしまいます。また、環境変数を利用する場合も、Windows側のアクセス権限や実行ユーザーの管理が必要です。
今回のようなCSVの登録・更新を行う処理であれば、APIトークンには必要な権限だけを付与し、レコード削除などの不要な操作は許可しないようにします。複数のアプリや業務で利用する場合は、APIトークンの用途や管理担当者を把握できるようにしておくことも大切です。
なお、APIトークンを環境変数に設定するだけで、値が暗号化されるわけではありません。より厳格な管理が必要な環境では、OSのアクセス制御や認証情報を安全に保管する仕組みの利用も検討しましょう。
cli-kintoneでの自動取り込みが向いているケース・向いていないケース
cli-kintoneは無料で利用でき、基幹システムから出力したCSVをkintoneへ自動で取り込む仕組みを構築できます。
ただし、前章で解説したように、CSVの出力完了チェックやエラー通知、ログ管理などは別途用意する必要があります。自社でバッチファイルの作成・保守ができるか、どこまでの処理を自動化したいかによって、適した連携方法は異なります。
cli-kintoneが向いているケース
cli-kintoneは、以下のような環境に向いています。
追加のツール費用を抑えたい場合:CSVの取り込みを自動化したいものの、有料の連携サービスを導入する予算が限られている
社内にIT担当者がいる場合:コマンドやバッチファイルを作成でき、エラー発生時の調査・修正にも対応できる
CSVの形式が決まっている場合:基幹システムから出力するCSVの列名やデータ形式が一定で、大掛かりな加工を必要としない
Windowsの実行環境を用意できる場合:定期的に処理を実行するPC・サーバーを管理できる
特に、毎日決まった形式で出力される売上実績や取引先マスタなどを、kintoneのアプリへ登録・更新する用途であれば、比較的シンプルな構成で自動化できます。
ただし、cli-kintone自体が無料でも、バッチファイルの作成やエラー対応などには作業工数がかかります。導入時の設定に加え、運用開始後の管理を誰が担当するのかも決めておきましょう。
cli-kintoneが向いていないケース
一方、以下のような場合は、cli-kintoneだけで対応するよりも、外部のデータ連携サービスを利用したほうが管理しやすい場合があります。
社内に保守できる担当者がいない場合:バッチファイルやWindowsの実行環境を管理できず、エラーが発生した際の対応が難しい
CSVの加工が複雑な場合:複数ファイルの結合や項目の変換、データクレンジングなどを取り込み前に行う必要がある
エラー通知や処理履歴の管理が必要な場合:取り込み失敗をすぐに把握したい、管理者が処理状況をまとめて確認できるようにしたい
CSVの出力タイミングが一定でない場合:決まった時刻ではなく、ファイルが出力・転送されたことを検知して取り込みを開始したい
こうした処理も、WindowsのバッチファイルやPowerShellなどを組み合わせれば実装できる場合があります。
ただし、処理が複雑になるほど、開発や保守に必要な工数も増えていきます。特に、業務で毎日利用するデータを連携する場合は、エラーが発生した際に担当者が気づけることや、原因を確認できることも考慮しておきたいポイントです。
外部のデータ連携サービスを利用する方法もある
cli-kintoneでの運用が難しい場合は、CSVの自動取り込みに対応した外部サービスを利用する方法があります。代表的なサービスとして、クラフテクス株式会社の「DataSyncer® CSV to kintone(データシンカー®)」や、メシウス株式会社の「krewData(クルーデータ)」などがあります。
DataSyncer CSV to kintone(データシンカー):
Windows上の指定フォルダに保存されたCSVファイルを検知し、kintoneへ自動で登録するサービスです。CSVの取り込みとあわせてデータクレンジングにも対応しており、基幹システムから出力されるCSVを定期的に取り込む用途に利用できます。krewData:
kintoneアプリのデータを集計・加工できるプラグインです。外部ファイル入出力機能を利用すると、OneDriveやBox、Google Driveなどのクラウドストレージに保存されたCSV・Excelファイルを読み込み、データを加工してkintoneアプリへ登録できます。
どちらもCSV連携に利用できるサービスですが、データの取得元や処理内容が異なります。Windowsからアクセスできる指定フォルダのCSVを自動で取り込みたい場合はDataSyncer、クラウドストレージ上のCSVを取り込み、kintoneのデータと組み合わせて加工・集計したい場合はkrewDataが選択肢になります。
cli-kintoneを含め、各ツールの特徴や必要な運用管理を比較し、自社の環境に合った方法を選びましょう。
▼関連コラム
まとめ
この記事では、cli-kintoneを使って基幹システムから出力したCSVをkintoneへ自動で取り込む方法について、基本的な仕組みから設定手順、活用例、注意点まで解説しました。
cli-kintoneは無料で利用でき、Windowsのバッチファイルやタスクスケジューラと組み合わせることで、CSVの定期的な取り込みを自動化できます。
ただし、CSVの出力完了チェックやエラー通知、ログ管理などは別途用意する必要があります。自社での構築・保守が難しい場合は、DataSyncerなどの外部連携サービスも選択肢になります。
既存の基幹システムを活かしながら、自社の運用体制やコストに合った連携方法を検討してみてください。
kintoneと基幹システムの連携ならルーブピークへ
Lubepeak株式会社では、基幹システムへの接続可否の確認から、連携対象データの整理、CSV・API・連携ツールの選定、kintone側のアプリ設計まで対応しています。
cli-kintoneを活用したCSVの自動取り込みをはじめ、既存の基幹システムを活かしながら、業務内容や運用負荷、コストに合わせた連携方法をご提案します。
kintoneと基幹システムの連携をご検討の方は、ぜひお気軽にご相談ください。
Lubepeak株式会社 代表
平井 将吾

~ 経歴 ~
2021年
富士フイルムビジネスイノベーション株式会社へ新卒入社2022年~2025年
官公庁において、「kintone」の導入で「自治体DX」を多数支援2025年10月~
Lubepeak株式会社を設立。
中小企業のお客様を対象に「kintone」の導入支援を行い、要件整理から運用定着まで一貫支援2026年1月
Lubepeak株式会社が「サイボウズコンサルティングパートナー」に認定2026年6月
Lubepeak株式会社が「サイボウズプロダクトパートナー」に認定2026年10月
kintone連携チャットツール「ChatCrew」をリリース

サイト運営者
顧客の業務改善に向き合える場所
ルーブピークは、「kintone」で企業の課題を共に解決するメンバーを募集しています。
採用サイトはこちら






























