KING OF TIME（KOT）連携について

gamba! と KING OF TIME 勤怠管理を連携することで、日報を投稿するだけで自動的に退勤打刻が完了します。打刻忘れを防ぎ、勤怠管理をよりスムーズに行えます。

設定のご相談などはお気軽にお問い合わせください。→ 無料サポートを受けたい

目次

1. 機能概要
2. 事前準備
3. 連携の初期設定
4. データ連携の仕組み
5. 連携項目一覧
6. ご注意

1. 機能概要

gamba! と KING OF TIME 勤怠管理を連携すると、以下の機能をご利用いただけます。

• gamba! のユーザー情報と KING OF TIME の従業員情報を紐付け
• 日報提出時に KING OF TIME へ自動で退勤打刻
• KING OF TIME の打刻状況を gamba! 上でリアルタイムに確認
• 打刻時刻の調整機能（指定時刻での打刻）
• 日報作成画面から直接退勤時刻を設定可能
• 管理者による打刻可能時間帯の制限設定

自動打刻の動作条件（重要）

• 日報が正式に投稿されたときのみ自動打刻（下書き保存では打刻されません）
• 日報カテゴリの投稿のみが対象（メモや KPI では打刻されません）
• 各ユーザーが自動退勤打刻を「有効」に設定している場合のみ動作（強制打刻はありません）
• 当日すでに退勤打刻済みの場合は重複して打刻されません
• 管理者が設定した時間帯外では自動打刻されません

2. 事前準備

連携には gamba! と KING OF TIME 両方のアカウントが必要です。連携時に、KING OF TIME の「従業員コード」と「メールアドレス」で gamba! ユーザーとの照合を行います。

gamba! 側での準備

【1】アカウントの申し込み

gamba! をまだご利用でない場合は、下記より申し込んでください。
https://www.getgamba.com/v3/registration/new

【2】ユーザー登録のメールアドレス設定

gamba! に登録するメールアドレスは、KING OF TIME に登録されているメールアドレスと一致させてください。従業員の紐付け時に、従業員コードとメールアドレスの両方で照合します。

【3】ご不明点のお問い合わせ先

設定についてご不明な点は、gamba! サポートまでご連絡ください。

• お問い合わせフォーム：https://www.getgamba.com/contact/
• 営業時間：平日 10:00〜18:00（土日祝日・年末年始を除く）

KING OF TIME 側での準備

【1】管理者アカウントの用意

連携設定時に、KING OF TIME の管理者アカウントでログインして認証を行います。管理者アカウントをご用意ください。

【2】従業員情報の登録

連携する従業員を KING OF TIME の管理画面から登録してください。以下の情報が必要です。

• 従業員コード：各従業員を識別する一意のコード
• メールアドレス：gamba! のユーザーメールアドレスと一致させる
• 氏名（姓・名）

従業員登録の手順：

1. KING OF TIME 勤怠管理にログイン
2. 設定 > 従業員 > 従業員管理 をクリック
3. 「新規登録」ボタンをクリック
4. 従業員情報を入力して保存
    

詳細な操作方法は KING OF TIME のヘルプサイトをご参照ください。
https://www.kingtime.jp/manual/

⚠️ 重要：メールアドレスは gamba! に登録されているものと完全に一致させてください。一致しない場合、連携エラーとなります。

3. 連携の初期設定

gamba! 側での設定

【1】管理者による初期設定

1. gamba! 管理画面にログイン
2. 設定 > KING OF TIME 連携管理 をクリック
3. 「KING OF TIME と連携する」ボタンをクリック
   
   
4. KING OF TIME の OAuth 認証画面でログインし、「許可」をクリック
   
   

5. gamba! 管理画面に戻り、以下を設定して「設定を保存」をクリック

   • 連携を有効にする：チェックを入れる
   • 自動退勤打刻を許可：チェックを入れる
   • 打刻可能開始時刻（例：00:00）
   • 打刻可能終了時刻（例：23:59）
      

6. 

7.  

【2】各ユーザーによる従業員情報の紐付け

1. gamba! にログインし、個人設定画面にアクセス
2. 「KING OF TIME 連携」をクリック
3. 「従業員を設定」ボタンをクリック（新しいウィンドウが開きます）
   
4. KING OF TIME に登録されている「従業員コード」と「メールアドレス」を入力
5. 「承諾する」ボタンをクリック
   
   
6. 「従業員情報をリンクしました」と表示されれば連携成功です
   
   

ユーザー設定画面で確認できる情報：

• 連携状態（連携済み・未連携）
• 従業員キーと名前
• 自動退勤打刻設定（ON/OFF）
• 打刻時刻調整 有効/無効
• 管理者設定の自動打刻可能時間帯

【3】自動退勤打刻の個人設定

1. KING OF TIME 連携画面で「自動退勤打刻」を設定（日報投稿時に自動打刻するかを選択）
2. 「打刻時刻調整 有効」をオンにすると、退勤時刻を指定して打刻できるようになります
3. 「設定を保存」をクリック

打刻時刻の指定方法：

1. 日報作成画面で、退勤打刻状態を表示しているバッジをクリック
2. 時刻設定パネルで希望の退勤時刻（例：18:30）を入力
3. 「保存」をクリック
4. 日報投稿時に、設定した時刻で自動退勤打刻されます

KING OF TIME 側での設定

KING OF TIME 側で追加の設定は不要です。事前準備で以下が完了していることをご確認ください。

• WebAPI の利用が有効になっている
• OAuth2.0 アプリケーションの登録が完了している
• 従業員情報（コード・メールアドレス・氏名）の登録が完了している

4. データ連携の仕組み

自動退勤打刻が実行される条件

gamba! で日報を提出したとき、以下の必須条件をすべて満たす場合に自動打刻が行われます。

必須条件：

• 日報が正式に投稿されている（下書き保存では打刻されません）
• カテゴリが「日報」である（メモや KPI では打刻されません）
• ユーザーが自動退勤打刻を「有効」に設定している

追加条件：

• 管理者が KING OF TIME 連携を有効にしている
• ユーザーが従業員情報の紐付けを完了している
• 日報提出時刻が、管理者の設定した打刻可能時間帯内である
• 当日の退勤打刻がまだ行われていない

自動打刻の動作例：

打刻時刻の調整機能

「打刻時刻調整 有効」をオンにすると、日報作成画面から退勤時刻を指定して打刻できます。

「打刻時刻調整 有効」がオフの場合は、日報投稿時刻がそのまま退勤打刻時刻になります。

打刻状態の確認方法

日報作成画面のバッジで打刻状態をリアルタイムに確認できます。

• 🟢 退勤済（15:30）：退勤打刻済み
  
  
• 🟠 自動退勤（15:30）：設定済みの退勤時刻が表示されています
  
  
• ⏳ 確認中：打刻状態を確認中
  
• 🔴 エラー：打刻状態の確認に失敗
  
  

自動打刻に失敗した場合

• 自動打刻に失敗した場合、システムは最大 3 回まで自動でリトライします
• 打刻が失敗しても日報の投稿は正常に完了します
• KING OF TIME 側から手動で打刻することが可能です

手動打刻の手順：

1. KING OF TIME 勤怠管理にログイン
2. 打刻画面から退勤打刻を実行

詳細は KING OF TIME のヘルプサイトをご参照ください。
https://www.kingtime.jp/manual/

5. 連携項目一覧

6. ご注意

従業員の照合について

従業員の紐付けは、KING OF TIME の「従業員コード」と「メールアドレス」の両方で行います。どちらか一方でも一致しない場合、連携エラーとなります。

WebAPI 制限時間帯について

KING OF TIME の WebAPI には以下の制限時間帯があります。この時間帯は API リクエストが制限される場合があります。

制限時間帯：8:30〜10:00 ／ 17:30〜18:30

この時間帯に日報を提出する場合は、KING OF TIME 側で手動打刻をお願いいたします。

問題が解決しない場合のお問い合わせ

以下の情報を添えてサポートまでご連絡ください。

• エラーメッセージの内容
• 発生日時
• 実行した操作の詳細

お問い合わせ先：https://getgamba.com/contact/
営業時間：平日 10:00〜18:00（土日祝日・年末年始を除く）