データ連携/HRBrain勤怠管理のAPI連携方法
機能概要
HRBrainで管理している従業員情報をHRBrain勤怠管理に連携できます。
また、HRBrain勤怠管理で管理している勤怠情報をHRBrainに連携できます。
連携の定期実行を設定することで、毎日定時にデータの登録・更新を行うため、CSV連携や手入力などの作業コストを削減することができます。
- HRBrain→HRBrain勤怠管理の定期実行時間:AM3:15
- HRBrain勤怠管理→HRBrainの定期実行時間:AM2:15
AM8:30〜AM10:00とPM5:30〜PM6:30の時間帯はHRBrain勤怠管理の連携操作が行えません(手動連携・設定編集が不可)。
目次
連携項目について
設定・操作方法
注意事項
連携項目について
従業員情報と勤怠情報の2種類のデータが連携可能です。
| データ種類 | 項目種類 | 連携方向 |
| 従業員情報 | 【固定のマッピング項目】 • 連携元と連携先が固定されている (チェックボックスがある場合、オン/オフで連携設定できる) |
• HRBrain → HRBrain勤怠管理 |
| 【選択可能なマッピング項目】 • 連携先と連携元の項目それぞれを自由に選択できる • 一部項目は連携先次第でマッピングが必須になる (連携元の項目は自由に選択できる) |
• HRBrain → HRBrain勤怠管理 | |
| 勤怠情報 | 【選択可能なマッピング項目】 • HRBrain勤怠管理の勤怠項目をHRBrainの定期更新項目に連携できる |
• HRBrain勤怠管理 → HRBrain |
従業員情報
■固定のマッピング項目
- HRBrain→HRBrain勤怠管理への連携時のみ下表の項目が固定になります
- 所属と主部署の連携は、HRBrainとHRBrain勤怠管理の双方にて名称と階層(HRBrain勤怠管理側は区切り文字「>」での階層表現)が一致している状態にしてください
- 雇用区分と雇用形態の連携は、HRBrainとHRBrain勤怠管理の双方にて名称が一致している状態にしてください
| HRBrain勤怠管理項目名 | HRBrain項目名 | 備考 |
| 所属 | 組織情報>主部署 | 名称と階層で一致判定 (コードは一致判定に使用しない) |
| 雇用区分 | 組織情報>雇用形態 | 名称で一致判定 |
■選択可能なマッピング項目
- HRBrain→HRBrain勤怠管理への連携時のみ一部項目を除き自由にマッピング設定が可能です
- HRBrain勤怠管理側の姓・名・性別・従業員コード(連携キー項目がメールアドレスの場合)のマッピング設定が必須になります(HRBrain側のマッピング項目は自由に選択可能です)
- 下記はHRBrain勤怠管理の従業員項目一覧です
従業員コード
姓
名
姓(カナ)
名(カナ)
メールアドレス
予備のメールアドレス
性別
入社年月日
生年月日
退職年月日
⚠️注意点
予備のメールアドレス単体でのマッピングはできません(メールアドレスとセットでマッピングしてください)。
勤怠情報
■選択可能なマッピング項目
- HRBrain勤怠管理→HRBrainへの連携時のみマッピング設定が可能です
- HRBrain勤怠管理の前月分の勤怠情報をHRBrainの定期更新項目に連携することが可能です
- 定期更新項目は事前に作成しておく必要があります(定期更新項目の作成方法についてはこちらをご確認ください)
- 下記はHRBrain勤怠管理の勤怠項目一覧です
総勤務回数
平日勤務回数
遅刻回数
早退回数
総勤務日数
平日勤務日数
欠勤日数
休暇取得>休暇取得日数
休暇取得>時間休暇取得時間(分)
休暇取得>時間休暇取得時間(時間)
所定時間(分)
所定外時間(分)
残業時間(分)
深夜労働時間(分)
深夜所定外時間(分)
深夜残業時間(分)
休憩時間(分)
遅刻時間(分)
早退時間(分)
所定時間(時間)
所定外時間(時間)
残業時間(時間)
深夜労働時間(時間)
深夜所定外時間(時間)
深夜残業時間(時間)
休憩時間(時間)
遅刻時間(時間)
早退時間(時間)
休日労働>所定労働時間(分)
休日労働>深夜労働時間(分)
休日労働>残業時間(分)
休日労働>深夜残業時間(分)
休日労働>所定外時間(分)
休日労働>深夜所定外時間(分)
休日労働>所定労働時間(時間)
休日労働>深夜労働時間(時間)
休日労働>残業時間(時間)
休日労働>深夜残業時間(時間)
休日労働>所定外時間(時間)
休日労働>深夜所定外時間(時間)
割増労働>残業時間1(分)
割増労働>深夜残業時間1(分)
割増労働>残業時間2(分)
割増労働>深夜残業時間2(分)
割増労働>残業時間1(時間)
割増労働>深夜残業時間1(時間)
割増労働>残業時間2(時間)
割増労働>深夜残業時間2(時間)
法定休日労働>所定労働時間(分)
法定休日労働>深夜労働時間(分)
法定休日労働>残業時間(分)
法定休日労働>深夜残業時間(分)
法定休日労働>所定外時間(分)
法定休日労働>深夜所定外時間(分)
法定休日労働>勤務回数
法定休日労働>勤務日数
法定休日労働>所定労働時間(時間)
法定休日労働>深夜労働時間(時間)
法定休日労働>残業時間(時間)
法定休日労働>深夜残業時間(時間)
法定休日労働>所定外時間(時間)
法定休日労働>深夜所定外時間(時間)
法定外休日労働>所定労働時間(分)
法定外休日労働>深夜労働時間(分)
法定外休日労働>残業時間(分)
法定外休日労働>深夜残業時間(分)
法定外休日労働>所定外時間(分)
法定外休日労働>深夜所定外時間(分)
法定外休日労働>勤務回数
法定外休日労働>勤務日数
法定外休日労働>所定労働時間(時間)
法定外休日労働>深夜労働時間(時間)
法定外休日労働>残業時間(時間)
法定外休日労働>深夜残業時間(時間)
法定外休日労働>所定外時間(時間
法定外休日労働>深夜所定外時間(時間)
拘束時間(分)
休暇みなし時間(分)
拘束時間(時間)
休暇みなし時間(時間)
インターバル不足回数
週の残業時間>残業時間(分
週の残業時間>深夜残業時間(分)
週の残業時間>法定外休日残業時間(分)
週の残業時間>法定外休日深夜残業時間(分)
週の残業時間>残業時間(時間)
週の残業時間>深夜残業時間(時間)
週の残業時間>法定外休日残業時間(時間)
変形労働>年の残業時間(分)
変形労働>年の深夜残業時間(分)
変形労働>月の残業時間(分)
変形労働>月の深夜残業時間(分)
変形労働>週の残業時間(分)
変形労働>週の深夜残業時間(分)
変形労働>月の法定休日残業時間(分)
変形労働>月の法定休日深夜残業時間(分)
変形労働>週の法定休日残業時間(分)
変形労働>週の法定休日深夜残業時間(分)
変形労働>年の法定外休日残業時間(分)
変形労働>年の法定外休日深夜残業時間(分)
変形労働>月の法定外休日残業時間(分)
変形労働>月の法定外休日深夜残業時間(分)
設定・操作方法
権限設定
開発者向けサイトの以下権限が必要です。
- [外部サービス同士の連携]権限
- [公開API Token設定]権限(Token取得のため)
▷データ連携/開発者向けサイトについて>開発者向けサイト内の権限付与の方法
連携設定
1.[メニュー] > [開発者向けサイト] > [外部サービスとの連携]をクリック
2.[新規連携設定]ボタンを押下し、データ連携方向と連携するサービスを選択
3.[連携設定] > [認証情報設定]でHRBrain勤怠管理とHRBrainを認証
※HRBrainのトークン発行方法はこちらを参照
4.連携設定の[項目マッピング設定]で連携したい項目を選択し[保存]をクリック
a.HRBrain→HRBrain勤怠管理連携設定の場合
b.HRBrain勤怠管理→HRBrain連携設定の場合
👉️注意点
・連携のキーとなる情報を「従業員番号」か「メールアドレス」で選択可能です
・メンバー情報の自動削除の[有効にする]にチェックを入れた場合、
連携元で削除したメンバー情報が連携先でも自動で削除されます(HRBrain→HRBrain勤怠管理連携時のみ)
・「従業員番号」か「メールアドレス」に一致するメンバーが存在しない場合、そのメンバーの情報は連携されません
・HRBrainのアカウントが必要です
設定情報の確認・変更
保存された設定は[開発者向けサイト] > [外部サービスとの連携] > [連携設定]に一覧表示
手動実行
手動でデータ連携を行いたい場合は、[連携実行]ボタンをクリック
連携結果の確認
1.連携結果は[開発者向けサイト] > [外部サービスとの連携] > [連携ログ]から確認可能
2.[連携ログ]の「>」をクリックすることで、連携内容の詳細を確認可能(ステータスによる絞り込みも可能)
データの更新がない場合の連携内容詳細は下記
連携操作不可の表示
AM8:30〜AM10:00とPM5:30〜PM6:30の時間帯は連携操作不可
注意事項
HRBrain勤怠管理の1テナントとHRBrainの1テナントとの連携を想定しております。
複数テナント同士、または複数テナントを1つのテナントへ連携することは想定外のユースケースとなります。(利用にあたり想定外のエラーが発生する可能性があるため、サポートの対象外となります。)