---
title: "打卡與出勤紀錄"
description: "上下班打卡、每月出勤紀錄、主管的工時表，以及打卡規則與驗證設定的原則。"
---

> Documentation Index
> Fetch the complete documentation index at: https://peoplematter.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 打卡與出勤紀錄

出勤是薪資的地基：[薪資單](/docs/payroll/payslip/)上的底薪，就是從這裡記錄的
正常工時算出來的。這一頁講錢還沒出現之前的事 — 打卡、出勤紀錄，以及主管怎麼
核定一天。

## 打卡

「工時」畫面最上方是打卡卡片，按鈕跟著你的狀態走：**上班打卡** →（**開始休息**
／**結束休息**）→ **下班打卡**，旁邊是今天累計的時數。每次打卡都有確認框，
說的是實話：「此紀錄將寫入今日的出勤紀錄。」— 打卡不是可以隨手亂按的按鈕。

打錯了怎麼辦？畫面下方那行提示就是答案：「紀錄有誤嗎？主管可以更正當日的打卡
紀錄。」你自己不能改 — 更正走主管的[「工時表」](#主管工時表)，這是刻意的
分工。

確認框只會列出機構要求的打卡驗證項目，並即時顯示結果：只要求確認位置，就只有「位置」
一列；只要求掃描代碼，就只有「掃描代碼」一列；兩者都沒要求，就不會出現任何驗證列（手機
提供了位置時，打卡仍會一併記錄）。

按下**上班打卡**之前，「位置」說的是手機定位的進度：還在定位時是**定位中…**，取得定位後
是**已取得位置，按下打卡時比對** — 與分院範圍的比對，發生在你按下**上班打卡**的那一刻；
手機無法定位時則是**無法取得位置**。按下之後，打卡若沒有直接完成，位置會顯示比對結果：
**在分院範圍內**、**不在分院範圍內**、**無法取得位置**或**此分院尚未設定位置範圍**；
「掃描代碼」一列也是這時才出現，還沒取得代碼時顯示**尚未提供代碼——請掃描分院顯示裝置**。
分院自己還沒設定好的項目（沒有座標、沒有可用的顯示裝置），一律誠實顯示「尚未設定」，絕不會
被當成「已通過」。

掃描代碼還沒完成時，確認框會出現**掃描代碼**按鈕，按下就會開啟相機 — 對準分院顯示
裝置上的 QR Code 即可。若相機完全無法開啟，畫面會改為提供手動輸入同一組六位數代碼的
欄位，但**只有在位置驗證已通過時**才會出現：光是念出六位數並不能證明人在現場。

驗證沒過，只要機構開放例外打卡，按鈕會改成**以例外方式打卡**：選一個類型（外出、
外勤工作、遠距工作、臨時支援（未排班）、無法完成驗證），寫清楚原因，還可以附上
照片，送出後一樣完成打卡 — 只是會被標記起來，主管在「工時表」會看到完整說明，不必
另外追問。

## 出勤紀錄

打卡卡片下方按月份列出你的**出勤紀錄**：每天的上班時間、下班時間、工作時數、
休息時間、加班時數，以及狀態：

| 狀態 | 意思 |
| --- | --- |
| **進行中** | 還有一段打卡沒有結束。 |
| **待確認** | 這天結束了，等主管核定。 |
| **已核定** | 主管核准，或超過期限自動定案 — 薪資從此計算。 |

> **「已核定」不一定有人按過核准**
>
> 超過期限仍待確認的日子會依所在分院的時區**自動定案**為已核定
> — 出勤單不能永遠開著等人。所以「已核定」不必然是「有人看過」。

出勤紀錄上方是「**本月出勤**」摘要：**應出勤**、**實際出勤**、**遲到**與工作時數
四個數字，算法跟主管的「工時表」完全相同、不會另外重算，兩邊的數字因此不會兜不
起來。這個月完全沒有排定出勤時，這裡只會說「這個月沒有排定的出勤。」，不會出現
一排 0。

## 主管：工時表

「工時表」開在**未核定**的日子上 — 這是你的待辦，不是流水帳；狀態與員工篩選
可以切到已核定或全部。點一列就打開當日明細面板：

- **核准** — 面板的主要動作。核准後這一天就鎖定，不能再**調整**或補登，直到有人按**解鎖**。
- **批次核定** — 逐日檢視過後的週結：勾選未核定的日子（或表頭全選，單次上限
  50 天），頁面底部會浮出「已選取 N 筆」的列，按其中的**核准**，一個確認框一次核定，
  每一天都同樣鎖定。無法核定的日子（例如還有人在打卡中）會留在清單上並標明原因，
  其餘照常完成。
- **解鎖** — 核准旁邊，把鎖定的一天打回可改狀態。因逾期而定案的日子不能解鎖。
- **調整** — 更正某段打卡區間（員工報告打錯時的更正路徑）。
- **新增打卡區間** — 在頁面層級，因為補登可以指向你審核範圍內的任何員工，
  包括還沒有出勤單的那天。
- **匯出 CSV** — 把審核清單存成檔案：內容是目前篩選條件下的每一列，檔名標示它涵蓋的
  日期（在公司 ▸ 全公司總覽的「工時表」分頁匯出，就是全部分院合併的結果）。時數以
  「分鐘」輸出，試算表加總不會有歧義。

公司的「工時表」分頁涵蓋整個組織，所以日子是一頁一頁載入的 — 按**顯示更多**載入下一頁
— 這裡也沒有欄位排序和合計列，因為它們只能描述已經載入的那幾頁。匯出的檔案永遠是整個
期間，全組織的合計就在那裡。

被標記的一天，狀態欄會多一個**例外**徽章，原因、類型、驗證結果與照片直接顯示在該列
下方，不必再點開別的畫面 — 類型用詞跟員工看到的完全相同。排班本身判定「這人今天沒
排班卻打卡了」時，會另外掛上**未排班**徽章：這是排班給的事實，跟員工自己選的類型是
兩件獨立的事，兩個徽章可能同時出現。核准與批次核定對這種列的處理方式沒有不同。

## 打卡規則

在 公司 ▸ 設定 ▸ 打卡（在設定左側清單的「制度」之下）設定打卡規則、進位方式與出勤單週期。畫面上的快照提示是這個模組
最重要的一句話：**「每張出勤單會在建立當下凍結目前的政策設定，因此調整政策
絕不會改寫已經記錄過的日子。」** 改政策改的是未來，不是歷史 — 已經算過的錢
不會因為今天改了規則而變。

同一頁上還有四個打卡驗證開關：**要求打卡時確認位置**、**要求打卡時掃描裝置
代碼**、**允許以例外方式打卡**，以及**遲到寬限（分鐘）**。這四個開關只表達
機構「要求什麼」，不表達「哪個分院做得到」——沒有設定地理圍欄的分院不會被
要求確認位置，沒有可用顯示裝置的分院不會被要求掃描代碼。正因如此，畫面下方
的「分院驗證設定」把每個因此而「安靜」的分院攤在陽光下，見下一節。

## 分院驗證設定

每個分院自己的打卡半徑、啟用碼與顯示裝置，都在同一個「打卡」頁的下方管理：

- 選好分院後可設定**打卡半徑（公尺）**——以該分院既有座標為圓心的允許範圍；
  分院尚未設定座標時，這個欄位會停用並說明原因。座標在 公司 ▸ 設定 ▸ 分院（在設定左側清單
  的「組織」之下）設定：點分院那一列，在「編輯分院」填入**緯度**與**經度**
  （見[組織](/docs/organization/)）。
- **啟用碼**是給現場顯示裝置配對用的一次性代碼，附有複製按鈕；產生新的一組
  會立即讓前一組失效，每組啟用碼只能使用一次。
- **顯示裝置**列表列出每台裝置的名稱、最後回報時間與回報 IP，可個別**撤銷**
  （撤銷前會先確認，且無法復原）。
- **重新產生裝置密鑰**會讓該分院所有已啟用的裝置換發新密鑰。裝置會在下次
  回報時自動取得新密鑰，換發前舊密鑰仍可正常使用——不是會中斷打卡的切換。

上方兩個要求開關若打開，畫面會用醒目的警示列出「哪個分院」目前沒有被真正
檢查到，不必逐一點開分院才看得到：

| 情況 | 警示文字 |
| --- | --- |
| 已要求確認位置，但分院尚未設定地理圍欄（或分院沒有座標） | 已啟用，但此分院尚未設定地理圍欄 |
| 已要求掃描代碼，但分院沒有可用的顯示裝置 | 已啟用，但此分院沒有可用的顯示裝置 |

第二種情況最容易被忽略：撤銷最後一台裝置，或讓平板留在抽屜裡直到七天租約
到期，都不需要任何人「動過設定」就會發生。裝置列表中被偵測為疑似複製品的
那一台，狀態一律顯示「偵測到重複裝置」，不會被畫成一台正常運作的裝置。

## 分院打卡顯示裝置

有些分院要求打卡時額外掃描一組畫面上輪替的代碼，證明人確實在分院現場 —
這組代碼由立在門口的一支備用手機或平板持續顯示、每 20 秒輪替一次。畫面上
同時有可供掃描的 **QR Code** 與可供讀取的**六位數代碼**，再加上倒數與這台
裝置的名稱，沒有別的。

QR Code 與六位數永遠是同一組代碼：員工平常用掃的，六位數是給相機開不起來的
手機備用 — 包括用電話念給站在分院現場的人，這也正是手動輸入必須同時通過位置
驗證的原因。

**架設一台新的顯示裝置：** 用該裝置的瀏覽器開啟總部提供的連結（或自行輸入
網址），畫面會請你輸入**啟用碼**（連結會自動帶入）與**裝置名稱**（例如
「前台平板」），按下**啟用**即可開始顯示代碼。啟用碼只能使用一次。

裝置接上網路後每 15 分鐘會自動回報一次，讓它即使離線也能撐過一整週；偶爾
漏了一次回報不算異常。畫面出現下列文字時該怎麼辦：

| 畫面顯示 | 代表的意思 |
| --- | --- |
| **請重新連線** | 這台裝置已經一段時間沒有連上伺服器，通常是網路斷線 — 檢查裝置的網路連線即可，連上後畫面會自動恢復，不必重新啟用。 |
| **偵測到重複裝置** | 系統偵測到疑似同一台裝置的複本在運作，已永久停止顯示代碼。這不是使用者能自行排除的狀況，請聯絡管理員撤銷後重新啟用。 |

Source: https://peoplematter.app/docs/time/index.mdx