批量調整租客狀態
適用於公司擁有者、公司管理者與管理員。在「批量操作」頁一次選取多位租客，改成「已退租」或「在住」，核對確認視窗列出的連帶影響與被擋下的租客，再逐筆讀結果。改成「已退租」不是刪除租客，但會一併終止名下有效中與草稿的租約，而且不能再改回「在住」。
開始前
- 使用公司擁有者、公司管理者或管理員的帳號登入。一般用戶的側邊欄沒有「批量操作」；直接開啟網址會顯示「權限不足」，不能操作。「批量操作」是團隊版的功能（14 天試用期間也可使用）。個人版與免費版（試用結束或授權到期的公司會自動轉為免費版）的左側「系統管理」群組沒有「批量操作」，從網址進入會看到「功能未啟用」；請公司擁有者到左側「帳號管理」→「方案升級」查看方案，需要時寄出申請，由 好寓|租屋管理系統 開立帳單、收款後人工開通。
- 管理員必須在每個涉及的房屋有有效的「編輯」權限，只有檢視或管理房間權限不足。檢查範圍包含租客目前房屋、房間所屬房屋與所有歷史租約房屋；建立租約時也包含新房屋。公司擁有者與公司管理者可處理本公司範圍；關聯到其他公司、缺失或已封存房屋時，整筆仍會被擋下，請先由公司擁有者或公司管理者核對關聯。
- 先想清楚要改成什麼。目標狀態只有「已退租」（預設）與「在住」兩種，「待確認」不能當目標。改成「已退租」會把這位租客名下有效中與草稿的租約改成「已終止」、終止日設為當天、釋放房間（維修中與預約中的房間維持原狀），並作廢終止月份之後尚未收款的租金帳單（已收款或已上傳憑證的月份不作廢，只加註待處理；終止當月不重算）。若租客另有其他公司的歷史租約關聯，整位租客會被擋下，不會只終止本公司的租約卻改動租客狀態。改成「在住」只改租客自己的狀態，不動租約與房間。
- 「已退租」不是刪除或封存：租客仍在「租客管理」，只是狀態變了。這一頁的狀態名稱與「租客管理」一致：在住、已退租、待確認。
- 改成「已退租」之後，這位租客不能再改回「在住」或「待確認」，被終止的租約與作廢的帳單也不會恢復。要讓他重新入住，必須為他新增租約，系統會自動把他改回「在住」。所以按下按鈕前先確認選對人。
- 沒有任何房屋或租約關聯的「待確認」租客，請由公司擁有者或公司管理者處理；管理員不能批次變更這類租客。要辦理正式退租與押金結算，請走「辦理退租與押金結算」；這一頁不會退押金，也不會結算欠款。
操作步驟
步驟 1：開啟「批量操作」的租客頁籤
位置：左側「系統管理」→「批量操作」→「租客批量操作」頁籤
按左側「系統管理」群組裡的「批量操作」，頁面預設停在「租客批量操作」頁籤。每張卡片是一位租客，顯示姓名、Email、房屋與房號和目前狀態。卡片上方有「搜尋」欄與「目前狀態」下拉；「全選目前顯示的 5 位租客」旁邊寫著「顯示 5 位（共 5 位），已選取 0 位」。右上角的狀態下拉預設是「已退租」，按鈕「更新 0 位租客」是灰色，因為還沒選任何人。清單最多載入前 200 位租客，超過時畫面會明講只載入了多少位。
看到租客卡片，「更新 0 位租客」不能按。往下做之前先看一眼狀態下拉：它一開始就是「已退租」。
步驟 2：用篩選縮小清單並選取租客
位置：「租客批量狀態更新」下方的「搜尋」、「目前狀態」與租客卡片
在「目前狀態」選「在住」，清單只剩 3 位在住的租客。勾選「全選目前顯示的 3 位租客」把這 3 位都選起來，再點「林租客（教學用）」取消選取他，因為林租客的租約要繼續。選中的卡片會變成深色，再點一次取消。「搜尋」欄可輸入姓名、Email、電話、房屋或房號，用空白隔開多個詞時每個詞都要符合。
畫面寫著「顯示 3 位（共 5 位），已選取 2 位」，按鈕變成「更新 2 位租客」。
步驟 3：搜尋或篩選改變時，選取會跟著調整
位置：「搜尋」欄與右上角的通知
選取只會留在畫面上看得到的租客。本例在「搜尋」輸入「陳」，清單只剩陳租客，已選取的黃租客看不到了，右上角出現通知「已調整選取範圍」，內容是「已從選取中移除 1 位不符合目前搜尋或篩選條件的租客」。看過通知後清掉搜尋文字，再點一下「黃租客（教學用）」重新選取。
畫面回到「顯示 3 位（共 5 位），已選取 2 位」，陳租客與黃租客被選取。每次改搜尋或篩選之後，都要再看一眼已選取的人數。
步驟 4：確認目標狀態並填寫原因
位置：「租客批量狀態更新」標題右側的狀態下拉、「變更原因（選填）」與下方的提示文字
狀態下拉只有「已退租」與「在住」，本例保持「已退租」。在「變更原因（選填）」寫一句原因，本例填「已搬離（教學用）」；原因會留在被終止租約的備註與這次批量操作的紀錄裡。選「已退租」而且已選取租客時，下方出現橘色提示：「改為「已退租」會一併以今天終止這些租客名下的有效中與草稿租約。按下按鈕後會先預覽實際筆數與無法變更的租客，確認後才寫入。」
看到橘色提示。到這裡還沒有任何資料被送出，實際會終止幾份租約要等下一步的預覽。
步驟 5：按「更新 2 位租客」並核對預覽結果
位置：按「更新 2 位租客」後開啟的「批量將租客改為已退租」視窗
按「更新 2 位租客」，按鈕會短暫顯示「預覽中…」：系統先向後端預覽，不寫入任何資料。視窗的「受影響對象」是預覽算出來的實際數字：「租客狀態改為「已退租」：2 筆」「名下有效中與草稿租約以今天終止：3 筆」，並說明涉及幾間房間（本例 3 間）、終止月份之後尚未收款的租金帳單會作廢。下方名單逐位列出租客與租約：陳租客將終止「晴禾公寓（教學用） 101（有效中）」；黃租客將終止「102（有效中）」與「104（草稿）」兩份，草稿租約也會被終止。沒有任何租約的租客只列姓名。視窗最後一段說明不能回頭的事：租客不能再改回「在住」或「待確認」，被終止的租約與作廢的帳單不會恢復，租客資料本身不會被刪除，要再入住請新增租約。
預覽沒有寫入任何資料。數字或名單不對就按「取消」（或按 Esc）回到清單修正。若有租客被擋下，名單下方會多一段「以下 N 筆不會變更（預覽時已被擋下）」，見步驟 9。 預覽不保留權限；確認送出時會重新檢查角色、公司、房屋與分派。若其間被撤權或資料已封存，該筆會失敗，請以送出後的結果逐筆核對，不要重送成功項目。無權項目會顯示一般拒絕原因；看得到清單不代表可以批次修改。
步驟 6：輸入筆數並確認送出
位置：同一個確認視窗的「請輸入「2」以確認」欄與「將 2 位租客改為已退租」按鈕
改成「已退租」會終止租約，所以視窗要你輸入預覽通過的人數。在欄位輸入 2，按「將 2 位租客改為已退租」。輸入的數字不符時會顯示「輸入內容不符，請重新輸入」，不會送出。需要輸入筆數的情況是：改成「已退租」而且有租約會被終止，或人數加終止的租約數超過 10；其他情況是一般的確認視窗（見步驟 9）。
視窗關閉並開始處理，按鈕暫時顯示「處理中…」，完成後出現結果。
步驟 7：讀懂批次處理結果
位置：頁面上方的「批次處理結果」面板與右上角的通知
先看右上角通知「批次處理完成」：共 2 位租客全部成功。再看面板：按「成功 2 筆」展開名單，姓名後面的「（已終止 1 份租約）」「（已終止 2 份租約）」是這位租客實際被終止的租約份數，與步驟 5 預覽的份數一致。成功的租客會自動取消選取。面板不會自動消失；核對後再按「關閉」。 黃租客後方另顯示需人工處理 2026-11 租金：該月已有憑證，不會自動作廢；請核對收款後處理。未起租與草稿取消保留原起訖日期。
陳租客與黃租客已是「已退租」，3 份租約已終止。各種結果的看法整理在下方「批次結果怎麼看」。
步驟 8：到租約管理核對結果
位置：左側「租客服務」→「租約管理」
開啟「租約管理」，找到剛才改成「已退租」的租客：陳租客的租約、黃租客的兩份租約狀態都是「已終止」，租期迄日變成執行當天（示範為 2026/10/14）；沒被選取的林租客仍是「有效中」。這些租約原本佔用的房間，若沒有其他租約，會回到「可租」；原本標為「維修中」或「預約中」的房間不會被改動。 尚未起租的租約則保留原租期，備註會寫「取消未起租租約」，請一併核對。
租約狀態與預期一致。押金與欠款沒有因此結清或退還，需要時依「辦理退租與押金結算」處理。
步驟 9：已退租的租客不能改回「在住」，預覽就會擋下
位置：「批量操作」頁，狀態下拉選「在住」後按「更新 2 位租客」開啟的「批量將租客改為在住」視窗
按左側「批量操作」回到租客頁籤，把狀態下拉改選「在住」，點選剛退租的「陳租客（教學用）」與還沒簽約、狀態是「待確認」的「王租客（教學用）」，按「更新 2 位租客」。預覽通過 1 位：王租客可以改成「在住」，沒有租約也可以處理。陳租客被擋下，視窗列出「以下 1 筆不會變更（預覽時已被擋下）」與原因：「已退租的租客不能改回「在住」。要讓他重新入住，請為他新增租約，系統會自動改回「在住」。」這次只改租客自己的狀態、不終止租約，也沒超過 10 筆，所以是一般確認視窗，不用輸入筆數。按「將 1 位租客改為在住」。
視窗只計入預覽通過的 1 位；被擋下的陳租客不會送出，也不會被改動。
步驟 10：讀懂「未送出」的項目
位置：頁面上方的「批次處理結果」面板與右上角的通知
右上角通知「部分成功」：成功 1 位租客、失敗 1 位租客；失敗項目仍保留在選取中，可直接重試。面板「失敗 1 筆」底下的陳租客標著「未送出（預覽時已被擋下）：」加上原因；「未送出」表示他沒有送到後端，什麼都沒改動。按「成功 1 筆」展開，是王租客。
王租客已是「在住」；陳租客仍是「已退租」。
步驟 11：沒送出的租客留在選取中，不要直接重送
位置：租客卡片與右上角的按鈕
成功的王租客自動取消選取，沒送出的陳租客仍被選取，按鈕變成「更新 1 位租客」，這就是重試的範圍；本頁的結果面板沒有「只重試失敗的 N 筆」按鈕。原樣重送陳租客只會再被擋下一次。要讓他重新入住，請為他新增租約（可到「租約管理」單筆新增，或用「批量建立租約並處理部分失敗」），建立租約後系統會自動把他改回「在住」。不需要這個動作時，點一下陳租客取消選取，按鈕回到灰色。
選取集合只剩真正還需要處理的租客；已成功的租客不會被重送。
步驟 12：沒有權限時會看到什麼
位置：一般用戶帳號直接開啟「批量操作」網址時
一般用戶的側邊欄沒有「批量操作」。直接開啟網址會顯示「權限不足」，無法選取或送出；請公司擁有者、公司管理者或管理員代為處理。
知道這是權限限制，不是步驟做錯，而且沒有任何資料被改動。
步驟 13：核對待生效續約的失敗原因
位置：批量操作 → 租客批量操作 → 批次處理結果
若預覽後資料改變，結果可能只成功部分租客。讀取失敗列的新約生效日期，再由側邊欄「租約管理」找到原租約，核對尚未生效的新約。
首輪成功列已完成；失敗租客仍留在選取中，不會一起回滾。
步驟 14：只重試仍選取的失敗租客
位置：批量操作 → 租客批量操作
未處理續約相依前，不要重複按更新。處理完後返回「批量操作」，核對目前只選取失敗租客，再按「更新 1 位租客」並重新預覽確認。圖中示範未解除相依時仍失敗。
重試只送出失敗租客，首輪成功租客不會再次執行。
完成後
「批次處理結果」裡的失敗與「未送出」項目都已處理，或確認不需要處理，而且「租約管理」顯示已退租租客的租約為「已終止」，即完成。批量改成「已退租」只改租客狀態、終止租約並作廢尚未收款的租金帳單：不會退還押金、不會結算欠款，也不會刪除或封存租客；要辦理正式退租，請另走退租結算。 單筆或批量停用時，尚未起租的有效中／草稿租約一律視為取消：保留原起訖日，顯示「已終止」並加註「取消未起租租約」，未收租金帳作廢；已收款或有憑證的帳保留供人工核對。已起租租約的當月租金不因單純停用而重算。 每位租客的狀態、租約、帳款與房況一起完成；該位失敗時全部保留原狀。成功列如顯示需人工處理，請到「收款管理」核對已收款或有憑證的租金帳，不自動退款。單筆在「租客管理」編輯為「已退租」也套用相同規則，保留帳款時會顯示持續提醒。
疑難排解
左側沒有「批量操作」或頁面顯示「功能未啟用」：批量操作是團隊版的功能（14 天試用期間也可使用），目前的方案不含；請公司擁有者到左側「帳號管理」→「方案升級」查看，需要時寄出申請，開通後重新整理頁面。一般用戶直接開啟網址會顯示「權限不足」。若預覽或結果回報「資源不存在或無權執行此批次操作」，先請公司擁有者或公司管理者核對帳號角色、房屋分派是否啟用及本操作需要的權限；不要反覆送出同一筆。試用結束或授權到期：系統會在數分鐘內自動轉為免費版，並寄信通知公司擁有者。批量操作是團隊版的功能，轉換完成後左側不再有「批量操作」，從網址進入會顯示「功能未啟用」；轉換完成前（通常數分鐘內）畫面上方有橫幅說明，預覽仍可使用，但按下確認後批量寫入會被拒絕並顯示授權訊息。要繼續使用，請公司擁有者到左側「帳號管理」→「方案升級」寄出團隊版的開通或續約申請，開通後立即恢復。通知「沒有可執行的項目」：所選租客在預覽時全部被擋下，沒有送出任何變更，原因列在結果面板。失敗原因「租客不存在或無權存取」：租客已封存或屬於其他公司；已封存的先到「封存區」還原。某位租客執行失敗：該位租客的狀態、租約、帳款與房況全部維持原狀，其他成功項目保留；請先依失敗原因處理，再重新預覽並送出仍選取的失敗項目。通知「選取已變更」：預覽之後選取或表格內容改了，沒有送出任何變更，請重新按一次按鈕預覽。通知「已調整選取範圍」：搜尋或篩選條件改了，看不到的租客已被移出選取。找不到租客：清單最多載入前 200 位，畫面會寫明「只載入了前 N 位租客（共 M 位）」，搜尋只在已載入的租客中尋找，其餘請到「租客管理」單筆處理。把租客改成「在住」只改租客自己的狀態，不會恢復已終止的租約與房間狀態，需要繼續出租請另外建立租約。 若停用失敗列出已完成續約及新約生效日期，請先記下失敗租客與房號，從側邊欄「租約管理」找到該租客、房號的原租約，在該列續約欄按「查看新租約」核對。不續住時，由有權限的人員回到「租約管理」找到尚未生效的草稿新約，按「封存」並完成確認；再從側邊欄回到「批量操作」，重新選取要停用的租客、預覽並確認送出。失敗的租客、租約、帳款與房況均維持原狀。 同一批失敗項目修正後重新預覽、確認送出，面板會保留首輪成功並更新重試結果；已從本次範圍移除的失敗列不再列入，通知只計本次送出的結果。關閉面板會清除前輪累計；若仍有請求處理中，回應到達後只顯示該次結果。加入新對象送出會重新計數；租客狀態改成另一個目標也視為新操作。預覽取消或網路失敗不會清掉前輪結果。 租客涉及多棟或歷史租約時，必須通過全部相關房屋的權限檢查；已封存、缺失或跨公司的關聯請由公司擁有者或公司管理者先核對處理。沒有任何房屋或租約關聯的待確認租客，管理員不能批次調整狀態，請交由公司擁有者或公司管理者處理。