班表匯入
班表匯入功能提供批量上傳班表的快速方式，適合多位服務人員或長期班表的一次性設定。透過 CSV 範本填寫班次資料後匯入，比逐日點擊建立班次效率高出許多，是新店開幕或班表大調整時的必備功能。
進入路徑
後台左側 美業預約 → 班表，於頁面右上方點擊 匯入 ▼ 下拉選單即可下載範本、上傳檔案、查看匯入歷史。
提示：班表匯入沒有獨立頁面，所有匯入動作都整合在「班表」頁面右上方的下拉選單。
匯入流程
第一步 下載範本
在右上方 匯入 ▼ 下拉中點 下載範本 CSV，取得標準 CSV 格式檔案。
第二步 填寫班表資料
於 Excel / Google Sheets 開啟 CSV 後依範本格式填寫，欄位共三個：staff_phone、work_date、shifts。
比對的是手機號碼，不是姓名
staff_phone 欄位要填服務人員設定中登記的手機號碼（去除空格後逐字比對，例如 0912345678），系統依這支電話反查是哪一位人員，完全不比對姓名。
填錯電話（例如打錯一碼、或這位人員在系統裡根本沒登記手機）會讓那一列被判定為「找不到電話為 xxx 的員工」而匯入失敗；填了一個沒有這個人的姓名不會被擋（因為系統根本不看姓名欄），所以匯入前請先確認每位人員在「服務人員設定」裡都有登記正確的手機號碼。work_date 格式為 YYYY-MM-DD，例如 2026-06-01。
只接受「今天～未來 3 個月」這個範圍
shifts 班別名稱，需與本頁右上「班別設定」中設定的班別名稱相符（例如「早班」「晚班」）。同一天有多個班次時，shifts 欄可用逗號（, 或 ，）或頓號（、）分隔多個班別名稱寫在同一列，不需要拆成多列。這一欄留空或填「休」代表當天休假。
每一列代表一個服務人員在特定日期的班表；同一人同一天只會有一列生效（重複匯入同一人同一天會覆蓋上一次的班別設定，不會疊加）。
第三步 上傳並確認
在 匯入 ▼ 點 上傳 CSV 檔 選檔案，系統會解析並自動建立班次。完成後 toast 提示成功 / 失敗筆數。
多門市必須先切門市，否則會擋下上傳
查看匯入歷史
在 匯入 ▼ 點 匯入歷史 即可查看過往每次匯入的檔名、總筆數、成功 / 失敗筆數、錯誤明細。
多門市的品牌只會看到當前門市的匯入紀錄，並多一個「門市」欄位。該欄顯示「未指定門市」的是 2026-09-09 之前留下的舊紀錄（當時系統還沒有記錄門市），不代表它屬於哪一家店。
錯誤處理
系統以逐列解析，錯誤的列不匯入並於「匯入歷史」中保留錯誤明細，正確的列正常建立。常見錯誤原因：
| 錯誤原因 | 說明 |
|---|---|
| 缺少 staff_phone / work_date | 該欄位是空的 |
| work_date 日期格式錯誤 | 不是 YYYY-MM-DD 格式 |
| work_date 已過期 | 早於今天 |
| work_date 超過 3 個月限制 | 晚於今天起算 3 個月 |
| 找不到電話為 xxx 的員工 | staff_phone 在服務人員設定裡查不到這支電話，不是比對姓名 |
| 找不到班別設定 | shifts 欄填的名稱與「班別設定」裡的班別名稱不相符 |
| 某人在該天已排班於其他門市 | 同一位人員同一天只能屬於一家門市（見上方「多門市必須先切門市」） |
大量匯入建議
staff_phone 要與系統服務人員設定裡登記的手機號碼完全一致（去除空格），這是最常見的匯入錯誤原因——匯入不比對姓名，姓名欄打錯或缺漏不會造成匯入失敗，只有電話比對得到才算數。
另：CSV 中的 shifts 欄位必須先在班表頁面右上「班別設定」建立對應名稱的班別，否則匯入時會被當作錯誤略過；work_date 也只接受今天到未來 3 個月內的日期。常見問題
Q1 匯入後發現日期填錯，如何修正
至「班表」頁面找到錯誤日期的班次，點擊格子即可編輯或刪除後重建。系統允許同一人同一日多個班次，請手動清理舊資料後再重新匯入。
Q2 CSV 開檔時中文亂碼怎麼辦
範本下載的 CSV 含 BOM，Excel 應該能正確顯示中文。若仍亂碼，請以 UTF-8 編碼重新存檔，或使用 Google Sheets 開啟。
Q3 匯入成功但班表頁面找不到新建的班次
請確認班表頁面上方的「視圖」與「月份」涵蓋匯入的日期。若匯入的是未來月份的班表，需切換到對應月份才看得到。
其他問題協助