toko

裝備租借

把登山裝備借給旅客。租金與押金在現場收付、記在租借單上,不計入訂單應收。可借量依租期自動計算。

裝備租借屬登山模組。未開通時,後台看不到這一頁。

什麼時候用

  • 旅客報名登山團,需要租睡袋、冰爪、頭燈等裝備。
  • 線控在出團前盤點:這一梯要借多少、和同期其他梯次搶不搶同一批裝備。
  • 旅客還裝備時,點交數量、登記破損,再處理押金。

裝備主檔與庫存

在後台 →「資源」→「裝備」的「裝備主檔 / 庫存」分頁維護品項。每個品項填:

欄位意思
品名、分類、規格例:睡袋、寢具、-10°C
單位租金每件每日的租金
押金每件押金,歸還驗收後退還
總數庫存總量
維修中維修或報廢中、不能出租的件數
啟用停用後不再開放新租借,既有租借單不受影響

品項表有兩個數字,意思不同:

  • 目前在倉: 總數 − 目前在外 − 維修中。「目前在外」是已交付還沒歸還的件數,加上歸還時短少的件數。已開單但還沒交付的預留,東西還在倉庫,不算在外。
  • 今日可借: 今天還能再借出的件數。已登記在今天的租借單都會扣掉,包括還沒交付的。

可借量依租期計算。 某段租期可借 = 總數 − 維修中 − 這段租期內任一天已登記的最多件數。日期不重疊的梯次可以各自先開單。例:岩盔共 15 頂,11/8–10 的單借 14 頂,11/22–24 的單仍可借 15 頂;與前單重疊的 11/9–11 最多借 1 頂。

  • 起訖日都算在內:前單 11/10 還、後單 11/10 借,算重疊。
  • 過了迄日還沒歸還的單,一直占用到歸還驗收。沒填迄日的單也一樣。
  • 提早或延後歸還,從實際歸還當天起釋出。歸還時短少的件數不再釋出。
  • 交付時,系統會再檢查一次存量。前一張單逾期還沒還,或提早交付時起日之前已借給別張單,系統會擋下交付。交付後從交付當天起占用。

這些數字都由租借單自動計算,不能手改。要調整庫存,改總數或維修中。改到總數扣除維修少於今天以後已登記的件數時,系統會擋下。

頁首的「存量吃緊」提醒只看今天的可借量。其他日期的可借量,在新增租借時選租期就會顯示。

開租借單

每張租借單綁定一張訂單與一個梯次。從「租借單」分頁按「新增租借」,或在梯次的出團準備裡開單。

  1. 選訂單。訂單報名多個梯次時,再選這批裝備跟哪一梯出團。
  2. 填租借人、租借起訖日。品項旁的可借量會依這段租期重新計算。
  3. 加入品項與數量。超出這段租期的可借量時,畫面直接提示。
  4. 送出。系統依租期再檢查一次庫存。訂單的應收與付款狀態不變。

開單條件:

  • 梯次的行程是登山團,並在行程設定開了「可租借裝備」;梯次沒有取消。
  • 訂單是行程訂單、未取消或完成,而且報名了這個梯次。
  • 每個品項在這段租期都要夠借。任一品項不足,整張單都不成立。多人同時開單也不會超借。

計價規則:

  • 租金 = 每日租金 × 晚數 × 件數。 晚數是起訖日相差的天數,至少算 1。沒填起訖日也算 1。
  • 押金 = 每件押金 × 件數,不乘天數。
  • 開單當下的價格會固定在這張單上。之後改主檔價格,不影響已開的單。

收付勾記

租借單的「收付」記下現場收付的錢。每次勾記都留下時間、經手人與稽核紀錄。

  • 租金已收: 收到租金時勾記。勾錯了可以改回未收。
  • 押金已收: 收到押金時勾記。押金為 0 的單沒有這一項。
  • 押金已退或沒收: 歸還後登記退還客人與沒收的金額,兩者相加要等於押金。沒收用於抵扣破損或遺失。登記錯了可以清除再登記。

押金已收、還沒登記退還的單不能取消。

2026-11 以前開的單,租金可能已隨訂單付款收進公司戶頭。這種單顯示「租金已收(TOKO 收款,遷移前)」,不能改回未收。

修改租期

未歸還的單可以按「改租期」。系統依新租期重新檢查可借量,不夠就不存檔。

  • 只改日期,不改金額。 租金與押金維持開單時的金額。天數變了要多收或退租金,請在現場處理。
  • 逾期的單延到今天以後,狀態會回到「租借中」。
  • 已歸還或已取消的單不能改租期。

交付、歸還與取消

txt
新增租借 → 交付裝備 → 歸還驗收 → (有押金)確認押金結清
  • 交付裝備: 把裝備交到旅客手上時按「交付裝備」。已交付的單不能直接取消。
  • 歸還驗收: 逐品項填歸還數量,可以少於借出量。有破損或遺失就填賠償金額。一張單只能歸還一次,送出前請點清全部數量。
  • 取消單: 只用在開錯的單(掛錯訂單、選錯品項、數量打錯)。取消會回補庫存,這張單不再收錢。必須填取消原因。

取消的限制:

  • 已交付的單要先歸還驗收,不能取消。
  • 已取消的單不能再取消或歸還。
  • 押金已收、還沒登記退還時,不能取消。先在現場退還押金並登記。
  • 租金已收的單,取消後請在現場退還客人。

押金與賠償

歸還驗收只做點交與結算狀態,不會自動退錢。押金與賠償都在現場處理,不進訂單。

歸還結果對款狀態下一步
無破損、押金沒收或已退已對款不用再處理
無破損、押金已收還沒退押金待退退還押金,在「收付」登記,再按「確認押金結清」
有破損押金待退沒收押金抵扣賠償,不足的現場收;登記後確認對款

押金已收但還沒登記退還或沒收時,「確認押金結清」會被擋下。沒有押金、但有賠償待對款的單,按鈕叫「確認賠償對款」。

逾期

過了租期末日仍沒歸還的單,系統定期自動標成「逾期」,也可以手動標記。

  • 逾期只改狀態。裝備仍在旅客手上,所以逾期的單一直占用庫存,到歸還驗收為止。
  • 逾期的單照常可以歸還驗收結案。
  • 逾期但還沒交付的單可以取消。

在「租借單」分頁用「歸還狀態:逾期」篩選,就能列出所有逾期未還的單。

查詢租借單

「租借單」分頁可以依歸還狀態、梯次、品項與租期區間篩選。

租期區間問的是「這段時間有哪些裝備在外面」。只要租期和區間有重疊就列出。例: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 的項目。

狀態值:

欄位值
returnStaterented 未歸還、returned 已歸還、overdue 逾期、cancelled 已取消
reconStatepending 待對款、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。

相關指南

Command Palette

Search for a command to run...