メインコンテンツまでスキップ

通勤費支給データの連携

@earlyAccess

本機能は早期アクセス機能であり、一部のお客様のみ先行提供しております。
今後のアップデートにおいて予告なく破壊的な仕様変更が行われる場合がございます。
不具合やご不明な点は担当コンサルまでお寄せください。

当資料の位置づけ​

カスタムファンクションから Combosite 連携用のメソッドのパラメータ・レスポンスの定義を説明するための資料です。

Combosite 連携用メソッドを利用することで、Combosite のデータの取得・更新などの操作が可能になります。

カスタムファンクション設定方法​

カスタムファンクション設定時には、以下のように設定してください。

実行トリガー設定​

  1. 実行トリガー:
    • Combositeトリガー
  2. 実行トリガー処理:
    • 給与計算-通勤費計算(前):給与の通勤費計算を行う場合

カスタムファンクション設定画面

利用可能サービス​

#実行トリガー処理名サービス名主なメンバ
1給与計算-通勤費計算(前)combositeDataService.tsukinhiShikyuDataupdateJisseki
2給与計算-通勤費計算(前)combositeDataService.tsukinhiKihonDatareadByEmployeeIdAndTerm
3給与計算-通勤費計算(前)combositeDataService.kyuyoKihonDatareadByEmployeeIdAndTerm
4給与計算-通勤費計算(前)combositeDataService.keisanTaishoshaDataread

具体的なユースケース​

副勤務地の計算​

  • カスタムデータにて、各従業員の各月の勤怠日数を登録する(勤怠日数、処理年月をパラメータとして扱う)。
  • 取得した通勤費基本と、勤怠日数より、通勤費支給実績を計算する(日額×勤怠、片道×勤怠など)
  • updateJissekiメソッドを利用して、通勤費支給実績を更新する。
備考

通勤費支給実績とは:
各従業員に紐づく通勤費基本マスタより算出できる、支給金額や距離、日数などの情報が載っているデータです。
通勤費基本で設定した通勤手段ごとに支給実績を作成しています。この合算値が通勤費として支給されます。
詳細については、通勤費基本マスタデータの各設定を参照ください (例:電車)。

例:

通勤手段:電車の場合

  • 支給金額:10000円
  • 距離:10km
  • 日数:20日

通勤手段:バイクの場合

  • 支給金額:5000円
  • 距離:50km
  • 日数:20日

上記の場合、通勤費は15000円として支給されます。

利用可能メソッド詳細​

通勤費支給データ連携​

combositeDataService.tsukinhiShikyuData​

備考

tsukinhiShikyuData は TsukinhiShikyuDataService のインスタンスです。
詳細はリンクを参照してください。

📄️CombositeTsukinhiShikyuDataService

本機能は早期アクセス機能であり、一部のお客様のみ先行提供しております。

updateJisseki​

Combosite の「事前計算の実行」・「本計算の実行」処理時に通勤費支給実績を作成します。

警告

実行時に、前回給与計算分の通勤費支給実績は削除されます。
今回の給与計算の計算対象者のうち、jissekiList に含めなかった従業員は、削除のみが行われます。
jissekiList の employeeId は、今回の給与計算の計算対象者に含まれている必要があります。

通勤費基本データ連携​

combositeDataService.tsukinhiKihonData​

備考

tsukinhiKihonData は TsukinhiKihonDataService のインスタンスです。
詳細はリンクを参照してください。

📄️CombositeTsukinhiKihonDataService

本機能は早期アクセス機能であり、一部のお客様のみ先行提供しております。

readByEmployeeIdAndTerm​

従業員IDと期間を指定して、通勤費基本マスタを取得します。テスト実行時は実際の取得はできません。

給与基本データ連携​

combositeDataService.kyuyoKihonData​

備考

kyuyoKihonData は KyuyoKihonDataService のインスタンスです。
詳細はリンクを参照してください。

📄️CombositeKyuyoKihonDataService

本機能は早期アクセス機能であり、一部のお客様のみ先行提供しております。

readByEmployeeIdAndTerm​

従業員IDと期間を指定して、給与基本マスタを取得します。今回の給与計算の支払に該当するものだけが対象です。テスト実行時は実際の取得はできません。

計算対象者データ連携​

combositeDataService.keisanTaishoshaData​

備考

keisanTaishoshaData は KeisanTaishoshaDataService のインスタンスです。
詳細はリンクを参照してください。

📄️CombositeKeisanTaishoshaDataService

本機能は早期アクセス機能であり、一部のお客様のみ先行提供しております。

read​

今回の給与計算の計算対象者を取得します。テスト実行時は実際の取得はできません。