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人事労務と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日として計上する」の設定にしている際には、必ず「カスタムデータ項目設定」にて総出勤日数を連携する項目を作成する必要があります。
  なお、「半休取得時の出勤日数の計上方法」を変更する場合は、サポートデスクでの内部設定が必要です。「メールサポートを利用する（freee勤怠管理Plus）」のヘルプページを参考に、サポートデスクへお問い合わせください。
• freee勤怠管理Plusの「月別データの表示設定」は「締め日設定が15日以前/以後で表示範囲を決定（デフォルト）」に設定されていないと、インポート処理が失敗します。
  ※ freee勤怠管理Plusの「月別データ表示設定」はfreee人事労務の勤怠月表示と相違がないように設定を行ってください。