データ連携/勤革時とのAPI連携方法
2025-10-15 10:41:35 UTC
勤革時 API連携でできること
勤革時の従業員情報もしくは勤怠情報を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→勤革時 勤革時→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 | 勤怠情報（前月分） | |
| 深夜労働時間（時間） | 勤革時→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 | 勤怠情報（前月分） | |
| 法定休日労働>深夜労働時間（分） | 勤革時→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 | 勤怠情報（前月分） | |
| 拘束時間（分） | 勤革時→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 | 勤怠情報（前月分） | |
| 変形労働>週の法定外休日深夜残業時間（分） | 勤革時→HRBrain | 勤怠情報（前月分） | |
| 変形労働>年の残業時間（時間） | 勤革時→HRBrain | 勤怠情報（前月分） | |
| 変形労働>年の深夜残業時間（時間） | 勤革時→HRBrain | 勤怠情報（前月分） | |
| 変形労働>月の残業時間（時間） | 勤革時→HRBrain | 勤怠情報（前月分） | |
| 変形労働>月の深夜残業時間（時間） | 勤革時→HRBrain | 勤怠情報（前月分） | |
| 変形労働>週の残業時間（時間） | 勤革時→HRBrain | 勤怠情報（前月分） | |
| 変形労働>週の深夜残業時間（時間） | 勤革時→HRBrain | 勤怠情報（前月分） | |
| 変形労働>月の法定休日残業時間（時間） | 勤革時→HRBrain | 勤怠情報（前月分） | |
| 変形労働>月の法定休日深夜残業時間（時間） | 勤革時→HRBrain | 勤怠情報（前月分） | |
| 変形労働>週の法定休日残業時間（時間） | 勤革時→HRBrain | 勤怠情報（前月分） | |
| 変形労働>週の法定休日深夜残業時間（時間） | 勤革時→HRBrain | 勤怠情報（前月分） | |
| 変形労働>年の法定外休日残業時間（時間） | 勤革時→HRBrain | 勤怠情報（前月分） | |
| 変形労働>年の法定外休日深夜残業時間（時間） | 勤革時→HRBrain | 勤怠情報（前月分） | |
| 変形労働>月の法定外休日残業時間（時間） | 勤革時→HRBrain | 勤怠情報（前月分） | |
| 変形労働>月の法定外休日深夜残業時間（時間） | 勤革時→HRBrain | 勤怠情報（前月分） | |
| 変形労働>週の法定外休日残業時間（時間） | 勤革時→HRBrain | 勤怠情報（前月分） | |
| 変形労働>週の法定外休日深夜残業時間（時間） | 勤革時→HRBrain | 勤怠情報（前月分） |
連携できる人
開発者向け向けサイトの以下権限が必要です。
・[外部サービス同士の連携]権限
・[公開API Token設定]権限（Token取得のため）
▷データ連携/開発者向けサイトについて>開発者向けサイト内の権限付与の方法
操作方法
①[メニュー] > [開発者向けサイト] > [外部サービスとの連携]をクリック
②[新規連携設定]ボタンをクリック
③連携方向と連携先サービスを選択し[作成]ボタンをクリック
④[認証情報設定]で勤革時の認証情報（アクセストークン）とHRBrainの認証情報（クライアントシークレット）を入力
※HRBrainのクライアントシークレット発行方法はこちらをご確認ください
⑤[マッピング設定]で連携したい項目を選択し[保存]をクリック
従業員項目の設定
💡ポイント
[退職者を連携対象外とする]にチェックを入れると退職者は連携されなくなります。
[雇用区分]と[所属]のチェックを外すことで連携しないように設定できます。
勤怠項目の設定
保存された設定は[開発者向けサイト] > [外部連携サービスとの連携] > [連携設定]に一覧で表示されます
⑥手動実行を行いたい場合は、[連携実行]をクリックするとデータ連携が実行されます
- 基本日次連携（毎日AM03:15）
- 勤革時の利用禁止時間帯（8:30～10:00、17:30～18:30）は連携実行ボタンは押せない
⑦データ連携結果は[連携ログ]から確認できます
注意事項
- 連携設定はそれぞれ片方向ずつの設定となります。（勤革時→HRBrain、HRBrain→勤革時）
勤革時とHRBrainの相互連携設定はできません。 - 連携キーとなる従業員番号もしくはメールアドレスが変更された場合、変更前と変更後で別のアカウントとみなし連携処理を行います
【連携元サービスで連携キーを変更した】
変更後の従業員情報が、連携先に新規追加される
【連携先サービスで連携キーを変更した】
連携元サービスに残存する変更前の従業員情報を、連携先に新規追加します。
その際、変更前後の従業員情報の重複により、エラーとなる場合があります。
メンバー情報の自動削除をONにしていた場合、連携先の変更後のアカウントは削除されます。