Appearance
超商代碼下撥
路徑：/admin/settlement/cvs | 快捷鍵：7 → A
管理超商代碼（CVS）訂單的下撥作業，支援「依規則」與「自訂」兩種下撥模式。
頁籤切換
頁面上方提供兩個頁籤：
| 頁籤 | 說明 |
|---|---|
| 按撥款天數設定 | 根據各商戶設定的撥款天數規則，自動計算應下撥的訂單 |
| 自行選擇日期 | 手動選擇日期範圍與商戶，自由勾選訂單進行下撥 |
按撥款天數設定
系統根據每個商戶的撥款天數規則設定，自動計算截止日期並列出所有符合條件的待下撥訂單。
下撥規則說明
| 規則格式 | 說明 | 範例 |
|---|---|---|
T/N | 營業日計算，排除週末與國定假日 | T/0 表示當日下撥、T/3 表示 3 個營業日後 |
D/N | 曆日計算，含週末 | D/5 表示 5 個曆日後 |
TIP
T 規則（營業日）會參照系統的國定假日設定來排除假日。
表格欄位
| 欄位 | 說明 |
|---|---|
| NO. | 列表序號 |
| 商戶代碼 | 商戶識別碼（等寬字型） |
| 商戶名稱 | 商戶顯示名稱 |
| 撥款天數 | 規則格式（如 T/0、D/5） |
| 撥款日期 | 根據撥款天數規則計算的日期區間（例如 T/0 為當日） |
| 繳費筆數 | 符合條件的訂單數量 |
| 繳費總額 | 符合條件的訂單金額合計 |
| 服務費總額 | 訂單金額 × 服務費率 的總和 |
| 手續費總額 | 訂單數 × 每筆手續費 的總和 |
| 下撥金額 | 繳費總額 − 服務費 − 手續費（翠綠色粗體） |
| 操作 | 查看明細按鈕 |
表格左上角顯示符合條件的 筆數，右上角為 「一鍵下撥」 按鈕（無可下撥資料時自動禁用）。
查看訂單明細
點擊操作欄的檔案圖示，開啟彈窗顯示該商戶的待下撥訂單清單：
- 摘要統計：繳費筆數、繳費總額、服務費總額、手續費總額、下撥金額
- 訂單表格：
- 勾選框（可全選）
- 付款時間
- 訂單號（等寬字型）
- 訂單金額
- 服務費
- 手續費
- 下撥金額
勾選訂單後可執行「批次下撥」。
自行選擇日期
手動指定日期範圍與商戶，查詢已付款但尚未下撥的訂單並進行下撥。
篩選條件
| 篩選項目 | 說明 |
|---|---|
| 日期範圍 | 訂單付款日期範圍，預設為最近 7 天 |
| 商戶 | 選擇特定商戶 |
摘要統計
篩選結果上方顯示五欄統計：
| 統計 | 說明 |
|---|---|
| 繳費筆數 | 符合條件的訂單數 |
| 繳費總額 | 訂單金額合計（$） |
| 服務費總額 | 服務費總和 |
| 手續費總額 | 手續費總和 |
| 下撥金額 | 繳費總額 − 服務費 − 手續費（翠綠色） |
訂單表格
| 欄位 | 說明 |
|---|---|
| 勾選框 | 勾選要下撥的訂單，表頭有全選功能 |
| 付款時間 | 訂單付款完成時間 |
| 訂單號 | 系統訂單號（等寬字型） |
| 訂單金額 | 訂單金額（粗體，$ 前綴） |
| 服務費 | 該筆訂單的服務費 |
| 手續費 | 該筆訂單的手續費 |
| 下撥金額 | 訂單金額 − 服務費 − 手續費（翠綠色粗體） |
批次下撥
勾選訂單後，點擊「批次下撥」按鈕，系統會顯示確認彈窗：
| 確認項目 | 說明 |
|---|---|
| 商戶名稱 | 下撥對象 |
| 繳費筆數 | 勾選的訂單數量 |
| 繳費總額 | 勾選訂單的金額合計 |
| 服務費總額 | 紅色文字，帶 − 前綴 |
| 手續費總額 | 紅色文字，帶 − 前綴 |
| 下撥金額 | 實際撥入金額（翠綠色粗體） |
確認後系統將下撥任務送入背景佇列（BullMQ）非同步執行，不會阻塞畫面。下撥進度透過 WebSocket 即時推播，完成後頁面自動重新載入資料。
非同步下撥
大量訂單的批次下撥改為背景佇列處理，避免長時間等待或阻塞 API。下撥過程中可繼續操作其他頁面。
超商自動下撥（站點限定）
部分站點可在商戶資料管理的超商設定中，為個別商戶開啟超商區塊的 「自動下撥」 開關。開啟後該商戶的超商訂單在繳費完成當下就會自動觸發下撥，將款項結算至商戶雲帳戶，不需要在本頁人工操作。
自動下撥的撥款紀錄一樣可在撥款歷程查到，操作者欄位顯示為「系統」，IP 顯示為「-」。
觸發時機共三種：
| 時機 | 說明 |
|---|---|
| 供應商回調 | 超商實際繳費完成、供應商回報付款成功時 |
| 人工補登 | 管理員於超商訂單查詢補登繳費資料時 |
| 人工補發回調 | 先前因預約異常被阻擋的訂單，管理員補發回調成功後補觸發 |
預約異常的訂單不會自動下撥
若訂單被標記為 預約異常且回調被阻擋，自動下撥會 跳過 該筆訂單。這類訂單需人工確認後補發回調，屆時才會觸發下撥，避免異常資料直接入帳。
開啟後撥款天數與退款不再適用
已自動下撥的訂單不會出現在本頁的待下撥清單，該商戶的撥款天數設定對這些訂單不再有作用；訂單狀態直接變為「已下撥」，因此也無法再標記退款。
TIP
此功能與 ATM 頁的 ATM 自動下撥彼此獨立，各自有各自的商戶開關，互不影響。
費用計算公式
| 費用項目 | 計算方式 |
|---|---|
| 服務費 | 每筆訂單金額 × 服務費率（%），逐筆無條件進位（CEIL），再加總 |
| 手續費 | 訂單筆數 × 每筆手續費（固定金額） |
| 下撥金額 | 繳費總額 − 服務費總額 − 手續費總額 |
服務費計算
服務費採逐筆 CEIL（無條件進位）計算，確保每筆訂單的服務費至少為 1 元。預覽資料由後端 API 計算，與實際下撥結果一致。
WARNING
下撥操作會將訂單狀態從 SUCCESS 變更為 SETTLED，此操作無法復原。
雙人審核（站點限定）
部分站點啟用 雙人審核 機制，下撥不再由單一管理員直接執行，必須由 另一位 管理員核准後才會實際下撥。
運作流程
- 管理員勾選訂單後點擊下撥，確認彈窗的按鈕會顯示為 「送出審核」（而非「批次下撥」）
- 送出後建立一筆審核請求，訂單 尚未 下撥
- 頁面上方出現橘色的 「待審核」 卡片，所有有權限的管理員都看得到
- 由另一位管理員核准後，系統才實際執行下撥
待審核卡片
| 項目 | 說明 |
|---|---|
| 申請人 | 送出此次下撥申請的管理員 |
| 申請時間 | 送出審核的時間 |
| 訂單筆數 | 本次申請包含的訂單數量 |
| 剩餘時間 | 距離自動過期的倒數（橘色 Badge） |
| 明細 | 展開後顯示各商戶的商戶代碼、商戶名稱、繳費筆數、繳費總額 |
操作按鈕
| 角色 | 可用操作 |
|---|---|
| 申請人本人 | 取消 —— 撤回自己送出的申請 |
| 其他管理員 | 核准 —— 立即執行下撥 駁回 —— 需填寫駁回備註後送出 |
不可自審
送出申請的管理員無法核准自己的申請，只能取消。這是雙人審核機制的核心設計，確保下撥一定經過兩個人。
30 分鐘自動過期
審核請求送出後 30 分鐘 內未被處理會自動過期，需要重新送出申請。過期後訂單不會被下撥。
即時同步
待審核卡片透過 WebSocket 即時更新。其他管理員送出、核准、駁回或取消申請時，你的畫面會立即反映，不需重新整理。
權限
| 權限代碼 | 說明 |
|---|---|
settlementCvs.review | 審核（核准／駁回）超商代碼的下撥申請 |
settlementAtm.review | 審核（核准／駁回）ATM 的下撥申請 |
settlementCreditCard.review | 審核（核准／駁回）信用卡的下撥申請 |
每個下撥頁面的待審核卡片只列出自己這種付款方式的申請；沒有該付款方式的審核權限時，卡片上不會出現核准／駁回按鈕。
INFO
這些權限僅在啟用雙人審核的站點才會出現在角色列表的權限編輯彈窗中，預設已分配給系統管理員（systemAdmin）角色。
權限
超商代碼、ATM、信用卡三個下撥頁面的權限各自獨立，只勾本頁的權限不會連帶開放 ATM 或信用卡下撥（詳見角色列表 → 下撥權限依付款方式分開授權）。
| 權限代碼 | 說明 |
|---|---|
settlementCvs.read | 查看本頁與待下撥數量 |
settlementCvs.settle | 執行下撥（沒有此權限時不會出現下撥按鈕） |
settlementCvs.review | 審核超商代碼的下撥申請（僅雙人審核站點，見上方雙人審核） |
簡化下撥模式（站點限定）
部分站點啟用簡化下撥模式，與標準模式的差異如下：
| 項目 | 標準模式 | 簡化模式 |
|---|---|---|
| 訂單明細 | 顯示每筆訂單明細 | 不顯示訂單明細 |
| 下撥金額 | 由系統自動計算（不可編輯） | 可手動編輯下撥金額 |
| 差異額顯示 | - | 自訂金額與系統計算金額不同時，顯示差異額（正數為多撥、負數為少撥） |
| 撥款歷程 | 預設展開 | 預設收合 |
| 被阻擋訂單 | 包含在下撥中 | 自動過濾排除被阻擋的訂單 |
| 一鍵下撥 | - | 無可下撥資料時按鈕自動禁用，防止空操作 |