-
2026.05.06 -
2026.05.08
勤怠連携 TEAL側エクスポート設定作業手順(KING OF TIME / タッチオンタイム)
概要
顧客から TEAL 専用の一般管理者アカウントが共有された後、TEAL 担当者が KING OF TIME / タッチオンタイム の管理画面で実施するエクスポート設定作業の手順書です。
本マニュアルの範囲
- ログイン動作確認
- 出力レイアウト「TEALBI連携用」の作成(17列)
- 人件費概算出力機能の状態確認
- 時給・日給設定の状況確認
- サンプル CSV のダウンロード検証
- 完了報告
範囲外(別マニュアル参照)
- 顧客側でのアカウント作成 →「勤怠連携アカウント作成手順(KING OF TIME / タッチオンタイム)」
- TEAL コンソール側のバッチプロセス設定
- TEAL BI 側の店舗マッピング登録
- 初回データ取込テスト
前提
- KING OF TIME / タッチオンタイムは同一仕様(OEM関係)。本マニュアルの操作手順は両製品で共通
- 顧客側でTEAL専用一般管理者の作成・権限付与(基本設定権限「オプション」=○閲覧・編集/所属・雇用区分管理権限の「データ出力」=○可能、いずれも「全ての〜」対象)が完了していること
-
- 1. 事前確認:顧客から受領した情報
-
作業前に以下が揃っていることを確認します。不足があれば顧客へ確認のうえ補完してください。
項目
例
受領確認
管理画面ログインURL
管理画面ログインURL
KOT:https://s1.ta.kingoftime.jp/admin
(s1/s2/s3 は企業ごとに異なる)タッチオンタイム:
https://touchontime.com/admin(固定)☐
管理者コード
英数3〜10文字(例:teal01)
☐
ログインID(自動生成)
「企業コード+管理者コード」の形式
☐
パスワード
(顧客設定値)
☐
登録メールアドレス
kot-[顧客略称]@teal-tech.jp
または tot-[顧客略称]@teal-tech.jp☐
ℹ️ KOT はログイン前後でURLのサブドメインが変わる場合があるため、必ずログイン後のURLを控えること(バッチプロセス設定で使用)。タッチオンタイムは固定(https://touchontime.com/admin)。
-
- 2. ログイン動作確認
-
2.1. ログイン
受領したログインID/パスワードで管理画面にログインします。
2.2. 確認項目
「全メニュー」→「エクスポート / インポート」を開き、以下を確認します。
確認項目
期待される状態
エクスポート画面が表示される
データ種別ごとのダウンロードボタンが並ぶ
「月別データ」横
「出力レイアウト作成」リンクあり
「日別データ」横
「出力レイアウト作成」リンクあり(これが必須)
「タイムカード」横
「出力レイアウト作成」リンクあり
⚠️ 「出力レイアウト作成」リンクが表示されない場合 顧客側の「基本設定権限のオプション」が「△ 閲覧のみ」のままになっています。「○ 閲覧・編集」へ変更を依頼してください(自分では変更不可)。
エクスポート画面が真っ白で何も表示されない場合 顧客側の「所属管理権限」または「雇用区分管理権限」の「データ出力」が「○ 可能」になっていません。両方とも「○ 可能」に設定変更を依頼してください(AND条件のため、片方だけでは無効)。
-
- 3. 出力レイアウトの新規作成(メイン作業)
-
ここが本作業の中核です。手順を順番通りに実施してください(特に全体設定を項目選択より先に行うこと)。
3.1. 画面遷移
[全メニュー] > [エクスポート / インポート] > [日別データ] 横の [出力レイアウト作成] リンク
「日別データレイアウト登録」画面が開きます。
3.2. 全体設定(必ず項目選択の前に行う)
画面上部の【全体設定】を以下の通り設定します。
設定項目
設定値
レイアウト名
TEALBI連携用
項目名の出力
出力する
クォート文字列
データを “” で囲む(“10.00” と表示)
時間表示形式
60進数(1時間30分を1.30と表示)
⚠️ 時間表示形式は必ず「60進数」を選択してください。「10進数(1.50)」「分単位(90)」では TEAL 側の時間変換が機能せず、労働時間・人件費の計算が狂います。
3.3. 表示項目の選択(17列)
「選択された項目」欄に以下17列を、指定された順序で追加します。
順序
列名
用途・補足
1
企業コード
識別
2
企業名
識別
3
所属コード
TEAL店舗マッピングに使用
4
所属名
表示用
5
出勤先所属
ヘルプ勤務・他店打刻識別
6
出勤先所属コード
TEAL店舗マッピングに使用
7
従業員コード
識別
8
名前
表示用
9
人件費+交通費
実績人件費(人件費概算出力機能+時給設定が前提)
10
日時(曜日なし)
対象日付(YYYY/M/D)
11
締め状況
確定/未確定
12
労働合計時間
所定内+所定外の総労働時間(60進数)
13
労働予定時間
★ 着地見込み計算に使用(最重要)
14
出勤予定時刻
シフト予定時刻
15
退勤予定時刻
シフト予定時刻
16
出勤時刻
実績打刻
17
退勤時刻
実績打刻
⚠️ 項目の選択は「列名」で識別すること。番号で選んではいけない 「選択できる項目」欄では各項目に番号(例:026、032 等)が振られていますが、この番号は企業・アカウントごとに異なります。番号で覚えると別企業で作業した際に取り違えるため、必ず列名(「労働予定時間」「出勤先所属コード」等)で識別してください。
3.4. サンプルプレビューの確認
画面下部のプレビューに、以下と一致するヘッダ行が表示されることを確認します。
企業コード,企業名,所属コード,所属名,出勤先所属,出勤先所属コード,従業員コード,名前,人件費+交通費,日時(曜日なし),締め状況,労働合計時間,労働予定時間,出勤予定時刻,退勤予定時刻,出勤時刻,退勤時刻
順序が違う場合は、項目を一度削除して再度正しい順序で追加します。
3.5. 保存
画面下部の「登録」ボタンをクリックして保存します。
-
- 4. 人件費概算出力機能の状態確認
-
「人件費+交通費」列に値を出力するために必要な機能です。
4.1. 確認手順
[設定] > [その他] > [オプション] > [勤怠管理設定]
「人件費概算出力機能」の項目を確認します。
状態
対応
「使用する」になっている
対応不要。次のステップへ
「使用しない」になっている
TEAL側の「オプション」権限が「○ 閲覧・編集」なら自分で「使用する」に変更し保存。「△ 閲覧のみ」しかない場合は顧客に変更を依頼
⚠️ この設定が「使用しない」のまま運用に入ると、時給を登録しても「人件費+交通費」列が常に0円となり、TEAL BI 上で人件費が表示されません。必ず「使用する」になっていることを確認してください。
-
- 5. 時給・日給設定の状況確認
-
5. 時給設定の状況確認
権限が「△ 閲覧のみ」のため、設定状況の確認のみ行います。
5.1. 確認手順
[設定] > [従業員] > [従業員設定]
主要スタッフ数名を抽出し、「その他(≡)」→「単価」を開いて、「所定(時給)」に値が入っているかを確認します。
ℹ️ TEAL BI 側の人件費可視化は時給ベースで設計されているため、確認・依頼対象は「所定(時給)」のみです。「平日日給」等の他フィールドは確認不要です。
運用形態
確認すべきフィールド
時給運用
「所定(時給)」に値が入っているか
月給・日給運用
「平日日給」に1日あたりの換算額が入っているか
5.2. 未設定の場合
顧客へ以下を案内します。
- 主要スタッフの時給(「所定(時給)」フィールド)を入力していただきたい旨
- 一括登録は「設定 > インポート > 単価データ CSV」から可能であること
- 未設定のまま運用開始すると、該当スタッフの「人件費+交通費」列が0円になり、店舗別人件費の集計が不正確になること
-
- 6. サンプルCSVダウンロード検証
-
6.1. ダウンロード手順
[エクスポート / インポート] > [日別データ[CSV]] のボタンをクリック
ダウンロード画面で以下を指定:
設定項目
値
出力レイアウト
TEALBI連携用(先ほど作成したもの)
出力期間
過去1〜数日分(実績データのある日)
「ダウンロード」ボタンでCSVを取得します。
6.2. CSV検証項目
項目
期待値
確認
ヘッダ行
17列が指定通りの順序で並ぶ
☐
時間表示形式
1.30 形式(60進数)
☐
クォート
数値も “” で囲まれる(“10.00” 形式)
☐
「人件費+交通費」
時給設定済みスタッフは0以外の値
☐
「労働予定時間」
シフト登録のある日に数値が入る
☐
「労働合計時間」
打刻実績のある日に数値が入る
☐
データ件数
1日1スタッフ1行になっている(期間合計ではない)
☐
問題があればこの段階で原因を切り分け、出力レイアウトの修正または顧客への設定変更依頼を行います。
-
- 7. 完了報告
-
検証が成功したら、顧客へ完了連絡を送信します。報告に含める内容:
- 出力レイアウト「TEALBI連携用」の作成完了
- 人件費概算出力機能の状態(「使用する」確認済み/顧客対応依頼中)
- 時給・日給設定の状況(設定済み/一部未設定で要対応)
- サンプル CSV ダウンロードと検証の成功
- 次のステップ(TEAL 側でバッチ設定を行い、本番連携を開始する旨)
設定変更や追加対応が必要な事項があれば、本連絡で具体的に依頼してください。
8. トラブルシューティング
8.1. 「出力レイアウト作成」リンクが表示されない
基本設定権限の オプション が「△ 閲覧のみ」または「× 権限なし」のため。顧客側に「○ 閲覧・編集」への変更を依頼する(自分では変更不可)。
8.2. エクスポート画面が真っ白で何も表示されない
「所属管理権限」または「雇用区分管理権限」の データ出力 が「○ 可能」になっていない。両方とも「○ 可能」に設定変更を顧客に依頼する(AND条件)。
8.3. 出力レイアウト保存時にエラーが出る
全体設定(時間表示形式・クォート・項目名出力)が未設定のまま項目選択を行った可能性。全体設定を先に保存してから項目選択をやり直す。
8.4. CSVの「労働予定時間」「出勤予定時刻」「退勤予定時刻」が空欄
シフト未登録の日は空欄になる仕様(正常動作)。確認方法:
- KOT管理画面で「日別データ」→「予実」タブを開き、「シフトデータ」列に値が入っているか確認
- 値があれば3列はCSVで取得可能。空ならば外部シフト管理システム(らくしふ・シフオプ等)との連携状況を顧客側で確認
8.5. CSVの「人件費+交通費」が全件0円
以下のいずれか:
- 人件費概算出力機能が「使用しない」になっている → 第4章で確認・対処
- 従業員の時給が未設定 → 第5章で確認・依頼
- 出力レイアウトに「人件費+交通費」列が含まれていない → 第3章でレイアウトを編集
8.6. 時間が 1:30 や 1.50 や 90 で出力される
出力レイアウトの時間表示形式が「60進数(1.30)」以外になっている。レイアウトを編集して「60進数(1時間30分を1.30と表示)」に修正する。
8.7. CSVのデータが期間合計(1スタッフ1行)になっている
出力レイアウトの集計設定が「1日ずつ」以外になっている可能性。日別データのレイアウトであることを再確認する。
付録A:作業チェックリスト(コピペ用)
■ ログイン動作確認
[ ] ログイン成功
[ ] エクスポート/インポート画面が表示
[ ] 「日別データ」横に「出力レイアウト作成」リンクあり
■ 出力レイアウト作成(TEALBI連携用)
全体設定
[ ] レイアウト名: TEALBI連携用
[ ] 項目名の出力: 出力する
[ ] クォート文字列: データを “” で囲む
[ ] 時間表示形式: 60進数(1.30形式)
17列の追加(順序通り、列名で識別)
[ ] 1. 企業コード
[ ] 2. 企業名
[ ] 3. 所属コード
[ ] 4. 所属名
[ ] 5. 出勤先所属
[ ] 6. 出勤先所属コード
[ ] 7. 従業員コード
[ ] 8. 名前
[ ] 9. 人件費+交通費
[ ] 10. 日時(曜日なし)
[ ] 11. 締め状況
[ ] 12. 労働合計時間
[ ] 13. 労働予定時間 ★
[ ] 14. 出勤予定時刻
[ ] 15. 退勤予定時刻
[ ] 16. 出勤時刻
[ ] 17. 退勤時刻
[ ] サンプルプレビューでヘッダ行が一致することを確認
[ ] 登録(保存)
■ 人件費概算出力機能
[ ] 設定 > その他 > オプション > 勤怠管理設定 で「使用する」を確認
■ 時給・日給設定
[ ] 設定 > 従業員 > 従業員設定 で主要スタッフ数名の単価を確認
[ ] 未設定の場合は顧客に依頼
■ サンプルCSV検証
[ ] 出力レイアウト「TEALBI連携用」で1日分ダウンロード
[ ] ヘッダ行・時間形式・クォート・人件費・労働予定時間を確認
■ 完了報告
[ ] 顧客へ完了連絡を送信
