請款與出款批次
要付錢給廠商、嚮導或員工時,開一張請款單,經主管核准、紙本簽名,再由會計付款。每月月結時,把同一對象的多張請款合成一筆匯款。
請款不是退款
| 要付給誰 | 走哪個流程 |
|---|---|
| 廠商、嚮導、員工佣金 | 請款單(本篇) |
| 客人本人 | 訂單退款,見 訂單與金流模型 |
即使金額相同,也不要用請款單退錢給客人,反過來也一樣。
請款單的流程
後台 →「款項」→「請款」。
- 建立:按「建立請款單」,或從梯次的成本轉請款。可以存成草稿,也可以直接送審。
- 送審:建單人按送審。
- 核准:主管核准,或填原因退件。退件的單回到草稿,由建單人修改後再送審。
- 列印:核准後才能列印 PDF。拿紙本給相關人簽名,系統記下列印時間與簽名人。
- 入帳:會計在網銀付款後,按「標記為已付」,填網銀交易序號。出款帳戶與紙本簽名人可選填。
- 建單人不能核准自己的請款單。
- 只有建單人能編輯、送審或取消自己的單;管理員不受限。
- 只有草稿能修改。從梯次成本轉來的請款單不能改明細,金額有錯要取消後重開。
- 已付款是終態,不能再修改。已取消的單不能恢復,要付款就另開新單。
- 每次狀態變動都留下稽核紀錄,不能修改。
「標記為已付」只是記下你已經付了這筆錢。系統不會替你轉帳,實際匯款仍由會計在網銀完成。
填寫請款單
| 欄位 | 說明 |
|---|---|
| 對象類別 | 廠商、嚮導、員工佣金或其他 |
| 受款人 | 名稱、銀行、分行、帳號、統編或身分證 |
| 連結出團 | 選填。這筆款屬於哪個梯次 |
| 摘要 | 必填。請款事由 |
| 請款明細 | 每筆有類別、項目、數量與單價,加總成應付金額 |
| 代扣稅額 | 應付金額減代扣稅額,就是實付淨額 |
連結梯次時,可以從分房資料帶入住宿明細:系統依住宿廠商彙總房間數、晚數與房費,當作明細草稿。
金額一律是整數台幣。
誰能做什麼
| 角色 | 檢視 | 建單 / 送審 | 核准 / 退件 | 標記已付 | 列印 | 取消 |
|---|---|---|---|---|---|---|
| 管理員 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| 線控 | ✅ | ✅ | ❌ | ❌ | ✅ | ✅ |
| 業務 | ✅ | ✅ | ❌ | ❌ | ✅ | ✅ |
| 會計 | ✅ | ❌ | ✅ | ✅ | ✅ | ❌ |
嚮導代墊
嚮導先墊付的成本,經會計覆核後,會出現在「請款」頁的嚮導代墊清單。
- 可以逐筆轉請款。
- 也可以勾選同一位代墊人的多筆成本,合成一張請款單,可以跨梯次。
- 代墊人不同的成本不能合併。
出款批次
後台 →「款項」→「出款批次」。這頁屬進階會計模組。
同一個對象一個月常有好幾張已核准的請款單。出款批次把它們合成一筆匯款,產出可匯入網銀的轉帳檔。
- 一張請款單歸在建立的月份。
- 只有已核准、還沒付款、還沒進其他批次的請款單會列入。
領隊薪資
「領隊薪資」分頁列出當月嚮導與內勤的應付金額。
- 選月份。
- 需要時,按「加入出款對象(純行政薪)」加入只領行政薪的人,或在對象列填行政薪外加。
- 填扣款項,例如勞健保自付或借支。名目與金額都由你自己填,系統不內建薪資級距或費率。
- 勾選對象,建立出款批次。
扣款合計不能超過應付金額。行政薪外加會在批次確認時,自動產生一筆公司營業費用。這需要先建一個代碼為 salary_admin 的費用類別,見 營業費用與損益表。
廠商結帳
「廠商結帳」分頁列出當月每家廠商的應付合計。
- 選月份,勾選廠商,建立出款批次。
- 複製每家廠商的確認連結,傳給廠商。廠商不用登入,就能核對自己當月的明細並按確認。連結 14 天後失效。
- 所有廠商都確認後,才能確認整批出款。
嚮導與員工的列不需要確認。
確認出款與轉帳檔
- 在批次列表按確認,填出帳帳戶與網銀批次交易序號(選填)。
- 確認後,批次裡的請款單全部標記為已付款,並記入帳戶對帳。
- 下載批次轉帳檔,匯入網銀執行轉帳。轉帳檔有收款人戶名、帳號、銀行代號與金額。
收款銀行資料缺漏的對象會標紅,整批擋下,補齊後才能匯出。
廠商目錄
廠商每月重複出現,建一次檔就好。「廠商結帳」分頁下方的廠商目錄記錄名稱、慣用類別與收款銀行(戶名、銀行代號、帳號)。
- 帳號只顯示末 4 碼。
- 不用的廠商停用,不刪除。
- 系統不預載任何廠商或銀行,由你自己填。
›API 與 CLI 對應
請款單:
| 用途 | 端點 | 權限 |
|---|---|---|
| 列表 / 單張 / 統計 | GET /payment-requests、GET /payment-requests/{id}、GET /payment-requests/stats | payable.read |
| 建立 / 修改草稿 | POST /payment-requests、PATCH /payment-requests/{id} | payable.create |
| 送審 | POST /payment-requests/{id}/submit | payable.submit |
| 核准 / 退件 | POST /payment-requests/{id}/approve、POST /payment-requests/{id}/reject | payable.approve |
| 記錄列印 / 簽名 | POST /payment-requests/{id}/mark-printed、POST /payment-requests/{id}/mark-signed | payable.print、payable.create |
| 標記已付 | POST /payment-requests/{id}/mark-paid(必填 bankReference) | payable.mark_paid |
| 取消 | POST /payment-requests/{id}/cancel | payable.cancel |
| 住宿明細建議 | GET /payment-requests/supplier-suggestions?departureId=... | payable.create |
- 狀態
status:draft、submitted、approved、paid、cancelled。退件不是狀態,退件的單回到draft,並帶rejectedAt與rejectionReason。 - 對象類別
payeeType:supplier、guide、staff_commission、other。 - 金額:
amountTwd(應付)、taxAmountTwd(代扣稅額)、netAmountTwd(實付淨額)。 - 建立時帶
submitImmediately可直接送審。明細items[]每筆有category、description、quantity、unitPriceTwd。
出款批次與廠商目錄:
| 用途 | 端點 | 權限 |
|---|---|---|
| 彙整當月應付 | GET /payouts/aggregate?period=YYYY-MM&scope=... | supplier.read |
| 可匯款帳戶 | GET /payouts/remit-accounts | supplier.read |
| 建立批次 | POST /payouts/batches | supplier.read |
| 產生廠商確認連結 | POST /payouts/lines/{lineId}/confirm-token | supplier.read |
| 確認批次 | POST /payouts/batches/{id}/confirm | payable.mark_paid |
| 下載轉帳檔 | GET /payouts/batches/{id}/transfer-file | payable.mark_paid |
| 廠商目錄 | GET /suppliers、GET /suppliers/{id} | supplier.read |
| 新增 / 修改廠商 | POST /suppliers、PATCH /suppliers/{id} | supplier.manage |
scope:guide、supplier、staff。- 廠商欄位:
name、categoryHint、payeeAccountName、payeeBankCode、payeeAccountNumber、status(active或inactive)。 - 出款批次與廠商目錄端點都需要進階會計模組。
›請款單送審與核簽的重試(API)
請款單的送審、核准與退回都要帶 operationId(1 至 128 字元)。第一次送出前產生並保存;重試時沿用原值與原內容。不同操作用新的識別。
| 操作 | 端點 | 必填 |
|---|---|---|
| 送審 | POST /api/v1/payment-requests/{id}/submit | operationId |
| 核准 | POST /api/v1/payment-requests/{id}/approve | operationId、expectedSubmissionId |
| 退回 | POST /api/v1/payment-requests/{id}/reject | operationId、expectedSubmissionId、reason |
核簽前先讀 GET /api/v1/payment-requests/{id},把 submissionEventId 放進 expectedSubmissionId。草稿沒有送審版本,欄位為 null。
{
"operationId": "payable-reject-20261023-001",
"expectedSubmissionId": "al_example_submission",
"reason": "請確認受款資料"
}- 送審需要
payable.submit,且操作人須為建單人或管理員。核准與退回需要payable.approve;建單人不能核准自己的請款單,但可以退回。 - 已完成操作的重試回
ok: true,不再轉移狀態或通知。這只表示原操作已完成;重試後重新讀取明細。 - 同一帳號重用
operationId卻改了動作、請款單、送審版本或退回原因,回409 conflict。核簽指向舊送審版本也回409 conflict;重新讀取後由使用者確認新版本,不要自動改送。 - 送審成功後,可核簽的後台帳號收到鈴鐺通知;核准與退回結果通知送審人。通知只有單號與結果。
CLI 用 --operation-id 與 --submission-id:
toko payment-requests submit "$REQUEST_ID" --operation-id payable-submit-20261023-001 --confirm
toko payment-requests get "$REQUEST_ID" --json
toko payment-requests approve "$REQUEST_ID" --operation-id payable-approve-20261023-001 --submission-id "$SUBMISSION_ID" --confirm
toko payment-requests reject "$REQUEST_ID" --reason '請確認受款資料' --operation-id payable-reject-20261023-001 --submission-id "$SUBMISSION_ID" --confirm