toko

換梯與拆單

換梯保留同一張訂單與已付的錢;拆單把一位旅客和他分到的款項搬到新訂單。

三種換梯

換梯方式誰操作團費換梯手續費
同行程換梯承辦保留原成交價與原折扣不自動收,需要時人工掛帳
跨行程換梯承辦改用目標行程的現行價不自動收,可填人工調整
客人自助換梯客人改用目標梯次的現行價自動收,等於當下那一級的退改費

三種方式都保留訂單編號、旅客與現金紀錄。換梯不是取消再重訂。

承辦換梯

  1. 在訂單頁按「更多」→「換梯(同行程)」或「換梯(跨行程)」。
  2. 選目標梯次,填換梯原因。
  3. 按「預覽換梯」,核對新應收、下一筆要收的錢、文件與待辦。
  4. 按「確認換梯」。

確認時系統會重新檢查名額、價格與權限。預覽後訂單、名冊、款項或目標梯次有變動時,要重新預覽。

規則:

  • 停售或額滿的原梯次可以換出。 原梯次須未出發、未取消、未結團,且已占名額足夠。
  • 停售的先到先得梯次有位即可換入。 候選標示「已停售」,預覽會提醒占用名額。換完仍維持停售,前台不恢復販售。停售抽籤梯次不可轉入,請使用團控人工安置;安置目標仍須在售。
  • 同行程換梯不重算團費。 目標牌價不同也照原成交價。既有的掛帳、少收與已執行的減應收退款都保留。要加收或少收,先在訂單「款項」分頁處理,再重新預覽。
  • 跨行程換梯重新報價。 價格照原成交的直客或同業通路,讀目標的現行價(含促銷)。可以直接填一筆人工調整:正數加收、負數少收。開啟「少收必須經核准」時,非管理員不能填負數,請改送手動少收申請。
  • 抽籤梯次另需權限。 換進或換出抽籤梯次,需要抽籤模組與抽籤管理權限。換進抽籤梯次後要重新應募,原梯次的中籤資格不會帶過去。
  • 有未結的退款單時不能換梯。 草稿、待核准、待執行或處理中的退款單,要先結案。

跨行程報價

選「換梯(跨行程)」後,先看報價再決定:

  • 報價分列原團費、目標團費、原折扣、本次調整、價差、已付、已退、可退額度與付款期限。
  • 報價不佔名額、不扣折扣碼名額、不改應收,有效 15 分鐘。
  • 目標可以用行程名稱、日期、梯次標籤搜尋,每次最多列 50 筆。

原本用的折扣碼會依報價當天的設定重新檢查:

  • 仍適用:繼續使用,不再扣名額。折抵金額依目標團費重算。
  • 不再適用:折扣退出,名額歸還一次。之後取消或再換梯,都不會再歸還或恢復。
  • 折扣碼的分潤已轉成請款單、且換梯會改變分潤金額或受款人時,不能確認。請款單還沒付時先取消它;已付時先在分潤端人工處理。

換梯後的款項

換梯後,系統依新應收重建收款計畫:

  • 訂金還沒付足時,補到目標梯次的訂金規則。已付足的訂金不重收。
  • 其餘照目標梯次的尾款期限。期限已過就立即到期。
  • 舊的付款連結與 ATM 帳號失效。沒有欠款時,不建立零元的付款入口。
  • 已付比新應收多時,可在後台選「退款」或「保留給本人」。退款建立草稿,不直接退錢。
  • 保留須有退款建立權限,且符合未出發的一般會員訂單資格。換梯與轉保留一起完成,不建退款草稿。
累計入款已退現金新應收結果
10,0003,0008,000已收淨額 7,000,尚欠 1,000,不開退款草稿
8,00006,000退回草稿 2,000,或保留 2,000 給本人

換梯前已經在付款中的款項不會被擋。舊付款入口失效後才到的款項,經金額、來源與簽章核對後,仍入同一張訂單一次。系統依新應收重算尚欠,多出來的部分再開退款草稿。

›換梯 API
  • POST /orders/{id}/transfer-departure:先帶 mode: "preview" 與 targetDepartureId;確認時帶 mode: "confirm"、預覽回傳的 previewToken、穩定的 requestId 與 reason。需要 order.update 與訂單負責範圍。
  • 跨行程換梯同一端點,預覽與確認都帶 crossTrip: true;沒帶時,別的行程的目標回 unsupported。人工調整帶 adjustment(kind、amountTwd、reason),金額不為零時另需 order.adjust,確認須送與預覽相同的內容。開啟「少收必須經核准」時,非管理員的負數調整回 409 conflict。
  • 跨行程報價:GET /orders/{id}/cross-trip-quote(q 最多 100 字,每次最多 50 筆)搜尋目標;POST /orders/{id}/cross-trip-quote 帶 targetDepartureId 取得報價。回應的 quote 分列各項金額;sourceVersion、participationVersion、quoteFingerprint 與 expiresAt 供重新驗證。confirmationAvailable 為 true 才能確認,blockers 說明原因。
  • adjustment.kind:price_hold 保價、negotiation 議價、change_fee 換梯費。省略時為 negotiation。
  • 抽籤梯次缺少抽籤模組或 lottery.manage 時回 forbidden。
  • 目標梯次不可訂或名額不足時回 unavailable。原梯次已出發、已取消、已結團或已占名額不足時回 source_unavailable。停售與額滿不擋人工換出。
  • 預覽回傳的金額:collectedTwd 累計入款、returnedTwd 已退現金、customerCashAppliedTwd 已收淨額、outstandingTwd 尚欠、overpaymentRefundTwd 將建立的多付退回草稿金額。paidRefundFeesTwd 只影響可退額度。nextPaymentPurpose 與 nextPaymentTwd 是換梯後的下一筆付款。
  • 換梯失效的收款,intents[].invalidationReason 為 departure_change,invalidatedAmountTwd 保留原金額。遲到的收款可從同單 transactions 查驗;重複通知不新增收款。
  • 成功回應的 orderId 仍是原單,departureChangeId 識別這次換梯。API 版本 2026-11-03 另帶舊別名 backupOrderId,值也等於原單;下一個 API 版本移除它。
  • 多付退回草稿的種類是 overpayment_return,不會再減一次應收。

客人自助換梯

在「後台 → 公司設定 → 取消政策 → 客戶自助換梯」開啟後,客人可以在會員訂單頁自己換到同一行程的其他梯次。

設定項:

  • 出發前幾天前可自助換梯:原梯次與新梯次距出發都要至少這個天數。0 表示不限。
  • 新梯較便宜時的差額:「開退款草稿」或「留在訂單當溢付」。差額已扣掉換梯手續費。

規則:

  • 只開放先到先得的梯次。抽籤梯次、舊轉單鏈、需要人工核算的行程,客人要聯繫承辦。
  • 團費改用新梯次的現行價。折扣碼依新團費重新檢查。
  • 系統加一列「換梯手續費」,金額等於當下那一級的退改費。這筆是新應收,不受可退現金上限限制。
  • 新梯較貴時,客人在訂單頁照一般流程補款。付款保留期限不重新起算。
  • 換梯立即生效,承辦收到通知信。後台換梯紀錄標示「客人自助」。
  • 有未結的退款單時不能再自助換梯。

自助換梯沒有員工 API。

換梯後的文件

  • 旅遊契約:每次換梯都建立新契約。舊的待簽連結失效,舊的已簽契約只供查閱。換回原梯次也不能沿用舊契約。
  • 同意書:種類、版本與對象都相同且仍適用時保留;新種類或新版本要補簽。
  • 護照:只換梯次、旅客與護照資料沒變時,保留護照確認,另外檢查目標日期的效期。

契約產生或寄送失敗,不會撤回已完成的換梯。承辦可在訂單「文件」分頁補發或重發。

換梯不會自動作廢代收轉付收據。收據有問題時,先在「後台 → 款項 → 代收轉付」處理,再重新預覽。

舊轉單鏈的換梯

舊轉單鏈的目前訂單可以保留編號,換到同行程的一般梯次,不能跨行程換梯。

  • 新團費比結轉款低時,超出的結轉款會釋出,並在實際收款的那張單開多付退回草稿。例:結轉 8,000、目前團費 5,000,草稿合計 3,000。
  • 換梯前會檢查整條鏈的未結退款。任一張有草稿、待核准、待執行或處理中的退款單,都要先結案。
  • 舊鏈的掛帳、少收與沖正會一起調整有效結轉款。同一次報名正在處理其他操作時會失敗,等它完成後再試。
›舊鏈的預覽欄位

預覽的 legacyChain 列出完整舊單,effectiveCreditTwd 是有效結轉款,policyTotalTwd 是扣結轉前的團費。調整與沖正遇到同次報名正在處理其他操作時回 409 conflict。

換梯後的安排

換梯會把下列事項列成待辦,承辦可以先完成換梯,再逐項處理:

  • 分房:實際房間清除,房型與房友偏好保留。目標梯次有房可分,或旅客有房型、房友需求時,才列分房待辦。
  • 房升差額:重新分攤;溢收只建立退款草稿。原成交團費保留,但舊的房升費不保證保留。
  • 團前住宿:原出發前夜床位釋回,要在目標梯次另行登記,不保證有床。
  • 同行組:全單旅客在目標梯次組成新的同行組。跨訂單的同行關係留在原梯次,換回去也不會恢復。
  • 調查:同行程的原答案保留。目標停用原選項時,提示承辦確認,不會自動改答案。目標的必填調查列為待辦。

完成安排後,對應待辦自動消失。後台訂單頁提供目標梯次的分房與出團準備入口。

›換梯安排的欄位
  • 預覽的 arrangements 另列房升費:本單原費用與新費用、同房其他訂單差額、退款草稿合計及待辦。
  • 釋回的床位原因為 departure_changed。
  • 訂單詳情的 arrangements.tasks 列出未完成項目,含 travelerId、kind、label。kind 為 room、pretrip_stay 或 survey。

換梯通知與補寄

每次成功換梯都會建立一封通知,沿用原訂單連結。

  1. 到後台 →「範本」→「罐頭訊息」,建立並啟用一個 Email 範本,「識別碼」填 DEPARTURE_CHANGE。內容列出前後行程與梯次、價差、付款或退款狀態、待補資料、待簽文件與訂單連結。
  2. 到訂單的「溝通」分頁,查看通知狀態、嘗試次數與失敗原因。
  3. 通知寄送失敗時,補好範本後按「補寄通知」。補寄需要訂單編輯權限,且訂單要在你的範圍內。

規則:

  • 換梯、尾款、中籤與未成團通知,同一個參團版本只寄一次。換回曾參加的梯次也算新版本。
  • 加入寄送佇列不代表已送達。寄送失敗不撤回換梯,也不需要重新確認。
  • 尾款通知補寄只限已付訂金、未取消且仍有尾款的訂單。寄送時重新計算尾款金額。
›寄送結果值
  • 逐單寄尾款的回應保留 emailSent,並提供 outcome:queued 新增通知、already_sent 已有同版通知未重寄、no_template 未設定範本、no_recipient 沒有收件人。
  • emailSent: true 只代表已加入佇列,不代表已送達。

拆出旅客

一張單有兩位以上旅客、其中一位要改去別團或自己付款時,用「拆出」把他搬到一張新訂單。

  1. 在訂單頁「旅客」分頁,按該旅客的「拆出」。
  2. 選目的地:「同梯次另開一張單」或換到同行程的別的梯次。
  3. 選填「轉到新單的已付款」。留空時依應收比例分配。
  4. 按「預覽」,核對原單與新單的應收、轉移金額與原單多收。
  5. 填原因,按「確認拆出」。

系統一次完成這些事:

  • 新單沿用原單的訂購人、承辦、通路與成交單價。新單的主要旅客是被拆出的旅客。
  • 原單減一人的團費。原單的折扣、掛帳、少收、房型升等都留在原單,不分攤。要分攤時,另外調整。
  • 已付款從原單搬到新單,算新單的已收,不是退款再收。轉移金額不能超過新單的應收,也不能超過原單的可退現金。
  • 兩張單都依新應收重建收款計畫。原單已付足的訂金,拆出後不重收。
  • 原單多收時,開一張多付退回草稿。
  • 不自動收退改費或換梯費。要收時,在新單掛帳。

例:兩人同行,每人 20,000,已付訂金 10,000。拆出一人後,新單帶走 5,000,原單留 5,000。

不能拆出的情況:

  • 主要旅客,或原單只剩一位旅客。
  • 抽籤單、有裝備租借、有接駁或加住等其他費用的訂單。
  • 有未結的退款單、付款中的款項或有效收據的訂單。
  • 梯次已出發。
  • 拆到別的梯次時,來源梯次在出發前 6 天內(名單已凍結),且員工沒有確認提醒。對話框會顯示名單凍結的提醒,確認拆出即確認凍結。同梯次另開單不受這個限制。
  • 一次只能拆一位。不能跨行程拆出;要換行程時,先同梯拆出,再對新單做跨行程換梯。

拆到別的梯次分兩段:先同梯另開單,再對新單換梯。第二段失敗時,新單留在原梯次,是一張有效的訂單;到新單的訂單頁再換梯。

系統不會自動寄信給客人。新單有欠款時,用新單的付款連結或尾款繳款單通知客人。

›拆出 API
  • POST /orders/{id}/split-traveler:mode: "preview" 回預覽與 previewToken;mode: "confirm" 帶 previewToken、requestId 與 reason。travelerId 必填;targetDepartureId 省略時同梯另開單;transferTwd 省略時依應收比例分配,預覽與確認要送相同的值。
  • 需要 order.update 與原單的負責範圍。只改轉移金額不需要 order.adjust。
  • 不符條件時回 409 conflict,訊息是原因碼,例如 primary_traveler、last_traveler、lottery、open_refund、payment_in_flight、receipt_blocked、target_full、edit_window_closed、invalid_amount、stale_preview。
  • 回應帶 newOrderId、newOrderNumber、transferTwd 與 refundDraftId。拆到別梯時,departureChange 說明第二段的結果。
  • 同一 requestId 重送且內容相同時回原結果;內容不同回 idempotency_conflict。
  • CLI:orders split-traveler。

搬入舊單拆出後改訂購人

舊系統曾把兩位不相干的客人併成一張單。這種搬入的舊單拆出後,新單可以改到被拆出旅客自己的會員帳號。

  1. 在新單的訂單頁,按「訂購人」卡片的「改訂購人」。
  2. 搜尋並選擇這位旅客的會員帳號。查無會員時,先到會員頁替這位旅客建帳號。
  3. 填原因,按「確認改訂購人」。

改了之後,新單的已付款與之後的退款都跟著新訂購人。同意書要由新訂購人重簽。稽核記錄操作人、原訂購人、新訂購人與原因。

  • 需要 order.adjust(內建角色是線控與管理員)。一般訂單拆出的新單不能改訂購人。
  • 新單有未結的退款單、付款中的款項或有效收據時不能改,先處理完再改。

旅客退出

一張單有兩位以上旅客、其中一位不來了時,用「退出」。系統一次減一席、減一人應收、收取消費,再退款或轉保留款。抽籤單(已申請、備取、中籤)也能用。

  1. 在訂單頁「旅客」分頁,按該旅客的「退出」。
  2. 按「預覽」,核對團費份額、今天套到的退改費階梯、取消費與可退金額。
  3. 要破例少收時,填「減免取消費」,再按「重新預覽」。
  4. 有可退金額時,選「退款」或「轉保留款」。
  5. 填原因,按「確認退出」。

系統一次完成這些事:

  • 旅客離開名冊,梯次已售減一。候補照常遞補。
  • 原單減一人的團費。團費份額是成交單價;搬入的舊單用每人單價。折扣、掛帳、房型升等都留在原單。
  • 取消費與整單取消用同一套退改費階梯與收入歸屬。百分比列算團費份額的百分比,定額列算一人。
  • 取消費的上限是這位旅客分到的已付款(依應收比例)。只付訂金時,取消費可能被壓低,差額不追收。
  • 可退金額是原單多付的部分扣掉取消費。原單還有人欠錢時,可退金額是 0,原單照新應收收尾款。
  • 選「退款」時開退款單,照一般核簽,匯款另扣轉帳費。選「轉保留款」時,錢留給訂購人,可折抵日後的訂單。
  • 減免走少收核准。你能直接核准少收時,減免當下生效:原單還有人欠錢時,減免的錢留在原單抵尾款;原單不欠錢時,減免的錢併入可退金額。需要核准時,退出先照全額取消費完成,減免待核准;核准後補開差額的退款單。

例:三人同行,每人 20,000,已付清。出發前 4 天退出一人,套 80% 階梯。取消費 16,000,可退 4,000。

取消費與退款記在一張「由退出產生」的已取消新單上。這張單不出現在後台訂單清單的日常檢視與會員中心。搜尋單號、溢收與異常篩選、訂單匯出與 API 清單照列,從退款單與保留款也可以點進去。

原單本來就多收超過這位旅客的已付款時,退出後原單還是多收。系統在原單開溢收退款草稿,預覽會先列出金額。

抽籤單退出後,送籤匯出的分組不再有這位旅客。已送出的入園證減人與保險名單,請到送籤台另外處理,系統不會自動做。

不能退出的情況:

  • 主要旅客,或原單只剩一位旅客。改主要旅客,或取消整張訂單。
  • 梯次已出發,或訂單已完成、已取消。未中籤待安置的抽籤單。
  • 有裝備租借、接駁或加住等其他費用、未結的退款單、付款中的款項或有效收據。旅客分頁的按鈕旁會寫原因。
  • 行程的退改費要人工核算(海外行程)。改用拆出旅客,再取消新單。
  • 出發前 6 天內(名單已凍結)。對話框會顯示提醒,確認退出即確認凍結。

客人不能在會員中心自己退出旅客。

›退出 API
  • POST /orders/{id}/withdraw-traveler:mode: "preview" 回預覽與 previewToken;mode: "confirm" 帶 previewToken、requestId 與 reason。travelerId 必填。
  • 預覽有可退金額時,確認要帶 disposition:refund 或 keep。waiverTwd 是減免金額,預覽與確認要送相同的值。帶 disposition 或 waiverTwd 時需要 refund.create。
  • 名單凍結時,預覽與確認都帶 acknowledgeRosterFreeze: true。
  • 需要 order.update 與原單的負責範圍。
  • 不符條件時回 409 conflict,訊息是原因碼,例如 primary_traveler、last_traveler、open_refund、payment_in_flight、receipt_blocked、manual_refund_assessment、edit_window_closed、disposition_required、hold_unavailable、invalid_waiver、stale_preview。
  • 回應帶 withdrawalOrderId、feeTwd、refundableTwd、refundIds、retainedFundId 與 waiver。
  • GET /orders/{id} 的 actions.withdrawTraveler 說明能不能退出,以及不能的原因。
  • 同一 requestId 重送回原結果;旅客不同回 idempotency_conflict。
  • CLI:orders withdraw-traveler。

相關指南

Command Palette

Search for a command to run...