楽楽精算サクセスナビ
全体検索
ログイン
ユーザー画像
ログイン

設定・操作手順を調べる

ユーザー画像
楽楽精算CS
2023/03/20 09:00

楽楽コネクタオプションの初期設定（どっと原価NEO）

目次

概要
共通設定
　▶「楽楽精算」の共通設定
　▶「Qanat Universe Agent(エージェント)」の設定
　▶連携のフォルダ作成
仕訳データ出力の設定
仕訳データの自動連携
　▶「楽楽精算」仕訳データ出力の設定
　▶「楽楽精算」自動ファイル出力の設定
　▶「楽楽コネクタ」連携設定
　▶「仕訳連携」手動実行の手順
「工事マスタ」の連携
　▶「楽楽コネクタ」の設定
　▶「工事マスタ」手動実行の手順
　▶項目の変換表(「どっと原価NEO」→「楽楽精算」)
連携エラー

 

概要

  • 「API連携オプション」（有料）と「楽楽コネクタオプション」（有料）のお申込が必要です。
  • 「楽楽コネクタ」を通じて、「どっと原価NEO」と「楽楽精算」とのデータ連携ができます。
  • 仕訳データの自動連携
    　「楽楽精算」から自動出力されたファイル（仕訳データ）を取得できます。
  • CSV自動取込
    　「どっと原価NEO」から出力された「工事マスタ」のCSVファイルを、
    　「 楽楽精算」の「プロジェクトマスタ」に取り込むことができます。
  • 以下のオプションをご利用のお客様は、「楽楽コネクタ」を利用することができません。

　・「IPアドレス制限オプション」
　・「SSLクライアント認証オプション」

  • 「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．標準設定」又は「2．個別設定」の「編集」をクリック
     
  3. 「出力項目」で「工事マスタ」「工事枝番」の出力項目として
    　「仕訳データ：借方:プロジェクトコード」をそれぞれ設定
     
  4. 「出力文字数の制限」の「変更する」をクリック
     
  5. 「工事マスタ」にあたる「仕訳データ：借方:プロジェクトコード」で以下の設定
    　→　開始位置：1　　長さ：10
     
  6. 「工事枝番」にあたる「仕訳データ：借方:プロジェクトコード」で以下の設定
     　→　開始位置：12　　長さ：2
     
  7. 「確定」をクリック

    ≪完了≫


仕訳データの自動連携

「楽楽精算」から出力した仕訳データを「どっと原価NEO」に取り込むことができます。 

　１つの「楽楽精算-指定フォルダ 仕訳連携」に対して
　設定できる「自動ファイル出力ID」は１つのみです。

　例えば以下のような場合は、2つある「楽楽精算-指定フォルダ 仕訳連携」のそれぞれに、
　異なる「自動ファイル出力ID」を設定してください。

【例1】計上仕訳と支払仕訳でフォーマットが異なり、
　　　 「仕訳データ出力の設定」でそれぞれ個別設定をしている場合

異なる個別設定の仕訳区分を、1つの「自動ファイル出力ID」に設定することができないため、
2つの「自動ファイル出力ID」を登録し、それぞれ異なる「楽楽精算-指定フォルダ 仕訳連携」に
設定する
【例2】「計上仕訳の実行タイミングは毎日、支払仕訳の実行タイミングは毎月」のように
　　　     仕訳区分によって実行タイミングを変えたい場合

異なる実行タイミングを、1つの「自動ファイル出力ID」に設定することができないため、
2つの「自動ファイル出力ID」を登録し、それぞれ異なる「楽楽精算-指定フォルダ 仕訳連携」に
設定する

　なお、「自動ファイル出力ID」を3つ以上設定する必要がある場合は、
　追加のお手続きをいただくことで、4つまで設定ができます。



　「楽楽コネクタオプション」は1連携のご契約で自動ファイル出力 2 IDまで、
　2連携のご契約で自動ファイル出力 4 IDまで連携が可能です。
　連携システムごとの必要な連携数は以下となります。

　　FX5：仕訳連携（自動ファイル出力 2 IDまで）…1連携必要
　　FX5：支払先マスタ連携…1連携必要
　　指定フォルダ：仕訳連携（自動ファイル出力 2 IDまで）…1連携必要
　　どっと原価NEO：プロジェクトマスタ連携…1連携必要

【例】

連携の種類 必要な連携数
指定フォルダ連携　1 ID分
FX5　支払先マスタ連携		 2連携
指定フォルダ連携　3 ID分
FX5　支払先マスタ連携		 3連携
指定フォルダ連携　3 ID分
どっと原価NEOプロジェクトマスタ連携		 3連携
指定フォルダ連携　3 ID分 2連携
指定フォルダ連携　1 ID分 1連携



 
▶「楽楽精算」仕訳データ出力の設定

ご利用の会計システムの仕様に合わせて、
「楽楽精算」で作成した仕訳データをどのようなレイアウトで出力するか
「楽楽精算」の「管理」タブ > 「仕訳データ出力の設定」から設定をしてください。

　zipファイルでの連携には対応していないため、
  「仕訳データ出力の設定」で複数ファイルを出力する設定を行っている場合は設定変更が必要です。


▶「楽楽精算」自動ファイル出力の設定

  1. 「管理」タブ >「自動ファイル出力の設定」をクリック
  2. 「新規登録」をクリック
  3. 対象の仕訳区分や実行タイミングを選択
    　※必ず「項目名」の「項目名を出力する」のチェックは外してください。

4.「自動実行」を「有効」にチェック


5.「確定」をクリック

※計上仕訳と支払仕訳で出力フォーマットが異なる場合など、
 「自動ファイル出力設定ID」を複数登録する必要がある際には、
　必要なID分、2.～5.の手順を繰り返してください。

※出力時間を変更したい場合は、「出力開始時間の設定」からご設定ください。
　変更前に自動ファイル出力の設定 > 出力開始時間の設定 注意をご確認ください。
  （出力設定（ID）ごとに異なる出力開始時間は設定できません。）


6.設定後、表示される「ID」を確認


≪完了≫

以上で、「楽楽精算」の「自動ファイル出力の設定」は完了です。
　


▶「楽楽コネクタ」連携設定

  1. 「楽楽コネクタ」にログイン
  2. 「コネクタ一覧」で「楽楽精算‐指定フォルダ 仕訳連携」の「連携設定」をクリック


3.「Step1. 楽楽精算API 接続設定」をそれぞれ以下の内容を記載

　・楽楽精算URL　　　　　→URL「https://●●●●●●.rakurakuseisan.jp/●●●●●●a/」
　・APIトークン　　　　　  →楽楽精算「APIトークンの発行」で発行した情報
　・自動ファイル出力ID　　→楽楽精算「自動ファイル出力の設定」の該当のID

 

4.「Step2. Qanat Universe Agent 接続設定」をそれぞれ以下の内容を記載

　・AgentID 　       →「Qanat Universe Agent」に表示される「エージェントID」を入力
　・AgentKey　    →「Qanat Universe Agent」に表示される「エージェントキー」を入力
　・フォルダ名      →「連携のフォルダ作成」で作成したフォルダ名を指定
　　　　　　　　　 【例】「仕訳データ」というフォルダを作成した場合、「仕訳データ」と指定
　・ファイル名 　→「どっと原価NEO」に連携する仕訳データファイルのファイル名の頭を指定
　 　　　　　　　　【例】「仕訳データ」と指定した場合、出力ファイル名は、
　　　　　　　　　　　　 「仕訳データ_202006190503.csv」のようになります。

■「AgentID」「AgentKey」の確認方法
　タスクバーの「Qanat Universe Agent」の「設定」 > 「エージェント」をクリック

詳細は「Qanat Unverse Agent_ユーザーズマニュアル」>「4.1 設定画面を開く」をご確認ください。

 


5.「Step3. 連携タイミング」を選択

※「楽楽精算」で自動出力される仕訳データファイルを取得するタイミングを設定します。
　「スケジュール実行」の場合、以下から選択します。
　・「毎日」の場合、実行する時間を選択
　・「毎週」の場合、実行する曜日、時間を選択
　・「毎月」の場合、実行する日付、時間を選択

　「楽楽コネクタ」では、楽楽精算から自動出力された最新のデータを指定フォルダに出力します。
　そのため、連携タイミングは、楽楽精算から仕訳データが自動出力されるタイミングと
　合わせてご設定ください。

　【例】「毎週」の頻度でファイルを出力をしたい場合
　「楽楽精算」の「自動ファイル出力の設定」の実行タイミングと
　「楽楽コネクタ」の「スケジュール実行」を両方「毎週」に設定してください。

　※「楽楽精算」の自動出力頻度を「毎日」に設定して、「楽楽コネクタ」の連携タイミングを
　　「毎週」にした場合、最新の1日分しか取得（指定フォルダに出力）できません。

　※「楽楽精算」から仕訳データファイルが自動出力されるタイミングは、
　　「自動ファイル出力の設定」で設定された頻度（毎日、毎週、毎月）および
　　  出力開始時間に出力されます。

 

　出力開始時間に楽楽精算のメンテナンスが実施された場合は、 
　サービス停止の有無に関わらず、メンテナンス中には自動ファイル出力処理が実行されません。
　メンテナンスが終了したタイミングで自動で実行されます。

※メンテナンス後の自動出力タイミングは、
　サービス稼働状況 に事前掲載しているメンテナンス完了時刻が目安となります。
　ファイル出力が完了するまでにかかる時間は、お客様の環境に依存して前後しますので
　ご了承ください。

なおサービス停止なしのメンテナンスの場合は、メンテナンス中でも
「自動ファイル出力の設定」 > 「手動実行」ボタンから手動でファイル出力の実行ができます。
「手動実行」で出力されたファイルもAPIで取得することができます。

※サービス停止ありのメンテナンス完了時刻は、実績として午前7時終了が多くなっております。
　「Step3. 連携タイミング」で設定するファイル取得の時間は、こちらを考慮の上ご設定ください。


6.「保存」をクリック

≪完了≫


以上で、「楽楽コネクタ」の設定は完了です。
 

次は連携前に「どっと原価NEO」側の「汎用データ受入」を実施します。
「楽楽精算」側から出力した経費データを、
「どっと原価NEO」の【仕入伝票データ】として受入れることができます。

「どっと原価NEO」の自動ファイル連携モジュールをご購入のお客様は、
仕入伝票データの受入れを自動化する設定ができます。
設定についての詳細は会計システム提供会社へお問い合わせください。


▶「仕訳連携」手動実行の手順

  1. 「コネクタ一覧」で「楽楽精算‐指定フォルダ 仕訳連携」の「実行」ボタンをクリック


2.ステータスが成功(SUCCESS)になると、指定したフォルダに仕訳データファイルが出力される
　ので、出力された仕訳データファイルを「どっと原価NEO」にて取込


≪完了≫


「工事マスタ」の連携

「どっと原価NEO」から出力した「工事マスタ」を
「楽楽精算」の「プロジェクトマスタ」へ連携することができます。

　「どっと原価NEO」に登録されている「工事マスタ」と「工事枝番」は以下のように
　「楽楽精算」の「プロジェクトマスタ」へ連携がされます。

　・工事番号10桁-工事番号2桁
　※工事番号は頭を自動的に0埋めして「楽楽精算」へ登録されます。

【例】
　■「どっと原価NEO」のマスタ
　　工事マスタ…300
　　工事枝番…10
　　　　↓
　■「楽楽精算」の「プロジェクトマスタ」
　　プロジェクトコード…0000000300-10


▶「楽楽コネクタ」の設定

  1. 「楽楽コネクタ」にログイン
  2. 「コネクタ一覧」で「楽楽精算‐どっと原価プロジェクト連携」の「連携設定」をクリック


3.「Step1. 楽楽精算API 接続設定」をそれぞれ以下の内容を記載

　・楽楽精算URL　　　→URL「https://●●●●●●.rakurakuseisan.jp/●●●●●●a/」
　・APIトークン　　　 →楽楽精算「APIトークンの発行」で発行した情報

4.「Step2. Qanat Universe Agent 接続設定」をそれぞれ以下の内容を記載

　・AgentID 　　  →「Qanat Universe Agent」に表示される「エージェントID」を入力
　・AgentKey    　→「Qanat Universe Agent」に表示される「エージェントキー」を入力
　・フォルダ名　 →「連携のフォルダ作成」で作成したフォルダ名を指定
　　　　　　　　　 【例】「工事番号」というフォルダを作成した場合、「工事番号」と指定
　・ファイル名　→「どっと原価NEO」から出力される工事番号ファイルのファイル名の頭を指定
　　　　　　　　　 【例】出力ファイル名が「工事番号 20200619.csv」の場合は「工事番号」と指定

■「AgentID」「AgentKey」の確認方法
タスクバーの「Qanat Universe Agent」の「設定」 > 「エージェント」をクリック

詳細は「Qanat Unverse Agent_ユーザーズマニュアル」>「4.1 設定画面を開く」をご確認ください。


5.「Step3. 連携タイミング」を選択

※「スケジュール実行」の場合、以下から選択します。
　・「毎日」の場合、実行する時間を選択　
　　※「時間」は1時間ごと複数の時間を選択することができます。例】10時 13時 18時
　・「毎週」の場合、実行する曜日、時間を選択
　・「毎月」の場合、実行する日付、時間を選択

6.「保存」をクリック
≪完了≫

 以上で「楽楽コネクタ」の設定は完了です。



次は「どっと原価NEO」からデータを出力するために、
「どっと原価NEO」側の「工事マスタ」の出力を行います。

「楽楽精算」に「工事マスタ」を送ることで、
「楽楽精算」で経費精算する際に送った「工事マスタ」情報を選択して経費の登録ができます。

「どっと原価NEO」の自動ファイル連携モジュールをご購入のお客様は、
「工事マスタ」の出力を自動化する設定ができます。
設定についての詳細は会計システム提供会社へお問い合わせください。


▶「工事マスタ」手動実行の手順

  1. 「どっと原価NEO」より、「工事マスタ」のファイルを指定ファイルに出力
    　※「3.3 連携のフォルダ作成」で作成したフォルダにデータを格納してください。
     
  2. 「コネクタ一覧」で「楽楽精算‐どっと原価プロジェクト連携」の「実行」ボタンをクリック
    　※「コネクタ一覧」の「連携ログ」にて、実行結果が表示されます。


3.ステータスが成功（SUCCESS）になると、「楽楽精算」にデータ取り込みが成功
　※取り込みが成功すると、取り込み元のファイル名が変更されます。
　　(ファイル名の頭に”_”、後ろに年月日時分秒が付与されます）


≪完了≫


▶項目の変換表(「どっと原価NEO」→「楽楽精算」)

「どっと原価NEO」から出力した「工事マスタ」は、
以下の内容に変換されて「楽楽精算」の「プロジェクトマスタ」に取り込みされます。

※「上限文字数」を超えた場合は、取り込みエラーとなります。　　　　　　　　 
※「どっと原価NEO」の「工事マスタ」のその他の項目の自動連携はできません。


連携エラー

連携エラーがある場合は「コネクタ一覧」の「連携ログ」に「エラー詳細」ボタンが表示されます。
※「楽楽コネクタ」で確認できるレスポンスコードやエラーコードは、別途マニュアルがございます。

  （記事ID：1079）

いいね
× 


  

    キャンセル
    OK