裝備租借
把登山裝備借給旅客。租金與押金在現場收付、記在租借單上,不計入訂單應收。可借量依租期自動計算。
裝備租借屬登山模組。未開通時,後台看不到這一頁。
什麼時候用
- 旅客報名登山團,需要租睡袋、冰爪、頭燈等裝備。
- 線控在出團前盤點:這一梯要借多少、和同期其他梯次搶不搶同一批裝備。
- 旅客還裝備時,點交數量、登記破損,再處理押金。
裝備主檔與庫存
在後台 →「資源」→「裝備」的「裝備主檔 / 庫存」分頁維護品項。每個品項填:
| 欄位 | 意思 |
|---|---|
| 品名、分類、規格 | 例:睡袋、寢具、-10°C |
| 單位租金 | 每件每日的租金 |
| 押金 | 每件押金,歸還驗收後退還 |
| 總數 | 庫存總量 |
| 維修中 | 維修或報廢中、不能出租的件數 |
| 啟用 | 停用後不再開放新租借,既有租借單不受影響 |
品項表有兩個數字,意思不同:
- 目前在倉: 總數 − 目前在外 − 維修中。「目前在外」是已交付還沒歸還的件數,加上歸還時短少的件數。已開單但還沒交付的預留,東西還在倉庫,不算在外。
- 今日可借: 今天還能再借出的件數。已登記在今天的租借單都會扣掉,包括還沒交付的。
可借量依租期計算。 某段租期可借 = 總數 − 維修中 − 這段租期內任一天已登記的最多件數。日期不重疊的梯次可以各自先開單。例:岩盔共 15 頂,11/8–10 的單借 14 頂,11/22–24 的單仍可借 15 頂;與前單重疊的 11/9–11 最多借 1 頂。
- 起訖日都算在內:前單 11/10 還、後單 11/10 借,算重疊。
- 過了迄日還沒歸還的單,一直占用到歸還驗收。沒填迄日的單也一樣。
- 提早或延後歸還,從實際歸還當天起釋出。歸還時短少的件數不再釋出。
- 交付時,系統會再檢查一次存量。前一張單逾期還沒還,或提早交付時起日之前已借給別張單,系統會擋下交付。交付後從交付當天起占用。
這些數字都由租借單自動計算,不能手改。要調整庫存,改總數或維修中。改到總數扣除維修少於今天以後已登記的件數時,系統會擋下。
頁首的「存量吃緊」提醒只看今天的可借量。其他日期的可借量,在新增租借時選租期就會顯示。
開租借單
每張租借單綁定一張訂單與一個梯次。從「租借單」分頁按「新增租借」,或在梯次的出團準備裡開單。
- 選訂單。訂單報名多個梯次時,再選這批裝備跟哪一梯出團。
- 填租借人、租借起訖日。品項旁的可借量會依這段租期重新計算。
- 加入品項與數量。超出這段租期的可借量時,畫面直接提示。
- 送出。系統依租期再檢查一次庫存。訂單的應收與付款狀態不變。
開單條件:
- 梯次的行程是登山團,並在行程設定開了「可租借裝備」;梯次沒有取消。
- 訂單是行程訂單、未取消或完成,而且報名了這個梯次。
- 每個品項在這段租期都要夠借。任一品項不足,整張單都不成立。多人同時開單也不會超借。
計價規則:
- 租金 = 每日租金 × 晚數 × 件數。 晚數是起訖日相差的天數,至少算 1。沒填起訖日也算 1。
- 押金 = 每件押金 × 件數,不乘天數。
- 開單當下的價格會固定在這張單上。之後改主檔價格,不影響已開的單。
租借單不動訂單金流。租金與押金不算進訂單應收、尾款與收據。錢在現場收付,再到租借單上勾記。
收付勾記
租借單的「收付」記下現場收付的錢。每次勾記都留下時間、經手人與稽核紀錄。
- 租金已收: 收到租金時勾記。勾錯了可以改回未收。
- 押金已收: 收到押金時勾記。押金為 0 的單沒有這一項。
- 押金已退或沒收: 歸還後登記退還客人與沒收的金額,兩者相加要等於押金。沒收用於抵扣破損或遺失。登記錯了可以清除再登記。
押金已收、還沒登記退還的單不能取消。
2026-11 以前開的單,租金可能已隨訂單付款收進公司戶頭。這種單顯示「租金已收(TOKO 收款,遷移前)」,不能改回未收。
修改租期
未歸還的單可以按「改租期」。系統依新租期重新檢查可借量,不夠就不存檔。
- 只改日期,不改金額。 租金與押金維持開單時的金額。天數變了要多收或退租金,請在現場處理。
- 逾期的單延到今天以後,狀態會回到「租借中」。
- 已歸還或已取消的單不能改租期。
交付、歸還與取消
新增租借 → 交付裝備 → 歸還驗收 → (有押金)確認押金結清- 交付裝備: 把裝備交到旅客手上時按「交付裝備」。已交付的單不能直接取消。
- 歸還驗收: 逐品項填歸還數量,可以少於借出量。有破損或遺失就填賠償金額。一張單只能歸還一次,送出前請點清全部數量。
- 取消單: 只用在開錯的單(掛錯訂單、選錯品項、數量打錯)。取消會回補庫存,這張單不再收錢。必須填取消原因。
歸還與取消不同。 歸還表示服務已提供,租金照收;取消表示這張單不該存在,不收錢。 已歸還的單不能取消。
取消的限制:
- 已交付的單要先歸還驗收,不能取消。
- 已取消的單不能再取消或歸還。
- 押金已收、還沒登記退還時,不能取消。先在現場退還押金並登記。
- 租金已收的單,取消後請在現場退還客人。
押金與賠償
歸還驗收只做點交與結算狀態,不會自動退錢。押金與賠償都在現場處理,不進訂單。
| 歸還結果 | 對款狀態 | 下一步 |
|---|---|---|
| 無破損、押金沒收或已退 | 已對款 | 不用再處理 |
| 無破損、押金已收還沒退 | 押金待退 | 退還押金,在「收付」登記,再按「確認押金結清」 |
| 有破損 | 押金待退 | 沒收押金抵扣賠償,不足的現場收;登記後確認對款 |
押金已收但還沒登記退還或沒收時,「確認押金結清」會被擋下。沒有押金、但有賠償待對款的單,按鈕叫「確認賠償對款」。
逾期
過了租期末日仍沒歸還的單,系統定期自動標成「逾期」,也可以手動標記。
- 逾期只改狀態。裝備仍在旅客手上,所以逾期的單一直占用庫存,到歸還驗收為止。
- 逾期的單照常可以歸還驗收結案。
- 逾期但還沒交付的單可以取消。
在「租借單」分頁用「歸還狀態:逾期」篩選,就能列出所有逾期未還的單。
查詢租借單
「租借單」分頁可以依歸還狀態、梯次、品項與租期區間篩選。
租期區間問的是「這段時間有哪些裝備在外面」。只要租期和區間有重疊就列出。例:9/28 借、10/3 還的單,查 10 月也查得到。只填起日、沒填迄日的單,起日之後每一天都算在外面。
換梯時的裝備
旅客換梯時,換梯預覽會列出每張租借單的狀態。有租借單擋住時,不能確認換梯。逐張選一種處理方式:
- 解除: 釋回庫存。訂單金流不變。
- 改訂到新梯次: 填新租期,可改品項與數量。系統依新租期與目前價格開新單,並在同一個操作裡解除原單。庫存不足時全部不變。
已交付的單要先歸還驗收、結清押金,再重新預覽換梯。處理完後重新預覽,再確認換梯。放棄換梯時,先解除替代的租借單,再回原梯次另開一張。另開的單依當時價格計費,不會恢復原價。
出團裝備需求
裝備需求是線控在梯次層級的盤點:這一梯預計要借多少。它不扣庫存。真正動到庫存的只有租借單。
- 在梯次的出團準備裡,每個品項填一個需求量。再填一次是覆寫,不是累加。
- 只有開放租借裝備的登山團梯次能填需求。刪除不受這個限制。
- 系統把同一段日期內各梯次對同一品項的需求加總,與可租量比較。超過或吃緊時會提醒。
›API 與 CLI 對應
所有端點見 equipment API。
| 動作 | 端點 |
|---|---|
| 列出品項 | GET /api/v1/equipment/items |
| 新增品項 | POST /api/v1/equipment/items |
| 修改品項 | PATCH /api/v1/equipment/items/{id} |
| 列出租借單 | GET /api/v1/equipment/rentals |
| 開租借單 | POST /api/v1/equipment/rentals |
| 讀單一租借單 | GET /api/v1/equipment/rentals/{id} |
| 修改租期 | POST /api/v1/equipment/rentals/{id}/dates |
| 交付 | POST /api/v1/equipment/rentals/{id}/deliver |
| 歸還驗收 | POST /api/v1/equipment/rentals/{id}/return |
| 取消 | POST /api/v1/equipment/rentals/{id}/cancel |
| 標記逾期 | POST /api/v1/equipment/rentals/{id}/mark-overdue |
| 確認押金結清 | POST /api/v1/equipment/rentals/{id}/reconcile-deposit |
| 換梯前處理租借單 | POST /api/v1/orders/{id}/departure-change-equipment |
| 新增或覆寫梯次需求 | POST /api/v1/departures/{depId}/prep/equipment-needs |
| 刪除梯次需求 | DELETE /api/v1/departures/{depId}/prep/equipment-needs/{id} |
權限: 讀取要 equipment.read,寫入要 equipment.manage。寫入另需登山模組,未開通回 403 module_disabled。換梯前處理另要 order.update 與訂單負責範圍。
品項欄位: name、category、spec、rentPriceTwd(每日租金)、depositTwd、totalCount、outCount(目前在外)、maintenanceCount、inStockCount(目前在倉)、availableCount(指定租期可借)、isActive。列出與讀取品項可帶 rentFrom、rentTo(YYYY-MM-DD,端點含)指定 availableCount 看哪段租期;都不帶看今天,只帶起日表示一直租下去。
修改租期: 選填 rentStartDate、rentEndDate。省略的一端不改,null 清空。成交租金不變。
開單: orderId、departureId、lines(每筆 itemId + qty),選填 renterName、rentStartDate、rentEndDate、notes。明細回傳 rentPriceTwdSnapshot、depositTwdSnapshot;單據回傳 rentalCode、rentTotalTwd、depositTotalTwd。
歸還: returnedLines(每筆 lineId + returnedQty),選填 damageCostTwd。取消: 必填 reason。回應的 reversedReceivableTwd 恆為 0,retentionDeferred 恆為 false,只為相容保留。
收付勾記: 列出與讀取租借單都回傳 rentCollectedAt、rentCollectedByName、rentCollectedVia(onsite 現場收、order_payment 遷移前隨訂單收款)、depositCollectedAt、depositCollectedByName、depositSettledAt、depositSettledByName、depositRefundedTwd、depositForfeitedTwd。未勾記時為 null。勾記只能在後台做。
收付標記: 列出與讀取租借單也回傳 moneyMarks,是系統依勾記算出的狀態,與後台顯示的一致。rent 的 state 為 due 未收、done 已收、refund_due 單已取消但租金已收(要退)。deposit 的 state 為 due 未收、held 已收待退、done 已結清(另帶 refundedTwd、forfeitedTwd)。沒有要收付的項目為 null,例如已取消且沒收過錢的單,或金額為 0 的項目。
狀態值:
| 欄位 | 值 |
|---|---|
returnState | rented 未歸還、returned 已歸還、overdue 逾期、cancelled 已取消 |
reconState | pending 待對款、reconciled 已對款、deposit_pending 押金待退 |
清單篩選: returnState、reconState、orderId、departureId、equipmentItemId、rentFrom、rentTo(重疊判準,端點含)。
換梯處理: 帶 rentalId、targetDepartureId、participationVersion、reason。mode=release 解除;mode=rebook 另帶 rentStartDate、rentEndDate,可選 lines。相同條件重送回同一個 replacementRentalId,不同條件回 409。
錯誤: 庫存不足、改總數或維修數低於已登記的租借、狀態不允許(已歸還再歸還或取消、梯次不開放租借等)回 409;品項或租借單不存在回 404。