toko

請款與出款批次

要付錢給廠商、嚮導或員工時,開一張請款單,經主管核准、紙本簽名,再由會計付款。每月月結時,把同一對象的多張請款合成一筆匯款。

請款不是退款

要付給誰走哪個流程
廠商、嚮導、員工佣金請款單(本篇)
客人本人訂單退款,見 訂單與金流模型

即使金額相同,也不要用請款單退錢給客人,反過來也一樣。

請款單的流程

後台 →「款項」→「請款」。

  1. 建立:按「建立請款單」,或從梯次的成本轉請款。可以存成草稿,也可以直接送審。
  2. 送審:建單人按送審。
  3. 核准:主管核准,或填原因退件。退件的單回到草稿,由建單人修改後再送審。
  4. 列印:核准後才能列印 PDF。拿紙本給相關人簽名,系統記下列印時間與簽名人。
  5. 入帳:會計在網銀付款後,按「標記為已付」,填網銀交易序號。出款帳戶與紙本簽名人可選填。
  • 建單人不能核准自己的請款單。
  • 只有建單人能編輯、送審或取消自己的單;管理員不受限。
  • 只有草稿能修改。從梯次成本轉來的請款單不能改明細,金額有錯要取消後重開。
  • 已付款是終態,不能再修改。已取消的單不能恢復,要付款就另開新單。
  • 每次狀態變動都留下稽核紀錄,不能修改。

填寫請款單

欄位說明
對象類別廠商、嚮導、員工佣金或其他
受款人名稱、銀行、分行、帳號、統編或身分證
連結出團選填。這筆款屬於哪個梯次
摘要必填。請款事由
請款明細每筆有類別、項目、數量與單價,加總成應付金額
代扣稅額應付金額減代扣稅額,就是實付淨額

連結梯次時,可以從分房資料帶入住宿明細:系統依住宿廠商彙總房間數、晚數與房費,當作明細草稿。

金額一律是整數台幣。

誰能做什麼

角色檢視建單 / 送審核准 / 退件標記已付列印取消
管理員✅✅✅✅✅✅
線控✅✅❌❌✅✅
業務✅✅❌❌✅✅
會計✅❌✅✅✅❌

嚮導代墊

嚮導先墊付的成本,經會計覆核後,會出現在「請款」頁的嚮導代墊清單。

  • 可以逐筆轉請款。
  • 也可以勾選同一位代墊人的多筆成本,合成一張請款單,可以跨梯次。
  • 代墊人不同的成本不能合併。

出款批次

後台 →「款項」→「出款批次」。這頁屬進階會計模組。

同一個對象一個月常有好幾張已核准的請款單。出款批次把它們合成一筆匯款,產出可匯入網銀的轉帳檔。

  • 一張請款單歸在建立的月份。
  • 只有已核准、還沒付款、還沒進其他批次的請款單會列入。

領隊薪資

「領隊薪資」分頁列出當月嚮導與內勤的應付金額。

  1. 選月份。
  2. 需要時,按「加入出款對象(純行政薪)」加入只領行政薪的人,或在對象列填行政薪外加。
  3. 填扣款項,例如勞健保自付或借支。名目與金額都由你自己填,系統不內建薪資級距或費率。
  4. 勾選對象,建立出款批次。

扣款合計不能超過應付金額。行政薪外加會在批次確認時,自動產生一筆公司營業費用。這需要先建一個代碼為 salary_admin 的費用類別,見 營業費用與損益表。

廠商結帳

「廠商結帳」分頁列出當月每家廠商的應付合計。

  1. 選月份,勾選廠商,建立出款批次。
  2. 複製每家廠商的確認連結,傳給廠商。廠商不用登入,就能核對自己當月的明細並按確認。連結 14 天後失效。
  3. 所有廠商都確認後,才能確認整批出款。

嚮導與員工的列不需要確認。

確認出款與轉帳檔

  1. 在批次列表按確認,填出帳帳戶與網銀批次交易序號(選填)。
  2. 確認後,批次裡的請款單全部標記為已付款,並記入帳戶對帳。
  3. 下載批次轉帳檔,匯入網銀執行轉帳。轉帳檔有收款人戶名、帳號、銀行代號與金額。

收款銀行資料缺漏的對象會標紅,整批擋下,補齊後才能匯出。

廠商目錄

廠商每月重複出現,建一次檔就好。「廠商結帳」分頁下方的廠商目錄記錄名稱、慣用類別與收款銀行(戶名、銀行代號、帳號)。

  • 帳號只顯示末 4 碼。
  • 不用的廠商停用,不刪除。
  • 系統不預載任何廠商或銀行,由你自己填。
›API 與 CLI 對應

請款單:

用途端點權限
列表 / 單張 / 統計GET /payment-requests、GET /payment-requests/{id}、GET /payment-requests/statspayable.read
建立 / 修改草稿POST /payment-requests、PATCH /payment-requests/{id}payable.create
送審POST /payment-requests/{id}/submitpayable.submit
核准 / 退件POST /payment-requests/{id}/approve、POST /payment-requests/{id}/rejectpayable.approve
記錄列印 / 簽名POST /payment-requests/{id}/mark-printed、POST /payment-requests/{id}/mark-signedpayable.print、payable.create
標記已付POST /payment-requests/{id}/mark-paid(必填 bankReference)payable.mark_paid
取消POST /payment-requests/{id}/cancelpayable.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-accountssupplier.read
建立批次POST /payouts/batchessupplier.read
產生廠商確認連結POST /payouts/lines/{lineId}/confirm-tokensupplier.read
確認批次POST /payouts/batches/{id}/confirmpayable.mark_paid
下載轉帳檔GET /payouts/batches/{id}/transfer-filepayable.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}/submitoperationId
核准POST /api/v1/payment-requests/{id}/approveoperationId、expectedSubmissionId
退回POST /api/v1/payment-requests/{id}/rejectoperationId、expectedSubmissionId、reason

核簽前先讀 GET /api/v1/payment-requests/{id},把 submissionEventId 放進 expectedSubmissionId。草稿沒有送審版本,欄位為 null。

json
{
  "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:

bash
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

相關指南

Command Palette

Search for a command to run...