楽楽コネクタオプションの初期設定(FX5)

概要

  • 「API連携オプション」(有料)と「楽楽コネクタオプション」(有料)のお申込が必要です。
  • 「楽楽コネクタ」を通じて、TKCの会計ソフト「FX5」と「楽楽精算」とのデータ連携ができます。
  • 仕訳データの自動連携
    「楽楽精算」から自動出力されたファイル(仕訳データ)を取得できます。
  • CSV自動取込
    「FX5」から出力された「支払先マスタ」のCSVファイルを、「楽楽精算」の「支払先マスタ」に取り込むことができます。

注意

  • 英語対応オプション」を併用の場合、「楽楽コネクタ」を通して「支払先マスタ」の新規登録を行うことができません。
    新規登録は「楽楽コネクタ」を通さずに直接入力するか、「CSV取込」を利用して設定をお願いします。
    (詳細は、支払先マスタ > 設定手順 > CSV取込をご確認ください)
    ※新規登録後、登録内容の更新は「楽楽コネクタ」を通して連携することができます。
     
  • 「楽楽精算」の「管理」タブ >「仕訳データ出力の設定」は「出力設定のコピー」に用意された「FX5」の会計テンプレートで設定することを想定しています。
    テンプレートから項目追加・項目の並び替えなどをした場合、FX5の設定変更が必要になる可能性があります。必要に応じてFX5の「仕訳読取テンプレートの設計」で設定を変更してください。
    ※「仕訳データ出力の設定」で「タブ区切り」「固定長」を設定しても拡張子は「.csv」で出力されます。


以下のオプションをご利用のお客様は「楽楽コネクタ」を利用することが出来ません。
・「IPアドレス制限オプション」
・「SSLクライアント認証オプション」

「英語対応オプション」を併用の場合、「楽楽コネクタ」を通して「支払先マスタ」の新規登録を行うことができません。
新規登録は「楽楽コネクタ」を通さずに直接入力するか、「CSV取込」を利用して設定を
お願いします。(詳細は、支払先マスタ > 設定手順 > CSV取込をご確認ください。)
※新規登録後、登録内容の更新は「楽楽コネクタ」を通して連携することができます。

「楽楽精算」の「管理」タブ >「仕訳データ出力の設定」は「出力設定のコピー」に用意された
「FX5」の会計テンプレートで設定することを想定しています。
テンプレートから項目追加・項目の並び替えなどをした場合、FX5の設定変更が必要になる可能性が
あります。必要に応じてFX5の「仕訳読取テンプレートの設計」で設定を変更してください。
※「仕訳データ出力の設定」で「タブ区切り」「固定長」を設定しても拡張子は「.csv」で
出力されます。

共通設定

「楽楽精算」の共通設定

APIトークンの発行

「楽楽精算」のAPIの利用時に認証用キーとして使用する文字列です。
APIトークンは、「楽楽精算」の管理者ユーザー(ログインID:admin)のみ発行できます。

1267_seihin_01_20251219
「管理」タブ > 「システム設定」 > 「その他」タブからAPIトークン欄の「生成」ボタンをクリックし、APIトークンを生成します。
APIトークン生成後、「確定」をクリックするとAPIトークンが「楽楽精算」に登録され、APIが使用できる状態になります。

APIトークンの再発行

1267_seihin_02_20251219
「再生成」ボタンをクリックします。
「確定」ボタンをクリックすると、再生成後のAPIトークンが「楽楽精算」に登録されます。

APIトークンの削除

1267_seihin_03_20251219
「削除」ボタンをクリックします。
「確定」ボタンをクリックすると、APIトークンが「楽楽精算」から削除され、APIが使用できない状態になります。

「Qanat Universe Agent(エージェント)」の設定

「楽楽コネクタ」を利用するパソコンに「Qanat Universe Agent(エージェント) 」をインストールしてください。
インストーラ―とマニュアルは「楽楽コネクタ」にログイン後、「コネクタ一覧」の「連携設定」からダウンロードできます。

1267_seihin_04_20251219

連携のフォルダ作成

「C:\_qanatuniverse\_qua\userdata\」の直下に、「楽楽精算」の仕訳データのファイルを出力する/支払先データのファイルを設置するフォルダを作成します。

※どのフォルダの直下にフォルダを作成するかは、「Qanat Universe Agent(エージェント)」の「ファイルの配置場所」をご確認ください。

【例】
・「仕訳データ」ファイルを出力するフォルダ ・・・「仕訳データ」
・「支払先データ」ファイルを設置するフォルダ・・・「支払先」

1267_seihin_05_20251219

仕訳データの自動連携

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

補足

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

例えば以下のような場合は、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連携

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

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

注意

楽楽コネクタを利用しFX5との仕訳データの自動連携を行う場合、「楽楽精算」の「管理」タブ >「仕訳データ出力の設定」は「仕訳データ出力の設定 >  出力設定のコピー」に用意された「FX5」の会計テンプレートで設定することを想定しています。 

テンプレートから項目追加・項目の並び替えなどをした場合、FX5の設定変更が必要になる可能性があります。
必要に応じてFX5の「仕訳読取テンプレートの設計」で設定を変更してください。
※「仕訳データ出力の設定」で「タブ区切り」「固定長」を設定しても拡張子は「.csv」で 出力されます。

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

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

    1267_seihin_06_20251219

  4. 「自動実行」を「有効」にチェック
    1267_seihin_07_20251219
  5. 「確定」ボタンをクリック

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

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

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

    1267_seihin_09_20251219 

≪完了≫

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

「楽楽コネクタ」の設定

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

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

    ・楽楽精算URL   →「https://●●●●●●.rakurakuseisan.jp/●●●●●●a/」
    ・APIトークン    →「楽楽精算」「APIトークンの発行」で発行した情報
    ・自動ファイル出力ID  →「楽楽精算」「自動ファイル出力の設定」の該当のID
  4. 「Step2. Qanat Universe Agent 接続設定」をそれぞれ以下の内容を記載

    ・AgentID   →「Qanat Universe Agent」に表示される「エージェントID」を入力
    ・AgentKey →「Qanat Universe Agent」に表示される「エージェントキー」を入力
    ・フォルダ名  →「連携のフォルダ作成」で作成したフォルダ名を指定
    【例】「仕訳データ」というフォルダを作成した場合、「仕訳データ」

    ・ファイル名  →「FX5」に連携する仕訳データファイルのファイル名の頭を指定
    【例】「仕訳データ」と指定した場合、出力ファイル名は、「仕訳データ_202006190503.csv」のようになります。

補足

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

詳細は、「Qanat Unverse Agent_ユーザーズマニュアル」>「4.1 設定画面を開く」をご確認ください。
※上記マニュアルは「楽楽コネクタ」にログイン後、「コネクタ一覧」の「連携設定」からダウンロードできます。(インストーラーとセットでダウンロードされます。)
1267_seihin_11_20251219


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

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

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

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

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

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

注意

出力開始時間に「楽楽精算」のメンテナンスが実施された場合は、サービス停止の有無に関わらず、メンテナンス中には自動ファイル出力処理が実行されません。
メンテナンスが終了したタイミングで自動で実行されます。
※メンテナンス後の自動出力タイミングは、サービス稼働状況に事前掲載しているメンテナンス完了時刻が目安となります。

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

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

6.「保存」をクリック

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

次は連携前に「FX5」側の「読込設定」を行います。
設定についての詳細は会計ソフト提供会社へお問い合わせください。

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

  1. 「コネクタ一覧」で「楽楽精算‐FX5 仕訳連携」の「実行」ボタンをクリック

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

    1267_seihin_13_20251219

≪完了≫

「支払先マスタ」の連携

「FX5」から出力した支払先データを「楽楽精算」へ連携することができます。

「楽楽コネクタ」の設定

  1. 「楽楽コネクタ」にログイン
  2. 「コネクタ一覧」で「楽楽精算‐FX5 支払先連携」の「連携設定」をクリック

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

    ・楽楽精算URL    →「https://●●●●●●.rakurakuseisan.jp/●●●●●●a/」
    ・APIトークン     →「楽楽精算」「APIトークンの発行」で発行した情報
    ・自動ファイル出力ID →「楽楽精算」「自動ファイル出力の設定」の該当のID
  4. 「Step2. Qanat Universe Agent 接続設定」をそれぞれ以下の内容を記載

    ・AgentID   →「Qanat Universe Agent」に表示される「エージェントID」を入力
    ・AgentKey →「Qanat Universe Agent」に表示される「エージェントキー」を入力
    ・フォルダ名 →「連携のフォルダ作成」で作成したフォルダ名を指定
    【例】「支払先」というフォルダを作成した場合、「支払先」

    ・ファイル名 →「FX5」から出力される支払先データファイルのファイル名の頭を指定
    【例】出力ファイル名が、「支払先マスタ 20200619.csv」の場合は「支払先マスタ」と指定

補足

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

詳細は、「Qanat Unverse Agent_ユーザーズマニュアル」>「4.1 設定画面を開く」をご確認ください。
※上記マニュアルは「楽楽コネクタ」にログイン後、「コネクタ一覧」の「連携設定」からダウンロードできます。(インストーラーとセットでダウンロードされます。)
1267_seihin_15_20251219

5.「Step3. 連携タイミング」を選択
 ※「楽楽精算」の自動仕訳データ出力は早朝2時に実行されます。
 ※「スケジュール実行」の場合、以下から選択します。
  ・「毎日」の場合、実行する時間を選択
  ・「毎週」の場合、実行する曜日、時間を選択
  ・「毎月」の場合、実行する日付、時間を選択
 
6.「保存」をクリック

≪完了≫

以上で「楽楽コネクタ」の設定は完了です。
次は「FX5」からデータを出力するために、「FX5」側の「データ切出ツールの設定 」を
お願いします。設定についての詳細は会計ソフト提供会社へお問い合わせください。

「支払先連携」手動実行の手順

  1. 「FX5」より、支払先データファイルを指定ファイルに出力
    ※「3.3 連携のフォルダ作成」で作成したフォルダにデータを格納してください。
  2. 「コネクタ一覧」で「楽楽精算‐FX5 支払先連携」の「実行」ボタンをクリック
    ※「コネクタ一覧」の「連携ログ」にて、実行結果が表示されます。

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

    1267_seihin_17_20251219

≪完了≫

項目の変換表(「FX5」→「楽楽精算」)

「FX5」から出力した支払先データは、以下の内容に変換されて「楽楽精算」の「支払先マスタ」に取込されます。
「FX5」
項目名
「楽楽精算」
支払先マスタ項目名
変換内容
「FX5」→「楽楽精算」
コード 支払先コード 変換なし※上限文字数 半角20
取引先名 支払先名 変換なし※上限文字数 半角100
支払サイト1・支払サイト
支払予定日種別
0 当月
1 次月
2 次々月
3~12
申請時に日付を指定
支払サイト1・支払日
支払予定日
0 31
1~31 1~31
振込先1・金融機関コード 振込先銀行 変換なし
振込先1·支店コード 振込先支店 変換なし
振込先1・預金種目
振込先口座種別
1 当座
2 普通
4 その他
5 貯蓄
振込先1・口座番号 振込先口座番号 変換なし
振込先1・口座名義カナ 振込先名義カナ 変換なし※上限文字数 半角40
手数料の負担
振込手数料
0 先方負担
1 当方負担
 
※「上限文字数」を超えた場合は、取り込みエラーとなります。

連携エラー

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

1267_seihin_18_20251219

(記事ID:1267)