toko

出團準備與線控

出團準備以梯次為單位。你鎖定一個梯次,把這團要辦的事一次辦完,不必一張訂單一張訂單處理。

從梯次總覽進入

後台 →「梯次」→「梯次總覽」列出時間範圍內的所有梯次。點一個梯次,進入該梯次的頁面。

梯次總覽有四種檢視:

檢視用途
總覽一列一梯,看階段、抽籤、客人、承辦、餐食、期限、派車、保險、團費與缺件。
列表每梯一張可展開的卡片,看旅客名單,並執行成團、送籤、催尾款等梯次操作。
月曆依日期看各梯次。
甘特依期間看各梯次的長度與重疊。

時間範圍可選未來 7、60、90、180 天、未來一年、本月、下月或自訂區間。預設是未來 180 天。「我負責的團」只列你是承辦的梯次。「只看需注意」只列有缺件或警示的梯次。

「總覽」檢視可直接點備註、隨團人員與承辦格編輯。備註按 Enter 儲存,Shift + Enter 換行;出團準備上方會顯示同一份備註。隨團人員沿用出團準備的指派、確認與移除流程,檔期衝突及實名綁定規則不變。沒有對應寫入權限時,格子維持唯讀。階段仍透過既有動作變更。

備註寫入需 trip.manage。員工 API 可用 PATCH /trips/departures/{departureId} 的 notes 更新,傳 null 清空,省略則不變更。隨團人員指派需同時有 departure_prep.manage 與 guide_roster.manage;確認與移除需 guide_roster.manage。

梯次頁的上方分頁是「概覽 · 訂單 · 出團準備 · 分房 · 成本 · 損益」。本篇的作業大多在「出團準備」分頁。它的左側再分成四組:

分組子分頁
人員隨團人員、名單 & 出團待辦
後勤派車、餐食、出發前夜住宿、裝備租借
保險與證件旅責險、登山險、證件、調查項
款項與期限供應商付款、期限警戒

這一梯用不到的子分頁不顯示。例:非登山團沒有登山險、證件與裝備租借;行程沒有調查題目時沒有調查項。「隨團人員」的實際名稱是貴公司設定的職稱(例:「領隊 & 導遊」)。

›API 與 CLI 對應
  • 梯次清單:GET /departures/control。可帶 range(future_7、future_60、future_90、future_180、future_365、this_month、next_month,或 custom 配 from/to)、trip、status、mine。
  • 一梯的出團準備整包(隨團人員、派車、餐食、出發前夜住宿、裝備租借單、證件、待辦、投保):GET /departures/{depId}/prep,CLI 為 control prep <depId>。外部排程每梯讀一次即可。
  • 出團名單:GET /departures/{depId}/manifest。名單體檢:GET /departures/{depId}/validation-summary。
  • 讀取需 departure_prep.read;寫入(分房以外)需 departure_prep.manage;分房需 departure.update。

承辦

每個梯次可掛一位以上承辦(op 或 admin 帳號),回答「這團是誰在顧」。承辦管營運,與訂單的業務歸屬是兩件事;承辦也不是隨團人員。

指派承辦的入口:

  • 梯次頁「出團準備」分頁上方的承辦列:按「指派承辦」,搜尋後按「指派」。
  • 梯次總覽「總覽」檢視的承辦格:點人名就掛上或移除。
  • 梯次總覽勾選多個梯次,選承辦,按「指派承辦」。已是承辦的梯次會略過,完成後回報成功、略過與失敗的梯數。
  • 批次匯入梯次時填「承辦」欄,見行程與梯次。

新梯次也可以自動輪流帶入承辦:後台 →「公司設定」→「出團作業」→「梯次承辦輪流」。國內線與海外線各一份名單,照順序輪流,到底再從頭。之後在梯次頁改承辦,不影響輪到誰。名單空的就不帶入。

本梯不需要承辦時,在「出團準備」上方按「本梯不需承辦」,填寫原因後儲存。已有承辦時,先移除承辦。標記後不再列為「未派承辦」缺件;其他缺件仍會列入關注。按「撤銷不需承辦」會回到未派承辦,指派人員也會自動清除標記。標記與撤銷都記錄原因供稽核。

›API 與權限
  • 指派承辦需 departure_prep.manage。梯次清單的 opNames 列出承辦姓名;mine 篩選只對 op/admin 生效。
  • GET /departures/control 的 opNotRequiredReason 是不需承辦的原因;未標記時為 null。標記與撤銷目前從後台操作。
  • 移除一筆指派:DELETE /departure-op-assignments/{id}。
  • 輪流名單:GET /settings/departure-owner-rotation 讀兩份名單與下一位;PUT /settings/departure-owner-rotation 取代其中一份。需 role.manage。

成團

「還能不能賣」與「確定出團」是兩件事。梯次在銷售中,不代表已成團。

  • 成團由承辦手動確認。 人數達到行程的「最低成團人數」時,梯次總覽會提示,但系統不自動成團。未達門檻仍可人工成團。
  • 在梯次總覽「列表」檢視的梯次卡片按「標記成團」,確認後按「確認成團」。要撤回就按「退回成團」。
  • 成團不改變販售狀態,也不通知旅客。催尾款、同意書提醒都要另外按。
  • 成團時,行程有設「每幾位旅客配一位隨團人員」的話,系統會帶入還沒填的「需要隨團人員數」。
  • 退回未成團不會取消已寄出的尾款連結,客人仍可付款。要停收,請走取消與退款。
  • 整梯未成團時,用卡片「更多」選單的「宣告整梯未成團」。系統自動停售,訂單依序走備案;沒有可用備案就進保留區,款項留在原單。備案成功寄換梯通知,進保留區寄未成團通知。結果列出備案成功、進保留區、略過張數,以及略過單號與原因。跨梯訂單要逐張處理。已成團或已結團的梯次不能宣告。只處理部分訂單時,在名單勾選後按「未成團」。
  • 要恢復時,在保留區逐張「返回原梯次」。原梯次須尚未出發且有位,售票狀態由承辦另行改回。
  • 出團結束後,在卡片「更多」選單按「結團」。已確認的訂單會改為完成,有登山難度評鑑的行程會記入旅客的登山經歷。
  • 梯次狀態已是「已完成」、但還有已確認訂單時(沒經過結團就改了狀態),「結團」仍可以按。按下後補完成這些訂單並記入登山經歷。

最低成團人數以佔位人數計算,包含未付款的保留席,不含候補。

›API 與 CLI 對應
  • 切換成團:POST /departures/{depId}/confirmation。梯次的 confirmedAt 是成團時間,取消梯次不會清掉它,判斷下游資格時要一併看梯次是否取消。
  • 結團:POST /departures/{depId}/complete。
  • 宣告整梯未成團:POST /departures/{depId}/cancel-group-not-confirmed。先啟用保留區。系統停售後逐張處理,不增加送件次數。
  • 以上都需 departure.update。

成團後批次催尾款

成團後,在梯次總覽卡片的「更多」→「批次寄尾款」,一次寄出全梯的尾款繳款單。

  • 對象:訂金已付、訂單未取消、尾款還沒結清的訂單。抽籤梯次只寄給已中籤的訂單。
  • 同一張訂單在同一次參團已寄過的會略過。換梯後的訂單可以再寄。
  • 處理到一半時梯次被取消或退回未成團,剩下的訂單停止寄送。
  • 結果分成功、略過、失敗與「因梯次不符資格未寄」。請逐筆核對失敗的訂單。缺少尾款訊息範本時,可能已建好付款連結卻沒寄信,先補範本再重寄。
›API 與 CLI 對應

POST /departures/{depId}/send-balance-slips(departure.update)。CLI:control send-balance-slips <depId> --confirm --json。

出團待辦

每個梯次有一份出團待辦清單,在「名單 & 出團待辦」子分頁逐項勾選。已勾的項目,滑鼠移上去可看勾選人與時間。

  • 團層級:一團勾一次,例:收款、領隊、交通、餐食、保險、證件、裝備、名單。
  • 旅客層級:每位旅客勾一次,例:「已進 LINE 群」。只用在出團前。
  • 出團前/出團後:只有出團前的項目影響「備辦完成,可出團」的提示;出團後的收尾項目另計進度。
  • 這一團不適用的項目,標「本團不適用」並寫原因,就不計入完成度。

待辦項目由貴公司自己維護:後台 →「範本」→「出團待辦目錄」,或在「名單 & 出團待辦」子分頁按「管理待辦目錄」。可新增、改名、調整順序、停用或刪除。已有梯次勾過的項目只能停用,不能刪除。

每條路線要用哪幾項,在行程編輯頁「營運規則」分頁的「出團準備項目」勾選。沒勾選的行程,顯示所有啟用中的項目。

›API

切換團層級待辦:POST /departures/{depId}/prep/checklist。旅客層級勾選目前只有後台介面。

名單凍結期修改

出發前 6 天內,員工確認提醒後改了名單,入山證與投保名冊可能要重新送件。下列修改會在梯次留下一筆待處理:

  • 改到姓名、英文姓名、身分證號、護照號、生日或國籍。只改飲食等其他欄位不算。
  • 新增或移除旅客。
  • 拆出旅客到別的梯次:原梯次一筆;目標梯次也在凍結期時,目標梯次也一筆。

梯次總覽的「待辦與需注意」把同一梯次的待處理修改合成一條紅色待辦。出團準備頁在分頁列上方逐筆列出訂單、旅客、操作、改到的欄位、操作者與時間。重新送件與投保後,按「已重新送件與投保」。只標掉畫面上列出的那幾筆,之後的新修改會另外列出。需要出團準備的管理權限。

旅客待辦總覽與同行組

「名單 & 出團待辦」子分頁另有一張旅客總覽表,逐位旅客列出:

欄內容
同行組誰跟誰一夥,見下方。
人工勾選旅客層級待辦。
資料完整度完整、待補(只有提醒)、有誤、已豁免。由旅客資料自動算出。
同意書已簽最新版、未簽、不適用(貴公司還沒建立 PDPA 範本)。

完整度與同意書都由系統算出,不能手動改。要改完整度,就去補旅客資料。同意書是訂單層的狀態,要由該訂單完成簽署。已取消的訂單不列入。

同行組記錄誰跟誰一夥,嚮導在現場靠它分車、分通鋪:

  • 同一張訂單的旅客預設同組。分開下單的朋友也可以圈成同一組。
  • 每組有代號(A、B、C…)與顏色,在名單、分房、嚮導端與送籤視窗都一致。
  • 在總覽的同行組欄改組、開新組,或選「不屬任何組」。
  • 旅客換梯次時不帶走原組。旅客從訂單移除時一併出組。
  • 同行組不影響金額、契約、席次,也不影響送籤分組。
›API 欄位

名單 GET /departures/{depId}/manifest 的 companionGroupCode 是組別代號,companionGroupColor 是顏色序號。CLI control manifest-export 與團控名冊 CSV 都有「同行組」欄。改組目前只有後台介面。

調查項彙整與同意書提醒

「調查項」子分頁逐題彙整人數、姓名、數量與自由文字,不含已取消的訂單。旅客選到已停用的選項時仍會列出並標示,方便你聯絡對方改選。

  • 餐點回答不會自動寫進餐食安排。
  • 裝備意願不會自動開租借單、扣庫存或計價。

自訂同意書要由訂購人簽署,承辦不能代簽。成團後才要求的同意書,只在梯次已成團且未取消時才需要簽;抽籤訂單還要已中籤。發布新版會要求重簽。

成團不會自動寄同意書提醒。要提醒客人,在梯次總覽卡片的「更多」→「寄同意書提醒」。每按一次就寄一次,不會略過已寄過的人。

題目設定與答案規則見旅客與個資。

›API
  • 讀有效題目:GET /departures/{depId}/survey。
  • 停用梯次選項:PATCH /departures/{depId}/survey-options/{optionId}。
  • 寄同意書提醒:POST /departures/{depId}/send-consent-reminders(departure.update)。目前沒有營運端的簽署 API。

分房

分房分兩階段:客人下單時登記偏好(自動配房、指定房友、加價單人房),出團前由承辦在梯次頁「分房」分頁正式排房。

  1. 按「新增房間」建房,或按「複製上一梯房間」(還沒建房時可用)。
  2. 按「自動配對分房建議」看系統建議。它依同性別與指定房友分組,確認後才建房並指派。
  3. 也可以逐位指派,或用「批次指派」。
  4. 用「匯出」下載「分房表 CSV」或「分房表 xlsx」,或「列印分房表」,交給山屋、嚮導或保險使用。

規則:

  • 房間人數不能超過床位數,性別必須相符。
  • 把旅客排進加價房型,會在訂單新增一筆應收並產生補款入口,不會偷偷改大已付款的訂單。金流規則見訂單與金流模型。
  • 分房表的電話會遮罩,不含證件號、護照與成本。
  • 已取消訂單的旅客保留分房紀錄,但不占床位。
  • 旅客只有入住本梯次的房間才算已分房。換梯過來、還留著別梯分房的旅客,會在待分配名單出現,要個別改派。自動配對與批次指派不會覆寫既有分房。
  • 「複製上一梯房間」採用最近一個較早的梯次,包含已取消梯次的手動設定。
  • 工作台的「待分房梯次」只算未來 180 天內、在售或已關售、已建房且還有旅客沒分的梯次。只有通鋪床位池的梯次不列入。
›API
  • 建房與列表:POST /departures/{depId}/rooms、GET /departures/{depId}/rooms。
  • 自動配對:GET /departures/{depId}/rooms/auto-pair-preview 只回建議,不寫入;POST /departures/{depId}/rooms/auto-pair-apply 依建議建房並指派。
  • 逐位指派:POST /rooms/{roomId}/travelers;取消指派:DELETE /rooms/travelers/{travelerId}。
  • 分房表資料:GET /departures/{depId}/rooming-export。每列有 travelerId;CSV 不輸出這欄。

隨團人員

在「隨團人員」子分頁指派嚮導。角色分主要與協同,狀態分「待確認」與確認。只有確認的指派算進已派人數。確認後,嚮導可以登入嚮導 portal 回填現場成本與資料。

  • 需要幾位:在子分頁填「本梯需要幾位嚮導」(0–99)。填 0 表示不需嚮導,該梯不會列「隨團人員不足」。留空表示未填,不檢查是否派滿。
  • 行程可設「預設需要幾位嚮導」,新梯次自動帶入。行程也可設「每幾位旅客配一位隨團人員」,成團時依佔位人數無條件進位,帶入還沒填的梯次。兩者都不覆寫已填的值。
  • 梯次頁標頭顯示「隨團人員 已派/需要」。已成團且人數不足時,缺件列出「隨團人員不足」。
  • 已換領:入山/入園證上的人換成這位嚮導後,在他下方勾「已換領」。系統記下勾的人與時間。只有確認的指派可以勾,一位嚮導一個勾。子分頁標題與梯次總覽的嚮導格顯示「換領 已勾/確認人數」。
  • 換成別的嚮導、改角色(例:協同換成主要)、退回待確認,「已換領」都會清掉,要重新勾。
  • 「已換領」只是人工確認,不會改動申請單,也不會自動勾出團待辦。
  • 換人或檔期衝突請到後台 →「梯次」→「帶團排班」處理。
  • 職稱在後台 →「公司設定」→「出團作業」→「隨團人員職稱」設定,例:領隊/導遊、嚮導/協作嚮導。

嚮導建檔與排班見嚮導與排班。

›API 與權限

POST /departures/{depId}/prep/guides 指派,角色值 leader(主要)或 assistant(協同),狀態 tentative(待確認)或 confirmed。需同時有 departure_prep.manage 與 guide_roster.manage;檔期衝突回 409。梯次的 requiredGuideCount 經梯次更新寫入;行程欄位為 defaultGuideCount 與 travelersPerGuide。

GET /departures/{depId}/prep 的 guides[] 帶 permitSwappedAt(勾「已換領」的時間,未勾為 null)與 permitSwappedByName(勾的人)。GET /departures/control 的每一列帶 permitSwappedCount(確認的指派中已勾的人數)。勾「已換領」只能在後台操作,需 guide_roster.manage。

GET /departures/{depId}/prep/guides 讀這一梯的隨團人員資料:指派、出發月的嚮導名冊與載量、證照到期提示、已派/需要與換領進度。需 departure_prep.read。名冊的正式姓名要 guide_pii.read,內部備註要 guide.read,沒有權限時為 null。回應的 canAssign(指派)與 canManageRoster(確認與移除)是呼叫者的權限。梯次總覽點嚮導格時用這支讀取。

派車、餐食、投保

派車、餐食、旅責險、登山險各有一個子分頁,記錄安排狀態:

子分頁記什麼
派車路段、名冊司機與本梯次電話、車牌、車型、車資備註、狀態
餐食供應商、餐食方案、人數備註、狀態
旅責險、登山險保險公司、保單號、排定日(可以開始辦的日子,不是期限)、投保人數、狀態

司機名冊

司機名冊在「資源 → 司機」維護,可新增、編輯或停用,並選填所屬車行。派車可搜尋司機姓名,也可就地新增。選取後自動帶入電話、車牌與車型;本梯次可覆寫,修改不會回寫名冊。停用司機不再出現在選單,既有梯次照常顯示快照。

派車狀態為「未安排」「司機未定」「已安排」。總覽派車欄顯示狀態與司機姓名。沒有派車列時顯示「—」。多筆派車全部完成才顯示已安排;有司機未定時顯示司機未定,其餘顯示未安排。未全部安排時另顯示已安排筆數,例如「司機未定 1/3」。

派車 API 可傳 driverId 選取啟用中的名冊司機。省略 driverName、driverPhone、licensePlate、vehicleType 時,自動帶入所選司機資料;顯式值可覆寫本梯次快照。變更司機時才重新帶入,未變更司機時保留快照。driverId: null 解除名冊關聯,快照保留;舊有 driverName 與 vehicleInfo 寫入方式仍可使用。status 接受 pending、driver_pending、arranged。司機名冊目前由後台維護。

行程預設:新梯次自動帶入

同一條路線每梯的車型、餐食供應商、保險公司通常相同。在行程編輯頁「營運規則」分頁的「出團作業預設」設好,之後新建的梯次會自動帶入派車、餐食、投保列,狀態為待安排或待投保。司機與保單號再逐梯選填。

  • 改預設不會回頭改既有梯次。既有梯次在「出團準備」分頁按「補套行程預設」補上缺的列。重複按不會產生重複列,也不會動到人工加的列。
  • 保險預設可填「出發前 N 個工作天」。系統扣週末與國定假日、計入補班日,帶出投保排定日。改出發日時,還沒投保的列會跟著重算。
  • 集合時間與地點由行程設定,梯次留空就沿用行程的值,要例外才逐梯填。有行前集合夜時,集合日是出發前一天。
›API
  • 新增:POST /departures/{depId}/prep/transport、POST /departures/{depId}/prep/catering、POST /departures/{depId}/prep/insurance。
  • 修改與刪除:PATCH /departures/{depId}/prep/transport/{id}、DELETE /departures/{depId}/prep/transport/{id},餐食與投保同形。修改是部分更新:省略的欄位不動,給 null 才清空。該列不屬於這個梯次時回 404。
  • 投保列可帶 expectedUpdatedAt 防止蓋掉別人的修改:填 GET /departures/{depId}/prep 讀到的那一列 updatedAt。讀取後該列被別人改過時回 409,請重新讀取再改。省略就不檢查。
  • 投保險種 liability(旅責險)或 climbing(登山險)。
  • 行程預設:GET /trips/{id}/ops-defaults、PUT /trips/{id}/ops-defaults。補套到既有梯次:POST /departures/{depId}/prep/ops-defaults/apply(departure_prep.manage),回應帶各補了幾列。

期限警戒與到期待辦

期限警戒提醒你別錯過保險、名單、申請等截止日。它不受登山模組限制,所有租戶都能用。

期限從哪裡來。 在後台 →「範本」→「期限範本」設定每種期限從哪一天回推、提前幾天:

  • 基本範本套用到所有行程。海外範本隨行程模組開通,只套用到海外團。登山與抽籤範本各自需要對應模組;抽籤範本只套用到抽籤梯次。
  • 也可以建自訂範本,在行程編輯頁「營運規則」分頁的「期限規則」勾選。
  • 同一事項在多個範本中出現時,取較早的期限。
  • 改範本不會改既有梯次的日期,要在梯次上按「重算」。
  • 新租戶只有「旅責險投保期限」一項。開啟登山、海外或抽籤模組時,系統加入對應期限種類與建議天數,你可以依內規修改。

在梯次上處理。 梯次頁「期限警戒」子分頁列出每個期限的提醒日、最後期限與倒數:

  • 急迫度分四級:逾期、超級緊急、可以開始、注意準備。
  • 辦完按「標記完成」;這團不用做就按「本梯不適用」並寫原因。兩者都會讓事項離開到期待辦。
  • 「重算」依範本重算日期,只覆寫公式算出的日期,不動人工設定的日期。

跨梯次看。 後台 →「梯次」→「到期待辦」把所有梯次的期限依急迫度排在一起。可切換「今天該動手」或「全部」,視角可選全公司、我負責的團、未指派或某位承辦。「日期設定異常」卡列出該有期限卻沒有日期的事項,按「重算」修正。

硬期限通知。 後台 →「公司設定」→「出團作業」→「硬期限通知」開啟後,硬期限當天系統用後台鈴鐺通知該梯承辦;沒有承辦時通知管理員。每個期限只通知一次,不寄信。可設定發送時刻(台北時間),預設關閉。

假日表

工作天倒數要扣國定假日、計入補班日。後台 →「參考資料」→「假日表」維護這張表。

  • 系統不會自動匯入,每年年初請自己匯入當年資料。
  • 按「新增假日」逐筆新增,或按「批次匯入」從試算表貼上多行。每行寫「日期,名稱,類別」,類別填「國定假日」或「補班」,省略視為國定假日。同一日期會覆寫。任一行有錯,整批不寫入。
  • 補班日一定要標成「補班」,否則倒數會少算一天。
  • 沒有資料的年度只扣週末,期限會偏晚,畫面會提示「假日資料不完整」。
›API
  • 設定期限日期:POST /departures/{depId}/prep/deadlines。標記完成:POST /departures/{depId}/prep/deadlines/done。標記不適用(需原因):POST /departures/{depId}/prep/deadlines/not-applicable。重算:POST /departures/{depId}/prep/deadlines/recompute。
  • 跨梯次到期待辦:GET /departure-prep/deadlines(departure_prep.read)。
  • 假日表:GET /holidays、PUT /holidays/{date}、DELETE /holidays/{date}、POST /holidays/batch、GET /holidays/stats。讀取需 public_holiday.read,寫入需 public_holiday.manage。

裝備需求與租借(登山)

登山模組開啟、行程是登山團且開了「可租借裝備」時,「裝備租借」子分頁可以:

  • 登記需求量:逐品項登記這一梯要借多少。系統會加總鄰近日期各梯次對同款裝備的需求,與同一段日期的可借量比對。超過庫存標「缺」,剩 2 件以內標「低水位」。
  • 直接開租借單:指定要掛費用的訂單、租借人、租期與品項數量。租借費用進那張訂單的應收。

需求登記不扣庫存;真正借出走訂單的租借流程。詳見裝備租借。

›API
  • 需求量:POST /departures/{depId}/prep/equipment-needs(同品項再送就覆寫)、DELETE /departures/{depId}/prep/equipment-needs/{id}。行程不是登山團或沒開可租借裝備時回 409。回應帶跨梯次彙總警示(shortage、lowStock)。
  • 開租借單:POST /departures/{depId}/prep/rentals,需 departure_prep.manage 與 equipment.manage。庫存不足或品項不存在回 409。回應帶 rentalId。

證件與送籤(登山)

登山團的「證件」子分頁追蹤入山證、入園證、床位等證件,以及每張入山入園申請單。送籤要用的旅客資料由梯次總覽的「匯出送籤資料」產生。這些作業見入山入園申請與送籤。

出發前夜住宿

行程指定了公司內部住宿據點時,梯次頁有「出發前夜住宿」子分頁。你可以替旅客登記床位、記抵達時間、勾清潔費,並產生旅客自助登記連結。規則見訂房。

供應商付款與請款

「供應商付款」子分頁有兩塊:

  • 付款登記:按「新增付款」記下日期、經手人、付款渠道、付給誰與金額。退費記負數。頁面顯示合計與各渠道小計。付款渠道要先在後台 →「公司設定」→「收款帳戶」開啟供應商付款用途。登記只留紀錄,不寫成本,也不走核簽。
  • 對帳:唯讀顯示團費收齊度,以及供應商、裝備、住宿的應付未付(已付、已轉未付、未轉)。

成本登記與請款是另一條路:在梯次頁「成本」分頁登記成本,再把選定的成本轉成請款單,經核簽後出款。見梯次成本與範本與請款與出款批次。對客人收款與退款見付款流程。

›API 與 CLI 對應
  • 一梯的付款登記:GET /departures/{depId}/supplier-payments。跨梯次依付款日期區間(含頭尾,最多 366 天):GET /supplier-payments?from=&to=,回應另帶 totalTwd。兩者都需 payment.read。刪除的登記不再出現;退費是另一筆負數。CLI:control supplier-payments <depId>、control supplier-payments-range --from <date> --to <date>。
  • 對帳:GET /departures/{depId}/finance-summary。
  • 成本與請款:POST /departures/{depId}/costs、POST /departures/{depId}/payables;核簽見 payment-requests API。

出團名單的金額欄

梯次總覽的「匯出名冊」與出團名單 API 會帶每張訂單的應收。會計用它寄取消費收據或對帳時,注意:

  • 名單預設不列已取消訂單,要另外指定才會列出。
  • 對帳請用整單應收,不要加總每人分攤金額(分攤會四捨五入,加總可能差幾元)。
  • 已取消的訂單,整單應收改為公司留下的錢:百分比退改費、定額行政費與已完成退款的行政手續費。匯款手續費算在已退裡,不是應收。
  • 退款執行完後,「已收 − 已退(客人實拿+匯款手續費)− 整單應收」應為 0。不是 0 表示還有錢留在單上,請找承辦確認。
›名單 API 欄位

GET /departures/{depId}/manifest:

  • 每位旅客帶 travelerId,用它對人,不要用姓名。climbingExperience 列出登山經歷(名稱、完成日、來源);登山模組未啟用時是空陣列。
  • ?includeCancelled=true 一併列出已取消訂單的旅客,這些列的 orderStatus 為 cancelled。
  • staffNote 是該單的承辦備註(例:要跟某人同團、沒中籤改某梯),同一張單每列相同;沒有備註時為 null。只有後台與員工 API 看得到。
  • orderReceivableTwd 是整單會計應收,同一張單每列相同。amount 是每人分攤後四捨五入的數字。
  • 未取消的單:orderReceivableTwd 等於訂單應收,cancellationFeeTwd 與 refundFeesTwd 為 null。
  • 已取消的單:orderReceivableTwd = cancellationFeeTwd(取消費)+ refundFeesTwd(已完成退款的行政手續費,不含匯款手續費)。
  • percentageFeeTwd 是百分比退改費;fixedAdminFeeTwd 是定額行政費。changeFeeTwd 是不退的換梯費;unclassifiedFeeTwd 是分類未知的歷史費用。
  • refundRemainingTwd 是還要退,包含尚未完成的退款。此值不等於可再建立退款的額度。
  • 取消費還沒核算且單上還有現金時,orderReceivableTwd 與 cancellationFeeTwd 為 null,cancellationFeePending 為 true。

模組與權限

作業適用範圍
承辦、成團、待辦、分房、隨團人員、派車、餐食、旅責險、期限警戒、假日表、供應商付款所有租戶
證件、申請單、登山險、裝備租借登山模組開啟且行程是登山團
出發前夜住宿訂房模組開啟且行程指定了據點

權限細節見權限與角色。

相關指南

Command Palette

Search for a command to run...