換梯與拆單
三種換梯
| 換梯方式 | 誰操作 | 團費 | 換梯手續費 |
|---|---|---|---|
| 同行程換梯 | 承辦 | 保留原成交價與原折扣 | 不自動收,需要時人工掛帳 |
| 跨行程換梯 | 承辦 | 改用目標行程的現行價 | 不自動收,可填人工調整 |
| 客人自助換梯 | 客人 | 改用目標梯次的現行價 | 自動收,等於當下那一級的退改費 |
三種方式都保留訂單編號、旅客與現金紀錄。換梯不是取消再重訂。
承辦換梯
- 在訂單頁按「更多」→「換梯(同行程)」或「換梯(跨行程)」。
- 選目標梯次,填換梯原因。
- 按「預覽換梯」,核對新應收、下一筆要收的錢、文件與待辦。
- 按「確認換梯」。
確認時系統會重新檢查名額、價格與權限。預覽後訂單、名冊、款項或目標梯次有變動時,要重新預覽。
規則:
- 停售或額滿的原梯次可以換出。 原梯次須未出發、未取消、未結團,且已占名額足夠。
- 停售的先到先得梯次有位即可換入。 候選標示「已停售」,預覽會提醒占用名額。換完仍維持停售,前台不恢復販售。停售抽籤梯次不可轉入,請使用團控人工安置;安置目標仍須在售。
- 同行程換梯不重算團費。 目標牌價不同也照原成交價。既有的掛帳、少收與已執行的減應收退款都保留。要加收或少收,先在訂單「款項」分頁處理,再重新預覽。
- 跨行程換梯重新報價。 價格照原成交的直客或同業通路,讀目標的現行價(含促銷)。可以直接填一筆人工調整:正數加收、負數少收。開啟「少收必須經核准」時,非管理員不能填負數,請改送手動少收申請。
- 抽籤梯次另需權限。 換進或換出抽籤梯次,需要抽籤模組與抽籤管理權限。換進抽籤梯次後要重新應募,原梯次的中籤資格不會帶過去。
- 有未結的退款單時不能換梯。 草稿、待核准、待執行或處理中的退款單,要先結案。
跨行程報價
選「換梯(跨行程)」後,先看報價再決定:
- 報價分列原團費、目標團費、原折扣、本次調整、價差、已付、已退、可退額度與付款期限。
- 報價不佔名額、不扣折扣碼名額、不改應收,有效 15 分鐘。
- 目標可以用行程名稱、日期、梯次標籤搜尋,每次最多列 50 筆。
原本用的折扣碼會依報價當天的設定重新檢查:
- 仍適用:繼續使用,不再扣名額。折抵金額依目標團費重算。
- 不再適用:折扣退出,名額歸還一次。之後取消或再換梯,都不會再歸還或恢復。
- 折扣碼的分潤已轉成請款單、且換梯會改變分潤金額或受款人時,不能確認。請款單還沒付時先取消它;已付時先在分潤端人工處理。
報價與確認之間,名額、價格與折扣碼都可能改變。確認時以當下的狀態為準。
換梯後的款項
換梯後,系統依新應收重建收款計畫:
- 訂金還沒付足時,補到目標梯次的訂金規則。已付足的訂金不重收。
- 其餘照目標梯次的尾款期限。期限已過就立即到期。
- 舊的付款連結與 ATM 帳號失效。沒有欠款時,不建立零元的付款入口。
- 已付比新應收多時,可在後台選「退款」或「保留給本人」。退款建立草稿,不直接退錢。
- 保留須有退款建立權限,且符合未出發的一般會員訂單資格。換梯與轉保留一起完成,不建退款草稿。
| 累計入款 | 已退現金 | 新應收 | 結果 |
|---|---|---|---|
| 10,000 | 3,000 | 8,000 | 已收淨額 7,000,尚欠 1,000,不開退款草稿 |
| 8,000 | 0 | 6,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。
換梯通知與補寄
每次成功換梯都會建立一封通知,沿用原訂單連結。
- 到後台 →「範本」→「罐頭訊息」,建立並啟用一個 Email 範本,「識別碼」填
DEPARTURE_CHANGE。內容列出前後行程與梯次、價差、付款或退款狀態、待補資料、待簽文件與訂單連結。 - 到訂單的「溝通」分頁,查看通知狀態、嘗試次數與失敗原因。
- 通知寄送失敗時,補好範本後按「補寄通知」。補寄需要訂單編輯權限,且訂單要在你的範圍內。
規則:
- 換梯、尾款、中籤與未成團通知,同一個參團版本只寄一次。換回曾參加的梯次也算新版本。
- 加入寄送佇列不代表已送達。寄送失敗不撤回換梯,也不需要重新確認。
- 尾款通知補寄只限已付訂金、未取消且仍有尾款的訂單。寄送時重新計算尾款金額。
›寄送結果值
- 逐單寄尾款的回應保留
emailSent,並提供outcome:queued新增通知、already_sent已有同版通知未重寄、no_template未設定範本、no_recipient沒有收件人。 emailSent: true只代表已加入佇列,不代表已送達。
拆出旅客
一張單有兩位以上旅客、其中一位要改去別團或自己付款時,用「拆出」把他搬到一張新訂單。
- 在訂單頁「旅客」分頁,按該旅客的「拆出」。
- 選目的地:「同梯次另開一張單」或換到同行程的別的梯次。
- 選填「轉到新單的已付款」。留空時依應收比例分配。
- 按「預覽」,核對原單與新單的應收、轉移金額與原單多收。
- 填原因,按「確認拆出」。
系統一次完成這些事:
- 新單沿用原單的訂購人、承辦、通路與成交單價。新單的主要旅客是被拆出的旅客。
- 原單減一人的團費。原單的折扣、掛帳、少收、房型升等都留在原單,不分攤。要分攤時,另外調整。
- 已付款從原單搬到新單,算新單的已收,不是退款再收。轉移金額不能超過新單的應收,也不能超過原單的可退現金。
- 兩張單都依新應收重建收款計畫。原單已付足的訂金,拆出後不重收。
- 原單多收時,開一張多付退回草稿。
- 不自動收退改費或換梯費。要收時,在新單掛帳。
例:兩人同行,每人 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。
搬入舊單拆出後改訂購人
舊系統曾把兩位不相干的客人併成一張單。這種搬入的舊單拆出後,新單可以改到被拆出旅客自己的會員帳號。
- 在新單的訂單頁,按「訂購人」卡片的「改訂購人」。
- 搜尋並選擇這位旅客的會員帳號。查無會員時,先到會員頁替這位旅客建帳號。
- 填原因,按「確認改訂購人」。
改了之後,新單的已付款與之後的退款都跟著新訂購人。同意書要由新訂購人重簽。稽核記錄操作人、原訂購人、新訂購人與原因。
- 需要
order.adjust(內建角色是線控與管理員)。一般訂單拆出的新單不能改訂購人。 - 新單有未結的退款單、付款中的款項或有效收據時不能改,先處理完再改。
旅客退出
一張單有兩位以上旅客、其中一位不來了時,用「退出」。系統一次減一席、減一人應收、收取消費,再退款或轉保留款。抽籤單(已申請、備取、中籤)也能用。
- 在訂單頁「旅客」分頁,按該旅客的「退出」。
- 按「預覽」,核對團費份額、今天套到的退改費階梯、取消費與可退金額。
- 要破例少收時,填「減免取消費」,再按「重新預覽」。
- 有可退金額時,選「退款」或「轉保留款」。
- 填原因,按「確認退出」。
系統一次完成這些事:
- 旅客離開名冊,梯次已售減一。候補照常遞補。
- 原單減一人的團費。團費份額是成交單價;搬入的舊單用每人單價。折扣、掛帳、房型升等都留在原單。
- 取消費與整單取消用同一套退改費階梯與收入歸屬。百分比列算團費份額的百分比,定額列算一人。
- 取消費的上限是這位旅客分到的已付款(依應收比例)。只付訂金時,取消費可能被壓低,差額不追收。
- 可退金額是原單多付的部分扣掉取消費。原單還有人欠錢時,可退金額是 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。
相關指南
- 訂單與金流模型:應收、已收與狀態。
- 取消與退款:退款草稿怎麼核准與執行。
- 營運自動化:用 API 批次處理換梯後的安排。
- orders API · CLI orders。