freee勤怠管理Plusの勤怠データをAPI連携する

初回のみ行う作業：freee勤怠管理Plusとの連携

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

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

• 勤怠管理の方法を選択する
• API設定を行う

未設定の場合は以下のヘルプページをご確認の上、設定してください。

• freee人事労務とfreee勤怠管理Plus間で従業員情報を連携する - freee人事労務での事前設定を行う

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

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

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

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

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

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

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

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

1. ［勤怠］メニュー →［勤怠情報］→［一括更新］ボタンから［勤怠サマリー］をクリックします。
   freee人事労務の「勤怠基本設定」で勤怠管理の方法に「freee勤怠管理Plus」を選択している場合は、［勤怠］メニュー →［勤怠情報］→［勤怠データの取込］ボタンをクリックします。
2. 勤怠データのインポート画面が開きますので、［freee勤怠管理Plus］タブを選択します。
3. ［プレビュー］ボタンをクリックします。

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

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

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

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

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

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

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

固定時間制

フレックスタイム制

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

注意点

• 連携のキーが従業員番号になります。freee人事労務とfreee勤怠管理Plusの番号が一致するよう入力してください。
   
• 「8:30～10:00」と「17:30～18:30」の時間帯は、freee勤怠管理Plusの月別勤怠データAPIを用いたインポート機能が利用できません。
   
• freee勤怠管理Plusの「月別データの表示設定」は「締め日設定が15日以前/以後で表示範囲を決定（デフォルト）」に設定されていないと、インポート処理が失敗します。
  月別データの表示設定の詳細は、「月別データの表示期間変更方法」のヘルプページをご覧ください。
   
• 勤務・賃金設定が「裁量労働制」の場合は、API連携に未対応となります。
  裁量労働制の詳細は、「勤務・賃金設定 - 裁量労働制」のヘルプページをご覧ください。
  「freee形式」のCSVインポートにて勤怠データの取り込みが可能なため、詳しくは「「freee人事労務」とのCSV連携方法（裁量労働制）」のヘルプページをご覧ください。
   
• 「時間帯区分」はfreee勤怠管理Plus形式のCSV・API連携ではインポートできません。「時間帯区分」のインポートを行い、時間帯別に時給の計算を行いたい場合は、freee人事労務形式で勤怠インポートを行う必要があります。
  詳しくは、「時間帯別の時給の勤怠データをインポートする」のヘルプページをご覧ください。
• freee勤怠管理Plusの総出勤日数（デフォルト設定）は、freee勤怠管理Plusの 平日出勤日数（※）＋ 休日出勤日数 にて連携されます。
  ※ 「半休取得時の出勤日数の計上方法：0.5日として計上する」「半休取得時の出勤日数の計上方法：1日として計上する」のいずれの場合にも設定にかかわらず半休を取得すると「0.5日」として連携されます。
  「1日として計上する」の設定にしている際には、必ず「カスタムデータ項目設定」にて総出勤日数を連携する項目を作成する必要があります。
  
  ただし、カスタムデータ項目にて「総出勤日数」に「有休取得日数」を含めた日数で連携している場合、以下挙動となるためご注意ください。
• 「0.5日として計上する」設定にしている場合
  0.5日（半日出勤）＋0.5日（半休取得日数）＝1日として数えられます。
• 「1日として計上する」設定にしている場合
  1日（半日出勤）＋0.5日（半休取得日数）＝1.5日として数えられます。
  ※出勤日数と半休取得日数の集計が重複してしまい、正しい労働日数が集計ができなくなります。
  そのため、半日出勤＋半休取得日数＝1日として連携する場合は、「0.5日として計上する」設定が必要となります。
  
  なお、「半休取得時の出勤日数の計上方法」を変更する場合は、サポートデスクでの内部設定が必要です。「メールサポートを利用する【freee勤怠管理Plus】」のヘルプページを参考に、サポートデスクへお問い合わせください。
• freee勤怠管理Plusの「月別データの表示設定」は「締め日設定が15日以前/以後で表示範囲を決定（デフォルト）」に設定されていないと、インポート処理が失敗します。
  ※ freee勤怠管理Plusの「月別データ表示設定」はfreee人事労務の勤怠月表示と相違がないように設定を行ってください。
• 「時間外労働時間」の詳細設定として「所定内時間外労働時間」の連携が可能です。「所定内時間外労働時間」を利用する際は、「プロジェクト工数管理など、任意の時間集計項目の作成方法（補助項目：時間帯）- 参考：freee人事労務上に「所定内時間外労働」と「所定外時間外労働」を連携する場合」のヘルプページを合わせてご確認ください。
• 固定時間制やフレックス制で連携される勤怠項目が異なっているため、勤務・賃金設定の付け替えを行った際は、正しく勤怠集計をおこなうために、再度APIインポート作業を行ってください。
• freee人事労務を使用して給与計算を行う場合、「割増残業時間」と「割増深夜残業時間」は正しくインポートができません。
  固定残業代を支払われている場合であっても、freee勤怠管理Plus側では「割増残業集計機能」は行わないでください。
  ※ freee人事労務にて固定残業代の設定が行えるので、残業時間を全てインポートしても給与計算は正しく行われます。