『KING OF TIME』とサービス連携(API連携)することで、KING OF TIMEの勤怠データをFORROUに取り込み、給与計算に利用できます。
なお、勤怠データの取り込みは、FORROU側で操作が必要です。
本記事では、連携に必要な事前準備から、初回設定、勤怠データの取込手順までをご案内します。
勤怠データをCSV形式で取り込む場合は、以下の記事をご参照ください。
▶給与/賞与計算 勤怠データや変動(入力表)項目の金額をCSV形式で取り込む方法
目次
事前準備
利用権限
連携設定と勤怠データの取り込みには、以下の権限が付与されているアカウントが必要です。
- KING OF TIME : 全権管理者権限
顧問先事業所に、社労士用の管理者アカウントを「全権管理者権限」で発行を依頼します。
- FORROU:管理者権限 (▶ユーザの種類(権限)について)
従業員の紐付けに使用する情報
連携にあたり、KING OF TIMEの「従業員コード」と、FORROUの「従業員No」または「外部システムキー」を一致させてください。
※「前ゼロを省略して紐付け」機能により、「1」→「000001」や「000001」→「1」のように、冒頭のゼロを省略して判定することは可能です。
従業員の姓名も確認し、両サービスで登録内容が一致していることをご確認ください。
給与計算期間・締め日の設定
FORROUとKING OF TIMEで、取り込む勤怠データの集計期間が一致しているか、事前にご確認ください。
- FORROU: 給与計算期間(自~至)
- KING OF TIME: 勤怠の締め日
FORROUの「給与入力表取込」画面にある「取込対象年月(KING OF TIME)」には、対象給与の給与計算期間(自~至)の末日(勤怠締日)が属する年月が初期表示されます。
取り込むデータを変更する場合は、手動で変更することも可能です。
勤怠項目
KING OF TIMEから取り込む勤怠項目と、FORROU側の取込先項目をご確認ください。
カスタムデータ項目を使用している場合は、必要に応じてFORROU側にも対応する勤怠項目を追加してください。
なお、FORROUでは勤怠項目の紐付け設定時に、複数の項目を加算・減算することも可能です。詳しくは「▶複数の項目を加算・減算する」をご確認ください。
取込対象者
FORROU側の給与入力表に表示されている給与対象者を、取込対象とします。
事前に給与対象者をご確認ください。
取込元のデータに給与入力表に表示されていない従業員が含まれている場合は、以下の条件を満たしていれば、取込時に給与対象者として追加できます。詳細は▶黄色の背景で表示され、取込対象チェックが外れている場合をご確認ください。
- FORROUに従業員情報が登録されている
- 取込先給与データと同じ給与グループに所属している
また、KING OF TIMEの所属情報をもとに、給与入力表取込画面で「取込対象となる所属名(KING OF TIME)」を選択し、取込対象者を絞り込むこともできます。
API連携を利用できない時間帯
以下の時間帯は、KING OF TIMEのAPI制限により、勤怠データの取得をおこなえません。
制限時間帯:8:30 ~ 10:00 / 17:30 ~ 18:30
データ連携の設定をする
- FORROUに管理者権限を持つアカウントでログインし、画面右上の事務所名>サービス連携をクリックします。
- サービス連携画面の「外部連携」タブを選択し、『KING OF TIME』の「設定」をクリックします。
- API連携先となる事業所の「設定する」をクリックします。
- 別ウィンドウで開くKING OF TIMEの連携設定画面に、社労士用の全権管理者アカウントのIDとパスワードを入力します。
利用規約・同意書を確認し、同意のチェックを入れて「承諾する」をクリックします。
- 「認証が完了しました。」と表示されたら連携設定の完了です。顧問先担当者による認証操作等は不要です。
- 認証が完了すると、API連携画面では「状態:連携済」と表示されます。
勤怠データの取り込み方法
取込画面を表示する
-
▶事業所画面>サイドメニューの計算処理をクリックし、給与賞与登録一覧を表示します。登録一覧画面から該当の給与を選択し、入力計算画面を表示します。
計算データ領域が未作成の場合は、新規給与を選択し、計算データ領域を作成します。
▶給与計算画面の作成方法(給与計算新規作成画面の利用方法)
- 給与入力計算画面上部「入力表」をクリックし、「取込」をクリックします。
データ取込の操作手順
給与入力表取込画面で「①設定」→「②紐付け処理」→「③確認」の設定をおこないます。
①設定
「①設定」画面では、取込データの選択や、データ取込に関わる設定をします。「次へ」で「②紐付け処理」へ進みます。
| 項目名 | 説明 |
|---|---|
| 取込元 | 「KING OF TIME」を選択します。 |
| 従業員紐付け | 従業員情報と取込データを結びつけるキーをプルダウンから選択します。 外部システムキーは従業員No以外で従業員を紐付けるキーとして▶従業員情報>基本情報で設定します。 ※「前ゼロを省略して紐付け」にチェックを入れると、先頭のゼロを省略し、従業員No「1」と「000001」を同一者としてデータの紐付けができます。 |
| 取込対象年月(KING OF TIME) | KING OF TIMEから取得する勤怠データの対象年月を指定します。 FORROU給与計算期間(自~至)の末日(勤怠締日)が属する年月が初期表示されます。必要に応じて変更してください。 |
| 取込対象となる所属名(KING OF TIME) | KING OF TIME側で所属設定で登録されている所属名が表示されます。取り込み対象を絞り込む場合は選択します。 複数選択はできません。 |
②紐付け処理(連携)
「②紐付け処理」画面では、KING OF TIMEの取込ヘッダ項目(左側)と、FORROUの給与関連項目(右側)が表示されます。
初回設定時は、一部の既定項目のみ自動で紐付けされます。▶紐付け項目一覧
正しい紐付け先が設定されているか確認し、紐付け設定が完了していない項目を、この画面で紐付けしていきます。
A 【KING OF TIME】取込ヘッダ項目
KING OF TIME から取得した勤怠項目名がリストで表示されます。ピンク色表示は、既にFORROU側の項目と紐付け済みのものです。
※「紐付け処理済みを非表示」にチェックを入れると、紐付け未完了の項目だけを表示します。
B 【FORROU】給与関連項目
項目グループは5つあります。項目グループにチェックを入れると、各項目名が表示されます。
- 従業員No/姓名:自動で紐付けされます。
- 手当項目 変動(入力表):必要に応じて紐付け設定してください。
- 控除項目 変動(入力表):必要に応じて紐付け設定してください。
- 勤怠項目:一部の既定項目は自動で紐付けされます。正しく設定されているか確認し、紐付けされていない項目は手動で紐付け設定してください。
- 入力項目:必要に応じて紐付け設定してください。
②-1 項目を手動で紐付け設定する
左側のKING OF TIME取込ヘッダ項目欄から、対象の項目を選択し、右側の勤怠項目欄の対象項目の「+」をクリックすることで、項目が手動で紐付けされます。
※紐付けを解除する場合は、項目右側の×マークをクリックします。
※進法設定の変更はこちらの画面ではおこなえません。計算処理>給与マスタ>▶勤怠タブで変更後、▶給与マスタを現在の状態に更新し、再度取り込みをおこないます。
②-2 複数の項目を加算・減算する
KING OF TIMEの複数の勤怠項目を加算・減算し、FORROUの1つの勤怠項目にまとめて取り込むことができます。紐づけできる項目数に上限はありません。
加算する場合は「+」を、減算する場合は「-」をクリックします。
⚠ 注意
FORROU側で60進数(時間)で設定されている項目に対して、勤怠ソフト側の「日数」や「数値 (回数など)」の項目を紐づけると、注意喚起のメッセージが表示されます。
メッセージを「OK」すると、紐づけを続行することができますが、小数点以下第2位までの値を60進数として取り込むため、意図した取込結果になるかをご確認ください。
(例)
・勤怠ソフト 5(日) → FORROU 5:00(5時間00分)として取り込み
・勤怠ソフト 5.25(日) → FORROU 5:25(5時間25分)として取り込み
・勤怠ソフト 5.5(回) → FORROU 5:50(5時間50分)として取り込み
※日数→時間へは換算されません。
FORROU側の進数設定は、給与マスタ>勤怠タブで確認・変更ができます。
②-3 紐付け設定を保存する
紐付け設定の完了後「保存」をクリックし、紐付け設定内容を保存します。
紐付け設定を保存しておくことで、次回以降も同じ設定で勤怠データを取り込むことができます。
設定保存後、「次へ」で「③確認」へ進みます。
③確認
「③確認」画面では、取込対象データを確認し「取込」をクリックすると、取込対象欄にチェックが入っているデータを取り込みます。
【赤色の背景で表示され、姓名欄が空欄になっている場合】
従業員No(外部システムキー)や姓名が一致しない場合は、同一人物とみなされず、取込対象となりません。
赤色の背景で表示され、姓名欄が空欄になっている場合は、両サービスの従業員情報と、「①設定」の従業員紐付け・前ゼロの設定をご確認ください。
設定内容を修正後、 再度「①設定」から取込操作をおこないます。
【黄色の背景で表示され、取込対象チェックが外れている場合】
FORROU側の給与対象者に含まれていない従業員は、初期状態では取込対象となりません。
黄色の背景で表示されている従業員は、FORROU側の給与入力表に表示されていない従業員です。
「取込対象」にチェックを入れることで、給与対象者に追加して取り込むことができます。
※FORROUに従業員情報が登録されており、取込先の給与グループに所属していることが、対象者追加の条件です。
【入力計算の対象者確認について】
「入力計算の対象者確認」ボタンをクリックすると、FORROU側での給与計算対象者のうち、以下に該当する者を確認できます。
- KING OF TIME側のデータに該当者が存在しない者
- 両サービスで紐付けキーや姓名が一致しないため同一人物とみなされない者
※該当者がいない場合は、このボタンは表示されません。
該当者を確認し、必要に応じて従業員情報や取得条件を見直してください。
該当者を給与計算の対象者から削除する場合は、「対象外」にチェックを入れます。
これにより、勤怠データを取り込む際に、給与入力計算画面から該当者が削除されます。
※「対象外」は、現在の給与データの計算対象者から外す操作です。
APIで取得できなかった従業員を、そのまま給与計算対象者として残す場合はチェックを入れないでください。
2回目以降の取込
勤怠項目の紐付け設定を保存すると、次回以降は設定内容が引き継がれるため、「②紐付け処理」の再設定は不要です。
ただし、2回目以降も紐付け処理画面は表示されます。
取込時は毎回「①設定」→「②紐付け処理」→「③確認」→「取込」の順に画面を進めてください。
勤怠項目を追加・変更した場合は、「②紐付け処理」の設定を必要に応じて変更し、保存してください。
よくある質問
API取込と手入力の併用はできますか?
併用できます。
KING OF TIMEから特定項目の勤怠データを取り込んだ後に、給与入力計算画面で残りの勤怠項目のデータや変動手当などを入力・修正できます。
また、先に変動手当額などを入力して「入力保存」をクリックし、後から勤怠データを取り込むことも可能です。
給与グループを分けている場合は、どのように取り込みますか?
取り込み先の給与データごとに対応します。
勤怠の取り込みは、給与計算データの対象者に限定されるため、別グループの従業員は取込対象になりません。
勤怠データを再取込した場合、どうなりますか?
同じ給与データに対して複数回勤怠取込をした場合は、紐付け設定されていた項目については、後で取り込んだ内容に上書きされます。
初期紐付け項目一覧
KING OF TIMEとFORROUの連携時には、以下の既定項目が自動で紐付けされます。
その他の勤怠項目については、必要に応じて取込時に手動で紐付け設定をおこなってください。
| FORROU 既定項目 | KING OF TIME 既定項目 |
値の種別 |
|---|---|---|
| 従業員No | 従業員コード | - |
| 外部システムキー | 従業員コード | - |
| 姓 | 姓 | - |
| 名 | 名 | - |
| 出勤日数 | 総勤務回数 | 数値 |
| 有給日数 | 休暇区分コードが1の休暇取得 | 日数 |
| 欠勤日数 | 欠勤日数 | 日数 |
| 出勤時間 | 所定時間(分)+所定外時間(分) | 時間(分) |
| 残業時間 | 残業時間(分) | 時間(分) |
| 休出日数 | 法定休日勤務日数+法定外休日勤務日数 | 数値 |
| 休出時間 | 休日労働_所定労働時間 | 時間(分) |
| 深夜残業 | 深夜残業時間(分) | 時間(分) |
| 遅早回数 | 遅刻回数+早退回数 | 数値 |
| 遅早時間 | 遅刻時間+早退時間 | 時間(分) |