勤革時の勤怠データをAPI連携する

初回のみ行う作業：勤革時との連携

① freee人事労務での事前設定を行う

勤革時の勤怠データをAPI連携する場合、事前に以下の事業所設定が必要となります。

1. ［設定］メニュー →［API連携］を開きます。
2. 勤革時の［連携する］ボタンをクリックします。
   

3. 勤革時の連携確認画面が表示されます。勤革時のIDとパスワードを入力し、［承諾する］をクリックします。

   • 勤革時の全権管理者権限を持つアカウントで認証を行ってください。
   • 正しいID・パスワードが入力されていない場合、エラーとなる可能性があります。連携エラーとなった場合は、連携時に入力したID・パスワードを再確認の上、勤革時の全権管理者権限の正しいID・パスワードで再度連携をお試しください。
4. 勤革時との連携が完了します。

② freee人事労務と勤革時の従業員番号が一致しているか確認する

勤革時の勤怠データをAPI連携する場合、freee人事労務と勤革時の従業員番号が一致している必要があります。

連携させる従業員の従業員番号をご確認ください。
 

③ カスタムデータ項目連携の設定を行う

勤怠データのインポート画面の「カスタムデータ項目の連携」欄で、freee人事労務の勤怠項目と勤革時の勤怠項目を紐付けるための設定を行います。設定後は［設定を保存］ボタンをクリックします。

※ 各項目の対応については、本ページの「連携対応表（デフォルト設定）」または「連携対応表（カスタムデータ項目作成時）」をご覧ください。

※ この設定は締め日支払い日グループごとに保存されます。

毎月行う作業：APIインポート作業

1. ［勤怠］メニュー →［勤怠情報］→［一括更新］ボタンから［勤怠サマリー］をクリックします。
2. 勤怠データのインポート画面が開きますので、［勤革時］タブを選択します。
3. ［プレビュー］ボタンをクリックします。

4. 勤革時側のカスタムデータ項目を利用しない場合や、既に設定済みの場合は［インポート］ボタンをクリックします。
   勤革時側のカスタムデータ項目を利用する場合は、「カスタムデータ項目連携」の設定を行ってください。freee人事労務側の勤怠項目と勤革時側の勤怠項目を紐付けるための設定ができます。設定後は［設定を保存］→［インポート］ボタンの順にクリックします。

   ※ 各項目の対応については、本ページの「連携対応表（デフォルト設定）」または「連携対応表（カスタムデータ項目作成時）」をご覧ください。
    

連携対応表（デフォルト設定）

連携項目におけるデフォルト設定の対応は下表のとおりです。

連携対応表（カスタムデータ項目作成時）

連携対応表（デフォルト）の設定では、勤革時で法定外休日に勤務した所定時間、所定外時間が「時間外労働時間」に集計されるようになっています。
freee人事労務の集計方法に合わせて所定休日の勤務時間を「法定内残業時間」として集計する場合は、以下の連携対応表の「freee連携用所定外時間」のようにカスタムデータ項目を作成する必要があります。

カスタムデータ項目作成時における対応は下表のとおりです。

固定時間制

フレックスタイム制

カスタムデータ項目のよくある設定例

本セクションでは、freee人事労務の各労働時間に連携するためのカスタムデータ項目のよくある設定例をご紹介します。

有休取得日数を労働日数に含める場合

デフォルト設定の「総勤務日数」では、有休取得日数が含まれません。
そのため、総勤務日数＋有休取得日数を集計するカスタムデータ項目を作成する必要があります。
詳しい操作手順は、次のとおりです。

1. ［設定］メニュー →［画面表示］→［カスタムデータ項目設定］から、［月別］タブを開きます

2. ［＋新規作成］をクリックし、次の内容でカスタムデータ項目を登録します。
   【有休を含めた「総労働日数」の場合】

   • 「計算単位：日」を選択し、以下項目の「＋」にチェックを入れる
     • 平日出勤日数
     • 休日出勤日数 法定休日出勤日数
     • 法定外休日出勤日数
     • 有休取得日数

   【有休を含めた「所定労働出勤日数」の場合】

   • 「計算単位：日」を選択し、以下項目の「＋」にチェックを入れる
     • 平日出勤日数
     • 有休取得日数
3. 上記で作成したカスタムデータ項目を「労働日数」に紐づけて設定は完了となります。

無給休暇の取得分を給与から控除したい場合

独自に設定している無給休暇の取得分を給与から控除する場合は、控除する無給休暇の取得分を「欠勤日数」または「遅刻時間 or 早退時間」とあわせて集計するカスタムデータ項目を作成する必要があります。
詳しい操作手順は、次のとおりです。

1. ［設定］メニュー →［画面表示］→［カスタムデータ項目設定］から、［月別］タブを開きます

2. ［＋新規作成］をクリックし、次の内容でカスタムデータ項目を登録します。
   【無給休暇の「取得日数」を控除したい場合】

   • 「計算単位：日」を選択し、以下項目の「＋」にチェックを入れる
     • 欠勤取得日数
     • 無給休暇（※休暇名が表示されます）取得日数

   【無給休暇の「取得時間」を控除したい場合】

   • 「計算単位：時間」を選択し、以下項目「＋」にチェックを入れる
     • 早退時間 or 遅刻時間
     • 無給休暇（※休暇名が表示されます）時間休取得時間
3. 上記で作成したカスタムデータ項目を「欠勤日数」または「遅刻時間 or 早退時間」に紐づけて設定は完了となります。

在宅/出社回数に応じて手当を計算する場合

在宅/出社回数に応じて通勤手当を支給する場合は、まずfreee人事労務で「日次タグ・通勤手当」の設定が必要となります。
設定方法については、「在宅/出社回数に応じて手当を計算するケースの活用例」のヘルプページをご参照ください。
日次タグ、通勤手当を設定後の詳しい操作手順は、次のとおりです。

1. 勤革時で「スケジュール汎用フラグ」の設定をし、出社をした日付に「出社（※設定した汎用フラグ名が表示されます）」のチェックをいれます。
2. 「スケジュール汎用フラグ」の数を集計するカスタムデータ項目を作成します。
   ［設定］メニュー →［画面表示］→［カスタムデータ項目設定］から、［月別］タブを開きます。
   ［＋新規作成］をクリックし、次の内容でカスタムデータ項目を登録します。
   • 「計算単位：数値」を選択し、「出社（※設定した汎用フラグ名が表示されます）」の項目に「＋」のチェックを入れ、登録します。
3. freee人事労務のカスタムデータ項目連携の画面にて日次タグとカスタムデータ項目を紐づけて設定完了となります。

注意点

• 連携のキーが従業員番号になります。freee人事労務と勤革時の番号が一致するよう入力してください。
• 「8:30～10:00」と「17:30～18:30」の時間帯は、勤革時の月別勤怠データAPIを用いたインポート機能が利用できません。
  詳しくは、勤革時の「利用禁止時間帯」ページをご覧ください。
• 勤革時の「月別データの表示設定」は「締め日設定が15日以前/以後で表示範囲を決定（デフォルト）」に設定されていないと、インポート処理が失敗します。
• 勤務・賃金設定が「裁量労働制」の場合は、API連携に未対応となります。
  詳しくは、「勤務・賃金設定 - 裁量労働制」のヘルプページをご覧ください。
  「freee形式」のCSVインポートにて勤怠データの取り込みが可能です。詳しくは、「他社サービスの勤怠データを取り込む（インポート）- freee形式の勤怠データの入力について」のヘルプページをご覧ください。
   
• 「時間帯区分」はインポートできません。
  詳しくは、勤革時の「早朝、昼、夜間など任意の時間帯ごとの労働時間の集計方法（時間帯区分設定機能）」のヘルプページをご覧ください。
• 勤革時の総出勤日数（デフォルト設定）は、勤革時の 平日出勤日数（※）＋ 休日出勤日数 にて連携されます。
  ※ 「半休取得時の出勤日数の計上方法：0.5日として計上する」に設定している場合、半休を取得すると「0.5日」として連携されます。
  ただし、カスタムデータ項目にて「総出勤日数」に「有休取得日数」を含めた日数で連携している場合、以下挙動となるためご注意ください。

• 「0.5日として計上する」設定にしている場合

  0.5日（半日出勤）＋0.5日（半休取得日数）＝1日として数えられます。

• 「1日として計上する」設定にしている場合
  1日（半日出勤）＋0.5日（半休取得日数）＝1.5日として数えられます。
  ※出勤日数と半休取得日数の集計が重複してしまい、正しい労働日数が集計ができなくなります。
  そのため、半日出勤＋半休取得日数＝1日として連携する場合は、「0.5日として計上する」設定が必要となります。

  なお、「半休取得時の出勤日数の計上方法」を変更する場合は、内部設定が必要です。変更ご希望の場合は、勤革時のサポートセンターへお問い合わせください。

• 勤革時の「月別データの表示設定」は「締め日設定が15日以前/以後で表示範囲を決定（デフォルト）」に設定されていないと、インポート処理が失敗します。
  ※ 勤革時の「月別データ表示設定」はfreee人事労務の勤怠月表示と相違がないように設定を行ってください。
• 「時間外労働時間」の詳細設定として「所定内時間外労働時間」の連携が可能です。「所定内時間外労働時間」を利用する際は 、「プロジェクト工数管理など、任意の時間集計項目の作成方法（補助項目：時間帯）- 参考：freee人事労務上に「所定内時間外労働」と「所定外時間外労働」を連携する場合」のヘルプページを合わせてご確認ください。
  • 上記ヘルプページは「freee勤怠管理Plus」の仕様です。必ずしも勤革時と同じではありません。
• 固定時間制やフレックス制で連携される勤怠項目が異なっているため、勤務・賃金設定の付け替えを行った際は、正しく勤怠集計をおこなうために、再度APIインポート作業を行ってください。
• freee人事労務を使用して給与計算を行う場合、「割増残業時間」と「割増深夜残業時間」は正しくインポートができません。
  固定残業代を支払われている場合であっても、勤革時側では「割増残業集計機能」は行わないでください。
  ※ freee人事労務にて固定残業代の設定が行えるので、残業時間を全てインポートしても給与計算は正しく行われます。