概要

顧客から TEAL 専用の一般管理者アカウントが共有された後、TEAL 担当者が KING OF TIME / タッチオンタイム の管理画面で実施するエクスポート設定作業の手順書です。

本マニュアルの範囲

  • ログイン動作確認
  • 出力レイアウト「TEALBI連携用」の作成(17列)
  • 人件費概算出力機能の状態確認
  • 時給・日給設定の状況確認
  • サンプル CSV のダウンロード検証
  • 完了報告

範囲外(別マニュアル参照)

  • 顧客側でのアカウント作成 →「勤怠連携アカウント作成手順(KING OF TIME / タッチオンタイム)」
  • TEAL コンソール側のバッチプロセス設定
  • TEAL BI 側の店舗マッピング登録
  • 初回データ取込テスト

前提

  • KING OF TIME / タッチオンタイムは同一仕様(OEM関係)。本マニュアルの操作手順は両製品で共通
  • 顧客側でTEAL専用一般管理者の作成・権限付与(基本設定権限「オプション」=○閲覧・編集/所属・雇用区分管理権限の「データ出力」=○可能、いずれも「全ての〜」対象)が完了していること
  1. 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. ログイン動作確認

    2.1. ログイン

    受領したログインID/パスワードで管理画面にログインします。

    2.2. 確認項目

    「全メニュー」→「エクスポート / インポート」を開き、以下を確認します。

    確認項目

    期待される状態

    エクスポート画面が表示される

    データ種別ごとのダウンロードボタンが並ぶ

    「月別データ」横

    「出力レイアウト作成」リンクあり

    「日別データ」横

    「出力レイアウト作成」リンクあり(これが必須)

    「タイムカード」横

    「出力レイアウト作成」リンクあり

    ⚠️ 「出力レイアウト作成」リンクが表示されない場合 顧客側の「基本設定権限のオプション」が「△ 閲覧のみ」のままになっています。「○ 閲覧・編集」へ変更を依頼してください(自分では変更不可)。

    エクスポート画面が真っ白で何も表示されない場合 顧客側の「所属管理権限」または「雇用区分管理権限」の「データ出力」が「○ 可能」になっていません。両方とも「○ 可能」に設定変更を依頼してください(AND条件のため、片方だけでは無効)。

  3. 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. 人件費概算出力機能の状態確認

    「人件費+交通費」列に値を出力するために必要な機能です。

    4.1. 確認手順

    [設定] > [その他] > [オプション] > [勤怠管理設定]

    「人件費概算出力機能」の項目を確認します。

    状態

    対応

    「使用する」になっている

    対応不要。次のステップへ

    「使用しない」になっている

    TEAL側の「オプション」権限が「○ 閲覧・編集」なら自分で「使用する」に変更し保存。「△ 閲覧のみ」しかない場合は顧客に変更を依頼

    ⚠️ この設定が「使用しない」のまま運用に入ると、時給を登録しても「人件費+交通費」列が常に0円となり、TEAL BI 上で人件費が表示されません。必ず「使用する」になっていることを確認してください。

  5. 5. 時給・日給設定の状況確認

    5. 時給設定の状況確認

    権限が「△ 閲覧のみ」のため、設定状況の確認のみ行います。

    5.1. 確認手順

    [設定] > [従業員] > [従業員設定]

    主要スタッフ数名を抽出し、「その他(≡)」→「単価」を開いて、「所定(時給)」に値が入っているかを確認します。

    ℹ️ TEAL BI 側の人件費可視化は時給ベースで設計されているため、確認・依頼対象は「所定(時給)」のみです。「平日日給」等の他フィールドは確認不要です。

    運用形態

    確認すべきフィールド

    時給運用

    「所定(時給)」に値が入っているか

    月給・日給運用

    「平日日給」に1日あたりの換算額が入っているか

    5.2. 未設定の場合

    顧客へ以下を案内します。

    • 主要スタッフの時給(「所定(時給)」フィールド)を入力していただきたい旨
    • 一括登録は「設定 > インポート > 単価データ CSV」から可能であること
    • 未設定のまま運用開始すると、該当スタッフの「人件費+交通費」列が0円になり、店舗別人件費の集計が不正確になること
  6. 6. サンプルCSVダウンロード検証

    6.1. ダウンロード手順

    [エクスポート / インポート] > [日別データ[CSV]] のボタンをクリック

    ダウンロード画面で以下を指定:

    設定項目

    出力レイアウト

    TEALBI連携用(先ほど作成したもの)

    出力期間

    過去1〜数日分(実績データのある日)

    「ダウンロード」ボタンでCSVを取得します。

    6.2. CSV検証項目

    項目

    期待値

    確認

    ヘッダ行

    17列が指定通りの順序で並ぶ

    時間表示形式

    1.30 形式(60進数)

    クォート

    数値も “” で囲まれる(“10.00” 形式)

    「人件費+交通費」

    時給設定済みスタッフは0以外の値

    「労働予定時間」

    シフト登録のある日に数値が入る

    「労働合計時間」

    打刻実績のある日に数値が入る

    データ件数

    1日1スタッフ1行になっている(期間合計ではない)

    問題があればこの段階で原因を切り分け、出力レイアウトの修正または顧客への設定変更依頼を行います。

  7. 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:301.5090 で出力される

出力レイアウトの時間表示形式が「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日分ダウンロード

  [ ] ヘッダ行・時間形式・クォート・人件費・労働予定時間を確認

 

完了報告

  [ ] 顧客へ完了連絡を送信

コメントを書く

下記項目すべて入力のうえ、コメントしてください。

関連記事