概要
- 「API連携オプション」(有料)と「楽楽コネクタオプション」(有料)のお申込が必要です。
- 「楽楽コネクタ」を通じて、「どっと原価NEO」と「楽楽精算」とのデータ連携ができます。
- 仕訳データの自動連携
「楽楽精算」から自動出力されたファイル（仕訳データ）を取得できます。
- CSV自動取込
「どっと原価NEO」から出力された「工事マスタ」のCSVファイルを、「 楽楽精算」の「プロジェクトマスタ」に取り込むことができます。
共通設定
「楽楽精算」の共通設定
APIトークンの発行
「楽楽精算の」APIの利用時に認証用キーとして使用する文字列です。
APIトークンは、「楽楽精算」の
管理者ユーザー（ログインID：admin）のみ発行できます。
「管理」タブ > 「システム設定」 > 「その他」タブからAPIトークン欄の「生成」ボタンをクリックし、APIトークンを生成します。
APIトークン生成後、「確定」をクリックするとAPIトークンが「楽楽精算」に登録され、APIが使用できる状態になります。
APIトークンの再発行
「再生成」ボタンをクリックします。
「確定」をクリックすると、再生成後のAPIトークンが「楽楽精算」に登録されます。
APIトークンの削除
「削除」ボタンをクリックします。
「確定」をクリックすると、APIトークンが「楽楽精算」から削除され、APIが使用できない状態になります。
「Qanat Universe Agent(エージェント)」の設定
「楽楽コネクタ」を利用するパソコンに「Qanat Universe Agent(エージェント) 」をインストールしてください。
インストーラ―とマニュアルは「楽楽コネクタ」にログイン後、「コネクタ一覧」の「連携設定」からダウンロードできます。
連携のフォルダ作成
「C:\_qanatuniverse\_qua\userdata\」の直下に、「楽楽精算」の仕訳データのファイルを出力する／工事マスタデータのファイルを設置するフォルダを作成します。
※どのフォルダの直下にフォルダを作成するかは、「Qanat Universe Agent(エージェント)」>「ファイルの配置場所」をご確認ください。
【例】
・「仕訳データ」ファイルを出力するフォルダ ・・・「仕訳データ」
・「工事マスタデータ」ファイルを設置するフォルダ・・・「工事マスタ」
仕訳データ出力の設定
「楽楽コネクタ」を通して「どっと原価NEO」の「工事マスタ」および「工事枝番」を「楽楽精算」の「プロジェクトマスタ」に連携している場合、「楽楽精算」と「どっと原価NEO」に登録されているマスタに相違が発生します。
そのまま「楽楽精算」の「プロジェクトマスタ」を「どっと原価NEO」に連携した場合、取込エラーが発生する可能性があります。
そのため、事前に「楽楽精算」の「仕訳データ出力の設定」にて以下の設定をお願いします。
※「楽楽コネクタ」を通して「工事マスタ」の登録をしていない場合は、設定変更の必要はございません。
【例】
■「どっと原価NEO」のマスタ
「工事マスタ」… 100
「工事枝番」 … 01
■「楽楽精算」の「プロジェクトマスタ」
0000000100-01
- 「管理」タブ >「仕訳データ出力の設定」をクリック
- 「1．標準設定」又は「2．個別設定」の「編集」をクリック
- 「出力項目」で「工事マスタ」「工事枝番」の出力項目として
「仕訳データ：借方:プロジェクトコード」をそれぞれ設定
- 「出力文字数の制限」の「変更する」をクリック
- 「工事マスタ」にあたる「仕訳データ：借方:プロジェクトコード」で以下の設定
→ 開始位置：1 長さ：10
- 「工事枝番」にあたる「仕訳データ：借方:プロジェクトコード」で以下の設定
→ 開始位置：12 長さ：2
- 「確定」ボタンをクリック
≪完了≫
仕訳データの自動連携
「楽楽精算」から出力した仕訳データを「どっと原価NEO」に取り込むことができます。
「楽楽精算」仕訳データ出力の設定
ご利用の会計ソフトの仕様に合わせて、「楽楽精算」で作成した仕訳データをどのようなレイアウトで出力するか
「楽楽精算」の「管理」タブ > 「仕訳データ出力の設定」から設定をしてください。
「楽楽精算」自動ファイル出力の設定
- 「管理」タブ >「自動ファイル出力の設定」をクリック
- 「新規登録」をクリック
- 対象の仕訳区分や実行タイミングを選択
※必ず「項目名」の「項目名を出力する」のチェックは外してください。
- 「自動実行」を「有効」にチェック
- 「確定」ボタンをクリック
※計上仕訳と支払仕訳で出力フォーマットが異なる場合など、「自動ファイル出力設定ID」を複数登録する必要がある際には、必要なID分、2.～5.の手順をくりかえしてください。
※出力時間を変更したい場合は、「出力開始時間の設定」からご設定ください。
変更前に自動ファイル出力の設定 > 出力開始時間の設定 注意をご確認ください。
（出力設定（ID）ごとに異なる出力開始時間は設定できません。）
- 設定後、表示される「ID」を確認
≪完了≫
以上で、「楽楽精算」の「自動ファイル出力の設定」は完了です。
「楽楽コネクタ」連携設定
- 「楽楽コネクタ」にログイン
- 「コネクタ一覧」で「楽楽精算‐指定フォルダ 仕訳連携」の「連携設定」をクリック
- 「Step1. 楽楽精算API 接続設定」をそれぞれ以下の内容を記載
・楽楽精算URL →URL「https://●●●●●●.rakurakuseisan.jp/●●●●●●a/」
・APIトークン →楽楽精算「APIトークンの発行」で発行した情報
・自動ファイル出力ID →楽楽精算「自動ファイル出力の設定」の該当のID
- 「Step2. Qanat Universe Agent 接続設定」をそれぞれ以下の内容を記載
・AgentID →「Qanat Universe Agent」に表示される「エージェントID」を入力
・AgentKey →「Qanat Universe Agent」に表示される「エージェントキー」を入力
・フォルダ名 →「連携のフォルダ作成」で作成したフォルダ名を指定
【例】「仕訳データ」というフォルダを作成した場合、「仕訳データ」と指定
・ファイル名 →「どっと原価NEO」に連携する仕訳データファイルのファイル名の頭を指定
【例】「仕訳データ」と指定した場合、出力ファイル名は、「仕訳データ_202006190503.csv」のようになります。
5.「Step3. 連携タイミング」を選択
※「楽楽精算」で自動出力される仕訳データファイルを取得するタイミングを設定します。
「スケジュール実行」の場合、以下から選択します。
・「毎日」の場合、実行する時間を選択
・「毎週」の場合、実行する曜日、時間を選択
・「毎月」の場合、実行する日付、時間を選択
「楽楽コネクタ」では、楽楽精算から自動出力された最新のデータを指定フォルダに出力します。
そのため、連携タイミングは、楽楽精算から仕訳データが自動出力されるタイミングと
合わせてご設定ください。
【例】「毎週」の頻度でファイルを出力をしたい場合
「楽楽精算」の「自動ファイル出力の設定」の実行タイミングと「楽楽コネクタ」の「スケジュール実行」を両方「毎週」に設定してください。
※「楽楽精算」の自動出力頻度を「毎日」に設定して、「楽楽コネクタ」の連携タイミングを
「毎週」にした場合、最新の1日分しか取得（指定フォルダに出力）できません。
※「楽楽精算」から仕訳データファイルが自動出力されるタイミングは、「自動ファイル出力の設定」で設定された頻度（毎日、毎週、毎月）および出力開始時間に出力されます。
6.「保存」をクリック
≪完了≫
以上で、「楽楽コネクタ」の設定は完了です。
次は連携前に「どっと原価NEO」側の「汎用データ受入」を実施します。
「楽楽精算」側から出力した経費データを、「どっと原価NEO」の【仕入伝票データ】として受入れることができます。
「どっと原価NEO」の自動ファイル連携モジュールをご購入のお客様は、
仕入伝票データの受入れを自動化する設定ができます。
設定についての詳細は会計ソフト提供会社へお問い合わせください。
「仕訳連携」手動実行の手順
- 「コネクタ一覧」で「楽楽精算‐指定フォルダ 仕訳連携」の「実行」ボタンをクリック
- ステータスが成功(SUCCESS)になると、指定したフォルダに仕訳データファイルが出力されるので、出力された仕訳データファイルを「どっと原価NEO」にて取込
≪完了≫
「工事マスタ」の連携
「どっと原価NEO」から出力した「工事マスタ」を「楽楽精算」の「プロジェクトマスタ」へ連携することができます。
「楽楽コネクタ」の設定
- 「楽楽コネクタ」にログイン
- 「コネクタ一覧」で「楽楽精算‐どっと原価プロジェクト連携」の「連携設定」をクリック
- 「Step1. 楽楽精算API 接続設定」をそれぞれ以下の内容を記載
・楽楽精算URL →URL「https://●●●●●●.rakurakuseisan.jp/●●●●●●a/」
・APIトークン →楽楽精算「APIトークンの発行」で発行した情報
- 「Step2. Qanat Universe Agent 接続設定」をそれぞれ以下の内容を記載
・AgentID →「Qanat Universe Agent」に表示される「エージェントID」を入力
・AgentKey →「Qanat Universe Agent」に表示される「エージェントキー」を入力
・フォルダ名 →「連携のフォルダ作成」で作成したフォルダ名を指定
【例】「工事番号」というフォルダを作成した場合、「工事番号」と指定
・ファイル名 →「どっと原価NEO」から出力される工事番号ファイルのファイル名の頭を指定
【例】出力ファイル名が「工事番号 20200619.csv」の場合は「工事番号」と指定
5.「Step3. 連携タイミング」を選択
※「スケジュール実行」の場合、以下から選択します。
・「毎日」の場合、実行する時間を選択
※「時間」は1時間ごと複数の時間を選択することができます。【例】10時 13時 18時
・「毎週」の場合、実行する曜日、時間を選択
・「毎月」の場合、実行する日付、時間を選択
6.「保存」をクリック
≪完了≫
以上で「楽楽コネクタ」の設定は完了です。
次は「どっと原価NEO」からデータを出力するために、「どっと原価NEO」側の「工事マスタ」の出力を行います。
「楽楽精算」に「工事マスタ」を送ることで、「楽楽精算」で経費精算する際に送った「工事マスタ」情報を選択して経費の登録ができます。
「どっと原価NEO」の自動ファイル連携モジュールをご購入のお客様は、「工事マスタ」の出力を自動化する設定ができます。
設定についての詳細は会計ソフト提供会社へお問い合わせください。
「工事マスタ」手動実行の手順
- 「どっと原価NEO」より、「工事マスタ」のファイルを指定ファイルに出力
※「3.3 連携のフォルダ作成」で作成したフォルダにデータを格納してください。
- 「コネクタ一覧」で「楽楽精算‐どっと原価プロジェクト連携」の「実行」ボタンをクリック
※「コネクタ一覧」の「連携ログ」にて、実行結果が表示されます。
- ステータスが成功（SUCCESS）になると、「楽楽精算」にデータ取込が成功
※取込が成功すると、取込元のファイル名が変更されます。
(ファイル名の頭に”_”、後ろに年月日時分秒が付与されます）
≪完了≫
項目の変換表(「どっと原価NEO」→「楽楽精算」)
「どっと原価NEO」から出力した「工事マスタ」は、以下の内容に変換されて「楽楽精算」の「プロジェクトマスタ」に取り込みされます。
「どっと原価NEO」
工事マスタ項目名 |
「楽楽精算」
プロジェクトマスタ項目名 |
変換内容 |
| 工事マスタ+枝番 |
プロジェクトコード |
頭をゼロ埋めした13桁になります。「工事マスタ(10桁)」+「_」+「工事マスタ枝番(2桁)」 |
| 工事名称 |
プロジェクト名 |
変換なし ※上限文字数 半角100 |
※「上限文字数」を超えた場合は、取込エラーとなります。
※「どっと原価NEO」の「工事マスタ」のその他の項目の自動連携はできません。
連携エラー
連携エラーがある場合は「コネクタ一覧」の「連携ログ」に「エラー詳細」ボタンが表示されます。
※「楽楽コネクタ」で確認できるレスポンスコードやエラーコードは、別途マニュアルがございます。
（記事ID：1298）
CSV出力ボタン
1．
2．
