以下の内容を確認し、連携設定をしてください。
目次
機能概要
KING OF TIME 勤怠管理とNeWARP（工数管理システム）の勤怠データを連携できます。KING OF TIME 勤怠管理に記録された出勤時刻・退勤時刻・勤怠区分・合計勤務時間を、NeWARPの工数入力画面に自動反映します。連携時は、これらの項目はNeWARP側での手入力ができなくなります。
事前準備
KING OF TIME 勤怠管理とNeWARPの両方のアカウントが必要です。連携にあたり、KING OF TIME 勤怠管理の「従業員コード」とNeWARPの「KOT従業員コード」（ユーザーマスタ）を一致させてください。
NeWARP側での準備
NeWARPのユーザーマスタで、対象ユーザーにKOT従業員コードを設定してください（未設定の場合、工数入力画面がロックされ利用できません）。
NeWARPに関するお問い合わせ先
NeWARPとの契約や設定で不明点がある場合は、以下をご参照ください。
お問い合わせ先URL：https://www.cosmoroot.co.jp/support/progestion/（外部リンク）
KING OF TIME 勤怠管理側での準備
各従業員に「従業員コード」が設定されていることを確認してください。
連携のための初期設定
NeWARP側での連携設定
詳しくはNeWARPのサポート窓口にお問い合わせください。
KING OF TIME 勤怠管理側での連携設定
連携のための初期設定は特にありません。
システム間のデータ連携
自動連携
バッチなどによる定期同期はしていません。工数入力画面を開くたび（月切替時を含む）に、KING OF TIME 勤怠管理からリアルタイムでデータを取得します。
手動連携
特に初期設定はありません。画面を開くたびに自動的にKING OF TIME 勤怠管理から取得するため、手動での同期操作は不要です。
連携項目
KING OF TIME 勤怠管理とNeWARPの各項目は、以下のように対応し、連携します。
| NeWARP | KING OF TIME 勤怠管理 | 備考 | API |
|---|---|---|---|
| 開始時刻 | 出勤時刻 | 1日に複数回打刻がある場合、最も早い出勤打刻を採用 | timeRecord（code=1のtime） |
| 終了時刻 | 退勤時刻 | 1日に複数回打刻がある場合、最も遅い退勤打刻を採用 | timeRecord（code=2のtime） |
| 勤怠区分 | 勤務日区分・取得済み休暇 | 表示のみ | workdayTypeName, holidaysObtained |
| 合計勤務時間 | 労働合計時間 | 分単位の値を「時:分」形式に変換して表示 | totalWork |
ご注意
WebAPI制限時間帯について
以下の時間帯は利用できません。
8:30～10:00 / 17:30～18:30
入社日について
KING OF TIME 勤怠管理側で入社日が未来日の従業員は連携されません。入社日が過去の日付、もしくは未設定の従業員が連携されます。
対象期間について
KING OF TIME 勤怠管理から取得できるデータの対象期間は、過去3年・未来1年です。この範囲外の月は表示できません。