メインコンテンツに移動

よく見られているFAQFAQ

freee人事労務に関するFAQ

カテゴリ一覧

QKING OF TIME for おまかせ はたラクサポートの勤怠データをAPI連携する

A
 対象プラン

新プラン ミニマム スターター スタンダード アドバンス 

旧プラン ミニマム ベーシック プロフェッショナル エンタープライズ

 freee人事労務は、KING OF TIME for おまかせ はたラクサポート by NTT東日本 の勤怠データをAPI連携することに対応しています。

 

初回のみ行う作業:KING OF TIME for おまかせ はたラクサポートとの連携

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

KING OF TIME for おまかせ はたラクサポートの勤怠データをAPI連携する場合、事前に以下の事業所設定が必要となります。

❶ [設定]メニュー →[API連携]を開きます。

❷ はたラクサポートの[連携する]ボタンをクリックします。


❸ KING OF TIME for おまかせ はたラクサポートの連携確認画面が表示されます。KING OF TIME for おまかせ はたラクサポートのIDとパスワードを入力し、[承諾する]をクリックします。

 

!注意

KING OF TIME for おまかせ はたラクサポートの全権管理者権限を持つアカウントで認証を行ってください。

正しいID・パスワードが入力されていない場合、エラーとなる可能性があります。連携エラーとなった場合は、連携時に入力したID・パスワードを再確認の上、はたラクサポートの全権管理者権限の正しいID・パスワードで再度連携をお試しください。


❹ KING OF TIME for おまかせ はたラクサポートとの連携が完了します。

»② freee人事労務とKING OF TIME for おまかせ はたラクサポートの連携条件が一致しているか確認する

※KING OF TIME for おまかせ はたラクサポートの勤怠データをAPI連携する場合、以下の条件を満たす必要があります。

条件1  freee人事労務とKING OF TIME for おまかせ はたラクサポートの従業員番号が一致している

条件2  freee人事労務の締め日と支払い日設定の締め日とKING OF TIME for おまかせ はたラクサポートの雇用区分の締め日が一致している。

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

!注意

 KING OF TIME for おまかせ はたラクサポートで設定したカスタムデータ項目を利用する場合は本操作が必要です。


勤怠データのインポート画面の「カスタムデータ項目の連携」欄で、freee人事労務の勤怠項目と KING OF TIME for おまかせ はたラクサポートの勤怠項目を紐付けるための設定を行います。設定後は[設定を保存]ボタンをクリックします。

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

 

 

 

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

!注意

 KING OF TIME for おまかせ はたラクサポートからデフォルトの設定で勤怠データを取り込むと、有休取得日数が「総出勤日数」や「所定労働出勤日数」に含まれません。

そのため、有休取得日数を「総出勤日数」や「所定労働出勤日数」に含める場合は、freee人事労務にAPIインポートを行う前に KING OF TIME for おまかせ はたラクサポート側でカスタムデータ項目を登録する必要があります。
 

また、API連携では時間単位の休暇の取得日数を取り込むことができません。
時間単位の休暇を取得できるようにしている場合、休暇の管理は、はたラクサポート側で行っていただくようにお願いします。

※ 「半休取得時の出勤日数の計上方法」が「1日として計上する」設定になっている場合、半休が2日以上ある際に日数が重複してしまい正しい日数で計上されません。「1日として計上する」から「0.5日として計上する」に変更することで正しく計上されます。

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


❶ [勤怠]メニュー →[勤怠情報]→[一括更新]ボタンから[勤怠サマリー]をクリックします。

❷ 勤怠データのインポート画面が開きますので、[はたラクサポート]タブを選択します。

❸ [プレビュー]ボタンをクリックします。

❹  KING OF TIME for おまかせ はたラクサポート側のカスタムデータ項目を利用しない場合や、既に設定済みの場合は[インポート]ボタンをクリックします。
 KING OF TIME for おまかせ はたラクサポート側のカスタムデータ項目を利用する場合は、「カスタムデータ項目連携」の設定を行ってください。freee人事労務側の勤怠項目と KING OF TIME for おまかせ はたラクサポート側の勤怠項目を紐付けるための設定ができます。設定後は[設定を保存]→[インポート]ボタンの順にクリックします。

連携対応表(デフォルト設定)

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

!注意

連携対応表に記載のない項目の注意

• 「有休取得時間」や「特別休暇」に関する項目など、下記の連携対応表に記載のない項目はfreee人事労務に反映されません。

• 各項目の内訳を変更したい場合などは、 KING OF TIME for おまかせ はたラクサポートでカスタムデータ項目を作成してご対応ください。


 

freee人事労務 はたラクサポートはたラクサポートの内訳
従業員コード
従業員コード
 
労働日数
総出勤日数
平日出勤日数
休日出勤日数
総勤務総間
労働時間合計
所定時間
所定外時間
残業時間
深夜所定時間
深夜所定外時間
深夜残業時間
休日.所定時間
休日.所定外時間
休日.残業時間
休日深夜所定時間
休日深夜所定外時間
休日深夜残業時間
所定内労働時間
※ フレックスタイム制のみ勤務・賃金設定ごとに複数設定できます。
 所定時間
所定時間
深夜所定時間
法定内残業時間
※ フレックスタイム制のみ勤務・賃金設定ごとに複数設定できます。
所定外時間
所定外時間
時間外労働時間
※ フレックスタイム制のみ勤務・賃金設定ごとに複数設定できます。
時間外労働時間
残業時間
深夜残業時間
法定外休日所定時間
法定外休日所定外時間
法定外休日残業時間
法定外休日深夜所定時間
法定外休日深夜所定外時間
法定外休日深夜残業時間
法定休日時間
法定休日労働時間
法定休日所定時間
法定休日所定外時間
法定休日残業時間
法定休日深夜所定時間
法定休日深夜所定外時間
法定休日深夜残業時間
深夜労働時間
深夜労働時間
深夜所定時間
深夜所定外時間
深夜残業時間
休日深夜所定時間
休日深夜所定外時間
休日深夜残業時間
遅刻時間
遅刻時間
 
早退時間
早退時間
 
有休取得日数
有休取得日数
 
所定労働出勤日数
平日出勤日数
 
所定休日出勤日数
法定外休日出勤日数
 
法定休日出勤日数
法定休日出勤日数
 
欠勤日数
欠勤取得日数
 
遅刻日数
遅刻回数
 
早退回数
早退回数
 

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

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

 

Tips

freee人事労務で設定した「日次タグ」についても、カスタムデータ項目を紐づけることが可能です。

※公開中の日次タグのみ設定可能です。
※日次タグを利用可能な従業員のみインポートされます。
※計算単位が「時間」「数値」のカスタムデータ項目のみ連携可能です。
※整数の値のみインポート可能なため、連携する数字に小数点がある場合は連携されません。


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

 

!注意

• 対応関係はあくまで一例となりますので、給与規定などを元に適宜変更して設定ください。

• カスタムした部分は太字で強調しています。

 

»固定時間制

 
freee人事労務 はたラクサポートはたラクサポートの内訳
従業員コード
従業員コード
 
労働日数
freee連携用総出勤日数
平日出勤日数
休日出勤日数
有休取得日数
総勤務総間
労働時間合計
所定時間
所定外時間
残業時間
深夜所定時間
深夜所定外時間
深夜残業時間
休日.所定時間
休日.所定外時間
休日.残業時間
休日深夜所定時間
休日深夜所定外時間
休日深夜残業時間
所定内労働時間
 所定時間
所定時間
深夜所定時間
法定内残業時間
freee連携用所定外時間
所定外時間
深夜所定外時間
法定外休日所定時間
法定外休日所定外時間
法定外休日深夜所定時間
法定外休日深夜所定外時間
時間外労働時間
freee連携用時間外労働時間
残業時間
深夜残業時間
法定外休日残業時間
法定外休日深夜残業時間
法定休日時間
法定休日労働時間
法定休日所定時間
法定休日所定外時間
法定休日残業時間
法定休日深夜所定時間
法定休日深夜所定外時間
法定休日深夜残業時間
深夜労働時間
深夜労働時間
深夜所定時間
深夜所定外時間
深夜残業時間
休日深夜所定時間
休日深夜所定外時間
休日深夜残業時間
遅刻時間
遅刻時間
 
早退時間
早退時間
 
有休取得日数
有休取得日数
 
所定労働出勤日数
freee連携用平日出勤日数
平日出勤日数
有休取得日数
所定休日出勤日数
法定外休日出勤日数
 
法定休日出勤日数
法定休日出勤日数
 
欠勤日数
欠勤取得日数
 
遅刻日数
遅刻回数
 
早退回数
早退回数
 
日次タグ
※日次タグを作成して、公開していると名称が表示されます。
任意のカスタムデータ項目(※計算単位:数値・日のみ)※日次タグに数字を連携する場合は、計算単位が「日 or 数値」のカスタムデータ項目の作成が必要です。


»フレックスタイム制

 

freee人事労務 はたラクサポートはたラクサポートの内訳
従業員コード
従業員コード
 
労働日数
freee連携用総出勤日数
平日出勤日数
休日出勤日数
有休取得日数
総勤務総間
労働時間合計
所定時間
所定外時間
残業時間
深夜所定時間
深夜所定外時間
深夜残業時間
休日.所定時間
休日.所定外時間
休日.残業時間
休日深夜所定時間
休日深夜所定外時間
休日深夜残業時間
所定内労働時間(フレックスタイム制)
※ 勤務・賃金設定ごとに複数設定できます。
 フレックス基準内所定労働時間
フレックス基準内所定労働時間
法定内残業時間(フレックスタイム制)
※ 勤務・賃金設定ごとに複数設定できます。
フレックス基準内所定外時間
フレックス基準内所定外時間
時間外労働時間(フレックスタイム制)
※ 勤務・賃金設定ごとに複数設定できます。
フレックス基準外労働時間
フレックス基準外労働時間
法定休日時間
法定休日労働時間
法定休日所定時間
法定休日所定外時間
法定休日残業時間
法定休日深夜所定時間
法定休日深夜所定外時間
法定休日深夜残業時間
深夜労働時間
深夜労働時間
深夜所定時間
深夜所定外時間
深夜残業時間
休日深夜所定時間
休日深夜所定外時間
休日深夜残業時間
遅刻時間
遅刻時間
 
早退時間
早退時間
 
有休取得日数
有休取得日数
 
所定労働出勤日数
freee連携用平日出勤日数
平日出勤日数
有休取得日数
所定休日出勤日数
法定外休日出勤日数
 
法定休日出勤日数
法定休日出勤日数
 
欠勤日数
欠勤取得日数
 
遅刻日数
遅刻回数
 
早退回数
早退回数
 
不足時間
フレックス所定労働不足時間
※「freee人事労務側で自動計算する」を選択した場合、勤務・賃金設定で登録した総労働時間から自動計算されます。
フレックス所定労働不足時間

 

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

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

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

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

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

❷ [+新規作成]をクリックし、次の内容でカスタムデータ項目を登録します。
【有休を含めた「総労働日数」の場合】
• 「計算単位:日」を選択し、以下項目の「+」にチェックを入れる
 º 平日出勤日数
 º 休日出勤日数 法定休日出勤日数
 º 法定外休日出勤日数
 º 有休取得日数

【有休を含めた「所定労働出勤日数」の場合】
• 「計算単位:日」を選択し、以下項目の「+」にチェックを入れる
 º 平日出勤日数
 º 有休取得日数

❸ 上記で作成したカスタムデータ項目を「労働日数」に紐づけて設定は完了となります。

 

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

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

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

❷ [+新規作成]をクリックし、次の内容でカスタムデータ項目を登録します。
【無給休暇の「取得日数」を控除したい場合】
•  「計算単位:日」を選択し、以下項目の「+」にチェックを入れる
 º 欠勤取得日数
 º 無給休暇(※休暇名が表示されます)取得日数

【無給休暇の「取得時間」を控除したい場合】
•  「計算単位:時間」を選択し、以下項目「+」にチェックを入れる
 º 早退時間 or 遅刻時間
 º 無給休暇(※休暇名が表示されます)時間休取得時間

❸ 上記で作成したカスタムデータ項目を「欠勤日数」または「遅刻時間 or 早退時間」に紐づけて設定は完了となります。



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

在宅/出社回数に応じて通勤手当を支給する場合は、まずfreee人事労務で「日次タグ・通勤手当」の設定が必要となります。
日次タグ、通勤手当を設定後の詳しい操作手順は、次のとおりです。

❶ はたラクサポートで「スケジュール汎用フラグ」の設定をし、出社をした日付に「出社(※設定した汎用フラグ名が表示されます)」のチェックをいれます。

❷ 「スケジュール汎用フラグ」の数を集計するカスタムデータ項目を作成します。
[設定]メニュー →[画面表示]→[カスタムデータ項目設定]から、[月別]タブを開きます。
[+新規作成]をクリックし、次の内容でカスタムデータ項目を登録します。
•  「計算単位:数値」を選択し、「出社(※設定した汎用フラグ名が表示されます)」の項目に「+」のチェックを入れ、登録します。

❸ freee人事労務のカスタムデータ項目連携の画面にて日次タグとカスタムデータ項目を紐づけて設定完了となります。

 

注意点

•  連携のキーが従業員番号になります。freee人事労務とはたラクサポートの番号が一致するよう入力してください。

•  「8:30~10:00」と「17:30~18:30」の時間帯は、はたラクサポートの月別勤怠データAPIを用いたインポート機能が利用できません。
詳しくは、はたラクサポートの「利用禁止時間帯」ページをご覧ください。

•  はたラクサポートの「月別データの表示設定」は「締め日設定が15日以前/以後で表示範囲を決定(デフォルト)」に設定されていないと、インポート処理が失敗します。

•  勤務・賃金設定が「裁量労働制」の場合は、API連携に未対応となります。
「freee形式」のCSVインポートにて勤怠データの取り込みが可能です。

•  「時間帯区分」はインポートできません。
詳しくは、KING OF TIMEの「早朝、昼、夜間など任意の時間帯ごとの労働時間の集計方法(時間帯区分設定機能)」のヘルプページをご覧ください。

•  はたラクサポートの総出勤日数(デフォルト設定)は、はたラクサポートの 平日出勤日数(※)+ 休日出勤日数 にて連携されます。
※ 「半休取得時の出勤日数の計上方法:0.5日として計上する」に設定している場合、半休を取得すると「0.5日」として連携されます。
ただし、カスタムデータ項目にて「総出勤日数」に「有休取得日数」を含めた日数で連携している場合、以下挙動となるためご注意ください。

•  「0.5日として計上する」設定にしている場合
0.5日(半日出勤)+0.5日(半休取得日数)=1日として数えられます。
 

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

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

•  はたラクサポートの「月別データの表示設定」は「締め日設定が15日以前/以後で表示範囲を決定(デフォルト)」に設定されていないと、インポート処理が失敗します。
※ はたラクサポートの「月別データ表示設定」はfreee人事労務の勤怠月表示と相違がないように設定を行ってください。

•  固定時間制やフレックス制で連携される勤怠項目が異なっているため、勤務・賃金設定の付け替えを行った際は、正しく勤怠集計をおこなうために、再度APIインポート作業を行ってください。

•  freee人事労務を使用して給与計算を行う場合、「割増残業時間」と「割増深夜残業時間」は正しくインポートができません。
固定残業代を支払われている場合であっても、はたラクサポート側では「割増残業集計機能」は行わないでください。
※ freee人事労務にて固定残業代の設定が行えるので、残業時間を全てインポートしても給与計算は正しく行われます。

この回答はお役に立ちましたか?

ページ上部へ