打卡機串接與匯入打卡檔

店裡用指紋 / 臉部辨識打卡機的，有兩種方式把打卡帶進系統：打卡機直接上傳（ZKTeco 及相容機種的 ADMS／PUSH 雲端伺服器功能），或匯入打卡檔（打卡機或考勤軟體匯出的 CSV／Excel）。兩種方式與手機打卡走同一套判斷：遲到、早退、工時、異常標記、月結都一樣算。

進入路徑

• 後台左側 人事出勤 → 打卡機串接：登記打卡機、員工編號對應、未對應打卡。
• 後台左側 人事出勤 → 匯入打卡檔：上傳檔案。
• 「打卡紀錄」頁右上角也有這兩個入口。

支援範圍

打卡機直接上傳　ZKTeco 及相容機種、有「雲端伺服器設定（ADMS）」選單的機型。支援 HTTPS 的機型直接連主伺服器；只支援 HTTP 的舊機型改連打卡機專用入口（見下方設定步驟）。系統只接收打卡紀錄，不會從後台改機器上的設定、不會下載或刪除機器上的指紋與人員資料。

匯入打卡檔　CSV／TXT／DAT（Big5 或 UTF-8 自動判斷）或 Excel（只讀第一張工作表）。常見格式會自動對好欄位：ZKTeco 考勤軟體匯出（登記號碼 ＋ 日期時間）、打卡機 USB 隨身碟下載的 attlog.dat、一般「員工編號、日期、時間」表格。自動對不到時可以在畫面上自己指定欄位。

打卡機直接上傳：設定步驟

1. 在 打卡機串接 → 打卡機 輸入打卡機序號（SN）、名稱、所屬分店後按「新增打卡機」。序號在機器選單「系統資訊 / 裝置資訊」裡。「鎖定來源 IP」預設勾選（見下方）。
2. 到機器選單「通訊設定 → 雲端伺服器設定（ADMS）」：伺服器模式選 ADMS、啟用網域名稱，路徑不用填。伺服器位址與埠依機型：

1. 機器時區設 GMT+8，時間與網路時間同步。機器時鐘不準，打卡時間就不準。
2. 到「員工編號對應」把機器上的員工編號對到員工（見下方）。
3. 回到打卡機清單，看「連線」變成「連線中」，打一次卡後按「最近紀錄」確認有收到。

起算日　新增打卡機時可設定，預設當天。機器第一次連上時會把整台的歷史紀錄送上來，早於起算日的只保留在紀錄裡、不寫進出勤，避免舊資料灌進已經結算過的月份。

停用 / 刪除　停用後這台機器上傳一律被拒（每小時留一筆稽核）；刪除會解除序號登記，已收到的打卡保留。要把機器換到別家店，請刪除後重新登記。

鎖定來源 IP

新增時預設開啟　新增打卡機時「鎖定來源 IP」預設勾選。新增的當下還不知道機器從哪個 IP 連進來，所以系統會在機器第一次成功連上時記下店裡的對外 IP 並鎖定，之後別的 IP 用這個序號上傳一律拒絕（清單顯示「被拒：來源 IP 不符」，並留稽核紀錄）。清單「來源 IP」欄會顯示「下次連線時鎖定」或「已鎖定 x.x.x.x」。

店家換網路 / 換 IP　換了網路業者、路由器重新撥號拿到不同 IP、或把機器搬到別的網路，機器會被擋。到該台打卡機按「重新綁定下次連線 IP」，機器下一次連上時（通常 1 分鐘內）就會改鎖新的 IP。

不適合鎖定的情況　店裡用行動網路分享、或網路業者給的是會變動的 IP，鎖定後會常被擋。新增時取消勾選，或之後按「解除 IP 鎖定」／「不鎖定 IP」。

其他按鈕　未鎖定的機器可以按「鎖定目前 IP」（鎖定清單上顯示的最近來源 IP），或「下次連線時鎖定」。在這個功能推出前就登記的打卡機不會自動改成鎖定，要鎖請自己按。

員工編號對應

打卡機上的員工編號（例如 101）要先對到系統裡的員工，打卡才會寫進那個人的出勤紀錄。兩個地方都可以設定：

• 打卡機串接 → 員工編號對應：一次設定多人。
• 員工薪資 → 編輯：在員工編輯視窗下方新增這位員工的編號。

適用範圍　各店機器的編號各自獨立時，選那一家店；全公司用同一套編號時，選「全公司通用」（只有總部帳號能建）。同一個編號同時有分店專屬與全公司通用時，分店專屬優先。同一家店（或全公司）同一個編號只能對應一個人。

編號格式　1～24 碼英數字、-、_。前導零會保留（007 與 7 是不同編號）。

刪除對應不會回收已經寫進出勤的紀錄；之後再收到這個編號會進「未對應打卡」。

未對應打卡

打卡機或匯入檔裡對不到員工的編號不會被丟掉，會列在 打卡機串接 → 未對應打卡（依分店與編號分組，顯示筆數與期間）。按「指定員工」選人後，系統會建立對應，並立刻把這些打卡補進出勤紀錄。

匯入打卡檔

1. 選要匯入到哪一家店（分店帳號固定是自己的店），選擇檔案。
2. 系統先預覽，不寫入：列出每一列是「將新增 / 重複略過 / 未對應 / 格式錯誤」，以及對到哪位員工。欄位對應不對可以自己改，再按「用這個對應重新預覽」。
3. 確認後按「確認匯入」。畫面下方「最近的匯入」會留下這次的結果。

上限　每檔最多 3,000 筆打卡、檔案 3 MB。超過會整批拒收（不會只匯前面一部分），請分檔再匯（例如按月或按分店匯出），分幾次匯入結果一樣。

日期格式　2026-09-01、2026/9/1、20260901、民國 115/09/01、Excel 日期都看得懂；時間可以是 08:59、8:59:12、0859、下午 01:05。「日/月/年」（01/09/2026）不支援，會被讀成 1 月 9 日，請先在 Excel 改格式。

上下班怎麼判斷

• 當天最早的一次是上班、最晚的一次是下班；只有一次就只有上班。中間的打卡（例如午休外出）只保留紀錄，不改上下班時間。
• 打卡機上的「上班 / 下班」功能鍵不影響結果（員工常忘了切，整天都按成上班）。
• 以台灣時間的日期歸日。跨午夜的班次（例如 22:00 到隔天 06:00），下班那一次會落在隔天那一筆，與手機打卡相同。
• 遲到、早退依當天排班（沒排班用出勤規則的預設班次）加寬限判斷，與手機打卡同一套。

重複不會重算　同一位員工、同一秒、同一種來源只算一次。打卡機重送、同一個檔案匯入兩次，都只會算一次；打卡機與匯入檔都有同一筆也沒關係，時間相同不會改變紀錄。

在「打卡紀錄」頁，上下班時間下方會標示來源：手機 GPS / QR / IP、補卡、匯入檔、打卡機。

常見問題

Q1　打卡機一直顯示「尚未連線」

依序檢查：序號有沒有打錯（清單上的序號要和機器上一模一樣）；伺服器位址、埠、HTTPS 開關有沒有照機型填（HTTPS 機型填主伺服器、埠 443、開 HTTPS；只支援 HTTP 的機型填 iclock.ugomk.com、埠 80、關 HTTPS）；機器能不能上網。還是不行請聯繫客服，我們查得到這台序號有沒有連進來過。

Q2　原本好好的，突然顯示「被拒：來源 IP 不符」

店裡的對外 IP 變了（換網路、路由器重開拿到新 IP）。確認是自己店裡的機器後，按該台的「重新綁定下次連線 IP」。如果常常發生，代表店裡不是固定 IP，建議「解除 IP 鎖定」。

Q3　打了卡但出勤紀錄沒有

按該台打卡機的「最近紀錄」：顯示「未對應」＝這個編號還沒對到員工；「早於起算日」＝打卡日期早於起算日；「時間異常」＝打卡時間比現在還晚十分鐘以上，通常是機器時鐘錯了。

Q4　分店帳號看得到哪些資料

分店帳號只看得到、只能管理自己店的打卡機、編號對應、未對應打卡與匯入；全公司通用的編號可以看、不能改。