データ連携/KING OF TIME API連携方法
KING OF TIME API連携でできること
KING OF TIMEの従業員情報もしくは勤怠情報をHRBrainの社員名簿に連携させることができます。
または、HRBrainの従業員情報をKING OF TIMEの従業員情報に連携させることができます。
※相互連携設定はできません。
目次
連携項目について
マッピングできる項目一覧
連携できる人
操作方法
注意事項
連携項目について
- マッピングできない項目(対象項目が固定)
| HRBrainの項目 | KING OF TIME の項目 | 連携できる方向 |
| 主部署 | 所属 |
KING OF TIME→HRBrain HRBrain→KING OF TIME |
| 雇用形態 | 雇用区分 |
KING OF TIME→HRBrain HRBrain→KING OF TIME |
| (任意で作成された定期更新項目グループ) | 月次勤怠 | KING OF TIME→HRBrainのみ |
👉️注意点
・「氏」「名」はHRBrainに登録する際に必須のため除外できません。
・「性別」「従業員コード」「姓」「名」は
KING OF TIMEに新しい従業員を登録する際の必須項目のため除外できません。
・勤怠情報のマッピングでは事前にHRBrain内に連携させる定期更新項目グループを作成しておく必要があります。
マッピングできる項目一覧
| KING OF TIME の項目 | 連携できる方向 | 項目種別 | 留意事項 |
| 従業員コード |
HRBrain→KING OF TIME KING OF TIME→HRBrain |
従業員情報 | |
| 姓 |
HRBrain→KING OF TIME KING OF TIME→HRBrain |
従業員情報 | |
| 名 |
HRBrain→KING OF TIME KING OF TIME→HRBrain |
従業員情報 | |
| 姓(カナ) |
HRBrain→KING OF TIME KING OF TIME→HRBrain |
従業員情報 | |
| 名(カナ) |
HRBrain→KING OF TIME KING OF TIME→HRBrain |
従業員情報 | |
| メールアドレス |
HRBrain→KING OF TIME KING OF TIME→HRBrain |
従業員情報 | |
| 予備のメールアドレス |
HRBrain→KING OF TIME KING OF TIME→HRBrain |
従業員情報 | 予備のメールアドレス単体でのマッピングはできません。 メールアドレスとセットでマッピングしてください。 |
| 性別 |
HRBrain→KING OF TIME KING OF TIME→HRBrain |
従業員情報 | |
| 入社年月日 |
HRBrain→KING OF TIME KING OF TIME→HRBrain |
従業員情報 | |
| 生年月日 |
HRBrain→KING OF TIME KING OF TIME→HRBrain |
従業員情報 | |
| 退職年月日 |
HRBrain→KING OF TIME KING OF TIME→HRBrain |
従業員情報 | |
| 総勤務回数 | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 平日勤務回数 | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 遅刻回数 | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 早退回数 | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 総勤務日数 | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 平日勤務日数 | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 欠勤日数 | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 休暇取得>休暇取得日数 | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 休暇取得>時間休暇取得時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 休暇取得>時間休暇取得時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 所定時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 所定外時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 深夜労働時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 深夜所定外時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 深夜残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 休憩時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 遅刻時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 早退時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 所定時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 所定外時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 深夜労働時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 深夜所定外時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 深夜残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 休憩時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 遅刻時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 早退時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 休日労働>所定労働時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 休日労働>深夜労働時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 休日労働>残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 休日労働>深夜残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 休日労働>所定外時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 休日労働>深夜所定外時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 休日労働>所定労働時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 休日労働>深夜労働時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 休日労働>残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 休日労働>深夜残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 休日労働>所定外時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 休日労働>深夜所定外時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 割増労働>残業時間1(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 割増労働>深夜残業時間1(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 割増労働>残業時間2(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 割増労働>深夜残業時間2(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 割増労働>残業時間1(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 割増労働>深夜残業時間1(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 割増労働>残業時間2(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 割増労働>深夜残業時間2(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定休日労働>所定労働時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定休日労働>深夜労働時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定休日労働>残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定休日労働>深夜残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定休日労働>所定外時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定休日労働>深夜所定外時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定休日労働>勤務回数 | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定休日労働>勤務日数 | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定休日労働>所定労働時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定休日労働>深夜労働時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定休日労働>残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定休日労働>深夜残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定休日労働>所定外時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定休日労働>深夜所定外時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定外休日労働>所定労働時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定外休日労働>深夜労働時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定外休日労働>残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定外休日労働>深夜残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定外休日労働>所定外時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定外休日労働>深夜所定外時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定外休日労働>勤務回数 | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定外休日労働>勤務日数 | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定外休日労働>所定労働時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定外休日労働>深夜労働時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定外休日労働>残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定外休日労働>深夜残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定外休日労働>所定外時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 法定外休日労働>深夜所定外時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 拘束時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 休暇みなし時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 拘束時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 休暇みなし時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| インターバル不足回数 | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 週の残業時間>残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 週の残業時間>深夜残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 週の残業時間>法定外休日残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 週の残業時間>法定外休日深夜残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 週の残業時間>残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 週の残業時間>深夜残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 週の残業時間>法定外休日残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>年の残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>年の深夜残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>月の残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>月の深夜残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>週の残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>週の深夜残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>月の法定休日残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>月の法定休日深夜残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>週の法定休日残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>週の法定休日深夜残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>年の法定外休日残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>年の法定外休日深夜残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>月の法定外休日残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>月の法定外休日深夜残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>週の法定外休日残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>週の法定外休日深夜残業時間(分) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>年の残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>年の深夜残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>月の残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>月の深夜残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>週の残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>週の深夜残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>月の法定休日残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>月の法定休日深夜残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>週の法定休日残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>週の法定休日深夜残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>年の法定外休日残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>年の法定外休日深夜残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>月の法定外休日残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>月の法定外休日深夜残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>週の法定外休日残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) | |
| 変形労働>週の法定外休日深夜残業時間(時間) | KING OF TIME→HRBrain | 勤怠情報(前月分) |
連携できる人
開発者向け向けサイトの以下権限が必要です。
・[外部サービス同士の連携]権限
・[公開API Token設定]権限(Token取得のため)
▷データ連携/開発者向けサイトについて>開発者向けサイト内の権限付与の方法
操作方法
①[メニュー] > [開発者向けサイト] > [外部サービスとの連携]をクリック
②[新規連携設定]ボタンをクリック
③連携方向と連携先サービスを選択し[作成]ボタンをクリック
④[認証情報設定]で勤革時の認証情報(アクセストークン)とHRBrainの認証情報(クライアントシークレット)を入力
※HRBrainのクライアントシークレット発行方法はこちらをご確認ください
⑤[マッピング設定]で連携したい項目を選択し[保存]をクリック
従業員項目の設定
💡ポイント
[退職者を連携対象外とする]にチェックを入れると退職者は連携されなくなります。
[雇用区分]と[所属]のチェックを外すことで連携しないように設定できます。
勤怠項目の設定
保存された設定は[開発者向けサイト] > [外部連携サービスとの連携] > [連携設定]に一覧で表示されます
⑥手動実行を行いたい場合は、[連携実行]をクリックするとデータ連携が実行されます
- 基本日次連携(毎日AM03:15)
- KING OF TIMEの利用禁止時間帯(8:30~10:00、17:30~18:30)は連携実行ボタンは押せない
⑦データ連携結果は[連携ログ]から確認できます
注意事項
- 連携設定はそれぞれ片方向ずつの設定となります。(KING OF TIME→HRBrain、HRBrain→KING OF TIME)
KING OF TIMEとHRBrainの相互連携設定はできません。 - 連携キーとなる従業員番号もしくはメールアドレスが変更された場合、変更前と変更後で別のアカウントとみなし連携処理を行います
【連携元サービスで連携キーを変更した】
変更後の従業員情報が、連携先に新規追加される
【連携先サービスで連携キーを変更した】
連携元サービスに残存する変更前の従業員情報を、連携先に新規追加します。
その際、変更前後の従業員情報の重複により、エラーとなる場合があります。
メンバー情報の自動削除をONにしていた場合、連携先の変更後のアカウントは削除されます。
-
所属組織の連携設定について
-
KING OF TIMEの所属コードとHRBrainの主部署をマッピングして連携設定が行われます
-
KING OF TIMEに登録される組織名称と階層とHRBrainの主部署をあわせていただく必要があります。組織名称と階層が完全一致しない場合連携エラーとなりますので注意してください。
例:KING OF TIMEの所属組織:〇〇部>〇〇課と「>」も含む形で組織名称を登録してください。
-
-
HRBrain→KING OF TIMEへの連携で退職者情報を取り込みたくない場合、HRBrainの従業員情報から退職者は削除いただく必要があります。