新韻傳音

操作路徑

網址：（第一次登入用手機內建瀏覽器開啟，之後改用桌面圖示）

步驟說明

1. 第一次使用：iPhone 請用「Safari」開啟，Android 請用「Chrome」開啟。
2. 開啟後先登入，再依「如何把ORBIT加到手機桌面」把圖示加到手機桌面。
3. 之後每次使用：一律點手機桌面的 ORBIT 圖示進入，不要再從瀏覽器網址列或書籤開。
4. 不要從 LINE、Facebook、Instagram 等 App 內建的小瀏覽器直接點連結開啟——這種內建瀏覽器抓不到定位（打卡需要用），部分手勢操作（例如滑動打卡）也可能沒反應。

注意事項 / 常見問題

• 電腦（Windows/Mac）上使用不限瀏覽器種類，用一般常見的 Chrome、Edge、Safari 都可以，只有手機的「LINE 內建瀏覽器」是明確不能用的。
• 判斷是不是在 LINE 內建瀏覽器打開：畫面最上方或最下方如果有 LINE 自己的工具列（例如右上角三個點的選單、「用預設瀏覽器開啟」選項），就代表現在是 LINE 內建瀏覽器，請改用桌面圖示開啟。

操作路徑

Safari → 開啟 → 分享 → 加入主畫面

步驟說明

1. 用「Safari」開啟 （如果是從 LINE 點連結進來的，請先按住連結選「複製連結」，再貼到 Safari 網址列開啟，不要直接在 LINE 裡點開）。
2. 點畫面下方（或上方，依 iOS 版本而定）的「分享」按鈕（方形+向上箭頭圖示）。
3. 往下滑選單，點「加入主畫面」。
4. 右上角點「新增」。
5. 之後桌面上會出現 ORBIT 的圖示，名稱顯示為「ERP.POS」，之後一律點這個圖示進入系統。

注意事項 / 常見問題

• 一定要用 Safari：iPhone 上用 Chrome、LINE 內建瀏覽器等其他方式，「加入主畫面」出來的結果不是完整的獨立 App 模式（可能還是會被瀏覽器工具列包住），定位功能也可能不正常，請務必用 Safari 加入。
• 桌面圖示的名稱目前顯示是「ERP.POS」，不是「ORBIT」，這是正常的，點下去就是同一個系統。
• 加到桌面後，如果登入畫面要求重新輸入帳密，是正常的（第一次開啟獨立模式跟瀏覽器分開登入狀態），照平常方式登入即可。

操作路徑

Chrome → 開啟 → 右上角「⋮」→ 加入主畫面／安裝應用程式

步驟說明

1. 用「Chrome」開啟 （如果是從 LINE 點連結進來的，建議先複製連結貼到 Chrome 開啟，不要直接在 LINE 裡點開）。
2. 點畫面右上角「⋮」（三個點選單）。
3. 選「加入主畫面」或「安裝應用程式」（不同 Android 版本文字可能不同）。
4. 確認名稱後點「安裝」或「新增」。
5. 之後桌面上會出現「ORBIT」圖示（manifest 設定的名稱），之後一律點這個圖示進入系統。

注意事項 / 常見問題

• 建議統一用「Chrome」操作，三星內建瀏覽器（Samsung Internet）等其他瀏覽器的選單文字、位置可能不同，找不到「加入主畫面」選項時，改用 Chrome 開啟同一個網址再試一次。
• 部分機型會直接跳出「安裝這個應用程式？」的提示卡片，點「安裝」效果一樣。

操作路徑

登入頁 → 使用信箱密碼登入 → 忘記密碼？

步驟說明

1. 如果你原本是用「使用 LINE 登入」或「使用 Google 帳號登入」，登入不了時不需要重設密碼，直接重新點同一顆按鈕（LINE 或 Google）再走一次授權流程即可，這兩種登入方式沒有「密碼」可言。
2. 如果你是用信箱＋密碼登入：先點「使用信箱密碼登入」展開表單，確認信箱有沒有打錯（注意大小寫、有沒有多打空格）。
3. 密碼忘記了，點密碼欄位上方的「忘記密碼？」連結。
4. 輸入你的登入信箱，點「寄送重設連結」，系統會寄一封重設密碼信到信箱。
5. 到信箱點連結完成重設。
6. 都試過還是進不去，請聯繫你的管理者，或請管理者聯繫 ORBIT 客服 hello@obarai.com。

注意事項 / 常見問題

• 忘記自己是用哪一種方式登入（LINE / Google / 信箱密碼）：登入頁點「忘記帳號信箱？」，畫面會建議直接用 Google 登入（同一個信箱會自動對應到原本的帳號）。
• 這個「忘記密碼」流程只會寄信給輸入的信箱本身，不會經過管理者，所以要能收到信箱裡的信才能重設成功。

操作路徑

登入頁 → 使用 LINE 登入

步驟說明

1. 打開 ORBIT 登入頁，點「使用 LINE 登入」按鈕（綠色，LINE 圖示）。
2. 畫面會導去 LINE 的授權頁面，第一次使用要按「同意並登入」，把姓名／大頭貼授權給 ORBIT。
3. 授權完成後系統會自動用你的 LINE 帳號建立/對應一個 ORBIT 登入身分（不需要另外設密碼）。
4. 第一次登入且系統還沒辦法辨識你屬於哪間公司時，會導去「驗證公司身分」頁面，要求輸入公司的統一編號（8 碼數字）。
5. 統編驗證成功後：如果你是這間公司在 ORBIT 上第一個登入的人（等於公司負責人身分），會直接進入系統；如果公司已經有人建過帳號，會導去「個人資料建檔」頁面，填姓名、部門、職稱等資料後送出，等主管審核通過才能正式使用（詳見「第一次使用ORBIT：新人入職設定三步驟」）。

注意事項 / 常見問題

• LINE 登入不需要「統一編號」以外的額外綁定步驟——不用另外綁手機號碼或加 LINE 官方帳號好友，這裡的「登入」跟公司的 LINE 官方帳號（客服用）是兩件不相關的事。
• 如果 LINE 帳號沒有開放 email 權限，系統會用系統內部的暫用信箱（）代替，這是正常現象，不影響登入與打卡等功能，只是這個帳號沒有真實 email 可以收信（收不到密碼重設信、審核通知信等）。
• 統一編號如果一直驗證不過（找不到對應公司），畫面會提示聯繫 hello@obarai.com，不要自己重複亂試——請確認是不是統編打錯，或公司是不是還沒有跟 ORBIT 完成正式合作建檔。

操作路徑

登入（LINE／Google／信箱） → 驗證公司身分（統一編號） → 個人資料建檔 → 送出等主管審核

步驟說明

1. 登入：用公司提供的方式登入（LINE 或 Google 最快，見「如何用LINE登入ORBIT」）。
2. 驗證公司身分：系統辨識不到你屬於哪間公司時，會出現「驗證公司身分」畫面（說明文字：「第一次使用這個帳號登入，請輸入貴公司的統一編號，確認您屬於哪間公司的 ORBIT 帳號。」），在「統一編號」欄輸入公司統編（8 碼數字）後按「確認」，系統會把你跟正確的公司對起來。
3. 填寫個人資料建檔：畫面上會出現「HI，你好，我是ORBIT」的歡迎訊息，請填寫：姓名（必填）、部門、職稱、電話、Email、計薪方式（月薪／時薪）、對應的薪資金額。填完點「送出，等候主管審核」。
4. 送出後系統會建立你的員工資料，但狀態是「待審核」，要等主管在後台核准，才能正式使用打卡、請假等功能。

注意事項 / 常見問題

• 這個流程只會在第一次登入、系統裡還找不到對應你的員工資料時出現。已經建檔過的人再次登入會直接進系統，不會又跳出這個表單（重複送出會被擋下並提示「已經送出過建檔資料，請等候主管審核，或請主管協助修改」——2026-07-26 用已建檔帳號實測確認）。

• 如果你的電話號碼跟公司後台已經存在的一筆「還沒有人認領」的員工資料相同，系統會自動幫你把帳號連結上那筆既有資料（可能是主管之前用匯入功能先建好的），不會變成兩筆重複資料。
• 待審核期間能不能先打卡/請假：目前送出建檔後就會建立你的員工紀錄，但系統設計上是要等主管審核；實際上何時算「可以開始用」、審核前能不能先打卡，這一點系統裡沒有明確擋下待審核帳號使用考勤功能，正確的操作認知請跟主管/公司規定確認。（目前沒有明確擋下或提示，這點是否需要請工程調整？。細節請洽主管。）

操作路徑

新手機：登入 → 加入桌面 → 允許定位權限

步驟說明

1. 在新手機上用原本的方式登入（LINE／Google／信箱密碼皆可，帳號本身不用重新申請）。
2. 依「如何把ORBIT加到手機桌面」把圖示加回新手機桌面。
3. 第一次在新手機打卡時，會重新跳出「是否允許定位」的詢問，記得按「允許」（iPhone 需選「使用 App 期間」）。
4. 完成以上即可，不需要額外做其他設定。

注意事項 / 常見問題

• 舊手機會自動被登出：ORBIT 的登入設計是「單一裝置登入」——只要在新手機登入成功，舊手機下次操作系統時就會被強制登出（跳轉到登入頁），這是系統本來的設計，不是故障，不用特別去舊手機上按登出。
• 如果換手機後在新手機上一直卡在登入畫面進不去，通常不是設定問題，請參考「登入不了/忘記密碼怎麼辦」條目排查。
• 定位權限、桌面圖示都是綁在「這支手機」上的系統/瀏覽器設定，換手機後一定要重新做一次，不會跟著帳號自動帶過去。

操作路徑

（通用排除步驟，不對應特定畫面）

步驟說明

1. 先確認是不是從手機桌面的 ORBIT 圖示開啟，不是從 LINE 或其他 App 內建瀏覽器點連結進來的（內建瀏覽器最容易發生跑版、手勢/按鈕沒反應）。
2. 把 App 完全關閉（滑掉背景，不是只切到別的畫面）再重新從桌面圖示打開一次。
3. 還是不行，試著整個重新整理頁面（下拉更新，或關閉分頁重開）。
4. 確認手機系統版本、瀏覽器版本不要太舊（iOS Safari／Android Chrome 建議跟著手機系統更新）。
5. 都試過還是異常，把當下的畫面截圖，附上手機型號、大概的操作步驟，回報管理者轉告 ORBIT 團隊處理。

注意事項 / 常見問題

• 這一則是通用排除步驟，沒有針對單一bug撰寫，因為「跑版/點不動」可能有很多不同原因（網路不穩、瀏覽器快取、單一功能本身的bug等）。
• 如果「點不動」specifically是指員工考勤頁面的「滑動打卡」按鈕完全沒反應（連滑動動畫都不會跑），這件事有一個已知、已確認的系統性原因，不是單純畫面異常，請直接看「滑動開始上班沒反應怎麼辦」條目，裡面有明確說明。
• （細節請洽主管或 ORBIT 客服確認）

說明（跟大部分人想的不一樣，請先看這段）

1. 鈴鐺（通知）：那是系統公告／最新消息（例如系統維護、新功能），不是 LINE 訊息，是站內通知，跟 LINE 完全無關。
2. 請假申請送出時：系統會嘗試發一則通知，但對象是「公司負責人本人」（老闆帳號），不是承辦的主管、更不是申請人自己。而且要同時符合三個條件才發得出去：公司已在「整合應用」設定好 LINE 官方帳號的串接金鑰、老闆本人的帳號有用 LINE 登入過 ORBIT、以及公司後台的「自動通知」設定已開啟。
3. 請假被核准/拒絕時：系統設計是寄「Email」通知申請人，不是 LINE，而且要寄到你個人資料裡填的 Email 欄位，同樣要公司開啟「自動通知」才會寄。

步驟說明

1. 如果你是一般員工，收不到 LINE 通知：目前這是正常現象（系統沒有這個功能），請改用畫面上的「請假紀錄」「補打卡申請」列表自己查詢審核狀態，不用等通知。
2. 如果你是公司負責人，預期應該要收到 LINE 通知卻沒收到：請管理者到「整合應用」頁確認「LINE 官方帳號」區塊是否已完成串接（按鈕文字「串接 LINE 官方帳號」；2026-07-26 實測新韻目前顯示「未串接」、整頁「已連結 0 個」）；「自動通知」開關目前沒有畫面可以自己開啟，需要聯繫 ORBIT 團隊協助確認。
3. 如果核准/拒絕通知的 Email 沒收到：先確認自己的員工資料裡有沒有填 Email（見「個人資料填錯了，在哪裡改」），沒填就一定收不到。

注意事項 / 常見問題

• （目前整個系統找不到任何畫面可以自己開啟，只能改系統——這是刻意的（例如尚未正式對客戶開放）還是遺漏了設定畫面？新韻傳音目前是否已經開通這個開關？。細節請洽主管。）
• （細節請洽主管或 ORBIT 客服確認）

說明

會這樣是因為：系統選單裡的「員工」頁面（可以編輯所有員工資料的地方）權限限定在店長／管理者以上，一般員工（銷售員/點餐員/櫃檯等）的選單裡根本沒有「員工」這個項目，就算知道網址直接輸入也會被擋下。

步驟說明

1. 發現自己的姓名、電話、Email、部門、職稱、薪資等資料有誤，不要嘗試自己找設定頁面（目前沒有這個功能），直接跟你的主管/店長口頭或用其他管道說明要改哪一項、正確的資料是什麼。
2. 由主管到後台「員工」頁面，找到你的資料進行編輯。
3. 涉及薪資（月薪/時薪金額、計薪方式）的異動，通常需要更高層級的人確認，建議透過主管一併轉達。

注意事項 / 常見問題

• 這不是「找不到藏起來的按鈕」，是目前系統確實沒有做「員工自助修改個人資料」這個功能，如果你是新韻傳音的窗口在看這則，這算是本次盤點發現的一個產品缺口，可評估是否需要之後補上。
• 剛自助建檔、還在「待審核」狀態時發現填錯，同樣沒有自己修改或撤回重填的入口，只能請主管協助，或等審核後再請主管改。

答案

目前系統尚未提供此功能。 系統只有深色主題，沒有淺色模式可以切換；介面語言固定為繁體中文，沒有語言切換功能。

注意事項 / 常見問題

• 覺得畫面太暗或字太小，可以先用瀏覽器本身的縮放（手機雙指縮放、電腦 Ctrl/Cmd＋「+」）調整。
• 如果貴公司對淺色模式或多語言有實際需求，請聯繫 hello@obarai.com 提出，未來版本會評估。

操作路徑

員工考勤 → 打卡 → 滑動上班/下班打卡

步驟說明

1. 最常見原因：從 LINE（或 Facebook 等 App）內建瀏覽器直接點連結打卡——這種內建瀏覽器抓不到手機定位。請改從手機桌面的 ORBIT 圖示開啟（還沒加入桌面？見「如何把ORBIT加到手機桌面」）。
2. 確認手機系統的「定位服務」總開關是開著的。
3. 確認瀏覽器/App 本身有拿到定位權限，且第一次跳出詢問時有按「允許」——公司只有設定了打卡地點範圍（地理圍籬）時，上班/下班打卡才需要定位，午休開始/結束不需要。
4. 如果之前不小心按過「拒絕」，系統不會再自動跳出詢問，需要手動到手機設定重新開啟，詳見「定位權限按到拒絕了怎麼辦」。

注意事項 / 常見問題

• 系統實際上會依失敗原因顯示不同訊息，不是只有一種：定位權限被拒絕、訊號抓不到（室內常見）、10秒內沒反應（逾時）、裝置不支援定位，四種訊息內容不同，請照畫面實際顯示的文字判斷，不是每次都是同一句「需要開啟定位服務」。
• 在 LINE 裡直接點連結打卡 → 幾乎必定抓不到定位 → 一律從桌面圖示進入。
• 曾經按過「不允許」定位 → 系統不會再問 → 見「定位權限按到拒絕了怎麼辦」。
• 如果滑動打卡整個沒反應（連錯誤訊息都沒跳出來），不是定位問題，請看「滑動開始上班沒反應怎麼辦」條目。

操作路徑

手機系統設定 → 定位/隱私權設定 → 找到瀏覽器（Safari / Chrome） → 重新開啟定位權限

步驟說明

1. iPhone：設定 → 隱私權與安全性 → 定位服務 → 找到「Safari網站」（如果是從桌面圖示開的，可能會顯示成 ORBIT 或 ERP.POS 的捷徑圖示）→ 選「使用 App 期間」，並開啟「精確位置」。
2. Android：設定 → 應用程式 → Chrome → 權限 → 位置 → 選「僅在使用時允許」。
3. 回到 ORBIT（桌面圖示重新開啟），再打卡一次，這次應該會重新跳出定位權限詢問（或直接生效）。

注意事項 / 常見問題

• 只開了手機的「定位服務」總開關是不夠的——瀏覽器/這個網站本身要另外拿到授權，是分開的兩層設定，兩層都要開才會生效。
• iPhone 特別注意「精確位置」也要打開，只開「大概位置」的話座標誤差可能達數百公尺，容易導致打卡範圍判定失敗（見「人在公司卻顯示不在打卡範圍內」）。
• 找不到對應的瀏覽器/網站項目：代表這支手機之前從沒被詢問過定位權限，通常重新整理頁面、再點一次打卡，系統就會重新跳出詢問視窗。

操作路徑

員工考勤 → 打卡 → 滑動上班/下班打卡

步驟說明

1. 系統會顯示明確的錯誤訊息：「您不在店面範圍內（距離 XX 公尺，允許範圍 XX 公尺）。如為業務需求，請管理者核發外勤打卡授權。」，可以看到目前系統判定你離設定地點多遠（訊息全文 2026-07-26 於正式站實測取得）。打卡畫面本身也固定顯示提示：「系統已設定範圍，請至規定範圍內打卡。如果是業務或職務需求需要在其他地點打卡，請由管理者授權。」。
2. 確認手機定位的「精確位置」已開啟（見「定位權限按到拒絕了怎麼辦」）——只開一般定位、沒開精確位置，室內誤差可能達數百公尺，很容易誤判成範圍外。
3. 走近窗邊或門口再試一次，GPS 在室內深處訊號較弱，容易飄移。
4. 如果距離顯示異常大（例如顯示相差好幾公里），代表公司後台設定的打卡座標本身可能有誤，這不是個人裝置問題，需要請管理者確認公司地址/座標設定是否正確。
5. 都排除還是失敗，如果當天有業務/外勤需求，請管理者核發「外勤打卡授權」（見「外出跑業務可以在外面打卡嗎」）；如果是公司內部要長期調整允許範圍大小，需請管理者協助確認設定。

注意事項 / 常見問題

• 系統判定範圍只管「上班」「下班」兩個時間點，午休開始/結束不受地點限制。
• 連上公司 Wi-Fi 不代表定位就會準確，系統是用手機 GPS 座標判斷，不是用 Wi-Fi。
• 新韻傳音目前設定的允許打卡範圍是 100 公尺（2026-07-26 於正式站實測，錯誤訊息回報「允許範圍 100 公尺」）。如果員工反映「明明在店裡卻常常被判定範圍外」，可能是 GPS 誤差大於 100 公尺（室內深處常見）或座標設定有誤差，依上面步驟 2-4 排除。

操作路徑

（員工端）先口頭/其他管道告知管理者 → （管理者端）員工考勤 → 打卡頁面地點提示區 → 核發外勤打卡授權

步驟說明

1. 如果公司有設定打卡範圍限制，你在外面打卡失敗時，畫面會提示「如為業務需求，請管理者核發外勤打卡授權」。
2. 實務上請你事先（或當下）用其他管道告知你的主管，說明今天需要在範圍外打卡的原因。
3. 由管理者在打卡頁面點「管理者：核發外勤打卡授權」，選擇員工姓名與日期，備註原因（例如「出差拜訪客戶」），送出後即完成授權。
4. 授權完成後，被授權的員工當天打卡不會再受地點限制，打卡方式不變，一樣從桌面 ORBIT 圖示、滑動打卡即可。

注意事項 / 常見問題

• 這個授權是當天生效、需要每次個別核發的，不是一次設定永久生效，每次外出前都要重新請管理者核發當天的授權。
• 授權沒有審核流程或「申請中」狀態，管理者送出的當下就直接生效，不像請假/補打卡申請那樣有 pending/approved 的過程。
• 授權日期選錯：員工當天仍打不了卡，核發後建議請員工當場確認能不能正常打卡。

操作路徑

員工考勤 → 打卡

步驟說明

1. 上班到 → 滑動「滑動上班打卡」。
2. 上班中，畫面會顯示「上班中．請先打卡開始午休，才能打卡下班」，點「開始午休」按鈕。
3. 午休結束 → 滑動「滑動結束午休」。
4. 下班離開 → 滑動「滑動下班打卡」。

一共固定 4 段：上班 → 午休開始 → 午休結束 → 下班，順序系統會強制卡住，跳不過去。

注意事項 / 常見問題

• 系統設計是硬性規定四段都要打：系統會檢查，如果沒打「午休開始」「午休結束」，直接點下班打卡會被擋下，顯示「尚未打卡午休開始，請先完成午休打卡才能打卡下班」。也就是說，沒辦法跳過午休直接打下班卡。
• 畫面上方「今日狀態」會顯示你目前在哪個階段（尚未上班／上班中／午休中／已下班），跟著畫面顯示的按鈕打即可，不用自己記順序。
• 同一階段不能重複打：例如已經打過上班卡，畫面不會再讓你打第二次「上班」（會顯示「今日已打卡上班」）。
• 忘記打某一段怎麼辦，見「忘記打卡怎麼辦」條目。

說明

查證確認：系統已經有正式的「補打卡申請」功能（不是舊說法的「找管理者手動補登」——那是沒有這個功能之前的權宜做法，現在請走下面的申請流程，管理者也是在同一套審核畫面處理，不用再私下喬）。

操作路徑

員工考勤 → 補打卡申請 → 新增補打卡

步驟說明

1. 進入「員工考勤」頁面，點上方分頁切到「補打卡申請」。
2. 點「新增補打卡」。
3. 填寫：日期（必填）、上班時間／下班時間（至少填一個，兩個都可以只填一個）、補打卡原因（必填，簡述忘記打卡的原因）。
4. 點「提交申請」，狀態會顯示「待審核」。
5. 等主管在同一個列表核准，核准後系統會自動把時間寫回你當天的打卡紀錄；如果那天完全沒有打卡紀錄，核准後系統會直接幫你補建一筆。

注意事項 / 常見問題

• 補打卡申請目前只能補「上班」「下班」時間，不能補「午休開始」「午休結束」——如果忘記打的是午休那兩段，這個表單填不了，需要另外請管理者手動處理（見「打錯卡怎麼修正」條目）。
• 送出後可以在同一個分頁看到自己所有補打卡申請的狀態（待審核／已核准／已拒絕）。
• 越早處理越好：拖到月底才補，時間久了自己也不容易講清楚正確時間，建議想起來當天就送出申請。
• 送出後多久會核准、被拒絕怎麼辦，見「補卡申請送出後多久會核准？被退回怎麼辦？」條目。

操作路徑

員工考勤 → 補打卡申請 → 新增補打卡

步驟說明

1. 點「員工考勤」頁面上方的「補打卡申請」分頁。
2. 點右上角「新增補打卡」按鈕。
3. 填寫「日期」：選擇要補的那一天。
4. 填寫「上班時間」與「下班時間」：兩個欄位至少要填一個（例如只是忘記打下班卡，上班時間可以留空）。
5. 填寫「補打卡原因」（必填）：簡述忘記打卡的原因，例如「手機沒電忘記打卡」。
6. 確認資料無誤，點「提交申請」，畫面會關閉表單並自動出現在申請列表中，狀態顯示「待審核」。

注意事項 / 常見問題

• 日期、上班或下班（至少一個）、原因三者都是必填，缺一個系統會擋下並顯示對應的錯誤提示（例如「請選擇日期」「上班或下班時間至少填一個」「請填寫補打卡原因」）。
• 補打卡申請的日期沒有限制只能補「今天」或「最近幾天」，理論上可以選任何日期，但實務上建議盡快處理，太久以前的紀錄不容易佐證。
• 送出後如果打錯了想改，目前沒有「編輯」功能，只能等主管審核，或口頭告知主管暫緩處理，需要修正內容的話直接重新送一筆新的申請。

操作路徑

員工考勤 → 補打卡申請（查看自己送出的申請列表）

步驟說明

1. 送出補打卡申請後，狀態會先顯示「待審核」，這時系統還沒有把時間寫進你的打卡紀錄。
2. 系統沒有自動核准機制，也沒有時限規定，完全要等主管手動點「核准」或「拒絕」，處理時間依主管實際查看的速度而定。
3. 核准後，狀態變成「已核准」，同時你申請的時間會自動寫入當天的打卡紀錄（可以到「打卡」分頁確認紀錄有沒有更新）。
4. 如果被「拒絕」：狀態變成「已拒絕」，畫面不會顯示拒絕原因欄位；如果還是需要補這筆紀錄，目前沒有「重新申請」或「編輯」的按鈕，需要直接再送一次新的補打卡申請（同一天可以送第二筆）。（「待審核」→ 主管按「拒絕」→「已拒絕」的完整流程與狀態標籤文字，2026-07-26 已用 demo 帳號在正式站實測走過一輪。）

注意事項 / 常見問題

• 一筆申請只能被核准或拒絕一次，已經審核過的申請不能重複審核（系統會擋下並顯示「此申請已審核過」）。
• （細節請洽主管或 ORBIT 客服確認）
• （細節請洽主管或 ORBIT 客服確認）

操作路徑

員工考勤 → 打卡（近7日紀錄） 或 歷史紀錄與行事曆（完整列表）

步驟說明

1. 最近 7 天的打卡紀錄跟統計，直接在「員工考勤」首頁的「打卡」分頁下方就看得到，不用另外點進去——四張統計卡「正常出勤」「遲到」「早退」「缺勤」（各標「近 7 日」），下方「近 7 日出勤紀錄」表格（欄位：日期／上班／下班／工時／狀態）。
2. 要看更早以前的紀錄，點頁面上方的「歷史紀錄與行事曆」（跟「假別管理」並排的快捷連結）。
3. 進去後「打卡原始紀錄」區塊會列出打卡明細（欄位：員工、日期、上班、下班、狀態、備註；區塊副標寫「最新100筆，舊系統轉移用」），一般員工只看得到自己的資料。
4. 「每日考勤統計」區塊顯示每天的彙總數字，這個表是舊系統轉移或管理者匯入的歷史彙總，不是即時算出來的。
5. 「公司行事曆」區塊顯示國定假日/補班日，是全公司共用的資訊，不分個人。

注意事項 / 常見問題

• 查證後需要澄清一點：這個頁面不是真正的月曆網格檢視，是「表格列表」形式（一列一天），如果藍圖題目原意是指真正的日曆格狀畫面，目前系統沒有這種畫面，只有列表。（細節請洽主管或 ORBIT 客服確認）
• 這個頁面同時也是管理者用來「手動新增/匯入」歷史紀錄的地方，畫面上會看到「手動新增」「匯入」的按鈕，但這些操作實際上限管理者才能成功送出，一般員工即使看得到按鈕，點下去也會被系統擋下（顯示權限不足），這是正常現象，不用理會，你能用的只有查詢自己的紀錄。

操作路徑

員工考勤 → 打卡

步驟說明

1. 滑動打卡成功的瞬間，滑動條會出現打勾的完成圖示，手機會震動一下（如果裝置支援）。
2. 打卡完成後，畫面上方「今日狀態」文字會立刻更新（例如從「尚未上班」變成「上班中」）。
3. 上方四個欄位「上班打卡」「下班打卡」「午休開始」「午休結束」，對應的那一格會立刻顯示打卡時間（例如 09:05）。
4. 完成「下班打卡」後，畫面會切換成完成畫面，顯示綠色打勾圖示、「下班打卡完成」文字，以及當天扣除午休後的總工時（例如 8h05m）。

注意事項 / 常見問題

• 如果滑到底卻沒有出現打勾動畫、也沒有跳出任何錯誤訊息：不是「打卡成功但沒顯示」，通常代表操作根本沒有送出去，請看「滑動開始上班沒反應怎麼辦」條目排查。
• 打卡失敗時系統一定會用紅色框顯示錯誤原因文字（定位問題、範圍問題、網路問題等），如果畫面上方及下方都沒有出現任何提示、狀態文字也沒有變化，就是沒有成功。
• 打卡成功後想再次確認，可以直接看「近7日出勤紀錄」列表裡今天那一列的時間是否正確。

ℹ️ 歷史紀錄：「銷售員」角色曾有整頁沒反應的系統bug，已於 2026-07-24 修復

排查步驟

1. 先確認滑動手勢本身有沒有做對：需要用手指從最左邊拖到最右邊（拖到底，約９成以上的距離），不是輕點一下，拖不夠遠系統會自動彈回原位，這是正常設計，不是故障。
2. 確認是從手機桌面的 ORBIT 圖示開啟，不是 LINE 等 App 內建瀏覽器（內建瀏覽器對這類拖曳手勢、定位權限的支援不穩定，見「要用什麼瀏覽器開啟ORBIT」）。
3. 檢查頁面上方「選擇員工」下拉選單裡有沒有出現你自己的名字：

- 如果下拉選單是空的、完全選不到任何人（包含自己），代表帳號權限或資料有異常（歷史上曾因角色bug造成，已於2026-07-24修復），請截圖回報管理者處理。 - 如果下拉選單選得到自己的名字，但滑到底還是沒反應，才繼續看下面步驟。

1. 滑到底後系統會請求定位權限，如果手機當下彈出定位詢問視窗、被切到背景又切回來，可能會中斷這次滑動手勢，導致看起來「沒反應」，請重新滑一次。
2. 都排除後仍無法使用，重新整理頁面或關閉重開再試一次；如果還是不行，截圖回報管理者。

說明

先澄清一個介面設計：系統的按鈕是「跟著狀態走」的——上班後如果還沒打「午休開始」，畫面只會出現「開始午休」按鈕，不會出現「下班」的滑動按鈕，所以理論上不太可能誤把「午休」按成「下班」（畫面上根本沒有下班按鈕可以按錯）。比較可能發生的打錯情況是：手滑多按了一次「開始午休」/「結束午休」、或打卡當下網路延遲重複點擊。

操作路徑

• 上/下班時間打錯：員工考勤 → 補打卡申請 → 新增補打卡（自己送出即可）
• 午休開始/結束時間打錯：需要請管理者到「歷史紀錄與行事曆」手動編輯

步驟說明

1. 如果打錯的是「上班」或「下班」時間：直接送「補打卡申請」，填正確的時間跟原因，等主管核准後系統會自動覆蓋回正確時間。做法同「如何送出補卡申請」條目。
2. 如果打錯的是「午休開始」或「午休結束」時間：目前的「補打卡申請」表單沒有這兩個欄位，員工自己沒有辦法送出申請修正，需要用其他管道（口頭/其他通訊軟體）直接告知管理者正確時間。「補打卡原因＊」，確無午休欄位。）
3. 管理者收到反映後，到「員工考勤」→「歷史紀錄與行事曆」→「打卡原始紀錄」區塊，找到那筆紀錄點編輯圖示，可以個別修改上班/下班/午休開始/午休結束四個時間欄位，存檔即可修正。

注意事項 / 常見問題

• （細節請洽主管或 ORBIT 客服確認）
• 已經打卡完成的紀錄，員工自己沒有「刪除」或「復原」的按鈕，不管是哪個時段打錯，自己都改不了，一定要透過補打卡申請或管理者協助。

說明

查證確認：目前系統沒有「加班申請」功能——員工這邊完全沒有畫面可以自己登記或申請加班。系統裡確實有「加班時數」這個欄位（在「每日考勤統計」報表裡），但這個數字只能由管理者透過 CSV 匯入，或手動輸入才會出現，不是打卡系統自動算出來的，員工自己看得到這個數字，但沒辦法自己新增或修改。

操作路徑

（員工端目前無操作入口；如需登記加班，須告知管理者由其匯入/登錄）

步驟說明

1. 如果你有加班，目前系統上沒有按鈕可以自己申請或登記，一律要用口頭或其他管道告知管理者。
2. 管理者確認後，需要透過「歷史紀錄與行事曆」→「每日考勤統計」的匯入功能，或後續手動輸入的方式（目前介面上沒有單筆手動新增每日統計的表單，僅支援整批 CSV 匯入），把加班時數記錄進系統。
3. 你可以到「歷史紀錄與行事曆」→「每日考勤統計」查看自己名下的加班時數欄位，確認公司有沒有幫你登記。

注意事項 / 常見問題

• （目前對加班的實際處理方式是什麼（口頭報備、LINE群組留言、紙本簽核）？系統目前沒有加班申請/核准的正式流程，如果需要，這是額外要規劃的功能，不是設定就能打開的。細節請洽主管。）
• 打卡系統本身（上下班時間）跟「加班時數」報表是兩個獨立的東西：就算你下班打卡時間比較晚，系統不會自動把多出來的時間算成加班時數，兩者不連動。

說明

操作路徑

員工考勤 → 歷史紀錄與行事曆 → 公司行事曆（僅供查詢，非計薪依據）

步驟說明

1. 要確認某一天是不是國定假日/補班日，到「歷史紀錄與行事曆」→「公司行事曆」查詢，可以看到日期、名稱（例如「開國紀念日」）、類型（放假／補班）、來源（政府行事曆／公司自訂）。按「新增」加自訂假日。）
2. 如果國定假日當天有排班出勤，打卡方式完全照平常流程（上班→午休開始→午休結束→下班），系統不會特別用不同方式處理。
3. 國定假日出勤是否有加給、怎麼計算，目前系統沒有自動判斷，需要另外用人工方式核算，反映給管理者處理。

注意事項 / 常見問題

• （細節請洽主管或 ORBIT 客服確認）
• 「補班日」代表原本的假日（通常是六日）被調整成要上班，行事曆上會標示「補班」，但一樣不會影響打卡本身的操作方式。

⚠️ 重要說明：一般員工目前完全看不到自己的薪資單

操作路徑

（員工端無法自行查詢）管理者：員工 → 薪資單分頁 → 選擇年月查詢

步驟說明

1. 如果你是一般員工，想看自己的薪資單：目前系統上沒有入口，請直接跟管理者/店長索取，或詢問公司薪資單是透過什麼管道（紙本、其他表單）發放的。
2. 如果你是管理者：進入「員工」頁面，切到「薪資單」分頁，選擇年份／月份查詢，可以看到全公司每個人的：職位、薪資基準（月薪或時薪金額）、出勤天數、總工時、遲到天數、請假天數、應付薪資（依出勤/請假自動試算，非最終薪資）。
3. 「應付薪資」欄位算法：月薪制直接顯示約定月薪；時薪制是「總工時 × 時薪」四捨五入計算，目前沒有扣除項（扣款欄位固定顯示 0），也還沒有納入加班費、國定假日加給等其他項目。

注意事項 / 常見問題

• （細節請洽主管或 ORBIT 客服確認）
• 系統試算出來的「應付薪資」目前不包含加班費、國定假日加給、請假扣薪等項目（請假天數只是列出參考，沒有真的從薪資裡扣），如果要當作正式薪資單使用，還需要管理者自己額外核算調整，不能直接照系統數字發薪。

答案

打卡操作完全一樣，系統不分班別。 系統目前沒有排班表／班別範本功能，不管你是早班、晚班還是輪班，打卡都是同一套流程：一天四段、順序固定——上班 → 午休開始 → 午休結束 → 下班（見第15號條目）。

員工檔上的「上班時間／下班時間」欄位僅供顯示參考，不影響打卡判定。

注意事項 / 常見問題

• 目前系統的遲到判定是全公司統一的固定門檻（超過上午 9:30 打上班卡記為「遲到」），不會依個人班表調整——晚班員工正常時間上班可能被標成遲到。（細節請洽主管或 ORBIT 客服確認）
• 需要換班、調班，目前系統內沒有排班功能可操作，依公司內部規定跟主管協調即可，系統只記實際打卡結果。

操作路徑

員工考勤 → 請假申請 分頁 → 「新增請假」

步驟說明

1. 選「假別」（例如特休、事假，見「有哪些假別？額度怎麼看？」）。
2. 選「起始日」「結束日」——多天／全天請假不用填時間，只選日期即可。
3. 如果只請部分時段（半天或指定幾小時），勾選「只請部分時段（半天／指定時數，僅限單日）」，此時結束日會自動鎖定跟起始日同一天，並多出「起始時間」「結束時間」兩個欄位（此模式只能單日，不能跨日）。
4. 填「請假事由」（必填）。
5. 按「提交申請」，送出後等主管核准。

注意事項 / 常見問題

• 假單分兩種填法：整天／跨日（只填日期，系統自動以整天8小時計算時數）跟部分時段（勾選後才會出現時間欄位，只能單日）。不是每張假單都要填時間。
• 部分時段（半天假）的結束時間必須晚於起始時間，且限單日；想跨日請假就不要勾選部分時段。

操作路徑

員工考勤 → 打卡 分頁

步驟說明

1. 先送出下午的假單：「新增請假」表單裡勾選「只請部分時段（半天／指定時數，僅限單日）」，會展開「起始時間＊」「結束時間＊」欄位（例：13:00～18:00），填好送出等主管核准。
2. 中午要離開時，照常打「下班打卡」。
3. 假單跟打卡紀錄目前是各自獨立的兩筆資料，系統不會因為你有假單就自動免除打卡動作。

注意事項 / 常見問題

操作路徑

員工考勤 → 請假申請 分頁

步驟說明

如果假單還是「待審核」狀態：

1. 請主管將該假單「拒絕」——效果等同銷假，該天恢復正常應出勤，不會扣假別額度。（2026-07-26 實機走過完整流程：員工送出→「待審核」→主管按「拒絕」→狀態變「已拒絕」。）
2. 需要的話，之後再重新送一張新假單。

如果假單已經「已核准」：

1. （細節請洽主管或 ORBIT 客服確認）

注意事項 / 常見問題

• 送出前發現填錯，直接聯絡主管拒絕原假單、重新送一張最快。

操作路徑

員工考勤 → 請假申請 分頁 → 「新增請假」

步驟說明

1. 用跟一般請假完全相同的流程送假單，「起始日」可以選過去的日期——系統不會檢查日期是否已經過去，只檢查「結束日不能早於起始日」，所以事後補請過去的假在系統操作上是可行的。
2. 事由欄位建議註明是事後補請。
3. 送出後一樣等主管核准。

注意事項 / 常見問題

• （細節請洽主管或 ORBIT 客服確認）
• （目前都不是系統會自動判定的即時狀態（打卡狀態欄位只在上班打卡當下判斷遲到，之後不會再更新），所以嚴格來說沒有「早退紀錄」可以被回溯修正——核准這張補請的假單，只會單純新增一筆請假紀錄、扣一次假別。細節請洽主管。）

操作路徑

員工考勤 → 右上角「假別管理」（或請假申請彈窗內的「管理假別」連結）→

步驟說明

1. 頁面上半「假別設定」表格：列出所有假別的代碼、名稱、給假單位（天／小時）、最小申請單位、是否扣薪、是否需要證明文件。
2. 頁面下半「休假額度與餘額」表格：列出每筆額度紀錄的取得日期、額度、已休、剩餘（剩餘 = 額度 − 已休）、狀態（有效／已過期／已結算）。
3. 一般員工只能看到自己的額度；管理者以上可以看到全公司所有員工的額度（含未休折現金額，一般員工看不到別人的這項資料）。
4. 第一次進「假別管理」頁時，如果該公司還沒設定過假別，系統會自動帶入台灣勞基法11種法定假別當預設值（見33號條目的完整清單）。

注意事項 / 常見問題

• 假別的新增／刪除／匯入需要管理者以上權限；一般員工只能查看。

操作路徑

員工考勤 → 假別管理

步驟說明

實際查詢新韻傳音在系統系統裡目前設定的假別，跟系統預設的台灣勞基法11種法定假別完全一致，新韻沒有另外調整過任何一筆假別設定：

| 代碼 | 假別 | 給假單位 | 是否扣薪 | 需證明文件 | 備註 | |---|---|---|---|---|---| | L01 | 特別休假 | 小時 | 否 | 否 | 法定特休，未休完需結算 | | L02 | 加班補休 | 小時 | 否 | 否 | 加班轉換，未休完需結算 | | L03 | 事假 | 小時 | 是（全額） | 否 | 一年最多14天(112小時) | | L04 | 普通傷病假 | 小時 | 是（半薪） | 是 | 一年最多30天(240小時，半薪) | | L05 | 公傷病假 | 小時 | 否 | 是 | 依實際情況核給 | | L06 | 婚假 | 天 | 否 | 是 | 8天(64小時) | | L07 | 喪假 | 天 | 否 | 是 | 依親屬關係給予不同天數 | | L08 | 產假 | 天 | 否 | 是 | 56天(448小時) | | L09 | 陪產檢及陪產假 | 天 | 否 | 是 | 7天(56小時) | | L10 | 家庭照顧假 | 小時 | 是（全額） | 否 | 併入事假計算(最多7天) | | L11 | 生理假 | 小時 | 是（半薪） | 否 | 每月1天，全年最多3天不併入病假 |

注意事項 / 常見問題

• 這是系統首次載入「假別管理」頁時自動帶入的台灣勞基法標準值，新韻目前完全沿用預設值，沒有自行調整過任何一項。
• 如果新韻之後想調整（例如把某假別改成不扣薪、調整需要證明文件的假別），管理者可以直接在「假別管理」頁編輯或刪除重建，不需要工程協助。
• L01特休的實際天數會依員工年資動態計算（每日排程自動重算），不是固定值，這裡列出的是「假別規則設定」，不是「每個員工實際可休天數」，員工個人的特休額度要看「假別管理」頁下半的「休假額度與餘額」表格。

操作路徑

員工考勤 → 假別管理（查是否需要證明）／請假申請（送出假單）

步驟說明

1. 到「假別管理」頁查該假別的「需證明」欄位是否為「是」——新韻目前設定普通傷病假(L04)、公傷病假(L05)、婚假(L06)、喪假(L07)、產假(L08)、陪產檢及陪產假(L09)這6種需要證明文件，特別休假、加班補休、事假、家庭照顧假、生理假不需要。
2. （目前只是假別設定裡的一個標記，用來提醒「這個假別依規定要附證明」，系統也不會因為缺證明就擋你送出申請。細節請洽主管。）

注意事項 / 常見問題

• 在證明文件上傳功能做出來之前，建議請假事由欄位裡註明「證明已另外提供給主管」，避免主管審核時搞不清楚狀況。

操作路徑

POS → 櫃檯

步驟說明

1. 用上方「搜尋菜單品項或條碼」找商品，或按「掃描」用相機掃條碼，也可以直接點商品格加入購物車。
2. 購物車內用 +／− 調整數量；往右滑品項可加備註／規格，往左滑可刪除該品項。
3. 需要的話在「付款方式」選信用卡／電子支付／現金（見40號完整清單），也可以切換「零售／企業」計費模式。
4. 需要開票的話在「發票／收據」選收據或紙本發票（注意：這裡選的發票類型目前不會真的送出電子發票，實際開票要另外到「電子發票」頁操作，見44號說明）。
5. 滑動「滑動結帳 NT$ xxx」完成，畫面會顯示「付款完成」。

注意事項 / 常見問題

• 畫面右上角若顯示的是「點餐員模式」（一般服務生角色），只能「滑動送出」把訂單送出，沒有收款/結帳權限，需要收銀員或以上角色才能完成收款。
• 送出後的訂單品項無法再修改，加項/減項請見37號說明。

操作路徑

POS → 訂單

步驟說明

1. 上方分頁切換：全部／待處理／進行中／已完成／已取消，可快速篩選。
2. 用搜尋框輸入「訂單編號」或「客戶」姓名／電話查特定訂單。
3. 表格每列顯示：訂單編號、客戶、品項數、總額、付款方式、付款狀態、訂單狀態、時間。

注意事項 / 常見問題

訂單狀態（獨立一個欄位）：

• 待處理 → 進行中 → 已完成（依產業會顯示不同用詞，例如零售業叫「處理中／已完成」）
• 已取消（訂單已作廢，見38號）

付款狀態（另一個獨立欄位，跟訂單狀態分開看）：

• 未付款 / 已付款 / 已退款

• 訂單編號旁若有紫色「線上」標籤，代表是線上點餐進來的訂單，不是櫃檯手動建立的。
• 頁面每30秒自動重新整理一次，有新的線上訂單會跳出提示音跟橫幅通知。

操作路徑

送出前：POS → 櫃檯（購物車還在畫面上時） 送出後：POS → 訂單（只能整張作廢重開）

步驟說明

訂單還沒送出（還在購物車階段）：

1. 直接在購物車裡用 +／− 調整數量；往左滑該品項會出現紅色「← 滑動刪除」確認，滑到底即刪除；往右滑是開啟備註/規格面板（不是刪除）。要加新品項，直接在左側商品清單再點選即可，沒有限制。

訂單已經送出（已建立訂單）：

1. （細節請洽主管或 ORBIT 客服確認）/route.ts`的PATCH只允許改「狀態、付款方式、備註、桌號、付款狀態」這幾個欄位，訂單品項完全沒有對應的新增/修改/刪除端點。目前唯一的做法是：整張訂單作廢（見38號，需要管理者以上權限），回到櫃檯重新建立一張正確的訂單。這對於「客人加點一杯飲料」這種小幅調整來說操作上比較麻煩，建議洽主管確認是否需要開發「訂單建立後可修改品項」的功能。]

注意事項 / 常見問題

• 送出前務必跟客人確認清楚品項，避免送出後才發現要改，需要整張作廢的麻煩。

操作路徑

POS → 訂單 → 該筆訂單列最右側「取消訂單」（禁止圖示按鈕）

步驟說明

1. 只有「已完成」「已取消」以外狀態的訂單才會顯示作廢按鈕。
2. 按下後，若設定裡開著「作廢需主管PIN」（預設開啟），會跳出主管PIN輸入框，輸入正確PIN才會執行。
3. 作廢後訂單狀態變成「已取消」，系統會自動把該筆訂單扣掉的庫存加回去（不是單純隱藏，是真的還原庫存）。

注意事項 / 常見問題

• 權限層級：只有「店長」「管理員」角色能看到作廢按鈕（權限），一般「銷售員」「櫃檯」角色的帳號畫面上不會出現這個按鈕。
• 「作廢」是取消整張訂單，不是刪除單一品項，作廢後品項無法復原（庫存會退回，但訂單紀錄仍會保留、只是狀態變成已取消，方便之後查核）。
• 是否需要主管PIN二次確認可在「設定 → 安全與權限 → 取消訂單／作廢」開關，預設開啟；PIN驗證需要先在同一頁設定「主管授權密碼」，沒設定過的話無法通過驗證。

操作路徑

POS → 訂單 → 該筆訂單列最右側「退款」（回轉圖示按鈕，只在「已完成且已付款」的訂單才會出現）

步驟說明

1. 按下「退款」，若「設定 → 安全與權限 → 退款」開關開著（預設開啟），會跳出主管PIN輸入框驗證。
2. 驗證通過後，訂單的付款狀態變成「已退款」。

注意事項 / 常見問題

• （細節請洽主管或 ORBIT 客服確認）
• 權限層級：只有「店長」「管理員」角色能看到退款按鈕（權限）。
• 2026-07-25實機確認：訂單頁分頁為「全部／待處理／進行中／已完成／已取消」，列表有「付款」「狀態」欄位；「退款」按鈕只出現在已完成且已付款的訂單，demo租戶當下沒有此狀態的訂單，按鈕觸發後的PIN流程依程式碼查證。

操作路徑

POS → 櫃檯 → 付款方式區塊

步驟說明

1. 新韻目前是「零售」計費模式，畫面上會出現三個選項：信用卡、電子支付、現金（新韻沒有另外設定，所以用系統預設的這三種；若切到「企業」計費模式，選項會換成匯款、月結、支票）。
2. 點選對應方式後滑動結帳即可，畫面上的付款方式只是記錄在訂單裡的分類標籤。

注意事項 / 常見問題

• 櫃檯結帳畫面的付款方式選擇，沒有串接任何線上金流自動扣款（不管選信用卡、電子支付或現金，系統都只是把選到的文字存進訂單的付款方式欄位）——實際收款（刷卡機、掃碼支付、收現金）都在系統外完成，系統本身不會發起扣款。
• 畫面上的「電子支付」只是訂單分類標籤，不代表已串接某家第三方金流。

操作路徑

POS → 櫃檯 → 購物車下方「套用折扣（主管授權）」

步驟說明

1. 按「套用折扣（主管授權）」，輸入主管PIN（先在「設定 → 安全與權限」設定過主管授權密碼才能通過）。
2. 驗證通過後選折扣方式：九折／八五折／八折，或輸入固定折扣金額（NT$）。
3. 折扣套用在整張訂單（不是單一品項），會顯示在購物車總計區塊，可再按旁邊的 × 移除折扣重選。

注意事項 / 常見問題

• 單一品項要「招待」（整項免費）也是同樣要輸入主管PIN，跟折扣是兩個獨立功能：折扣是打整單折數/減固定金額，招待是把某一項的價格歸零。

操作路徑

POS → 櫃檯 → 購物車品項 → 往右滑開啟備註面板

步驟說明

1. 系統目前有的是「拆開品項份數，各自設定不同規格」：購物車裡某品項數量大於1時，往右滑該品項打開備註面板，會看到「拆開 N 份，各自設不同規格」按鈕，按下後這一項會拆成N筆各自獨立、可各自加不同備註/規格的品項——但這些拆開的品項仍然是同一張訂單、一起結帳，不是分成兩張單分開收款。
2. （細節請洽主管或 ORBIT 客服確認）

注意事項 / 常見問題

• 上面第1點的「拆份」功能主要是拿來讓同一項商品的不同數量各自加不同規格/備註（例如3杯飲料各要不同甜度），不是分帳工具，容易搞混。

操作路徑

POS → 訂單 → 該筆訂單列「開立發票」（收據圖示，只在「已完成且已付款」的訂單出現）→ 帶入「電子發票」頁

步驟說明

1. 不是在櫃檯結帳當下開票——訂單結帳完成後，到「訂單管理」頁找到該筆訂單，按「開立發票」連結；或直接到「電子發票」頁按「開立發票」手動開立（2026-07-25實機確認「電子發票」頁有「開立發票」按鈕與完整表單）。
2. 系統會自動帶入這張訂單的品項到「電子發票」頁的新增發票表單。
3. 手動輸入「買方統編」（欄位提示「消費者留 0000000000」）、「買方名稱（選填）」「買方 Email（選填，用於發送通知）」、發票類型（見46號）。
4. 「品項明細」確認無誤（畫面顯示「未稅金額 NT$ X（系統將自動加計 5% 稅）」）後按「確認開立」。

注意事項 / 常見問題

• （目前完全沒有被送出到後端：handleCheckout送給的資料只包含商品、付款方式、折扣、稅額、。細節請洽主管。）

操作路徑

POS → 電子發票

步驟說明

1. 找到該張狀態為「開立成功」的發票，按「作廢」。
2. 系統會跳出提示框要求輸入「作廢原因」，填寫後確認。
3. 作廢完成後該發票狀態變成「已作廢」。
4. 重開沒有自動化流程：作廢後系統不會幫你把資料帶到一張新發票，需要按「新增發票」重新填一次品項跟買方資訊（可以參考已作廢那張的內容手動重填）。

注意事項 / 常見問題

• 只有狀態是「開立成功」的發票可以作廢，其他狀態（待處理/已上傳待回應/錯誤/已作廢）不能再次作廢。
• 作廢需要輸入原因，且需要管理者以上角色才能操作。

操作路徑

POS → 電子發票 → 開立發票表單

步驟說明

1. 統一編號：「買方統編」欄位（畫面提示「消費者留 0000000000」），一般消費者不需要統編就保留預設，公司客戶要統編就直接輸入8碼數字。
2. 發票類型共四個選項（2026-07-25實機確認）：「紙本／一般載具」（預設）、「手機條碼」、「自然人憑證」、「捐贈發票」。
3. 手機條碼載具：發票類型選「手機條碼」，輸入格式為斜線開頭共8碼（例：/ABC123+）。
4. 自然人憑證載具：發票類型選「自然人憑證」，輸入格式為2碼英文字母加14碼數字。
5. 捐贈發票：發票類型選「捐贈發票」，輸入愛心碼（捐贈碼）。

注意事項 / 常見問題

• （目前不會被送出，只是畫面上看起來能填而已。細節請洽主管。）

操作路徑

列印本身：POS → 櫃檯結帳後自動觸發，不需要員工手動操作 排查狀態：設定 → 出單機橋接

步驟說明

列印怎麼運作：

1. 結帳建立訂單時，系統會自動把這筆訂單轉成一張列印工作排進佇列。
2. 店裡要有一台常駐執行「Print Agent」橋接程式的裝置（樹莓派/舊電腦都可以），這台裝置每4秒輪詢一次系統，抓到工作後轉成印表機看得懂的指令送給LAN上的熱感印表機列印。瀏覽器本身沒辦法直接連印表機，所以一定要有這個橋接裝置。

出單機沒反應排查：

1. 到「設定 → 出單機橋接」看裝置的連線狀態（「剛剛在線」/「X分鐘前連線」/「尚未連線」），確認裝置本身有沒有連上系統。
2. 若顯示「尚未連線」或已經很久沒更新，檢查跑Print Agent程式的那台裝置是不是還開著、程式是不是還在執行。
3. 檢查印表機跟跑Print Agent的裝置是否在同一個區網（用測試連線），印表機建議設定固定IP（不要用會跳動的DHCP）。
4. 中文列印亂碼：多數台灣出單機吃Big5編碼，先對照印表機說明書確認ESC-POS指令集是否跟程式內建的一致。

注意事項 / 常見問題

• HTTP 401錯誤：代表裝置憑證（AGENT_TOKEN）錯誤或已被後台撤銷，回「出單機橋接」重新產生一組新的憑證。
• 裝置憑證只會顯示一次，弄丟了要重新產生新的一組（舊的可以撤銷）。

操作路徑

跑Print Agent的那台裝置本機操作（不是在ORBIT網頁上）

步驟說明

1. 先確認裝置本身沒斷電、沒斷網。
2. 如果Print Agent是用終端機手動跑啟動列印服務，關掉終端機它就會停——需要重新開一個終端機視窗，切到資料夾再跑一次啟動列印服務。
3. 如果有設定「開機自動啟動、當掉自動重啟」（建議所有正式門市都要設定），依裝置類型：

- Linux（樹莓派）：用服務或pm2重啟該服務／程序。 - Windows：工作排程器裡找到對應的開機啟動工作，或用重啟。 - Mac：用或pm2重啟。

1. 重啟後回ORBIT「設定 → 出單機橋接」確認狀態變回「剛剛在線」，代表恢復正常。

注意事項 / 常見問題

• 建議正式上線的門市都要設定「開機自動啟動＋當掉自動重啟」，不要只靠手動啟動列印服務，否則裝置重開機或程式意外關閉後列印會整個停擺，要等有人發現才會手動重啟。
• 想確認程式運作正常但還不敢真的連印表機測試，可以先用（不會真的連印表機，只會把內容印在終端機畫面上）。

操作路徑

POS → 訂單（人工篩選比對），或 ERP → 報表（看當日總營收）

步驟說明

1. （目前沒有專門的「交班」或「班別現金對帳」功能。
2. 到「POS → 訂單」把分頁切到「已完成」，用「付款方式」「付款」欄手動篩選/加總「現金」付款的訂單金額，跟收銀機/錢箱實際點的現金比對（頁面沒有依付款方式自動加總的功能，需要人工目視加總或匯出後用Excel加總）。訂單頁頂端會顯示「N 筆訂單 · 今日已收款 NT$ X」，可以當作當日總收款的快速參考（2026-07-25實機確認），但這個數字不分付款方式。
3. 「ERP → 報表」可以看當日/近幾日的總營收，但同樣沒有依付款方式（現金/信用卡/電子支付）拆分的欄位，只有總金額。

注意事項 / 常見問題

• （細節請洽主管或 ORBIT 客服確認）

答案

訂單頁目前系統尚未提供此功能匯出。「訂單」頁面可以查詢、篩選、檢視訂單明細，但沒有匯出成 CSV／Excel 檔案的按鈕。

替代做法

• 需要營收彙總數字：用「報表」頁，支援日期區間與匯出（見 I 區第100號條目）。
• 需要單筆訂單的憑證：訂單可列印單據（見第47號條目）。
• 如果有整批訂單明細匯出的實際需求，請聯繫 hello@obarai.com 提出。

操作路徑

顧客管理 → 新增顧客

步驟

1. 進入「顧客管理」頁面，按右上角「新增顧客」。
2. 選「客戶類型」：「B2C（個人）」或「B2B（公司）」。
3. 填「姓名 」「手機 」（兩者必填），選填「生日」「Email」；若選B2B會多出「統一編號」欄位（8碼統編）。
4. 選填「備註」（過敏原、喜好、特殊需求等）。
5. 按對話框最下方的「新增顧客」送出。系統會用手機號碼查重，同一手機已建檔會擋下並在對話框內提示「此手機號碼已建檔」。

注意事項 / 常見問題

• 建立完整顧客資料可啟用：生日禮自動發放、會員等級升降、消費記錄追蹤、LINE 推播通知（畫面上的提示文字）。
• 「生日」欄位建議一律填寫：2026-07-25實機測試發現，生日留空直接送出時，伺服器會回錯誤（500），顧客不會被建立，而且畫面上沒有任何失敗提示、對話框只是停留原地，容易誤以為已建立成功。在系統修正前，請先填生日再送出。（此bug已另記錄於本區塊SKIPPED.md回報工程處理。）
• （細節請洽主管或 ORBIT 客服確認）

操作路徑

顧客管理 → （搜尋客戶）→ 滑到該筆資料列最右邊按「查看」

步驟

1. 在「顧客管理」列表用搜尋框（「搜尋姓名、Email 或電話…」）搜尋，或直接捲動找到客戶。
2. 滑鼠移到該客戶列，最右邊會出現「查看」連結，點進去（頁面上方會顯示「返回顧客管理」與「客戶檔案」）。
3. 客戶檔案頁預設顯示「消費記錄」頁籤：列出最近50筆訂單，含品項、日期、付款方式、金額、付款狀態（已付清／未繳費／已取消）；還沒有任何訂單時顯示「尚無消費記錄」。
4. 上方統計卡片會顯示「累計消費」「消費次數」「積分」「建檔日期」四格。

注意事項 / 常見問題

• 客戶檔案頁還有「備註」頁籤可以記錄客戶偏好（畫面提示「記錄客戶偏好、特殊需求或服務備註。」，按「儲存備註」存檔）；（細節請洽主管或 ORBIT 客服確認）

目前系統的實際行為

會員等級（Guest／Member／Gold／VIP）是畫面即時算出來的，不是系統欄位、也沒有任何人工調整的入口：

• （累計消費）≥ NT$50,000 → VIP
• ≥ NT$15,000 → Gold
• （到店次數）≥ 1 → Member
• 其餘 → Guest

等級會隨著客戶消費自動往上升，系統裡沒有任何地方能手動把客戶調成某個等級，也沒有「標籤」（tag）這種自由文字分類欄位——客戶紀錄裡最接近的是「備註」欄位（自由文字，見52號條目），可以拿來手動寫類似標籤的內容，但不是結構化的標籤系統，不能拿來篩選或批次操作。

操作路徑

顧客管理 → 列表「等級」欄位（唯讀顯示，VIP會多顯示星號圖示）

注意事項 / 常見問題

（目前沒有「標籤」功能（例如「常客」「批發客」這種可自訂多選標籤），只有一個自由文字備註欄位，若新韻有分眾行銷、批次篩選的需求，這。細節請洽主管。）

目前系統的實際行為

系統沒有「合併客戶」功能。新增客戶時，系統只會用「手機號碼」查重：同一租戶內手機號碼完全相同會被擋下，但如果兩筆資料手機打法不同（例如一筆有加國碼、一筆沒有）、或用不同手機/Email建立了同一個人的兩筆資料，系統不會自動抓出來，也沒有任何「合併」「歸戶」按鈕可以把兩筆資料的消費紀錄、積分整併成一筆。

目前可以做的權宜處理

1. 顧客管理 → 找出真正重複的兩筆資料，確認哪一筆要保留。
2. 把要保留的那一筆，透過編輯功能（細節請洽主管或 ORBIT 客服確認） 補齊正確的聯絡資訊。
3. 重複那一筆目前無法刪除（見58號條目說明客戶沒有刪除功能），也無法把它底下的訂單轉掛到保留的那一筆——訂單的目前沒有任何畫面可以重新指定。

注意事項 / 常見問題

（目前沒有任何補救工具（合併、轉單、刪除都沒有），一旦發生只能放著，或請工程師直接改系統。細節請洽主管。）

操作路徑

會員 → 匯入（頁面右上角，Import圖示）

步驟

1. 準備CSV或Excel檔案，第一列（表頭）要包含「姓名」與「手機」欄位——系統支援常見別名，例如「客戶全名」「客戶簡稱」「名稱」「公司名稱」對應姓名，「行動電話」「聯絡電話」對應手機。
2. 選填欄位可含：Email、生日、備註、統一編號（B2B用）、客戶種類。「客戶種類」欄位填有「法人」字樣算B2B，沒填這欄就看有沒有統一編號來猜B2B/B2C。
3. 按「匯入」選擇檔案。
4. 系統逐筆比對手機號碼，完成後跳出提示：新增幾位、幾位手機重複略過、幾筆缺必填欄位跳過。

注意事項 / 常見問題

• 缺少「姓名」或「手機」欄位（含別名）會直接擋下整批匯入，提示「檔案缺少『姓名』或『手機』欄位」。
• 匯入是逐筆呼叫API（不是批次寫入），資料量大時匯入時間會拉長，過程中請不要關閉頁面。
• 手機號碼重複的資料不會覆蓋既有客戶，會直接略過（不會更新原有資料的其他欄位）。

系統目前的實際保護機制

1. 跨租戶隔離：客戶紀錄用欄位＋系統RLS（Row Level Security）政策做隔離，A店的帳號在系統層級完全查不到B店的客戶資料，這是最基礎的保護，不是靠畫面畫面擋。
2. 角色門檻：查詢客戶資料（含電話、Email、生日）最低要「收銀員（cashier）」以上的帳號登入才能呼叫得到——「銷售員（waiter）」的帳號側欄沒有「顧客管理」入口，直接輸入網址開啟也只會看到「權限不足：目前角色「銷售員」無法使用此功能」。
3. 新增/編輯需要更高權限：新增或修改客戶資料要「店長（manager）」以上（見51號條目）。
4. 系統裡沒有「地址」欄位：目前客戶紀錄只有姓名、手機、Email、生日、備註、統一編號（B2B），沒有儲存客戶地址的欄位，所以這題如果被客戶問到「你們有沒有存我家地址」，可以明確回答系統目前不會存這項資料（除非未來新增外送/配送相關功能才會新增地址欄位）。

操作路徑

（無操作，本則為原則說明）

注意事項 / 常見問題

（細節請洽主管或 ORBIT 客服確認）

先講結論：新韻目前系統尚未提供此功能從系統發LINE通知給客戶

系統目前沒有「選一位客戶、發訊息給他」的畫面；唯一會真的送出的「廣播推播」（發給LINE官方帳號全部好友的「建案 LINE 推播」區塊）只有產業別設定為（建案客戶）的租戶才會顯示——2026-07-25用新韻demo管理者帳號實機確認，新韻（零售）的「整合應用」頁面上沒有這個推播區塊，只有「串接 LINE 官方帳號」的設定入口。

也就是說，對新韻而言，「發LINE通知給客戶」目前不支援，如有此需求請聯繫 hello@obarai.com 排入開發。

供參考：系統既有的LINE推播能力（新韻畫面上看不到）

產業別的租戶在「整合應用」頁面會多一個「建案 LINE 推播」輸入框，按「發送推播」會呼叫LINE Messaging API的broadcast端點，發送給這個LINE官方帳號的全部好友，適合新品/活動公告，無法只挑特定客戶發送。若之後系統更新對零售產業別開放此區塊，屬於工程調整。

系統另一種LINE通知：叫號/訂位提醒（自動觸發，非手動選客戶）

候位叫號、訂位確認/提醒等場景會自動觸發LINE推播，但這類通知需要客人先綁定LINE帳號才能真的推播到手機；目前客戶（表）資料完全沒有記錄LINE綁定身分的欄位，只有補教模組的「家長（guardians）」才有LINE綁定機制（透過「綁定驗證碼」加官方帳號回傳綁定）。也就是說，一般零售/餐飲客戶的自動叫號/訂位LINE通知，實際上永遠命中「客人尚未綁定LINE」這個分支，只會回傳文字內容提示店員「請以口頭或電話通知」，不會真的推播到客人手機。

注意事項 / 常見問題

（細節請洽主管或 ORBIT 客服確認）

目前系統的實際行為

目前唯一能做的：把可清空的欄位清空（不等於刪除）

1. 顧客管理 → 找到該客戶 → 進客戶檔案頁（滑到該列最右邊按「查看」）。
2. 「備註」頁籤可以把備註文字清空後按「儲存備註」。
3. 姓名、電話、Email、生日這幾個核心欄位目前客戶列表/檔案頁沒有直接編輯的入口可以清空（見54號條目也提到同樣的缺口），無法從畫面上把這些欄位改成空白或匿名化。
4. 消費紀錄、積分、到店次數等歷史資料，系統設計上是跟著訂單走的，訂單本身不會因為客戶資料異動而消失。

注意事項 / 常見問題

（細節請洽主管或 ORBIT 客服確認）

操作路徑

庫存 → 新增商品

步驟

1. 進入「庫存管理」頁面，按上方按鈕列的「新增品項」（同列還有「匯出」「條碼清單」「匯入」），開啟「新增商品」視窗。
2. 填「商品名稱 *」，選「品項類型」（一般商品／零件／半成品／成品／組合品，各類型差異見60、72號條目）。
3. 選「分類」（只能選畫面上已存在的分類，見文末說明）、填「商品編號 / SKU」（內部料號，留空自動產生）；商品本身有國際條碼的話另外填「國際條碼（471／EAN，可掃碼）」欄位（可手動輸入或按右側掃描鈕用鏡頭掃，見69號條目）。
4. 填「售價 NT$ *」「成本 NT$」「初始庫存」「補貨警示」（預設10）「單位」（預設「個」）。
5. 需要規格/尺寸或客製選項（例如大杯/小杯不同價格）可在下方「規格/尺寸」「客製選項」區塊新增，按「儲存」完成。

注意事項 / 常見問題

• 「分類」下拉選單只列出既有分類，「新增商品」這個畫面本身沒有「+新增分類」的輸入框可以直接建立新分類；要建立全新分類，目前只能透過商品匯入CSV（見71號的匯入邏輯，CSV裡填新分類名稱會自動建立）或請工程師直接呼叫API。
• 「成本」欄位只有店長／管理員看得到與能填，收銀員即使能看到這個畫面（實際上看不到，見上方角色說明），API也不會回傳成本數字（詳見68號條目）。
• 分類已由 2026-07-25 正式商品主檔匯入自動建立（2026-07-26 實測畫面上有「未分類」＋風水宗教商品/紀念品/蠟燭燭臺/收藏品/雕像雕塑/視聽線材轉換器/CD DVD與藍光光碟/燈具/精油/收納/電池/戒指/原石水晶共13個分類），新增商品時直接下拉選用即可，不要再手動打新的分類名稱以免不一致。

系統的實際設計：兩種不同的「多規格」機制

系統目前提供的「規格」功能是同一張商品卡片底下的多個價格選項（），不是各自獨立管理庫存的多個商品。以新韻的情境舉例：

• 如果「CD版」「USB版」「數位版」的庫存要分開算（例如CD有實體庫存、數位版不需要扣庫存）→ 建議建成三筆獨立商品（各自有自己的SKU、庫存、成本），這樣才能各自準確追蹤庫存量與售完狀態。
• 如果只是同一個品項的價格級距（例如「標準版」「典藏版」用同一庫存池，只是價格不同）→ 用「規格/尺寸」功能，在同一張商品卡片下新增多筆「名稱＋售價」。

操作路徑（規格/尺寸做法）

庫存 → 新增商品（或編輯既有商品）→「規格 / 尺寸（選填，不同價格）」區塊

步驟

1. 開啟新增或編輯商品畫面，捲到「規格 / 尺寸」區塊。
2. 按「+ 新增規格」，填規格名稱（例：CD版）與對應售價。（區塊標題「規格 / 尺寸（選填，不同價格）」與按鈕文字 2026-07-26 實機核對）
3. 可重複新增多筆規格。
4. 按「儲存」。

注意事項 / 常見問題

（細節請洽主管或 ORBIT 客服確認）

操作路徑

庫存 →（找到商品）→ 按「編輯」（鉛筆圖示）

步驟

1. 在「庫存管理」列表找到要改價的商品，按操作欄第一個圖示「編輯」，開啟「編輯商品」視窗。
2. 修改「售價 NT$ *」欄位（也可以順便改「成本 NT$」）。
3. 按「儲存」。

何時生效

立即生效，沒有「排程未來生效日」的功能。儲存的當下售價就改變，下一筆結帳（POS櫃檯選這個商品）就會套用新價格。系統沒有「這個價格從某天某時開始生效」的排程機制，也沒有「改價歷史紀錄」可以回頭查某個商品哪天改過價、改了多少。

注意事項 / 常見問題

（細節請洽主管或 ORBIT 客服確認）

「賣完」跟「下架」是兩種不同狀態，系統自動處理前者

情況一：庫存歸零（系統自動標示，不用手動操作）

庫存數量降到0時，「庫存」列表的「狀態」欄位會自動顯示紅色「缺貨」標籤，不需要任何手動動作。頁面上方也會出現橘色提示條「目前有X項商品庫存不足或缺貨，請盡快補貨」。

情況二：要完全不讓這個商品出現在POS/線上點餐（手動下架）

1. 庫存 →（找到商品）→ 操作欄按 ✕（停用）圖示。
2. 商品狀態變成「停用」，之後不會出現在結帳/點餐選單。
3. 要重新上架，同一個位置按 ✓（啟用）圖示即可恢復。

注意事項 / 常見問題

• 「缺貨」是根據庫存數量自動判斷（），不是一個要手動打勾的狀態；就算商品沒庫存了，只要沒手動按「停用」，它依然會出現在結帳選單，可能造成「明明沒貨還能被點」的情況——如果要完全防止賣超，建議缺貨時同時手動按「停用」。
• 商品列表還有「永久刪除」（垃圾桶圖示）跟「停用」是不同動作：刪除是真的從系統移除，過去訂單紀錄不受影響（訂單存的是品項名稱快照），但刪除後這個商品無法恢復，一般建議賣完想暫時下架用「停用」，不要用「刪除」。

採購鏈說明

這裡指的是「採購」頁面（庫存進貨的操作流程：草稿→已送出待廠商確認→運送中→已到貨），會真正影響庫存數量；跟「文件中心」底下的「採購單」文件（用來列印/簽名的正式紙本格式）是不同功能，那是另一套文件產生工具。

操作路徑

採購 → 新增採購單

步驟

1. 進入「採購管理」頁面，按「新增採購單」。
2. 選「供應商」（下拉「選擇供應商（選填）」，沒有先建供應商可以留空，見65號條目）。
3. 填「預計到貨日」「備註」（皆選填，可留空）。
4. 填「採購項目」：商品名稱、數量、單價，可按「+ 新增」加多筆。商品名稱請照「庫存管理」裡的名稱完整照抄——名稱完全一致，系統才會把這筆品項跟庫存商品連結起來，到貨時才會自動入庫（見64號）。
5. 按「建立採購單」，系統自動產生單號（格式，例：PO-20260726-001），狀態為「待出貨」。

狀態如何往下走

待出貨 → 按「標記運送中」變「運送中」→ 按「確認到貨」變「已到貨」（這一步會真正入庫加庫存，詳見64號條目）。

（以上整條流程 2026-07-26 用測試商品在正式站實際走過一輪並確認入庫，測試資料已清除。）

注意事項 / 常見問題

（目前沒有設定這個門檻（沿用店長可全權處理），是否需要啟用金額審核門檻、門檻訂多少，請ORBIT 團隊確認。細節請洽主管。）

操作路徑

採購 →（找到狀態為「運送中」的採購單）→「確認到貨」

步驟

1. 進入「採購管理」頁面，找到狀態是「運送中」的採購單。
2. 按「確認到貨」。
3. 系統會把這張採購單有連結到庫存商品的品項數量加進庫存（寫入庫存異動紀錄，備註「採購到貨」），狀態變成「已到貨」，同時記錄到貨日期。（2026-07-26 實測：測試商品經此流程庫存正確 +1。）

這一步就是本系統「進貨驗收」在庫存面的實際作用點——按下「確認到貨」的當下，商品庫存數字就會增加，不是另外有一個獨立的「驗收」畫面要再操作一次。

⚠️ 品項要「連結到庫存商品」才會入庫

建採購單時打的「商品名稱」如果跟「庫存管理」裡的商品名稱完全一致，系統會自動連結（2026-07-26 起，同日修復前完全不會連結）；名稱對不上的品項，「確認到貨」時會被跳過、不入庫，需要事後用「庫存調整」（＋進貨）手動補。所以建單時商品名稱務必照庫存裡的名稱複製貼上。

跟「文件中心 → 進貨驗收單」的關係

文件中心底下另外有一個「進貨驗收單」文件功能，是用來產生正式簽收單據（可列印、可讓供應商簽名確認）的文件，跟這裡「採購」頁面按「確認到貨」的庫存異動是兩個獨立系統——按文件中心的驗收單不會自動幫你在「採購」頁面把庫存加進去，兩邊需要的話要分別操作。

注意事項 / 常見問題

（細節請洽主管或 ORBIT 客服確認）

目前系統的實際行為

「採購」頁面左側會列出供應商清單（名稱、分類、聯絡人），但這是唯讀顯示，系統目前沒有「新增供應商」或「編輯供應商」的操作畫面——找遍「採購」頁面跟其他相關頁面，都沒有填寫供應商電話/Email/地址/備註後儲存的表單，後端也只有查詢（GET）跟新增（POST）兩支API，沒有修改（PATCH）供應商資料的API，代表就算工程師想手動用API改，目前也沒有現成的更新端點。

供應商資料目前唯一的建立方式

1. 採購 → 新增採購單。
2. 開啟採購單品項匯入CSV（或商品匯入時填的「供應商」欄位）時，系統會用供應商名稱自動比對：名稱不存在就自動建立一筆新供應商，但這種自動建立只會填「名稱」，聯絡人/電話/Email/地址都是空的。

操作路徑

採購 →（「供應商」清單區塊，僅供查看，無編輯功能）

注意事項 / 常見問題

（細節請洽主管或 ORBIT 客服確認）

⚠️ 重要：目前系統無法「先查異動紀錄」，只能直接盤點調整

原本這題的直覺處理順序是「先查是誰在什麼時候動了庫存 → 再決定怎麼調整」，但查證後發現：系統只有寫入庫存異動的功能，完全沒有可以回頭查詢「這批庫存什麼時候被什麼單據異動過」的畫面（G區塊78號條目已記錄同樣的缺口：紀錄確實完整記錄每一筆進貨/銷售/工單/退貨/盤點異動，但整個系統找不到任何頁面或API可以「讀」這張表，只有寫入路徑）。也就是說，目前做不到「先查異動紀錄，抓出是哪一筆單據造成落差，再決定怎麼處理」這個理想流程，只能跳過查證直接盤點修正。

操作路徑（目前唯一可行的作法：直接盤點調整）

庫存 →（找到數量不對的商品）→ 庫存調整（箱子圖示）

步驟

1. 庫存 → 找到數量不對的商品，按操作欄的「庫存調整」（箱子圖示）。
2. 選調整類型：「＋進貨」「－出貨」「＝盤點調整」（盤點調整是直接設定成盤點後的實際數字，不用自己算差額）。」＋「確認調整」按鈕。）
3. 數量不對且不確定原因時，建議選「盤點調整」，直接輸入實際清點到的數量。
4. 備註欄寫清楚原因（例：「7/24盤點差異，原因不明」），方便之後對帳。
5. 按「確認調整」。

注意事項 / 常見問題

（細節請洽主管或 ORBIT 客服確認）

操作路徑

庫存 → 新增商品 或 編輯既有商品 →「補貨警示」欄位

步驟

1. 開啟商品的新增或編輯畫面。
2. 找到「補貨警示」欄位（數字，預設10）。
3. 填入這個商品庫存低於多少數量時要提醒補貨。
4. 儲存。

警示會出現在哪裡

• 「庫存管理」列表「狀態」欄位：庫存量低於補貨警示值會顯示「庫存低」標籤，正常的顯示「正常」（庫存為0則是「缺貨」，列表上方另有「缺貨(N)」快速分頁）。
• 頁面上方會出現提示條：「目前有 X 項商品庫存不足或缺貨，請盡快補貨。」（2026-07-26 實測新韻正式資料顯示「目前有 189 項商品庫存不足或缺貨」）。

注意事項 / 常見問題

• 補貨警示是每個商品各自設定的，系統沒有「全店統一預設值」的整體設定畫面，新增商品時如果沒填會用預設值10。
• 目前這個警示只有畫面上的顏色標籤跟提示條，沒有自動發Email/LINE通知或推播提醒——要注意到低庫存，仍然要有人進「庫存」頁面才看得到。（細節請洽主管或 ORBIT 客服確認）

系統的實際保護機制

成本（）欄位在後端API層級就做了角色過濾，不是只靠畫面畫面藏起來：

• 商品列表（）與商品詳情（）在回傳資料前，會先判斷登入者有沒有權限。
• 有（店長manager／管理員admin）→ 回傳資料含欄位，庫存列表看得到「成本」欄位跟毛利相關數字。
• 沒有（點餐員waiter／收銀員cashier）→ 回傳的商品資料完全不含欄位，就算收銀員從瀏覽器開發工具直接看結帳頁的網路請求，也拿不到成本數字。

這個限制原本是特別修過的，代表這是刻意設計的保護，不是漏洞。

操作路徑

庫存 → 列表「成本」欄位（僅店長／管理員看得到）

注意事項 / 常見問題

• 收銀員（cashier）本來就打不開「庫存」頁面（不在選單/允許路徑內），這條規則主要保護的情境是「收銀員在結帳頁面時，商品清單的API回應裡不能夾帶成本資訊」。

建立條碼：「商品編號 / SKU」與「國際條碼」是兩個獨立欄位（2026-07-25 起）

2026-07-25 更新後（新韻 P0-5），商品有兩個相關欄位，不要搞混：

• 「商品編號 / SKU」：內部料號（提示文字「內部料號，留空自動產生」），留空系統自動產生。
• 「國際條碼（471／EAN，可掃碼）」：商品外包裝上印的國際條碼（提示文字「例：471 開頭 13 碼，或按右側掃描」），可手動輸入或按欄位右側的掃描鈕用手機鏡頭掃入。新韻的 728 筆正式商品已於 2026-07-25 從商品主檔 Google Sheet 匯入條碼值。

操作路徑

庫存 → 新增品項 或 編輯既有商品 →「國際條碼（471／EAN，可掃碼）」欄位

步驟

1. 開啟商品新增/編輯畫面，找到「國際條碼（471／EAN，可掃碼）」欄位。
2. 兩種填法：①手動輸入條碼數字；②商品本身已有現成條碼（例如包裝上印的），按右側掃描鈕用手機鏡頭掃描帶入。
3. 儲存商品。之後「庫存管理」列表該商品名稱下方會顯示「條碼 471…」。

列印：系統沒有內建標籤列印，但有「條碼清單」匯出

系統本身沒有「產生可列印的條碼圖案/標籤」的功能（沒有條碼產生器、標籤機列印畫面）；不過「庫存管理」列表上方有「條碼清單」按鈕，可以把全部商品的條碼清單匯出，交給外部標籤軟體（或 Excel＋條碼字型）批次產生標籤。結帳時的掃碼讀取功能正常（用手機鏡頭掃條碼比對商品）。

注意事項 / 常見問題

（細節請洽主管或 ORBIT 客服確認）

⚠️ 目前商品新增/編輯畫面沒有照片或描述欄位可以填

查證系統結構跟API發現：紀錄確實有（商品照片網址）欄位，API也願意接受這個欄位存進去，但「新增商品」「編輯商品」畫面上完全沒有對應的輸入框或上傳按鈕，一般操作流程中沒有任何方式可以幫商品設定照片。

另外，紀錄根本沒有「描述」（description）欄位——連系統層級都不存在，不是「有欄位沒畫面」，是這個欄位完全沒被設計進商品資料結構裡。目前商品卡片上能寫文字說明的地方，最接近的只有「規格/尺寸」「客製選項」這類結構化欄位，沒有一段自由文字的商品簡介/描述可以填。

操作路徑

注意事項 / 常見問題

（細節請洽主管或 ORBIT 客服確認）

操作路徑

庫存 → 匯出（頁面右上角，Export圖示）

步驟

1. 進入「庫存」頁面（可先用搜尋/分類篩選出想匯出的範圍，匯出內容會依目前畫面上顯示的商品清單）。
2. 按右上角「匯出」。
3. 系統產生CSV檔案下載，欄位包含：商品名稱、SKU、分類、售價、成本、庫存、補貨警示、單位、狀態（啟用/停用）。

注意事項 / 常見問題

• 匯出的CSV含成本欄位——因為「庫存」頁面本身就限店長以上才能打開，能匯出的人本來就有權限看成本，這點跟68號條目「成本欄位誰看得到」的保護邏輯是一致的。
• 匯出檔案用UTF-8 with BOM編碼，直接用Excel開啟中文欄位不會亂碼。

先分清楚：這題問的是「組合品」，不是H區塊的「生產型BOM」

商品編輯畫面裡有兩種長得很像的BOM設定區塊，容易搞混：

| 類型 | 品項類型 | 用途 | 是否受H區塊的BOM bug影響 | |---|---|---|---| | 組合內容（sales_bundle） | 「組合品」 | 銷售時自動展開，扣子項庫存 | 不受影響，本則說明對象 | | 生產用料表（manufacturing） | 「半成品」「成品」 | 生產工單領料扣原料庫存 | 會失敗，見H區塊81號條目 |

兩者存在同一張紀錄，只是不同，儲存邏輯對兩者的檢查條件不一樣：「組合品」只要求品項類型是即可儲存成功，不會卡到H區塊81號記錄的「欄位沒有勾選入口」那個bug——換句話說，組合品的組合內容設定功能是正常可用的。

組合品本身不建庫存，「還能賣幾組」是即時算出來的

品項類型選「組合品」的商品，系統會自動把設成，代表這個品項自己不佔庫存欄位，賣多少組完全取決於組合內容裡每一項子商品目前的庫存量：

• 結帳選到組合品時，系統會逐一檢查每個子項目「目前庫存 ÷ 組合所需數量」，取全部子項裡最小的那個當作可賣上限。
• 只要有任何一個子項不夠扣，整張訂單會被擋下（不會賣一半），並提示是哪個子項不足、需要多少、現有多少。
• 結帳成功的當下才會真正扣子項庫存（裡設定的各子項數量 × 銷售組數）。

操作路徑（設定組合內容）

庫存 → 新增品項（品項類型選「組合品」，先存檔）→ 重新編輯該商品 →「組合內容（銷售時自動展開，平時不建庫存）」區塊 →「+ 新增子品項」選子品項與數量 →「儲存組合內容」

注意事項 / 常見問題

（細節請洽主管或 ORBIT 客服確認）

操作路徑

倉儲 → 倉儲總覽

畫面看得到什麼

「倉儲總覽」頁面用卡片列出每個倉別：

• 每個倉別一張卡片，顯示「商品數」「總庫存」兩個數字；預設倉卡片會標「預設」
• 若該倉有商品低於補貨警示門檻，卡片下方會出現「N 項庫存偏低」提示
• 頁面最上方若跨倉合計有低庫存商品，會出現提示框「N 項庫存低於警示門檻（跨倉彙總）」，列出前 8 項「商品名稱（倉別 數量單位）」
• 頁面上方另有「倉別管理」「開始盤點」快捷連結

」提示框、品項格式「…（主倉 3個）」皆與上述一致。）

注意事項

（細節請洽主管或 ORBIT 客服確認）

操作路徑

倉儲 → 盤點作業，或從「倉儲總覽」頁按右上角「開始盤點」按鈕直接進入。

步驟一：開始盤點

1. 頁面右上角先用下拉選單「選擇倉別」，指定要盤點哪一個倉。
2. 點「開始盤點」按鈕，系統建立這個倉的盤點作業，並把畫面切換成該倉全部商品的清單，每項顯示「系統庫存」欄位。
3. 開始盤點後，這個倉會被系統凍結：在盤點作業「進行中」期間，這個倉的任何其他庫存異動（出貨、調撥、工單領料/完工等）都會被系統擋下（會出現「該倉正在盤點中，暫停此倉庫存異動」的錯誤），直到盤點結束。凍結只影響「這個被盤點的倉」，其他倉正常運作。

步驟二：盤點輸入

1. 盤點清單裡，每一列商品右側是「實際盤點」欄位（數字輸入框），一開始是空白。
2. 逐項輸入實際點到的數量，欄位失去焦點（滑鼠移開/切下一格）時會自動儲存這一項，不用另外按儲存鍵。
3. 頁面標題下方會顯示「進行中：已點 X / Y 項」，方便掌握進度。可以分批多次進來繼續輸入，盤點作業會保留「進行中」狀態直到手動結束。

步驟三：完成盤點

1. 全部（或想結束時）點右上角「結束盤點」按鈕。
2. 系統會先跳出確認視窗：「結束盤點後，差異將自動寫入庫存調整，確定結束嗎？」，按確認才會真正送出。
3. 送出後，系統把「實際盤點數量」跟「系統庫存」有差異的品項，自動寫入一筆庫存調整（差異多少就調整多少，沒填「實際盤點」的品項視為沒盤到、不動它的庫存）。
4. 畫面顯示「盤點完成，差異報表」，用表格列出每個有差異的商品：商品 / 系統庫存 / 實際盤點 / 差異（正數綠字，負數紅字）。沒有任何差異的話會顯示「本次盤點無任何差異」。
5. 盤點解除凍結，該倉恢復正常出貨/調撥/領料等操作。

注意事項

• 盤點是「整倉」的，沒有選擇部分商品盤點的功能——選了倉別開始盤點，該倉全部商品都會列進盤點清單。
• 沒填「實際盤點」的商品，系統不會把它當成「盤點為0」，只是單純不列入本次差異調整，系統庫存維持原樣。

驗證方式說明

結論

不行，只限「正在被盤點的那個倉」。 系統在系統層做了強制擋修：只要某個倉的盤點作業狀態是「進行中」，任何要異動那個倉庫存的動作（出貨、調撥出貨/入庫、生產工單領料/完工/取消沖銷、退貨回庫等）都會被擋下失敗，直到這次盤點結束（或作廢）為止。

細節

• 凍結只鎖「正在盤點的那個倉」，不影響其他倉——例如同時有「本店倉」「二店倉」，只盤點本店倉時，二店倉照常出貨不受影響。
• 盤點本身寫入的庫存調整（結束盤點時系統自動產生的差異調整）不受這條規則限制，這是唯一的例外，不然盤點會卡死自己沒辦法收尾。

注意事項

（細節請洽主管或 ORBIT 客服確認）

結論

沒有另外的核准機制，差異是按「結束盤點」當下自動處理的。 系統沒有「先產生差異報表→送給更高權限的人核准→核准後才真正調整庫存」這種兩段式流程。

實際運作方式

1. 點「結束盤點」按確認後，系統立刻把「實際盤點」跟「系統庫存」不同的品項，各自寫入一筆庫存調整（差多少調多少）。
2. 調整完成後才顯示「差異報表」表格（商品／系統庫存／實際盤點／差異），這張報表是調整已經生效之後的紀錄畫面，不是等待核准的畫面。
3. 因為進入「倉儲」功能本身就限定店長（manager）以上權限，實務上「執行盤點的人」跟「有權調整庫存的人」是同一個角色層級，系統用「誰能進這個功能」把關，沒有再疊加一層簽核。

注意事項

（細節請洽主管或 ORBIT 客服確認）

操作路徑

倉儲 → 倉別管理→「新增倉別」按鈕

步驟

1. 填「倉別名稱 *」（必填，例：忠孝店倉）。
2. 「代碼（選填）」（例：WH-01）。
3. 「類型」下拉選單四選一：主倉／分店倉／外部倉／業務車（業務車是 2026-07-25 新增的類型，給業務隨車庫存用；生產工單的倉別選單會自動排除業務車）。
4. 「地址（選填）」。
5. 按「儲存」完成新增。

、中國倉（外部倉）、A車 吳登雄／B車 李明寬（業務車）共 4 個倉別。）

倉別管理頁還能做什麼

• 星星圖示：把某個倉別設為「預設倉」（結帳、線上點餐、一般商品出貨在沒有特別指定倉別時，都是走這個預設倉）。
• 鉛筆圖示：編輯倉別資料。
• 停用/啟用切換：停用後這個倉不會出現在盤點、工單、退貨等選單的可選清單。
• 垃圾桶圖示（刪除）：有兩個限制——不能刪除「預設倉」（要先把預設倉指定給別的倉別）；倉內還有庫存（任何商品數量大於0）也不能刪除，系統會擋下並顯示「此倉別尚有庫存，無法刪除」。
• 新客戶開通時，系統會自動建立第一個倉別並設為預設倉，之後新增的倉別才需要手動指定類型。

注意事項

（細節請洽主管或 ORBIT 客服確認）

⚠️ 重大發現：目前這個功能存完會失敗，見文末說明

先講清楚題目範圍：這裡指的是「生產用料表」（生產型BOM，manufacturing）——生產工單領料時依此扣減原料/零件庫存，跟另一種「組合內容」（銷售組合，sales_bundle，結帳時自動展開扣子項庫存，F區塊67號已涵蓋）是同一張紀錄、不同類型，畫面上是兩個分開的區塊，不要混在一起。

操作路徑（設計上的流程）

庫存 → 找到「品項類型」設為「成品」或「半成品」的商品 → 編輯該商品 → 往下捲動到「生產用料表」區塊

步驟

1. 商品要先存成「成品」或「半成品」類型（品項類型下拉選單，新增商品時可選，需先存檔取得商品id）。
2. 重新打開編輯這個商品，表單下方會出現「生產用料表（生產工單領料時依此扣減原料／零件庫存）」區塊。
3. 按「+ 新增原料／零件」，用下拉選單選一個既有的「零件」「半成品」或「成品」類型商品當作用料，填數量。
4. 可以新增多列原料/零件。
5. 按「儲存生產用料表」送出。

⚠️ 目前這一步會失敗

也就是說：不管照上面步驟操作幾次，只要品項類型選「成品」或「半成品」，按「儲存生產用料表」目前必然會出現錯誤訊息，無法成功存檔。這不是操作方式的問題，是系統裡少了一個開關。

（細節請洽主管或 ORBIT 客服確認）(SKIPPED.md) 的完整說明。]

操作路徑

生產工單→「新增工單」按鈕

步驟

1. 「要生產的成品」下拉選單：選一個已經設定好生產型BOM的成品/半成品（選單文字顯示「品項名稱（v版本號）」）。
2. 「領料/入庫倉別」下拉選單：選一個倉別——這個倉同時是領料的來源倉，也是完工後成品入庫的目的倉，不能分開指定兩個不同的倉。
3. 「計畫產量」：填要生產的數量（可以是小數，例如0.5，支援公斤/公尺這類非整數單位）。
4. 「備註」選填。
5. 按「建立工單」，工單狀態會是「草稿」。

注意事項

• 工單編號系統自動產生，格式「WO-年月日-流水號」。
• 工單建立當下，系統會把當時的BOM用料表「凍結」成這張工單專屬的用料快照（工單列表可以展開「查看建單時用料快照」），之後就算原始BOM被改版，這張工單的用料內容不會被影響。

操作路徑

生產工單列表，找到狀態為「草稿」的工單

步驟

1. 該筆工單右側按「領料」按鈕（只有「草稿」狀態的工單才會出現這個按鈕）。
2. 系統立刻依這張工單的用料快照，把每一項原料/零件的「需用數量」從指定倉一次全部扣除（沒有分批領料，一次領完整張工單的量）。
3. 領完後工單狀態變成「已領料」，同時該倉這些原料/零件的庫存會即時減少。
4. 如果倉裡任一原料/零件庫存不夠扣（扣完會變負數），系統會擋下整個領料動作並顯示不足的品項與數量，不會出現扣一半的情況。

注意事項

• 沒有「部分領料」的設計——按下「領料」就是整張工單的用料一次扣完。
• 領料後想看每項料實際領了多少，可以在工單列表展開「查看建單時用料快照」，裡面會顯示「已領」欄位。

操作路徑

生產工單列表，找到狀態為「已領料」的工單 →「完工入庫」按鈕

步驟

1. 該筆工單右側按「完工入庫」（只有「已領料」狀態的工單才會出現這個按鈕），跳出「完工入庫」視窗。
2. 填「實際完工數量」，視窗會顯示「計畫 X」提醒原本計畫要生產多少。
3. 填「損耗數量」（選填，預設0）——這個欄位純粹供記錄用，領料已經是按計畫產量扣過庫存，損耗不會另外再扣一次料。
4. 系統會檢查「實際完工數量＋損耗數量」必須剛好等於「計畫產量」，兩者加起來對不上會被擋下（跳出提醒「實際完工數量＋損耗數量必須等於計畫產量」），不能送出。
5. 按「確認完工入庫」——成品在這一刻立即入庫（不是回報完工後還要另外一個入庫動作），入庫數量＝實際完工數量，入庫倉就是當初開工單時指定的「領料/入庫倉別」。
6. 工單狀態變成「已完工」。

注意事項

• 完工數量填的不是「額外增加的量」，是這批工單「實際做出多少良品」的數字，跟損耗數量合計要等於當初的計畫產量，等於是要求你把整批料的去向交代清楚（做成品+報損＝領的料）。
• 完工這個動作無法回復——工單一旦「已完工」，不能再取消（見85號）。

操作路徑

生產工單列表，找到狀態為「草稿」或「已領料」的工單 →「取消」按鈕

步驟與行為

1. 「草稿」「已領料」狀態的工單才有「取消」按鈕；「已完工」的工單不能取消（按鈕不會出現）。
2. 按「取消」會跳出確認視窗：「確定要取消這張工單嗎？已領料的零件/半成品會自動沖銷回庫。」
3. 確認後：

- 如果工單還是「草稿」狀態（還沒領過料）：直接標記「已取消」，沒有任何庫存動作（本來就還沒扣過料）。 - 如果工單已經是「已領料」狀態：系統會把之前領走的原料/零件全額自動沖銷回原本的倉（依用料快照的「已領」數量原封加回去），再把工單標記「已取消」。

注意事項

• 沖銷是全額的，不能只取消/退回部分原料——要嘛整張工單的料都退回去，要嘛不取消。
• 已完工的工單無法取消，如果生產完後發現真的做錯/要作廢，目前工單本身沒有「完工後撤銷」的功能，需要另外用庫存調整或退貨機制手動處理成品庫存（實際處理方式建議先洽主管確認有沒有更適合的走法，避免直接動）。

操作路徑

生產工單的工單列表本身，就是唯一的追蹤畫面。

看得到什麼

• 每張工單顯示：工單號、狀態標籤（草稿／已領料／已完工／已取消，各自不同顏色）、要生產的成品名稱、計畫產量。
• 已完工的工單會多顯示「實際完工 X（損耗 Y）」。
• 有指定倉別的話會顯示倉別名稱。
• 展開「查看建單時用料快照」可以看到每項原料/零件的需用量，已領料/完工後的工單還會顯示「已領」數量。

注意事項

（細節請洽主管或 ORBIT 客服確認）(081-manufacturing-bom-setup.md)），目前列表大概率是空的。]

提醒：這裡指的是「退貨」選單——真正會產生庫存異動的退貨處理。單據中心（DOCS）裡也有一個「退貨單」文件類型，那個是純粹的紙本/PDF單據記錄，不會影響庫存，跟這裡是兩個不同的東西，不要搞混（130號條目屬於M區塊，會另外處理）。

操作路徑

退貨→「新增退貨單」按鈕

步驟一：建立退貨單（狀態：草稿）

1. 搜尋/選擇要退貨的原訂單（用訂單編號搜尋）。
2. 選定訂單後，系統自動列出這張訂單「還可以退」的品項（已經退過的部分不會重複出現）：

- 一般商品：直接列出品項與剩餘可退數量。 - 組合品：系統會自動拆解成出貨當下快照裡的各個子品項分別列出（不是整組退，是退到組成的原料/零件層級），畫面上顯示「組合品名稱 → 子品項名稱」。

1. 每一項要設定：

- 退貨數量（不能超過剩餘可退數量） - 狀態：良品回庫／待驗／不良品／報廢／不回庫（五選一，下拉選單） - 回庫倉別：系統依「狀態」自動篩選相容的倉別可選——選「良品回庫」只能選「計入可售庫存」的倉；選待驗/不良品/報廢只能選「不計入可售」的倉；選「不回庫」則不用選倉（這批貨不會產生任何庫存增加，等於直接報銷掉，不進任何倉） - 原因：狀態選「報廢」或「不回庫」時必填寫原因，其他狀態選填

1. 按「建立退貨單」，退貨單狀態為「草稿」，這一步還沒有真的動庫存。

步驟二：確認回庫

1. 退貨單列表裡，「草稿」狀態的單子右側有「確認回庫」按鈕。
2. 按下前會跳確認視窗：「確認回庫嗎？良品會依指定倉別增加庫存，此動作無法重複執行。」
3. 確認後，系統依每一項設定的「狀態」寫入對應倉別的庫存增加——選「良品回庫」的品項會真的增加可售庫存（結帳看得到、賣得掉）；選待驗/不良品/報廢/的品項只會增加「該倉的實際數量」，不會增加「可售庫存」（見89號說明）；選「不回庫」的品項完全不產生庫存異動。
4. 退貨單狀態變成「已回庫」。

其他操作

• 「草稿」狀態的退貨單也可以按「作廢」，取消這張退貨單（不會產生任何庫存異動）。

注意事項

• 退貨數量有上限檢查：不能退超過「這張訂單當初實際出貨的數量」，防止重複退貨灌水庫存。
• 如果一開始還沒有設定「不計入可售」的倉別（例如待驗倉/不良品倉），選非良品狀態時畫面會提示「請先在倉別管理建立『不計入可售』的待驗／不良／報廢倉」——這是79號倉別管理要先做的前置設定。

⚠️ 重要：目前這三件事是各自獨立的動作，系統不會自動連動

各自怎麼操作

1. 退貨單回庫（87號流程）：只處理商品重新入庫，這個後端動作裡完全沒有觸碰付款狀態或發票的程式碼。
2. 訂單標記退款：在「訂單」頁，符合「已完成＋已付款」的訂單，若操作者有退款權限，會出現「退款」按鈕。按下去（可能需要先過管理者PIN授權，視系統設定而定）之後，系統做的事情只是把這張訂單的付款狀態欄位改成「已退款」——不會透過任何金流自動退款，也沒有真的把錢退出去。
3. 發票作廢：是「電子發票」模組的獨立功能，一樣要另外手動操作。

白話說明實際SOP

以現況來說，一筆訂單退貨要處理乾淨，店員/管理者要分開手動做完三件事：①在退貨頁建退貨單並確認回庫（把貨收回來、庫存加回去）②實際退錢給客人（現金退還，或去金流商後台手動操作退款，系統本身不會幫你動這筆錢）③回訂單頁把付款狀態標記「已退款」（純粹是系統上的記帳，方便之後對帳看得出這筆訂單退過款）④如果有開發票，另外去發票模組作廢/折讓。四件事順序上沒有系統強制的先後，也沒有任何一件事會自動觸發另一件。

注意事項

（細節請洽主管或 ORBIT 客服確認）

結論

不是靠「標記」單一商品，是靠「回庫到哪個倉」來決定可不可以再售。 系統沒有針對某一批瑕疵品貼「不可售」標籤這種機制，而是每個「倉別」本身有一個「是否計入可售庫存」的屬性（79號倉別管理設定），退貨時把瑕疵品指定回一個「不計入可售」的倉，這批貨自然就不會出現在可賣的庫存數字裡。

實際運作方式

1. 建退貨單時（87號流程），退貨品項的「狀態」選「不良品」（或「待驗」「報廢」）。
2. 系統只讓你選「不計入可售」的倉別（畫面上倉別選單會標「（不計入可售）」）——不會讓你把不良品選進良品倉，兩者不相容會被擋。
3. 確認回庫後，這批數量會真實記錄在該倉的庫存（表，每倉各自的實際數量查得到），但不會加進商品的「可售庫存」總數（）——這個總數是結帳、線上點餐、組合品庫存檢查在用的數字，不良品倉的異動不會更新它。
4. 效果上：這批瑕疵品實際還在，倉別管理看得到它在哪個倉、有多少，但員工結帳時系統不會把它算進可以賣的庫存，等於自動達成「不可再售」的效果，不需要另外對單一批次手動貼標籤。

注意事項

• 前提是要先在「倉別管理」建立至少一個「不計入可售」的倉（例如「不良品倉」「待驗倉」），否則87號流程會直接被擋，見79號說明。
• 如果之後不良品驗完發現其實可以賣（例如只是外包裝有瑕疵、內容物沒問題），目前系統沒有「把不良品倉的貨轉成良品」的一鍵功能，需要走74號（庫存移轉）或手動調整——但74號本身目前也是缺畫面狀態（見G區塊SKIPPED.md），這點如果是常見情境，需要洽主管確認实務上怎麼處理比較好。

先釐清兩件事

1. 商品出貨（真的扣庫存那一刻）：在客戶結帳、訂單成立當下就已經自動完成了——建立訂單的同一個系統動作，會直接把商品/組合品子項的庫存扣掉（寫入，來源標記「商品出貨」或「銷售組合出貨」），不需要另外走一個「出貨」步驟才會扣庫存。也就是說對新韻這種零售情境，結帳＝出貨，中間沒有「訂單成立但還沒出貨、庫存還沒扣」這種中間狀態。
2. 「出貨單」文件：是單據中心（DOCS）裡的一種文件類型，純粹是列印/PDF用的紙本單據，跟上面第1點的實際扣庫存動作完全沒有關聯——不開這張單，庫存還是照樣在結帳時扣了；開了這張單，也不會再扣一次庫存。可以想成是「出貨時附給客人/司機的紙本憑證產生器」。

操作路徑（出貨單文件）

單據中心 → 出貨單→「新增」

關於「外送」

sidebar另外有一個「外送」選單，但這個功能只開放給「cafe」（餐飲）產業別使用，新韻是零售業態，看不到這個選單。零售/一般商品的配送目前沒有像餐飲外送那種「外送員接單/配送狀態追蹤」的機制。

注意事項

（細節請洽主管或 ORBIT 客服確認）

操作路徑

財務 → 總覽（側邊欄「財務」，頁內上方有「總覽／稅務／SaaS／金流」四個分頁）

畫面內容說明

• 四張 KPI 卡：

- 本月營收（含稅） - 本月毛利（同時顯示毛利率 %） - 預估應納稅（顯示「銷項 － 進項」的組成） - 本月淨利（稅後）

• 「本月營收來源」：依 ／線上／／其他 四類分別顯示金額與佔比長條
• 「本月營收成本分佈」：依薪資／租金／廣告／SaaS／金流手續費／AI／雜費七類，依金額由高到低排序
• 下方「損益快覽」可切換「本月／本季／本年度」查看趨勢圖（見 92）
• 「ORBIT AI 財務顧問」：可直接用白話問財務問題，但需升級為正式授權方案才會開通，未開通時只顯示「請聯繫 hello@obarai.com 洽詢」

注意事項 / 常見問題

（細節請洽主管或 ORBIT 客服確認）

操作路徑

財務 → 總覽 → 損益快覽區塊，右上角可切換「本月／本季／本年度」三個分頁。

• 本季 = 從當季第一個月到目前月份逐月列出
• 本年度 = 從今年 1 月到目前月份逐月列出

數字怎麼算出來的

系統用以下公式逐月計算（含稅營業稅率固定 5%）：

1. 銷項稅額 = 當月營收 × 5/105
2. 進項稅額 = 當月「可抵扣成本」（ 的成本項目）合計 × 5/105
3. 預估應納稅額 = 銷項稅額 － 進項稅額（最低為 0，不會出現負數）
4. 毛利 = （營收 － 銷項稅額）－ 總成本
5. 淨利 = 毛利 － 預估應納稅額
6. 毛利率 = 毛利 ÷（營收 － 銷項稅額）× 100%

簡單說：先把含稅營收還原成未稅金額，扣掉所有成本得到毛利，再扣掉預估要繳的營業稅淨額，得到淨利。

注意事項 / 常見問題

這個公式本身是完整可驗證的，但資料來源跟 91 一樣，目前沒有實際資料寫入管道——沒有真實收入／成本資料，算出來的損益數字對真實客戶而言不具參考意義。看這頁之前建議先確認 91 提到的資料來源缺口是否已經解決。

操作路徑（兩種進入方式）

1. 訂單管理頁：該筆訂單列上有「開立發票」圖示按鈕，點擊會跳轉到電子發票頁並自動帶入該筆訂單的品項與買方資訊（買方姓名／Email）。
2. 電子發票頁（側邊欄「電子發票」）：右上角「開立發票」按鈕，開啟空白表單手動填寫。

沒有「結帳自動連動開立」——POS 結帳完成後系統不會自動產生發票，一定要走上面兩條路徑之一手動觸發。

步驟說明

1. 填買方統編（一般消費者留預設值 0000000000）、買方名稱（選填）、買方 Email（選填，用於發送通知）
2. 選發票類型（4 選 1）：

- 紙本／一般載具 - 手機條碼（格式：斜線開頭共 8 碼，例如 ） - 自然人憑證（2 碼英文字母 + 14 碼數字） - 捐贈發票（需填捐贈碼）

1. 填品項明細（品名／數量／單價），可按「新增品項」加多筆
2. 系統自動加計 5% 稅並顯示總金額，按「確認開立」送出

注意事項 / 常見問題

• 同一張訂單不能重複開立發票（已作廢的那張不算，允許補開一張新的）
• 開立成功後狀態會是「已產生待上傳」，還沒真的送到財政部，需要再手動按「上傳」才會完成（見 95）

操作路徑

電子發票列表 → 狀態為「開立成功」的那筆發票列會出現「作廢」按鈕。

步驟說明

1. 按「作廢」按鈕，跳出視窗要求輸入作廢原因（必填，不填無法送出）
2. 確認後系統會產生財政部規定的作廢單（F0501），上傳到 Turnkey SFTP
3. 上傳成功後該筆發票狀態變為「已作廢」

限制

• 只有狀態為「開立成功」的發票能作廢；「待處理」「已產生待上傳」「已上傳待回應」「錯誤」「已作廢」狀態都不能按這個按鈕作廢

注意事項 / 常見問題

（細節請洽主管或 ORBIT 客服確認）

發票有 6 種狀態

| 狀態 | 顯示文字 | 說明 | |---|---|---| | | 待處理 | 剛建立，尚未產生 XML | | | 已產生待上傳 | XML 已產生，還沒送出 | | | 已上傳待回應 | 已送出，等財政部回應 | | | 開立成功 | 財政部確認收件 | | | 錯誤 | 上傳失敗 | | | 已作廢 | 已執行作廢流程 |

電子發票列表上方有依狀態篩選的按鈕（含「全部」），可以快速只看某個狀態的發票。

上傳失敗怎麼處理

1. 只有狀態為「已產生待上傳」的發票列會出現「上傳」按鈕，按下去會把 XML 透過 SFTP 送到財政部 Turnkey 加值中心
2. 上傳失敗時，狀態會變成「錯誤」，且失敗原因會直接顯示在該筆發票列下方（紅字），不用另外找地方查錯誤訊息
3. 失敗後可以直接再按一次「上傳」重試，重試不會重新配發字軌號碼（號碼在開立當下就已經配好了）
4. 頁面右上角「重新整理」按鈕可手動刷新列表，確認最新狀態

注意事項 / 常見問題

• 「已上傳待回應」狀態理論上會等財政部回應後才轉成「開立成功」；如果卡在這個狀態太久，目前系統沒有主動通知或自動重查機制，需要人工用「重新整理」查看。

操作路徑

電子發票頁右上角「發票設定」（齒輪圖示）→

三大設定區塊

1. 賣方資訊（須與稅籍登記一致）：統一編號（8 碼）、賣方名稱、負責人、電話、地址、傳真、Email
2. Turnkey 連線設定：Turnkey 帳號、SFTP Port、SFTP Host（畫面提示：正式環境用 ，測試環境用 ）、憑證檔（PFX/P12 上傳）、憑證密碼
3. 字軌設定：發票類別（07 一般稅額／08 特種稅額）、字軌代碼（如 KZ）、起始號碼、結束號碼；設定好後畫面會顯示「已使用 X / 總張數」

底部有「啟用電子發票模組」開關，關閉後無法開立新發票，但既有紀錄不受影響。

關於「測試」

目前設定頁面上沒有「測試連線」按鈕。「測試」對應到的其實是一個開發用的 端點，用寫死的範例資料驗證產生出來的 XML 格式對不對，程式碼註解直接寫「上線前刪除」——這不是給客戶操作的正式功能，只是工程除錯用的工具。設定頁能做到的「接近測試」的方式，是先把 SFTP Host 設成測試環境網址（）跑一輪開立流程。

注意事項 / 常見問題

（細節請洽主管或 ORBIT 客服確認）

目前程式功能面有的相關功能（不是整合式 SOP，是各自獨立的工具）

• 系統設定 → 通知設定 → 「日結通知」開關：每天營業結束會發送當日營收摘要通知
• 報表分析頁：可切換今日／7 天／30 天檢視銷售，並匯出 CSV（見 100）
• 財務 → 稅務中心：顯示銷項稅額／進項稅額／預估應納稅額，頁面下方自己也提醒「以上為試算數字，實際申報金額需依據發票紀錄及稅務顧問確認。台灣營業稅申報為雙月制（奇月申報）」

注意事項 / 常見問題

（目前沒有一個整合式的「月結精靈」或結算 SOP 頁面，程式面能提供的就是上面幾個各自獨立的功能，要月底結算得自己把這幾頁拼起。細節請洽主管。）(091-finance-overview.md) 提到的財務資料來源缺口：如果財務總覽/稅務中心本身沒有真實資料，月結 SOP 這條要等那個缺口有解法後才有意義。]

先澄清一件事：這頁沒有「毛利」

操作路徑

報表（側邊欄）

畫面內容

• 四張 KPI 卡：{選定天數}營收、交易筆數（附均單價）、商品種類（有銷售紀錄的商品數）、日均營收
• 長條圖：每日營收（選 14 天以內時，圖上會標出金額與日期）
• 「熱銷商品 Top 5」：依營收排序，顯示品名／數量／營收

資料計算方式

只計算 （已付款）的訂單；未結帳、已作廢、退款的訂單不會算進這頁的任何數字。

日期區間

報表頁只有「今日」「7 天」「30 天」三個固定按鈕，沒有自訂起訖日期的功能（不是日曆選取器，不能任意指定「7/1 到 7/15」這種區間）。

匯出

頁面右上角「匯出」按鈕（資料還沒載入完成前會 disable），點開是下拉選單：

• 下載到本機：存成 CSV（UTF-8 with BOM），內容依序是「每日營收」明細、「熱銷商品」明細、「總計」（總營收／交易筆數／平均客單價）三段。檔名格式： 或
• 存到 Google Drive / 切換 Google 帳號後存：如果有設定 Google Drive 整合才會出現這兩個選項

依程式碼可以確認以下幾個最常見的落差原因，建議依序檢查：

1. 報表只算「已付款」訂單：報表分析頁只計算 的訂單，未結帳、已作廢、退款的訂單不會被算進去——如果心裡想的營收包含還沒結帳完成的訂單，兩邊數字本來就對不起來（見 99）。
2. 「報表」跟「財務 → 總覽」是兩套完全不同的資料來源：報表分析抓的是真實訂單（ 表）；財務總覽／損益／稅務抓的是 ／ 兩張表——這兩張表跟訂單資料完全獨立，目前也沒有自動同步機制（見 91）。拿「報表」的營收去對「財務」的營收本來就不會一樣，因為根本不是同一批資料，這不是 bug，是兩個模組本來就沒有串接。
3. Top 5 熱銷商品是用訂單明細小計加總，如果訂單有套用折扣，顯示金額是否已扣掉折扣需要另外確認實際資料。

注意事項 / 常見問題

（細節請洽主管或 ORBIT 客服確認）

操作路徑

財務 → 稅務

畫面內容

三張卡：

• 銷項稅額（含稅營收 × 5/105）
• 進項稅額（可抵扣成本合計 × 5/105）
• 預估應納稅額（銷項 － 進項）

下方「可抵扣進項明細」表格：列出 的成本類別（排除雜費類），逐項顯示金額與可抵扣進項稅。

頁尾提醒：「以上為試算數字，實際申報金額需依據發票紀錄及稅務顧問確認。台灣營業稅申報為雙月制（奇月申報）」——這句話是系統自己承認這只是試算工具，不是正式申報依據。

注意事項 / 常見問題

跟 91 一樣，這頁的數字來源（／）目前沒有資料寫入管道，對真實客戶目前會呈現空白／掛零。

答案

• 點餐員（waiter）、收銀員（cashier）：完全看不到「財務」「電子發票」「報表」這三個選單項目——這三個路徑根本不在他們的 清單裡，連選單都不會顯示，不是「看得到選單但欄位被隱藏」，是整個功能進不去。
• 店長（manager）、工務（supervisor，同權重）、管理員（admin）：這三個角色以上才看得到「財務」「電子發票」「報表」。

也就是說，一般收銀／點餐員工完全接觸不到營收、成本、稅務、發票列表這些資料，這塊系統面是店長（含）以上才有的權限，跟「員工細部權限」勾選系統無關（那套機制目前也沒有針對財務類路徑開放額外授權）。

例外：BI Planner

「業務目標／商機」不算「財務數字」，是業務目標管理功能，cashier 角色可以使用自己的部分（見 104）。

這是什麼

BI Planner 是把「業務目標、商機、預測、待辦行動」放在同一個工作台的模組，適合有業務銷售導向的客戶（例如需要主動開發案源的 B2B 業務）。四個分頁：總覽／Pipeline／行動計畫／每日日報。

誰能用

• ／：可以看到「全體業務」的資料，也能切換查看團隊裡任何一個成員的資料（右上角「篩選業務」下拉選單）
• ：只看得到、只能操作自己的商機／目標／日報，沒有「篩選業務」選單

怎麼開始用

1. 右上角「設定目標」：填當期營收目標（見 105）
2. 右上角「新增商機」：開始記錄潛在案源
3. 到「Pipeline」分頁，用商機卡片上的階段下拉選單，把商機依實際進度切換到對應階段（新商機／已評估／提案中／議價中／已成交／未成交）
4. 「每日日報」分頁：每天回報當日業績與工作內容

操作路徑

BI Planner 右上角「設定目標」按鈕。

步驟說明

1. 跳出視窗，填四個必填欄位：起始日、結束日、營收目標、成交筆數目標
2. 只能設定自己的目標；／ 會多看到一個「負責業務」下拉選單，可以幫團隊裡任何一個成員設定目標
3. 同一人、同一段期間重複設定會直接覆蓋更新（不會產生兩筆重複目標）

目標設定後會出現在哪裡

• 「總覽」分頁的「本月目標」卡（含「已達成 X%」）
• 「行動計畫」分頁的「目標進度」區塊（每個有設目標的人各一條進度條）

用白話說

「總覽」分頁的「加權營收預測」，簡單說就是：把每筆還在談的商機金額，乘上這筆商機目前的「成交機率」，全部加起來，再加上這個月已經確定成交的金額。

系統把商機分成 6 個階段，每個階段有一個預設成交機率：新商機 10%、已評估 30%、提案中 50%、議價中 75%、已成交 100%、未成交 0%。越後面的階段代表越接近成交，在預測裡佔的比重也就越高。業務把商機拖到哪個階段，機率就自動帶入該階段的預設值；如果覺得某筆商機的實際把握度跟預設值不同，也可以在新增／編輯商機時手動調整那一筆的成交機率 %。

可以信嗎

這個數字完全取決於業務有沒有誠實、即時更新商機的階段跟金額——如果案源進度沒有隨時更新，預測就會失真。本質上這是「業務自己回報的加權估算」，不是根據過去實際成交的歷史數據跑統計模型算出來的，僅供參考，不是精算保證。

「總覽」分頁

4 張卡：本月目標／本月已達成／距離目標尚差／每日需要業績（＝距離目標尚差 ÷ 剩餘天數，算出平均每天要做多少業績才能達標）。「本月目標」卡下方會直接顯示「已達成 X%」。

「行動計畫」分頁 → 「目標進度」區塊

針對每個有設定目標的人，各自顯示一條進度條，百分比 = 該人在目標期間內已成交金額 ÷ 營收目標。

「已達成」怎麼認定

商機階段被標記為「已成交」，且成交時間（，抓不到就用最後更新時間）落在目標期間內（用台北時區的日曆日判斷）才算進「已達成」金額。

跟A/005的差異：005-line-login-first-time-binding.md 講的是「員工/老闆個人」用LINE帳號登入ORBIT，跟公司的LINE官方帳號無關。這一則講的是「公司」把自己的LINE官方帳號（客服用，客人會加好友的那個帳號）串接進ORBIT系統，讓系統可以用這個帳號發訊息、收訊息——是完全不同的兩件事，不要搞混。

操作路徑

側邊選單 → 整合應用 → LINE官方帳號卡片 → 「串接 LINE 官方帳號」按鈕（已串接過則顯示「編輯 LINE 設定」）

步驟說明

1. 進入「整合應用」頁面，找到「LINE 官方帳號」卡片（分類標籤：顧客互動）。
2. 卡片右上角會顯示目前狀態：「已串接」（綠色）或「未串接」（灰色）。
3. 按卡片下方的「串接 LINE 官方帳號」（尚未設定時）或「編輯 LINE 設定」（已設定時），會跳出「LINE 串接設定」視窗。
4. 視窗要求填寫：

- 「Channel Access Token *」（必填）：畫面提示「從 LINE Developers → Messaging 取得」。 - 「Channel ID」（選填）：畫面提示「LINE Developers → Basic settings」。 - 下方會顯示一組「自動通知串接 接收網址（填入 LINE Developers 後台）」，格式為 ，旁邊有「複製」按鈕可以一鍵複製，貼到 LINE Developers 後台的 自動通知串接 URL 欄位。

1. 填完後按「儲存設定」。這一步需要帳號權限是「admin」層級才能真的存檔成功。
2. 儲存成功後畫面會顯示「✓ 儲存成功」，卡片狀態變成「已串接」。

⚠️ 重要限制：目前無法設定「Channel Secret」，會影響LINE收訊功能

這代表：不管怎麼操作這個設定視窗，永遠是空的，自動通知串接收到LINE傳來的訊息時一定會在簽章驗證那一步被擋下（回傳403 Forbidden），也就是說目前所有客戶的LINE「收訊」相關功能（AI客服自動回覆、補教家長LINE綁定）實際上都無法運作，即使Channel Access Token填對了也一樣（Token只影響「發送」方向，跟收訊的簽章驗證是兩回事）。詳細技術說明見 111-line-自動通知串接-explained.md。

（細節請洽主管或 ORBIT 客服確認）

注意事項 / 常見問題

• Channel Access Token是「長效」的存取金鑰，在LINE Developers Console的「Messaging 」分頁下產生，跟一般網站常見的「一次性驗證碼」不同，不會過期（除非手動重新產生）。
• 這裡串接的是「LINE 官方帳號」（企業/店家用，客人主動加好友的那種），跟員工個人用來登入ORBIT的LINE帳號是兩個完全不同的東西。
• 目前ORBIT是「一個客戶(client)對應一個LINE官方帳號」的設計（底下存一組token），如果客戶有多個LINE官方帳號（例如總店＋分店各自的OA），目前架構無法同時串接多個。（細節請洽主管或 ORBIT 客服確認）

A. 通知「老闆本人」的事件（機制）

| 事件 | 觸發時機 | 來源檔案 | |---|---|---|

⚠️ 這一整類通知能不能收到，取決於兩個前提，兩個都要滿足：

1. 要是：裡明文寫「Tier 1自動化通知目前是選擇選入(opt-in)」，預設是關閉的，只有這個值被設成才會觸發。查證整個程式碼庫，目前完全沒有任何畫面/設定頁可以讓客戶自己打開這個開關。
2. 老闆本人要曾經用LINE登入過ORBIT：LINE推播對象是从表查對應的LINE user id，這張表只有在用戶用「LINE登入」（見A/005）登入過才會有紀錄。如果老闆平常都用密碼登入、沒用過LINE登入，就算開了，也只會收到email，收不到LINE推播（email是主要管道，LINE是「盡力而為」的加值，兩者互不阻塞——LINE沒設定不影響email照樣送）。

B. 通知「特定對象」的事件（各自獨立邏輯，不透過）

| 事件 | 誰收到 | 前提／目前狀態 | |---|---|---| | 候位「叫號」 | 現場候位顧客 | 在「訂位管理」的候位清單按「已叫號」時，會呼叫（type: ）。但畫面沒有任何地方蒐集顧客的LINE user id，目前這支API一定會因為缺而落到「pending」分支，回傳「客人尚未綁定LINE，請以口頭或電話通知」，實際上不會真的推播到顧客手機。（細節請洽主管或 ORBIT 客服確認） | | 建案LINE推播（廣播給全部好友） | LINE官方帳號的全部好友 | 只有系統的「產業別」設定為（喜歡建築那類建案客戶）才會在「整合應用」頁面看到這個面板，手動輸入文字按「發送推播」，呼叫。這是目前唯一「按下去、只要Token有效就真的會送出」的LINE發送功能。（目前沒有其他管道可以群發LINE訊息給所有好友。細節請洽主管。） |

小結：目前「真的會送達」的LINE通知，實際上非常有限

綜合以上查證，扣掉需要手動開啟才會動作的A類、扣掉還沒接資料的訂位前一天提醒、扣掉沒有UI能綁定顧客LINE的候位叫號、再扣掉自動通知串接缺口卡住的補教綁定跟AI客服——目前唯一不需要額外設定、只要Channel Access Token填對就能實際運作的，只有「建案LINE推播」這個手動廣播功能，而且只有產業別客戶看得到。其餘功能都卡在至少一個前置缺口上。這個落差建議整理成一份給 ORBIT 團隊的優先修復清單，而不是逐一散在各條目裡。

先講結論

「整合應用」頁面的LINE官方帳號卡片沒有像其他整合項目那樣的「測試並連結」按鈕——因為LINE走的是的獨立流程（填Token→存檔），跟其他平台用「API端點URL + API金鑰 + 測試並連結」那套通用邏輯是分開的兩條路，LINE這條路目前沒有內建的「傳送測試訊息」功能。以下是目前系統裡實際能拿來驗證的方法，以及各自的限制。

方法一：測試「收訊」方向（顧客傳訊息進來）

做法：用自己的手機把店家的LINE官方帳號加為好友，傳一句話（例如「你好」）過去，理論上幾秒內會收到AI客服的自動回覆。

方法二：測試「發送」方向（系統推播給顧客）

做法：在「訂位管理」頁面把候位清單裡的某筆顧客標記為「已叫號」，理論上會觸發LINE推播。

⚠️ 目前這個方法也測不出真正送達：如109所述，這個動作呼叫時沒有帶顧客的LINE user id，畫面本身也沒有任何地方能取得顧客的LINE user id，所以這個請求一定會落到「pending」分支，只會回傳訊息文字給店員自己看，不會真的送到顧客手機上——測了也看不出Token到底有沒有生效。

方法三：唯一目前「按下去、只要Token正確就真的會送出」的測試方式

做法：如果貴公司的「產業別」設定為（目前只有喜歡建築這類建案客戶適用），「整合應用」頁面會多顯示一個「建案 LINE 推播」欄位，在文字框輸入任意測試文字（例如「測試訊息，請忽略」），按「發送推播」，會呼叫LINE Messaging API的broadcast端點，推播給LINE官方帳號的全部好友。

• 如果Channel Access Token正確，畫面會顯示「已推播給全部LINE好友」，且你自己的手機（如果已加好友）應該會收到這則測試訊息——這是目前唯一能驗證「Token本身有沒有設對」的方式。
• 注意：這個是廣播（broadcast），會發給所有好友看到，不是只發給自己，測試文字要避免寫真實促銷內容，用完要記得跟已加好友的人說明這是測試。

（細節請洽主管或 ORBIT 客服確認）

注意事項 / 常見問題

• 「串接LINE官方帳號」設定視窗按下「儲存設定」出現「✓ 儲存成功」，只代表Token有寫進系統，不代表Token本身是有效、正確的——存檔動作本身不會呼叫LINE API做任何驗證。
• 如果要確認Token是否有效但又不是產業別，目前唯一間接方法是查看伺服器log（Vercel Logs）裡有沒有這類錯誤訊息，這需要工程端協助查看，一般店長無法自行操作。

自動通知串接是什麼（白話說明）

一般我們串接LINE，Token是讓ORBIT主動發訊息給LINE用的（例如推播通知）。但反過來，「顧客傳訊息給店家的LINE官方帳號」這件事，LINE平台不會自己知道要把訊息轉去哪裡——需要店家先告訴LINE「有新訊息時，把資料POST到這個網址」，這個「被動接收對方通知」的網址，就叫自動通知串接。

在ORBIT裡，這個網址是，設定的地方是在LINE Developers後台的「Messaging 」設定頁，貼上這個網址並啟用「Use 自動通知串接」。

什麼情況需要設定

自動通知串接只有在你需要接收LINE傳來的事件時才需要，包含：

1. 補教家長要用LINE完成綁定（家長傳「綁定 ６碼數字」，系統要能收到這則訊息才能核對綁定碼、寫入）。

如果貴公司只需要系統主動推播（例如低庫存警示、候位叫號），不需要顧客能傳訊息回來讓系統理解/處理，理論上不設定自動通知串接也不影響「發送」方向的功能——但因為自動通知串接網址在「LINE串接設定」視窗是預先顯示好、附一鍵複製按鈕的（見108），系統的預設操作流程是希望每個客戶都設定它。

⚠️ 重大發現：目前自動通知串接對所有客戶都會回應403，實際上無法運作

LINE 自動通知串接: signature verification failed for client ${clientId}

LINE官方帳號每次呼叫自動通知串接，都會在請求headers帶一個，ORBIT這端要用「Channel Secret」重新算一次雜湊值來比對，確認請求真的是LINE平台送來的（不是別人偽造的）——這是LINE Messaging API的標準安全機制，本身沒有問題。

問題在於：這個值，整個repo找不到任何一個UI畫面或API可以把它寫進系統。108提到的「LINE串接設定」視窗只有「Channel Access Token」跟「Channel ID」兩個欄位，沒有「Channel Secret」欄位。也就是說，這個變數對任何客戶永遠是空值，上面那行一定成立，自動通知串接100%會回傳403 Forbidden，不管LINE Developers後台的URL貼得多正確、Channel Access Token填得多正確都一樣。

受影響範圍：

• LINE官方帳號AI客服自動回覆：完全無法觸發（顧客傳訊息，LINE平台送到自動通知串接，被403擋下，AI永遠不會被呼叫）。
• 補教家長LINE綁定：完全無法完成（家長傳綁定碼的訊息一樣被自動通知串接擋下，永遠不會被寫入，後續的到班/未到班通知連帶失效）。
• 這兩個功能在系統裡都寫得完整（AI回覆邏輯、綁定碼比對邏輯都在），純粹是「進不了門」的問題，跟H區塊81號的BOM 欄位缺口是同一種「差一步」的bug，不是設計沒做完。

（細節請洽主管或 ORBIT 客服確認）

跟n8n 自動通知串接的差異（背景知識，一般店員不需要操作）

操作路徑

側邊選單 → 整合應用

頁面上有哪些卡片

| 卡片 | 分類標籤 | 狀態 | |---|---|---| | LINE 官方帳號 | 顧客互動 | 已上線（可設定，但功能有限，見下方說明） | | Google 商家檔案 | 曝光導流 | 即將上線（），見SKIPPED.md | | Google 日曆 | 排程同步 | 即將上線，見SKIPPED.md | | 電子發票 | 財務合規 | 即將上線，見SKIPPED.md | | Facebook 粉絲專頁 | 社群經營 | 即將上線，見SKIPPED.md | | EDM 行銷自動化 | 行銷自動化 | 即將上線，見SKIPPED.md | | Instagram 行銷 | 社群行銷 | 即將上線，見SKIPPED.md |

本則只寫LINE官方帳號這張卡片（唯一標記為否、真的有操作入口的項目），其餘6項卡片畫面上直接顯示「即將上線」徽章，按鈕區塊固定顯示「更多模組即將上線」（灰字，不可點擊），完全沒有可操作的功能，依規則記入SKIPPED.md，不寫成條目。

LINE 官方帳號卡片說明

• 分類標籤：顧客互動
• 卡片描述文字：「串接品牌 LINE 官方帳號，訂單通知、預約提醒、候位叫號一鍵推播。」
• 右上角狀態徽章：「已串接」（綠色，帶勾勾圖示）或「未串接」（灰色），依是否已填值決定。
• 卡片內「資料流」說明（下方兩行小字）：

- →「訂單 / 預約狀態 → LINE 訊息推播」，標註觸發時機「狀態變更時」 - ←「LINE 訊息事件 → POS 通知中心」，標註觸發時機「顧客互動時（自動通知串接）」 - 這兩行是設計上的目標說明，跟目前實際串接情況有落差：「狀態變更時自動推播」目前只有候位叫號一種情境會嘗試觸發，且因為沒有UI能取得顧客LINE user id，實際上不會真的送達；「自動通知串接收顧客互動」則因為Channel Secret缺口目前完全無法運作。詳細見109、111。

• 操作按鈕：「串接 LINE 官方帳號」（未設定時）／「編輯 LINE 設定」（已設定時），點下去開啟設定視窗，詳細操作步驟見108。

⚠️ 頁面上兩個容易誤導的地方

1. 頁首「X 個平台 · 已連結 Y 個」的Y數字，不會反映LINE有沒有連結成功。
2. 頁面下方「已啟用的資料流」表格，目前對任何客戶都會是空的。這個表格只列出為true的平台的資料流，跟上一點是同一個資料來源（表），LINE不計入，其餘平台都是未串接，所以這張表在目前系統狀態下實質上永遠不會出現任何一列資料（這個顯示條件永遠不成立）。

注意事項 / 常見問題

• 頁首寫「主管密碼授權後可修改 設定」，實際查證是帳號角色限制（僅admin角色能存檔），不是輸入密碼的臨時授權，詳見108步驟5的說明。

三個「LINE」不要搞混

系統裡跟LINE有關的功能其實是三件互相獨立的事，很容易被當成同一件事，先分清楚：

1. LINE官方帳號（OA，Official Account）：這是新韻傳音自己申請、自己擁有的帳號（客人在LINE上加好友的那個帳號），跟ORBIT完全無關的資產——就算哪天不用ORBIT了，這個帳號還是新韻的，好友名單也還在。ORBIT不會、也不能「取代」這個帳號。
2. ORBIT串接這個OA帳號：新韻把自己OA帳號後台的「Channel Access Token」複製貼到ORBIT的「整合應用」頁面（見108），等於「授權ORBIT可以用新韻的名義透過這個OA帳號發訊息、（理論上）收訊息」。這一步做的事情，概念上很像把LINE官方帳號的「遙控器」交給ORBIT代操作，OA帳號本身還是新韻的，密碼/後台管理權都還在新韻手上，ORBIT只是拿到一組可以呼叫LINE API的Token。
3. 員工/老闆個人用LINE登入ORBIT：這是完全不同的第三件事，是「人」登入「ORBIT系統」的方式，跟前面兩點的OA帳號無關，詳見A/005。

對新韻來說具體是什麼關係

• 新韻的客人在LINE上看到、加好友的，永遠是新韻自己的LINE官方帳號，不會看到任何「ORBIT」字樣，客人感覺不到背後是ORBIT在運作。
• ORBIT是「後台的自動化引擎」：新韻設定完Token之後，理論上系統可以在特定情境（結帳完成、候位叫號等）自動代替新韻用這個OA帳號發訊息給客人——但查證109的結果，目前實際上能自動送達的情境非常少，多數還卡在缺功能或缺欄位的階段，不是設定好Token就等於全部自動化都會動起來，這點在跟新韻說明時要講清楚，避免期待落差。
• 如果新韻的OA帳號被停用、Token被重新產生過期，ORBIT這邊的推播/自動回覆功能會跟著失效，需要新韻重新去OA後台複製新的Token貼回ORBIT——這不是ORBIT系統故障，是常見的憑證過期情境。
• 一個新韻只能串一個OA帳號（目前資料結構是存一組token，一個client一組），如果新韻未來想用「一個客服帳號、一個活動帳號」分開經營，目前架構不支援同時串多個OA帳號。（細節請洽主管或 ORBIT 客服確認）

目前對新韻情境要特別說明的落差

1. 自動通知串接相關的功能（AI客服自動回覆等）目前對任何客戶都無法運作，是程式碼缺一個「Channel Secret」欄位的緣故，不是新韻設定錯誤（見111）。
2. 主動推播類的通知（低庫存、請假審核等）預設是關閉的，需由 ORBIT 團隊協助手動在後台幫新韻開啟才會動作，新韻自己在畫面上找不到這個開關（見109）。
3. 目前系統裡「按下去、只要Token正確就真的會送出訊息」的功能，只有產業別客戶才看得到的「建案LINE推播」廣播面板——新韻的產業別設定如果不是，目前完全沒有內建方式群發LINE訊息給所有好友。（細節請洽主管或 ORBIT 客服確認）

DOCS是什麼

「DOCS單據中心」是ERP.POS裡統一管理所有正式書面單據的模組，系統裡統稱「documents」引擎。10種單據類型共用同一套後端機制：流水號、版本追蹤、電子簽章、用印、PDF匯出、公開防偽驗證，不是每種單據各自一套。側邊欄沒有「DOCS」這個總入口按鈕，10種單據各自是獨立的選單項目（都掛在「文件表單」這一區），直接點選單裡對應的單據類型即可，不用先進某個總覽頁再選類型。

操作路徑

側邊欄 →（文件表單區）→ 依情境選對應單據

十類單據對照表：什麼情況開什麼單

| 單據 | 選單文字 | 什麼情況開 | 開單後對庫存/財務有實際影響嗎 | |---|---|---|---| | 採購單 | 採購單 | 要跟供應商叫貨時，先開這張記錄要採購的品項與數量 | 否，純記錄 | | 進貨驗收單 | 進貨驗收單 | 供應商貨到，驗收數量/品質時開，可對應採購單號 | 否，純記錄 | | 報價單 | 報價單 | 客戶詢價，要給對方一份正式報價時開 | 否，純記錄 | | 訂購單 | 訂購單 | 客戶確認要買、成立訂單時開（可參考報價單內容手動轉建，見118/119號條目） | 否，純記錄 | | 出貨單 | 出貨單 | 商品要出貨/配送給客戶時開，附配送資訊 | 否，純記錄 | | 合約 | 合約 | 要跟客戶簽長期服務/採購合約時開，走電子簽章流程 | 否，純記錄 | | 退貨單 | 退貨單 | 客戶退貨，要留一份書面退貨紀錄時開 | 否，純記錄——見下方重要提醒 | | 請款單 | 請款單 | 服務/貨品已交付，要跟客戶請款時開 | 否，純記錄 | | 收據 | 收據 | 收到客戶款項，要開立收款證明時開 | 否，純記錄 | | 維修保固單 | 維修保固單 | 商品送修，或客戶詢問是否還在保固期時開（維修單跟保固單合併成一張，同一次服務資訊放一起） | 否，純記錄 |

⚠️ 重要提醒：這裡的「退貨單」不會自動退庫存/退款，跟「退貨」功能是兩個不同東西

系統裡有兩個名稱很像但完全獨立的功能，容易搞混：

• 側邊欄「退貨」（，僅限有實體庫存的產業別如餐飲/零售/醫美/旅宿）：這是真正會改動庫存、觸發退款、連動發票作廢的完整退貨流程。
• 本條目講的「退貨單」（DOCS單據中心底下的）：純粹是一張書面紀錄單，開立/作廢都不會自動調整庫存或觸發退款，只是留一份「有這筆退貨」的正式文件（例如給客戶簽收用）。

兩者互不連動——在「退貨」功能裡處理完退貨，不會自動在DOCS裡生出一張「退貨單」；反之在DOCS開一張「退貨單」，也不會觸發真正的庫存/退款動作。需要哪一種，要看當下目的是「要真的退錢退貨到庫存」還是「只是要一張書面單據」。

⚠️ 另一個提醒：DOCS的「合約」跟「合約管理」也是兩個不同系統

設定頁裡另外有一個「合約管理」（僅ORBIT管理員/鎧洋自己看得到），那是鎧洋自己跟ORBIT客戶（例如新韻）簽約用的內部工具，跟本條目講的DOCS「合約」（新韻自己要開給"他們的"客人的合約）是完全不同的兩張表、兩套系統，不要混在一起操作。DOCS合約的電子簽章實作細節見121號條目。

個別單據的詳細操作

• 報價單建立／轉訂購單：見118、119號條目
• 合約建立與電子簽章：見120、121號條目
• 印章資產與版本歷史：見122、123號條目
• PDF輸出、雜湊驗證：見124、125號條目
• 請款單、收據、維修保固單：見126、127、128號條目
• 單據狀態流轉與刪除規則（10種單據共用同一套規則）：見129、130號條目

操作路徑

側邊欄 → 報價單 → 「+ 新增報價單」

步驟說明

1. 進入「報價單」列表頁，按右上角「+ 新增報價單」。
2. 「客戶資訊」區塊：可從下拉選單「從既有客戶選擇（或直接手動填寫）」帶入既有客戶的名稱/聯絡人/Email，或直接手動填「客戶名稱」「聯絡人」「手機」「電話」「Email」「地址」等欄位。
3. 「報價資訊」區塊：填「業務代表」（下拉選公司員工，預設帶入自己的名字，也可代同事開單改選別人）、「報價效期」「付款條件」「交貨條件」。
4. 「品項明細」區塊：可用「選商品帶入」下拉選單挑既有商品自動帶入品名與單價，或手動填「品名」「說明/規格」「數量」「單位」「單價」「折扣」，按「+ 新增一列」可加更多品項。
5. 視需要填「稅額」「其他費用」「備註」，確認下方「合計」金額無誤後按「建立報價單」。

注意事項 / 常見問題

• 新建立的報價單狀態一律是「草稿」，之後要走「送出→核准→完成」的狀態流程，見129號條目。
• 報價單本身不會自動連動到「訂購單」——目前系統沒有一鍵轉單的按鈕，詳見119號條目。

⚠️ 重大發現：畫面上目前沒有「轉單」按鈕可以按

這支API本身要求操作者至少是「店長」（）等級才能呼叫（），比建立/編輯一般單據要求的「收銀員」等級更高——這是我把角色標「管理者」而非藍圖原本猜的「員工」的依據，但因為畫面上沒有入口，這個角色門檻目前也只是理論上的設計，實務上還沒人用得到。

目前的替代做法（純手動，非本來設計的流程）

在畫面沒有補上「轉單」按鈕之前，要「報價單轉訂購單」只能手動做：

1. 開啟該張報價單詳情頁，把品項明細、客戶資訊記下來（或另開分頁對照）。
2. 到「訂購單 → 新增訂購單」，比照報價單內容手動重新輸入客戶資訊與品項。
3. 訂購單的「訂購資訊」區塊有一個「對應報價單號」欄位，手動填入原報價單的單號，作為兩張單之間的人工連結（不是系統自動關聯，只是備註用的文字欄位）。

（細節請洽主管或 ORBIT 客服確認）

操作路徑

側邊欄 → 合約 → 「+ 新增合約」

步驟說明

1. 進入「合約」列表頁，按右上角「+ 新增合約」。
2. 「甲方（本公司）」區塊：填「公司名稱」「統一編號」「代表人/聯絡人」「地址」。
3. 「乙方（客戶）」區塊：填「公司/個人名稱」「統一編號」「代表人/聯絡人」「手機」「地址」，或用「從既有客戶選擇」下拉帶入既有客戶資料。
4. 「合約條款」區塊：填「合約起始日」「合約結束日」「付款條件」「服務/商品範圍」。
5. 「品項明細」區塊填合約涵蓋的項目/金額，確認合計金額後按「建立合約書」。

建立後的合約狀態一律是「草稿」，簽署與用印流程見121、122號條目。

⚠️ 權限提醒：目前系統沒有針對「合約」做額外的角色限制

這跟一般公司實務上「合約通常要店長/管理者層級才能開」的直覺可能不一致。

（細節請洽主管或 ORBIT 客服確認）

⚠️ 先講清楚：DOCS目前沒有「寄公開連結給客戶自己遠端簽」這個功能

DOCS實際的簽署方式是：必須先登入ERP.POS，在合約詳情頁現場簽署，沒有讓客戶收到一個網址、自己在家用手機簽的流程。

操作路徑（DOCS實際支援的方式）

側邊欄 → 合約 → 點進一張合約 → 「簽名」頁籤

步驟說明

1. 開啟一張合約的詳情頁，切到「簽名」頁籤。
2. 畫面依合約範本列出要簽署的角色：「甲方代表」「乙方代表」。
3. 每個角色下方按「開始簽署」，會出現簽名畫布。
4. 簽署方式二選一：

- 「手寫簽名」：直接在畫布上用手指/滑鼠寫字，寫錯按「清除重簽」。 - 「選預存簽名」：從下拉選單選一組已經存過的簽名圖檔一鍵套用（預存簽名管理見）。

1. 按「確認簽署」送出，簽署完成後畫面會顯示「已簽署」與簽署時間。

注意事項 / 常見問題

• 實務上要讓客戶簽署，通常是店員/業務把平板或電腦交給客戶當面在畫布上簽，或店員代為輸入客戶指定的簽名圖檔——不是客戶自己遠端連線操作。
• 每張合約的簽署角色（甲方/乙方）由合約範本固定，不能自訂新增角色。

（細節請洽主管或 ORBIT 客服確認）

印章資產是什麼

「印章資產」是預先上傳到系統裡的印章圖檔（例如公司大小章、發票章、財務章、作廢章、急件章、自訂印章…），存在「印章資產」清單裡，之後在任何一張單據的「用印」頁籤就能挑選套用，用拖曳的方式決定蓋在文件上的位置、縮放、旋轉角度、透明度，不用每次都手動貼圖。

⚠️ 權限層級：新增印章跟開放使用權限都是admin專屬，店長(manager)做不到

• 新增一顆印章（）：程式碼檢查——只有admin等級能做，店長(manager)也不行。
• 設定某顆印章開放給哪些角色使用（）：同樣檢查，只有admin能設定。
• 新增的印章預設只有admin能用：新增印章時系統自動只寫入一筆權限，其他角色（含店長）要admin另外去權限設定頁把該角色勾選加進去才能用這顆印章蓋章。
• 實際蓋章這個動作本身：只要該角色有被admin開放這顆印章的使用權限，收銀員等級以上都能操作蓋章（用印頁籤本身不額外限制角色，蓋章清單由後端依過濾，看不到的印章代表沒有權限用）。

也就是說系統設計上是「admin決定誰能用哪顆印章，其他角色只能在被開放的範圍內蓋章，不能自己新增印章或調整權限」。

操作路徑：新增印章與設定使用權限（admin限定）

設定 → （印章資產管理，畫面文字待截圖確認）

步驟說明

1. admin帳號進入印章資產管理頁，上傳一張透明背景的印章圖檔（PNG）。
2. 選「印章類型」（公司大小章/發票章/財務章/已付款章/作廢章/急件章/樣品章/自訂），填印章名稱後儲存。
3. 新增後這顆印章預設只有admin自己看得到、能用。
4. 若要開放給店長或其他角色使用，進入該顆印章的權限設定，勾選要開放的角色（admin一律保留在清單裡，不能取消），儲存後被勾選的角色才會在「用印」頁籤的印章下拉選單裡看到這顆印章。

實際蓋章操作路徑（被開放權限的角色都能做）

任一張單據詳情頁 → 「用印」頁籤

1. 從下拉選單「選擇印章」（只會列出自己角色有權限用的印章）。
2. 選好印章後，圖檔會出現在畫布上，用滑鼠拖曳調整位置。
3. 用「縮放」「旋轉」「透明度」三個滑桿調整蓋章效果。
4. 按「確認用印」送出。

（細節請洽主管或 ORBIT 客服確認）

操作路徑

任一張單據詳情頁 → 「版本歷史」頁籤

步驟說明

1. 開啟任一張單據（報價單/合約/收據…10種單據通用）的詳情頁。
2. 切到「版本歷史」頁籤，系統會列出這張單據從建立到現在的每一個版本（v1、v2、v3…），由新到舊排列。
3. 每筆版本紀錄顯示：版本號、變更類型（建立／編輯／狀態變更／作廢／轉單）、變更時間。

版本是怎麼累加的（背後機制）

系統每次以下任一動作發生時，都會自動產生一筆新版本紀錄，不會覆蓋舊版本：

• 建立單據（版本1）
• 編輯單據內容（僅「草稿」「待處理」狀態可編輯，一旦核准/完成/作廢就不能再編輯）
• 狀態變更（送出/核准/完成/作廢/封存）
• 轉單（從既有單據衍生出新單據）

版本紀錄是只能新增、不能修改或刪除的（append-only），系統層級用trigger擋死，就算程式碼寫錯或有人直接改系統，舊版本也不會被覆蓋或消失，確保「這張單據曾經被改成什麼樣子」永遠查得到。

注意事項 / 常見問題

• 版本歷史目前只顯示「版本號／變更類型／時間」，沒有逐欄位的差異對照（例如v1跟v2哪個欄位被改了、改成什麼）——要看實際內容差異，目前只能各自產生PDF對照，或請工程人員查系統裡的snapshot欄位。

操作路徑

任一張單據詳情頁 → 「文件內容」頁籤（預設頁籤）→ 「產生PDF」

步驟說明

1. 開啟任一張單據詳情頁，確認在「文件內容」頁籤。
2. 按「產生PDF」按鈕，系統會依單據內容、簽名、印章即時組出一份PDF，並在PDF裡嵌入一個QR碼（掃描可連到公開防偽驗證頁，見125號條目）。
3. 產生完成後，畫面會出現「下載PDF」連結，點擊在新分頁開啟/下載PDF檔案。
4. 要列印的話，用瀏覽器開啟PDF後直接用瀏覽器內建的列印功能（Ctrl/Cmd+P）即可，系統本身沒有另外的「一鍵送印」按鈕。

⚠️ 補充：後端有一支「列印紀錄」，但畫面上沒有對應的按鈕

注意事項 / 常見問題

• 每次按「產生PDF」都會重新產生一份新的PDF檔案（檔名含版本號），舊版本的PDF不會被覆蓋。
• 已經產生過PDF的單據，之後再進來這張單據的頁面，系統會提供「重新簽發最新PDF的下載連結」（不用重新產生），但短效連結有時效性，過期要重新按「產生PDF」。

（細節請洽主管或 ORBIT 客服確認）

這是什麼、怎麼運作

每張DOCS單據每次建立或修改，系統都會把當下的完整內容（單據資料+品項明細）算出一組獨一無二的SHA-256雜湊值（一長串英數字），存進系統，並在「產生PDF」時把這組雜湊值編進PDF上的QR碼裡。

只要文件內容有任何一個字被改過（不管是系統內編輯，還是有人事後竄改PDF檔案本身），重新計算出來的雜湊值就會跟原本存的對不上，驗證就會失敗。所以雜湊值可以拿來證明「這份PDF跟系統裡存的內容是不是完全一致、有沒有被動過手腳」。

客戶怎麼驗證：掃PDF上的QR碼

1. 客戶用手機掃描PDF文件上印的QR碼。
2. 會導到一個不需要登入的公開驗證頁（），任何人都能查，不用有ERP.POS帳號。
3. 頁面顯示結果：

- 驗證通過：顯示「此文件驗證通過」，並列出單據編號、版本（含是否為最新版）、建立時間、是否已簽署電子簽章。 - 驗證失敗：顯示「此文件內容與系統紀錄不符，可能已遭竄改或非ORBIT系統產出的文件」。

怎麼跟客戶解釋（白話版）

「這份文件上有一個QR碼，掃了可以直接連到我們系統確認這份文件是不是我們開的正本、內容有沒有被改過。如果被動過手腳，掃出來會顯示驗證失敗，不需要打電話回來核對，掃碼就能自己查。」

注意事項 / 常見問題

• 驗證頁只顯示「有沒有簽署」，不會顯示簽署人是誰、簽名長什麼樣（避免公開頁洩漏簽名圖檔本身）。
• 舊版本的單據（例如v1，後來改成v2）如果被拿出來掃，仍然驗證得過，但頁面會標示「非最新版本」，提醒對方這不是目前最新的內容。
• 這個驗證頁沒有登入門檻，任何人拿到雜湊值都能查，設計上就是給系統外的人（客戶、第三方）不用開帳號也能驗證用的。

操作路徑

側邊欄 → 請款單 → 「+ 新增請款單」

步驟說明

1. 進入「請款單」列表頁，按「+ 新增請款單」。
2. 「客戶資訊」區塊：填或選「客戶名稱」「聯絡人」「地址」。
3. 「請款資訊」區塊：填「對應合約/訂單編號」（手動填寫的參考文字，非系統自動關聯）、「付款期限」「付款方式」「經辦人員」（下拉選公司員工，預設帶入自己）。
4. 「品項明細」填請款項目/金額，確認合計後按「建立請款單」。
5. 建立後狀態是「草稿」，走「送出→核准→完成」的流程，跟其他單據共用同一套狀態機（見129號條目）。

注意事項 / 常見問題

• 「對應合約/訂單編號」只是一個文字欄位，不是系統自動帶入或連結既有合約/訂單——要對照哪張合約/訂單，需要自己手動輸入單號。
• 請款單本身不會觸發任何自動記帳或財務模組連動，是獨立的書面單據紀錄。

收據跟電子發票是兩個完全獨立的系統

| | 收據（DOCS） | 電子發票 | |---|---|---| | 位置 | 側邊欄「收據」 | 側邊欄「電子發票」 | | 性質 | 一般書面收款證明，非稅務憑證 | 正式稅務發票，需上傳財政部平台 | | 開立方式 | 手動填表建立 | 走發票號碼、買受人統編/載具、XML產生、上傳等正式流程（狀態：待處理/已產生待上傳/已上傳待回應/開立成功/錯誤/已作廢） | | 兩者會互相連動嗎 | 不會，各自獨立建立，系統不會因為開了收據就自動生成發票，反之亦然 | 同左 |

收據什麼時候開

收到客戶付款（不管是訂金、尾款還是全額付清）需要一份證明收到這筆錢的書面文件時開立，例如客戶付現金訂金但還沒到開立正式發票的時間點，或客戶只是要一張內部對帳用的收款證明。

操作路徑：建立收據

側邊欄 → 收據 → 「+ 新增收據」

步驟說明

1. 進入「收據」列表頁，按「+ 新增收據」。
2. 「付款人資訊」區塊：填「付款人/公司名稱」「聯絡人」。
3. 「收款資訊」區塊：填「收款日期」「對應單據編號」（手動文字，非自動關聯）、「收款方式」「經手人」（下拉選員工，預設帶入自己）。
4. 「品項明細」填收款項目/金額，確認合計後按「建立收據」。

注意事項 / 常見問題

• 收據不具法律上的正式稅務憑證效力，若客戶要求開立正式發票（可報稅、可對獎），要另外走「電子發票」模組，兩邊需要各自手動輸入一次資料。

操作路徑

側邊欄 → 維修保固單 → 「+ 新增維修保固單」

步驟說明

1. 進入「維修保固單」列表頁，按「+ 新增維修保固單」。
2. 「客戶資訊」區塊：填「客戶名稱」「聯絡人」「手機」。
3. 「維修資訊」區塊：填「受理日期」「預計完成日」「故障描述」「維修人員」（下拉選員工，預設帶入自己）。
4. 「保固資訊」區塊：填「購買日期」「保固到期日」「是否在保」「保固條款」。
5. 「品項明細」填維修項目/更換零件與費用，確認合計後按「建立維修保固單」。

注意事項 / 常見問題

• 維修單跟保固單合併成同一張單據，不用分開開兩張單——同一次送修，維修進度跟保固狀態放在同一份文件上，避免要對照兩張單才知道這台還在不在保固期內。
• 「是否在保」目前是手動填寫的文字/選項欄位，系統不會依「購買日期」「保固到期日」自動幫忙判斷或警示是否過保，需要自行核對日期。

狀態一覽

| 狀態 | 顯示文字 | 說明 | |---|---|---| | draft | 草稿 | 剛建立、還沒送出，可自由編輯內容 | | pending | 待處理 | 已送出等待核准，仍可編輯內容 | | approved | 已核准 | 已核准，不能再編輯內容 | | completed | 已完成 | 流程走完，不能再編輯 | | cancelled | 已作廢 | 作廢，不能再變更（終止狀態） | | archived | 已封存 | 封存，不能再變更（終止狀態） |

狀態流程圖

每個動作要什麼角色

| 動作 | 畫面按鈕 | 出現時機 | 最低角色要求 | |---|---|---|---| | 送出 | 「送出」（草稿→待處理） | status為草稿時 | 收銀員 | | 核准 | 「核准」（待處理→已核准） | status為待處理時 | 店長 | | 完成 | 「完成」（已核准→已完成） | status為已核准時 | 收銀員 | | 作廢 | 「作廢」（→已作廢） | status不是已作廢/已封存時都會顯示 | 店長 |

（「送出」「完成」只要收銀員以上就能按；「核准」「作廢」要店長以上）

步驟說明：從草稿走到完成

1. 開啟單據詳情頁，狀態顯示「草稿」時，右上角出現「送出」按鈕，按下後狀態變「待處理」。
2. 狀態「待處理」時出現「核准」按鈕（需店長以上），按下後狀態變「已核准」，此後這張單據內容不能再編輯。
3. 狀態「已核准」時出現「完成」按鈕，按下後狀態變「已完成」。
4. 任何非終止狀態下都能按「作廢」（右上角紅框按鈕），按下會跳出提示要求輸入作廢原因，沒填原因無法送出作廢。

注意事項 / 常見問題

• 狀態變更不是嚴格線性流程——系統技術上允許同一張單直接從「草稿」跳到「作廢」，不強制一定要照「送出→核准→完成」的順序才能作廢，只要不是已作廢/已封存狀態，隨時都能作廢。
• 一旦進入「已作廢」或「已封存」，就不能再做任何狀態變更（系統會直接擋下並回報錯誤），這兩個狀態是終點。
• 單據編號（doc_number）不管作廢與否都不會被重複使用或回收，作廢只改狀態，不影響編號。

結論：不能刪除，只能作廢

DOCS的10種單據在系統設計上完全不提供刪除功能，這是刻意的硬性限制，不是還沒做：

• 畫面畫面（列表頁、詳情頁）沒有任何「刪除」按鈕。
• 後端API根本沒有寫方法，就算有人手動打API要求刪除，Next.js對未實作的方法會直接回應「405方法不允許」。
• 系統層級再加一道保險：紀錄掛了一個觸發器，只要有任何刪除動作打到這張表（就算是工程師直接操作系統），會直接丟出錯誤「documents 不可硬刪除，請改用status=cancelled(作廢)」，強制擋下。

要「移除」一張不要的單據，唯一的方式是作廢（狀態改成「已作廢」，見129號條目），作廢後：

• 單據本身不會消失，仍然留在列表裡（狀態顯示「已作廢」）。
• 單據編號永久保留、不會被其他新單據重複使用。
• 作廢時必填的「作廢原因」會被記錄下來，之後在詳情頁最上方會顯示「作廢原因：xxx」。
• 這次作廢動作本身也會產生一筆新的版本紀錄（版本歷史裡看得到），完整保留「誰在什麼時候把它作廢、為什麼」。

版本紀錄同樣不能刪除或修改

不只單據本身不能刪，每一筆版本歷史紀錄也是「只能新增、不能修改或刪除」——系統另外掛了一道觸發器擋住對版本紀錄的UPDATE/DELETE，就算之後想「清掉某個版本的紀錄」也做不到，確保稽核軌跡完整、不會被事後竄改或清除。

注意事項 / 常見問題

• 如果是純粹手滑建錯一張單、內容完全不需要，也只能作廢，不能刪掉讓它徹底消失，列表裡會一直看得到這張「已作廢」的單據（除非之後有加「封存」機制隱藏，但封存目前也只是換一個狀態，系統紀錄同樣不會消失）。

在哪裡看

「公司公布欄」不是側邊欄裡的獨立選單項目，而是直接嵌在頁面最上方：

• 進入「總覽」（Dashboard首頁）就會看到，是頁面最上面的區塊。
• 「員工考勤」頁面（打卡頁）最上方也有同一個公布欄——這是特別安排的，因為點餐員(waiter)角色雖然沒有「總覽」頁的權限，但有「員工考勤」的權限，這樣現場人員每天打卡時也一定會看到公告，不用額外開放整個Dashboard首頁給他們。

如何確認已讀

1. 公布欄列出的每則公告，還沒讀過的會有一個小圓點標記，背景也會比已讀的稍微亮一點。
2. 該公告卡片右側有一顆按鈕：

- 如果這則公告不需要確認，按鈕文字是「標記已讀」。 - 如果這則公告要求已讀確認（管理者發布時可以勾選這個選項），按鈕文字是「已讀並確認」。

1. 按下按鈕後，該公告就會被記錄成「已讀」（如果要求確認，也一併記錄「已確認」時間），畫面上會改顯示「已確認」的綠色標記。
2. 有「緊急」等級但還沒確認的公告，公布欄下方會出現一條紅色提示「尚有緊急公告需要確認」，提醒還沒處理完。

注意事項 / 常見問題

• 這個功能是否顯示，取決於公司帳號有沒有開啟「公司公布欄」設定——如果整個公布欄區塊完全看不到，代表這個功能還沒被啟用，需要請ORBIT開通（見下方缺口說明）。
• 公布欄可能只顯示「發給特定角色」或「發給全體」的公告，如果管理者發布時有指定角色，只有符合角色的人才看得到（見133號條目）。

（細節請洽主管或 ORBIT 客服確認）

操作路徑

總覽（Dashboard首頁）或「員工考勤」頁 → 公司公布欄區塊 → 「發布公告」

步驟說明：發布公告

1. 在公布欄區塊右上角按「發布公告」（只有店長以上的帳號才看得到這顆按鈕）。
2. 選公告等級：「一般通知」「重要事項」「緊急通知」三選一。
3. 填「公告標題」（最多120字）、「交代事項與說明」內容（最多5000字）。
4. 「發布對象」：預設不勾選代表全體員工都收得到；也可以勾選特定角色（管理員/主管/一般員工/現場人員/工務）限定範圍，見133號條目。
5. 視需要勾選「釘選」（讓這則公告固定顯示在上方）、「要求已讀確認」（收件人不只要標已讀，還要多按一次確認）。
6. 可設定「截止時間」，時間到了這則公告就不再顯示。
7. 按「發布公告」送出。

步驟說明：追蹤已讀名單

管理者帳號在公布欄看每則已發布的公告，卡片下方會直接顯示已讀/確認統計：「已讀 X/Y · 確認 X/Y」（X是目前已讀/已確認人數，Y是該公告的總收件人數，Y會依「發布對象」設定的角色範圍計算，不是固定全公司人數）。

其他管理動作

• 編輯：按公告卡片右側的鉛筆圖示，可修改標題/內容/等級/發布對象/釘選/已讀確認/截止時間後重新儲存。
• 封存：按垃圾桶旁的封存圖示，會跳出確認視窗「確定要封存這則公告嗎？封存後不再顯示給員工」，封存後的公告不會再出現在公布欄。
• 留言給同仁（個別對象）：公布欄上方另外有一個「留言給同仁」區塊，可以挑選特定同仁（僅限已經登入過系統、有帳號的員工），送出只有對方看得到的個人訊息——這不算公告，不會出現在公布欄清單，也不計入已讀統計，是完全獨立的1對1私訊功能。

注意事項 / 常見問題

• 「留言給同仁」的收件人清單只列出「已經登入過系統、有綁定帳號」的員工，還沒登入過的員工帳號不會出現在可選名單裡（因為沒有帳號可以收訊息）。
• 個人留言嚴格1對1，就連管理者自己也看不到別人收到的個人留言內容，不像公告那樣可以彙整查看已讀名單。

結論：可以指定「角色」，不能指定「部門」

• 管理員（admin）
• 主管（manager）
• 一般員工（cashier）
• 現場人員（waiter）
• 工務（supervisor）

發布公告時勾選其中幾種角色，只有對應角色的帳號才看得到這則公告；不勾選任何角色代表發給全體員工（不分角色都看得到）。

系統裡員工資料確實有「部門」這個欄位，但目前只在「留言給同仁」的收件人清單上用來輔助顯示（例如「王小明・外場」方便管理者辨識挑選對象），公告本身的「發布對象」設定沒有依部門篩選這個選項——不能設定「只發給外場部門」這種指定法，只能用角色，或者改用「留言給同仁」一個一個點名指定特定的人。

如果想模擬「發給某個部門」，目前的替代做法

用「留言給同仁」功能（見132號條目），手動從名單裡逐一勾選該部門的所有同仁，送出個人訊息——但這樣送出的是個人留言，不是正式公告，不會顯示在公布欄，也不會有已讀名單統計，只是一則私訊。

（細節請洽主管或 ORBIT 客服確認）

查證結果：系統裡確實有兩套完全獨立的公告機制，不是同一個東西

| | 系統公告（ORBIT官方） | 公司公布欄 | |---|---|---| | 誰能發布 | 只有ORBIT管理員（寫死的單一帳號，環境變數，預設） | 各客戶自己的店長/管理員（/角色） | | 發布對象 | 全部使用ERP.POS的客戶，不分租戶，一次發布所有人都看得到 | 只有自己公司內部的員工（依區隔，看不到別間公司的） | | 一般員工看的地方 | 右上角🔔通知鈴鐺，點開分「最新消息」「系統通知」兩個頁籤 | 總覽首頁/員工考勤頁上方，直接嵌在頁面裡 | | 公告類型 | 系統維護／新功能／最新消息／資安公告 | 一般通知／重要事項／緊急通知 | | 已讀確認機制 | 只有「已讀」，沒有「已讀名單」給誰追蹤（因為發給所有客戶，沒有意義列名單） | 有「已讀」也有「確認」兩階段，管理者看得到已讀/確認人數統計 | | 用途 | ORBIT平台本身要公告全體客戶的事（例如系統維護時間、新功能上線、資安警示） | 各公司自己內部要交辦/公告員工的事（例如排班異動、內部規定） |

白話總結

「系統公告」是ORBIT公司（鎧洋）發給所有使用ERP.POS的客戶看的，只有平台管理員能發，新韻的管理者帳號進得去「系統公告」這個頁面，但按「發布公告」會被系統擋下來（後端檢查登入信箱是否等於ORBIT管理員信箱，不是就回傳權限不足）。

「公司公布欄」才是新韻自己內部要公告/交辦員工事情用的，新韻的店長/管理員帳號可以自己發布、自己管理，只有新韻自己的員工看得到，不會被其他ORBIT客戶看到，也看不到其他客戶的公告。

兩者的顯示位置也不同：系統公告透過🔔通知鈴鐺查看，公司公布欄是直接嵌在Dashboard首頁/打卡頁上的一個區塊，不用另外點開。

操作路徑

員工考勤 → 「管理者：核發外勤打卡授權」按鈕 → 開啟「核發外勤打卡授權」視窗

步驟說明

1. 在「員工考勤」頁面點「管理者：核發外勤打卡授權」按鈕，開啟視窗。
2. 填寫：

- 員工（必填）：下拉選單選要授權的員工。 - 授權日期（必填）：只針對這一天生效。 - 備註（選填）：例如「出差拜訪客戶」，方便之後查證。

1. 點「核發授權」送出。
2. 送出成功會顯示「已授權，該員工當日打卡不受地點限制」。
3. 該員工在授權日期當天打卡，系統不會再檢查GPS/電子圍籬範圍。

注意事項 / 常見問題

• 這個授權是按員工＋按單一日期核發的，不是長期生效的設定；每次外勤都要重新核發，沒有「這個人以後都不用檢查範圍」的長期選項。
• 授權日期選錯，員工當天仍然打不了卡；核發後建議請員工當場確認能不能打卡成功。
• 跟140號「如何調整打卡範圍？」不同：140號是調整整間店/工地的固定打卡範圍（電子圍籬座標與半徑），135號是針對單一員工、單一天開的例外通道，兩者互不影響。

操作路徑

員工考勤 → 待審核清單（假單區塊）

步驟說明

1. 進入「員工考勤」頁面，會看到員工送出、狀態為「待審核」的假單清單。
2. 每筆假單可以看到假別、起訖時段、事由。
3. 點「核准」或「拒絕」：

- 核准：系統會把這筆假單換算成時數，從該員工對應假別的休假額度扣除（見144號「假別設定與額度怎麼調整？」）。 - 拒絕：假單維持未核准狀態，不會扣額度。

1. 如果公司有開啟自動通知，核准/拒絕結果會email通知員工本人。

注意事項 / 常見問題

• 核准動作同時做兩件事：改假單狀態、扣休假額度——所以一旦核准就不能反悔改回待審核，只能之後手動調整額度或請工程協助。
• 半天假、下午請假等情境的出勤判定，跟本則審核動作沒有連動：目前系統核准/拒絕假單只影響「假單本身的狀態」跟「額度扣抵」，不會回頭去改當天的打卡出勤紀錄狀態（早退/缺勤等），詳見137號的完整說明。
• 盡量當天處理：假單審核越晚，員工個人的請假紀錄跟額度餘額查詢就會有一段時間顯示「待審核」，容易造成混淆。

⚠️ 查證後跟原題目假設不同，請先看這段

原題目（藍圖v2/BATCH_01_DRAFT草稿）假設系統會自動顯示一種叫「早退(有待核准假單)」的複合狀態——早退，但因為有一張還沒核准的假單所以是暫時性的。逐一查證打卡與請假相關程式碼後，確認系統目前完全沒有這個機制，這點跟C區塊（026-034號請假條目）查證時發現的結論一致（見C/INDEX.md開頭說明），這裡針對「早退」這個狀態再補充完整一次：

1. 「早退」欄位真正會出現的唯二管道：

- （每日考勤統計）這張表本身就是給人工/外部試算表（例如Gemini算好的彙總表）匯入或手動輸入用的歷史彙總數字，一樣不是系統自己算的。

1. 假單核准與早退狀態之間沒有任何連動：不存在「核准假單後系統自動把早退清掉」這種自動修正機制，因為根本沒有「早退」這個即時判定在跑，也就沒有東西需要被清掉。

目前畫面上看得到什麼

「員工考勤」頁面上方的一週統計卡片有「早退」這個欄位（跟「正常出勤」「遲到」「缺勤」並列），這個數字是統計目前抓到的打卡紀錄裡欄位等於「早退」的筆數——但如同上面說明，這個目前只有CSV匯入才會寫入「早退」值，日常打卡不會自動產生。

注意事項 / 常見問題

（細節請洽主管或 ORBIT 客服確認）

操作路徑

員工 → 「新增員工」按鈕 → 填寫表單 → 「新增員工」儲存

步驟說明

1. 在「員工」頁面點右上「新增員工」按鈕，開啟表單。
2. 填寫欄位（標＊為必填）：

- 姓名＊ - 電話（格式提示：09xx-xxx-xxx） - Email - 上班時間／下班時間（時間欄位，僅供顯示參考，不影響打卡判定） - 權限等級（下拉選單，決定這個帳號能用哪些功能，見141號條目） - 部門（選填，例：業務部、行銷部） - 職位（選填，職級如經理／主任／專員） - 職務（選填，實際工作內容，例：電商平台、B2B、會計；不填則顯示權限等級名稱） - 計薪方式＋對應金額（「月薪 (NT$)」或「時薪 (NT$)」二選一） - 打卡據點（選填，指定後該員工打卡以該據點的電子圍籬範圍為準，見140號條目）

1. 點「新增員工」完成建檔。

注意事項 / 常見問題

• 這裡建立的是員工資料檔；員工要能自己登入系統，另需登入帳號（LINE／Google／Email 擇一），可請員工走「新人自助註冊」流程（見 A 區第6號條目），系統會把登入帳號跟員工檔對起來。
• 也可以用 CSV 批次匯入員工名單（「員工」頁的匯入功能，欄位含部門／職位／職務／計薪方式／基本薪資／離職日等）。
• 薪資欄位只有具「編輯員工」權限的管理者看得到，一般員工的清單畫面不顯示薪資欄。

操作路徑

員工 → 該員工列的停用操作 → 確認停用

步驟說明

1. 在「員工」頁面找到要辦理離職的員工。
2. 點該員工列的停用操作，系統會跳出確認訊息：「確定要將『（姓名）』標記為異動（停用）嗎？停用後不會出現在在職名單與打卡範圍內，但歷史考勤/薪資紀錄會保留，之後可以再恢復。」
3. 確認後，系統把該員工標記為停用，並自動記下當天為離職日。

注意事項 / 常見問題

• 系統刻意不提供「刪除員工」：員工底下掛著考勤、薪資、訂單等歷史紀錄，硬刪除會讓這些資料變成孤兒。停用（標記離職）就是正式的離職做法，歷史資料全部保留。
• 停用後該員工不會再出現在在職名單與打卡選單；狀態指示燈由亮轉暗。
• 停用是可逆的：之後可以在同一頁把該員工恢復為在職（復職時系統會清掉離職日）。
• 停用員工資料檔不會自動封鎖他的登入帳號本身；完整離職流程（含帳號、權限的收尾清單）見 P 區第148號條目。

操作路徑

設定 → 「打卡電子圍籬」區塊

步驟說明

1. 進入「設定」頁，找到「打卡電子圍籬」區塊。
2. 打開「啟用電子圍籬」開關（說明文字：開啟後員工打卡時需在指定範圍內）。
3. 填寫：

- 緯度（例：24.839745） - 經度（例：120.967551） - 允許半徑（公尺） - Wi-Fi SSID（例：OBARAI-5G）

1. 儲存後生效，這是全公司的預設打卡範圍。

注意事項 / 常見問題

• 這個範圍套用到沒有另外指派據點的員工。如果公司有多個打卡地點（例如工地＋辦公室），用設定頁的「多據點打卡（工地 / 辦公室）」區塊「新增據點」（據點名稱例：三號工地、總部辦公室，各自有緯度/經度/允許半徑），再到員工檔的「打卡據點」欄位指派——被指派據點的員工，打卡以該據點的範圍為準。
• 員工偶發性外出（出差、跑業務）不用改範圍：用「核發外勤打卡授權」開單日例外即可（見135號條目），不要為了一個人一天動全公司的圍籬設定。
• 打卡時的範圍檢查只在「上班／下班」兩段執行，午休打卡不檢查位置（員工午休常會離開範圍去用餐）。

角色分級

系統固定五個權限層級，由低到高： < < = （同層） < 。畫面上顯示的中文名稱依產業別而定；新韻傳音的產業別設定為「零售」，零售預設名稱是：銷售員(waiter)／櫃檯(cashier)／店長(manager)／主管(supervisor)／管理者(admin)。

但新韻傳音已經在 設定 頁自訂過顯示名稱，跟零售預設不同：／／ 三層目前統一顯示為「職員」，只有 （主管）跟 （管理者）維持零售預設、沒有被改。

| 權限層級 | 零售業預設名稱 | 新韻目前實際顯示 | 權限範圍 | | --- | --- | --- | --- | | waiter（最低） | 銷售員 | 職員 | 日常操作：打卡、訂單等基本功能 | | cashier | 櫃檯 | 職員 | 增加結帳付款等權限 | | manager | 店長 | 職員 | 增加審核、查看全員考勤等管理權限 | | supervisor | 主管 | 主管（未改） | 工程/客變/驗收類權限，跟店長屬同一階層（不是店長之上再一級），實際可操作範圍比店長窄 | | admin（最高） | 管理者 | 管理者（未改） | 全部功能，包含設定、操作日誌 |

如何指派

1. 「員工」頁 → 新增或編輯員工 → 「權限等級」下拉選單選擇角色（新韻目前畫面文字多數會看到「職員」，見上表）。
2. 個別員工細部權限（角色之外的加值）：員工列表每個人有一顆「權限」按鈕，管理者可在角色既有權限之上額外多勾幾項能力給特定員工（例如讓某位收銀層級的職員額外查看財務）。規則是只能加、不能減：角色本身已有的項目會預先勾好、反灰、不能取消，勾選的只有「額外開放」的部分。

注意事項 / 常見問題

• 想「拿掉」某人的既有能力，不是用細部權限（它減不了），而是把權限等級改成較低的角色，再把需要的能力逐項加回來。
• 新人自助註冊建立的帳號，權限等級預設是最低的waiter層級（目前顯示為「職員」），之後由管理者視職務調整。
• 權限異動屬於員工資料修改，會留在操作日誌（見142號條目）。
• 如果覺得三層都顯示「職員」容易混淆，可以到 設定 頁的角色名稱自訂功能，把這三層改回有區別的文字。

操作路徑

側邊欄「系統」區 → 操作日誌

功能說明

1. 「操作日誌」頁列出系統內的資料異動紀錄：誰、什麼時間、對哪筆資料做了什麼。
2. 動作類型包含：新增、修改、刪除、簽名、用印、匯出PDF、列印、轉單、作廢，可用篩選條件縮小範圍，看完點「清除篩選」還原。
3. 紀錄是系統層級自動留痕（訂單、商品、打卡紀錄等主要紀錄都掛了同一套稽核機制），修改前後的內容會一併記下，不是靠操作人自己回報。

注意事項 / 常見問題

• 打卡紀錄的手動新增／編輯／刪除（見157、158號條目）同樣會進操作日誌，刪除紀錄的確認訊息也明講「此動作無法在畫面上復原（但仍會留在操作日誌）」。
• 庫存數量的進出異動明細（stock movements）是另一套倉儲專用紀錄，目前沒有查詢畫面，不在操作日誌的涵蓋範圍內——問「誰動了庫存」目前查不到單筆明細（詳見 G 區 SKIPPED 記錄）。

功能說明

目前沒有單一入口的「全站資料匯出／備份」功能。 匯出功能分散在各模組自己的頁面，各自匯各自的：

• 客戶名單：會員頁的匯出功能
• 操作日誌：操作日誌頁
• 出勤／假別資料：出勤管理相關頁面（打卡原始紀錄、每日考勤統計、假別設定、休假額度都是 CSV 匯入/匯出格式）
• 單據：DOCS 各單據的 PDF 輸出

系統的正式資料都存在雲端系統，日常營運資料的保存不依賴客戶自己手動匯出；上述匯出主要用於報表加工、搬移資料或自留存檔。

注意事項 / 常見問題

• 「多久做一次」系統沒有強制規定，也沒有自動排程匯出的功能。如果公司內部有自留備份的習慣，建議固定頻率（例如每月一次）把常用的幾類資料匯出存檔。（細節請洽主管或 ORBIT 客服確認）

操作路徑

員工考勤 → 假別管理

功能說明

「假別管理」頁分兩塊：

1. 假別設定：11 種法定假別系統第一次進來會自動帶入（含給假單位、最小申請單位、是否扣薪、是否需證明等規則）。要調整規則走 CSV 匯入（對應公版 HR 表單的「假別設定」分頁）；網頁上沒有「新增假別」表單，只有刪除。
2. 休假額度與餘額：顯示每位員工各假別的取得日期、額度、已休、剩餘、狀態。這個表格是唯讀的，要調整額度（例如公司額外多給）同樣走 CSV 匯入（對應「額度與結算」分頁，取得日期/到期日期/原始額度/已休時數/狀態/應結算金額原封不動存入，不重算），網頁上沒有單筆手動編輯按鈕。

注意事項 / 常見問題

• 法定特休（L01）不用手動設：系統依台灣勞基法年資公式自動計算，只有特殊約定（公司多給）才需要用匯入覆蓋。
• CSV 匯入時注意：Google Sheets 一次只會匯出目前開啟的分頁，匯入前先切到正確分頁（「假別設定」或「額度與結算」）再另存，欄位對不到會顯示失敗筆數（多半是員編或假別名稱跟系統內不一致）。
• 員工端看自己的假別與額度：見 C 區第32號條目。

操作路徑

側邊欄「系統」區 → 我的合約

畫面說明

「我的合約」頁顯示這間公司跟 ORBIT 的服務合約資訊：

1. 合約期間：合約月數與付款方式（年繳／月繳／另議）。
2. 合約狀態：已簽署／待簽署。
3. 合約期間明細：起始日、到期日、簽約日。
4. 包含功能：

- 基礎功能（所有方案皆含）：POS 收銀結帳、CRM 會員管理、Kitchen 廚房出單、Notify 推播通知、Analytics 基礎報表、Settings 系統設定、AI 基礎對話。 - 加值模組：這份合約有開通的模組清單（例：ERP 資源規劃、HR 人事出勤、AUTH 權限管控、WMS 倉儲管理等）。

1. 查看完整合約：點右下按鈕開啟完整合約文件。
2. 有多份合約時，最新一份顯示在上方，其餘列在「歷史合約」。

注意事項 / 常見問題

• 這一頁是唯讀的：要變更方案、加購模組或續約，系統內沒有自助升級按鈕，請直接聯繫 ORBIT（hello@obarai.com 或側邊欄的 LINE 客服）。
• 尚未建立合約資料時，頁面會顯示「尚無合約資料」。

聯絡管道

1. Email：hello@obarai.com
2. LINE 客服：側邊欄下方常駐「LINE 客服」連結（服務時間 09:30–18:30），點了直接開啟 LINE 對話視窗。

建議的回報內容

系統沒有強制的回報表單，直接描述問題即可。以下是建議附上的資訊（建議做法，非系統規定），能大幅加快處理速度：

1. 發生時間（大約幾點幾分）
2. 操作步驟（在哪個頁面、按了什麼、預期看到什麼、實際看到什麼）
3. 錯誤畫面截圖（畫面上的錯誤訊息文字很關鍵，請完整拍到）
4. 裝置類型（手機／平板／電腦，用什麼瀏覽器）
5. 哪個帳號操作的（方便從操作日誌對照）

操作路徑

員工考勤 → 歷史紀錄與行事曆 → 「每日考勤統計」區塊

欄位解讀

每日考勤統計表格欄位：員工、日期、應出勤、實際出勤、遲到、早退、請假、加班（出勤單位小時，遲到/早退單位分鐘）。

注意事項 / 常見問題

• 這個區塊的定位是歷史彙總紀錄：主要透過 CSV 匯入（對應公版 HR 表單的「每日考勤統計」分頁），匯入的數字原封不動存入、不重算——適合搬移舊系統只留得下彙總數字、沒有原始打卡明細的歷史資料。
• 日常的即時打卡明細在同一頁上方的「打卡原始紀錄」區塊（員工、日期、上下班時間、狀態：正常／遲到／早退／缺勤）。
• 薪資相關的彙總（出勤天、工時、遲到、請假、應付薪資）在「員工」頁的「薪資單」區塊，以當月為單位計算。
• 同一頁還有「公司行事曆」區塊：點「同步政府行事曆」自動帶入中華民國政府行事曆的國定假日／補班日，不用手動填，補班日跟公司自訂假日一起管理。

操作路徑

員工考勤 → 歷史紀錄與行事曆 → 「打卡原始紀錄」區塊 → 「手動新增」按鈕

步驟說明

1. 進入「歷史紀錄與行事曆」頁，「打卡原始紀錄」區塊右上點「手動新增」。
2. 在「手動新增打卡紀錄」視窗選員工與日期，填上班／下班／午休開始／午休結束時間（可只填部分欄位）、狀態與備註。
3. 儲存後即建立該員工當天的打卡紀錄，不用等員工自己送補打卡申請。

注意事項 / 常見問題

• 這條路徑（2026-07-24 上線）跟原本的「員工自己送補打卡申請 → 管理者核准」兩條並存：員工會自己操作的走申請流程留完整軌跡；員工不會操作或忘了申請的，管理者直接代填。
• 代填、以及之後的任何編輯／刪除，都會自動進操作日誌（含修改前後內容與操作人），見158號條目。
• 也可以用 CSV 批次匯入打卡原始紀錄（同區塊的匯入功能，同一員工同一天重複匯入會覆蓋舊資料）。

操作路徑

員工考勤 → 歷史紀錄與行事曆 → 「打卡原始紀錄」區塊 → 每列的「編輯」／「刪除」按鈕

步驟說明

1. 在「打卡原始紀錄」找到要修正的那筆，每列右側有「編輯」「刪除」兩個按鈕。
2. 編輯：開啟「編輯打卡紀錄」視窗（跟手動新增同一個表單），預先帶入現有值，改完儲存。
3. 刪除：有二次確認，訊息明講「確定刪除這筆打卡紀錄？此動作無法在畫面上復原（但仍會留在操作日誌）。」

有無軌跡？

有，系統層級自動留痕。 打卡紀錄表掛了系統既有的通用稽核機制（跟訂單、商品同一套），任何編輯／刪除都會自動記下修改前後的完整內容與操作人，可在「操作日誌」查到——不依賴操作人自己回報。

注意事項 / 常見問題

• 員工自己發現打錯卡（例如午休按成下班），員工端走「補打卡申請」由管理者核准（B區第22號條目）；這裡的編輯／刪除是管理端的直接修正路徑，兩條並存。

功能說明

系統目前沒有「早班／晚班」這種共用的班別範本功能。 相關設定都在「員工」頁的員工檔上，逐人個別設定：

1. 上班時間／下班時間：兩個時間欄位，僅供顯示參考，不影響打卡判定邏輯。
2. 職位（選填）：職級，如經理／主任／專員，自由文字。
3. 職務（選填）：實際工作內容，如電商平台、B2B、會計；不填則顯示權限等級名稱。

注意事項 / 常見問題

• 「職位／職務」是顯示與人事管理用途的欄位，跟系統功能權限無關；權限由「權限等級」（五級角色）決定，見141號條目。
• 因為沒有班別範本，晚班員工的遲到判定不會因為「他是晚班」而不同——打卡判定規則全公司一套（詳見 B 區第154號條目的員工端說明）。

操作路徑

員工 → 該員工列 → 「重設密碼」按鈕

步驟說明

1. 在「員工」頁找到該員工，點「重設密碼」按鈕。
2. 系統直接產生一組新的臨時密碼，畫面只顯示這一次（關掉就查不回來，請先複製）。
3. 管理者把這組密碼告知員工本人，本人即可用「登入信箱＋這組密碼」登入。

注意事項 / 常見問題

• 只對有登入帳號的員工有效：員工尚未建立登入帳號時按鈕會反灰，滑鼠移上去顯示「此員工尚未建立登入帳號，無法重設密碼」。用 LINE／Google 登入的帳號本來就沒有密碼概念，也不適用。
• 這是管理者主動救回帳號用的（員工忘記登入方式、自助重設信收不到、不記得當初用哪個信箱註冊）；跟員工自己在登入頁點「忘記密碼？」收重設信是兩條並存的路徑。
• 別跟「設定 → 主管授權密碼（PIN）」搞混：那是 POS 收銀現場授權折扣／退款用的主管 PIN 碼，不是登入密碼。

先分清楚兩件事

「新據點」在系統裡有兩種完全不同的意思，請先確認你要的是哪一種：

一、同一間公司要加一個「打卡地點」（工地、辦公室、外點）

這是現有功能，自己就能設：設定 → 多據點打卡（工地 / 辦公室）→ 新增據點，填據點名稱（例：三號工地、總部辦公室）、緯度／經度／允許半徑，再到員工檔把人指派到據點即可（見140號條目）。這只是打卡範圍的多點設定，商品、庫存、報表都還是同一間公司一套。

二、要開「新分店」（第二間店，有自己的營運）

這不是系統裡打勾就有的自助功能。標準合約的服務範圍是單店／單分店；要開第二間店，標準做法是為新店另外簽一份合約。如果需求是「總公司＋多間分店」一起管理，ORBIT 可以用客製化報價依實際需求規劃——請直接聯繫 hello@obarai.com 或 LINE 客服洽談，我們會依你的分店數量與管理需求提供方案。

（細節請洽主管或 ORBIT 客服確認）

答案

不算，會被系統當成兩個不同的人。 三種登入方式（LINE／Google／Email＋密碼）各自獨立建立帳號，系統不會自動比對信箱或電話去合併。同一個人如果先用 LINE 登入建了帳號、之後又改用 Google 登入，會產生第二個帳號，兩邊的資料互不相通。

正確做法

1. 第一次登入用哪種方式，以後就固定用那一種——這是最重要的一條。
2. 建議公司在員工到職時就統一規定登入方式（例如全部用 LINE），寫進到職清單（見 P 區第147號條目）。
3. 如果員工不小心用第二種方式登入、發現「資料都不見了」，通常不是資料遺失，是登進了新帳號——退出後改用原本的方式登入即可找回。真的分不清楚時，請管理者對照「員工」頁的員工檔確認綁定狀況，必要時聯繫 ORBIT 處理。

注意事項 / 常見問題

• 目前員工端沒有「把 LINE 帳號改綁到另一個帳號」的自助入口。
• 管理者可用「重設密碼」功能救回走 Email 登入的帳號（見160號條目）。

管理者清單（到職前/當天）

1. 建員工檔：「員工」→「新增員工」，填姓名、電話、權限等級、部門/職位/職務、計薪方式（見 O 區第138號）。或請員工到職當天走自助註冊（下方員工清單第2步），再由管理者補齊權限與薪資欄位。
2. 決定登入方式並告知員工：LINE／Google／Email 擇一，以後固定用同一種（不同方式會被系統當成不同人，見 O 區第162號）。
3. 設定打卡歸屬：員工在非預設地點上班的，在員工檔指派「打卡據點」（見 O 區第140號）。
4. 調整權限等級：自助註冊的帳號預設是最低角色（銷售員），依實際職務調高（見 O 區第141號）。
5. 當場驗證：請員工當場打一次卡，確認選得到自己的名字、打卡有成功訊息——不要等到月底才發現帳號有問題。

員工清單（到職日）

1. 用公司指定的方式登入 ORBIT（第一次登入流程見 A 區第5、6號）。
2. 把 ORBIT 加到手機桌面（A 區第2、3號），允許定位權限（打卡要用，見 B 區第11、12號）。
3. 完成第一次打卡，跟主管確認打卡成功。
4. 看一下自己的假別與額度（C 區第32號）。

流程

1. 結清出勤：確認該員工最後一個工作日的打卡完整；有漏的用管理端代填/編輯補正（O 區第157、158號）。
2. 結清假別：「假別管理 → 休假額度與餘額」確認剩餘額度與應結算金額（依公司規定結算，見 O 區第144號）。
3. 結清薪資：「員工」頁「薪資單」區塊確認當月出勤天/工時/應付薪資。
4. 停用員工檔：「員工」頁把該員工標記為異動（停用）——系統會保留全部歷史考勤/薪資紀錄並自動記下離職日，之後如回任可以恢復（O 區第139號）。
5. 檢查權限：若該員工有額外勾過的細部權限或較高權限等級，停用即失效；但如果他知道主管授權密碼（PIN），記得到「設定」換一組新的 PIN。

注意事項 / 常見問題

• 系統刻意沒有「刪除員工」——停用就是正式做法，歷史資料依法保留。
• 離職員工的操作紀錄仍留在操作日誌，事後可查（O 區第142號）。

先講清楚：系統目前沒有引導式的「開店／關店」結算流程功能（例如現金點驗清單、逐步對帳精靈）。以下是用現有功能組合的建議流程，屬於工作習慣建議，不是系統強制步驟。

開店（建議流程）

1. 到店後打上班卡（B 區第15號）。
2. 開啟「櫃檯」頁確認可以正常進入結帳畫面。
3. 有用出單機的，確認出單機正常（D 區第47號）。

關店（建議流程）

1. 確認當天訂單都已完成結帳、沒有掛著未處理的單（D 區第36號）。
2. 現金櫃清點，跟「報表」頁的當日營收數字核對（I 區第99號）；對不起來的排查見 D 區第49號。
3. 依序打午休（如未打）、下班卡，完成一天四段打卡（B 區第15號）。

注意事項 / 常見問題

• 「設定 → 通知設定」有「日結通知」開關（每天營業結束時發送當日營收摘要，可設日結時間）——這是自動摘要通知，不是結算流程。
• （細節請洽主管或 ORBIT 客服確認）

系統沒有一鍵式的「月結」功能，月底結算是把三個模組各自的確認動作串起來做一遍。財務側的細節另見 I 區第98號（月底財務結算 SOP），這條是跨模組總表。

一、考勤結算

1. 「員工考勤 → 歷史紀錄與行事曆」檢查當月「打卡原始紀錄」：有漏打/打錯的，用管理端編輯/代填補正（O 區第157、158號），或核完員工的補打卡申請（O 區第136號相關流程）。
2. 確認當月假單都已審核完畢，沒有掛著待核准的（O 區第136號）。
3. 「員工」頁「薪資單」區塊核對每人出勤天/工時/遲到/請假/應付薪資。

二、財務結算

照 I 區第98號的財務結算 SOP 走：報表區間選整月、核對營收與毛利、確認數字對得起來（對不起來的排查見 I 區第101號）。

三、發票結算

檢查當月電子發票狀態：有沒有開立失敗、上傳失敗的（I 區第95號），需作廢重開的在時限內處理（I 區第94號）。

注意事項

• （細節請洽主管或 ORBIT 客服確認）

先講清楚系統的現況

ORBIT 目前系統尚未提供此功能離線操作。 系統是雲端服務，結帳、訂單、打卡都需要網路連線才能運作；斷網時已開啟的頁面可能還看得到，但任何送出的動作都不會成功。（系統沒有「離線暫存、恢復後同步」的機制，這點誠實告知，不要期待斷網時打的單會自己補上。）

應變建議（非系統功能，屬現場作業建議）

1. 先切換網路來源：店內 Wi-Fi 斷了，把收銀用的手機/平板切到行動網路（4G/5G）通常就能繼續操作——ORBIT 是網頁服務，不綁定特定網路。
2. 完全斷網時（含停電導致設備都不能用）：改用紙本記錄每筆交易（品項、數量、金額、付款方式、時間），恢復後依紙本逐筆在「櫃檯」補結、需要開發票的補開（D 區第35、44號）。
3. 打卡：斷網期間打不了卡的，恢復後由管理者依實際到勤時間代填（O 區第157號），或員工自己送補打卡申請（B 區第17號）。
4. （細節請洽主管或 ORBIT 客服確認）

員工手機遺失

1. 先鎖登入來源：ORBIT 的登入依附在 LINE／Google／Email 帳號上，第一步是去該平台把遺失手機上的登入登出／停權（LINE 用「換機」或到官方帳號設定登出其他裝置；Google 到帳戶安全頁把該裝置登出；Email 登入的就改密碼）。
2. 通知管理者。管理者視情況處理：

- 走 Email 登入的員工：用「重設密碼」發一組新臨時密碼（O 區第160號），舊密碼即失效。 - 疑慮較大時：直接把該員工檔停用（O 區第139號），確認拿回帳號後再恢復——停用是可逆的，不會弄丟資料。

1. 檢查有沒有異常操作：管理者到「操作日誌」看遺失期間該帳號有無異常動作（O 區第142號）。

管理者手機遺失

除上述步驟外，額外做：

1. 到「設定」更換主管授權密碼（PIN）——這組 PIN 用來授權折扣/退款，知道的人拿到手機就能用。
2. 檢查「設定」內的其他敏感設定有無被動過（操作日誌可對照）。