批量建立租約並處理部分失敗
適用於公司擁有者、公司管理者與管理員。在「批量操作」的「租約批量創建」頁籤一次填多份租約，按下按鈕後先預覽，核對確認視窗列出的連帶影響與被擋下的列，再送出，讀懂逐列結果，只修正並重送沒建立的那一列。批量建立的租約一建好就是「有效中」，房間改為「已租」、租客改為「在住」，並在押金管理建立一筆未實收的押金記錄，但不會產生租金帳單。
開始前
- 使用公司擁有者、公司管理者或管理員的帳號登入。一般用戶的側邊欄沒有「批量操作」；直接開啟網址會顯示「權限不足」，不能操作。「批量操作」是團隊版的功能（14 天試用期間也可使用）。個人版與免費版（試用結束或授權到期的公司會自動轉為免費版）的左側「系統管理」群組沒有「批量操作」，從網址進入會看到「功能未啟用」；請公司擁有者到左側「帳號管理」→「方案升級」查看方案，需要時寄出申請，由 好寓|租屋管理系統 開立帳單、收款後人工開通。
- 管理員必須在每個涉及的房屋有有效的「編輯」權限，只有檢視或管理房間權限不足。檢查範圍包含租客目前房屋、房間所屬房屋與所有歷史租約房屋；建立租約時也包含新房屋。公司擁有者與公司管理者可處理本公司範圍；關聯到其他公司、缺失或已封存房屋時，整筆仍會被擋下，請先由公司擁有者或公司管理者核對關聯。
- 租客、房屋與房間要先建好，而且房間狀態是「可租」；租客請先在「租客管理」建立，房間見「建立房屋與房間」。每一份租約的租期、月租金與押金都要已經確認：批量建立的租約一建好就是「有效中」（不是草稿），房間立刻變成「已租」，即使開始日還沒到。
- 每份建立成功的租約會連帶做這些事：房間改為「已租」；押金大於 0 的租約各建立一筆「應收、尚未實收」的押金記錄；租客改為「在住」，租客資料上的房屋、房號與租金一併更新。已退租的租客要回來住，就是靠新增租約，建立後系統會自動把他改回「在住」。這一頁不會產生租金帳單，也不會設定電費與收款帳戶，這些要怎麼補，見最後兩步與「常見問題」。單筆建立請看「建立第一份租約」，外部 CSV 匯入請看「使用 CSV 現況總表匯入租屋資料」。
- 按下「創建 N 份租約」後，系統會先逐列預覽檢查：必填欄位、月租金大於 0、押金不為負、結束日期不可早於開始日期（允許同日起訖）、房間可租且屬於所選房屋、租客沒有封存、租客目前沒有其他有效中租約，以及同一批裡有沒有重複的房間或重複的租客。通過的列才會送出，沒通過的列留在表格上並寫明原因。金額是否合理（例如多打一個零）系統不會判斷，送出前請自己核對。
操作步驟
步驟 1：開啟「租約批量創建」頁籤
位置：左側「系統管理」→「批量操作」→「租約批量創建」頁籤
按左側「系統管理」群組裡的「批量操作」，再按「租約批量創建」頁籤。表格一開始有 1 行空白，欄位依序是「列」「租客」「房屋」「房間」「開始日期」「結束日期」「月租金」「押金」「操作」。表格上方的說明會即時算出「共 N 行，其中 M 行資料完整可送出」；右上角的「創建 0 份租約」是灰色。
看到空白表格，還沒有任何資料被送出。
步驟 2：新增資料行並選租客、房屋、房間
位置：「批量創建租約」下方的表格
按「新增一行」補到需要的行數（本例 5 行：4 份租約加 1 行空白）。每一行依序選「租客」「房屋」「房間」；房間下拉會列出所選房屋的全部房間，包括已租、維修中的，系統不會先幫你濾掉，不可用的房間要預覽時才會被擋下。本例第 1 行是待確認的吳租客，第 2 行是已退租的鄭租客，第 3 行刻意選了和第 2 行同一間房 202，第 4 行選了已經有有效中租約的陳租客，用來看預覽會怎麼擋下。
前 4 行已有租客、房屋與房間，第 5 行維持空白；表格上方仍寫「共 5 行，其中 0 行資料完整可送出」。
步驟 3：填入租期、月租金與押金
位置：同一張表格的「開始日期」「結束日期」「月租金」「押金」欄
每行填「開始日期」「結束日期」「月租金」，需要時填「押金」。本例第 1 行為 2026-11-01 同日起訖，其餘三行為 2026-11-01 到 2027-10-31，月租金 11000、12000、12000、12000，押金 22000、24000、24000、24000。日期欄的排列順序依瀏覽器語言而定，截圖顯示為月/日/年。缺租客、房屋、房間、起訖日期或月租金的行不會送出，第 5 行維持空白即可，送出時會被略過。月租金要大於 0、押金不可為負、結束日期不可早於開始日期（允許同日起訖），否則預覽時那一列會被擋下。
表格上方變成「共 5 行，其中 4 行資料完整可送出」，右上角按鈕變成「創建 4 份租約」。送出前逐行再核對一次日期與金額。
步驟 4：按「創建 4 份租約」並核對預覽結果
位置：按「創建 4 份租約」後開啟的「批量建立租約」視窗
按「創建 4 份租約」，按鈕會短暫顯示「預覽中…」：系統先向後端逐列預覽，不寫入任何資料。視窗的「受影響對象」列出預覽通過的結果：「新增租約：2 筆」「房間改為「已租」：2 筆」「押金記錄（應收、尚未實收）：2 筆」「租客改為「在住」（目前是待確認或已退租）：2 筆」「每月租金總額 NT$23,000」，以及「預覽時被擋下、不會變更：2 筆」。下方名單逐份列出預覽通過的「租客 · 房屋 房號 · 租期 · 月租金」；再下面的「以下 2 筆不會變更（預覽時已被擋下）」寫出被擋下的列與原因，格式是「第 N 筆 · 租客 · 房屋 房號：原因」，本例是第 3 筆「同一批中已有另一列使用這間房間」、第 4 筆「該租客已有有效租約」。最後一段說明取消的方式：建立後如需取消，要逐份到「租約管理」封存（視窗寫的「刪除」就是租約管理裡的「封存」，移至封存區，可再還原），房間會跟著釋放；已建立的押金記錄、已產生的帳單與租客的「在住」狀態不會自動退回。名單沒問題就按「建立 2 份租約」。預覽通過超過 10 份時，視窗還會要你輸入筆數。
視窗關閉並開始處理，這時才寫入資料。名單不對就按「取消」（或按 Esc），什麼都不會建立。 預覽不保留權限；確認送出時會重新檢查角色、公司、房屋與分派。若其間被撤權或資料已封存，該筆會失敗，請以送出後的結果逐筆核對，不要重送成功項目。無權項目會顯示一般拒絕原因；看得到清單不代表可以批次修改。
步驟 5：讀懂部分成功的結果
位置：頁面上方的「批次處理結果」面板與右上角的通知
先看右上角通知「部分成功」：成功 2 份租約、失敗 2 份租約；失敗項目仍保留在選取中，可直接重試。再看面板：「失敗 2 筆」底下是第 3 筆周租客與第 4 筆陳租客，原因都標著「未送出（預覽時已被擋下）：」，加上預覽時的原因；「未送出」表示這兩列沒有送到後端，什麼都沒建立。按「成功 2 筆」展開，是已建立的「吳租客（教學用） · 201」與「鄭租客（教學用） · 202」。成功的行已從表格移除，表格只留下被擋下的兩行與空白行；面板的「第 3 筆」「第 4 筆」是送出當時的列號，成功的行移除後表格重新編號，所以周租客現在是第 1 行、陳租客是第 2 行。
2 份租約已建立並生效，鄭租客已從「已退租」改回「在住」；沒送出的兩列沒有建立。不要把已成功的行再送一次：它們已經建好，重送只會得到「該租客已有有效租約」。
步驟 6：修正或刪除沒建立的那幾行
位置：表格裡留下的幾行
被擋下的行仍保留你填的資料，逐行依原因處理。周租客那一行是房間重複：先確認哪間房現在是「可租」（可到「房間管理」查看），把該行的「房間」下拉改成 203。陳租客那一行是他已經有有效中租約，不應該再建立一份，按該行的「刪除」把它移掉。其他欄位沒問題就不用動；原因若是別的，依下方「失敗原因對照」處理。
表格只有周租客那一行是完整資料，表格上方寫「共 2 行，其中 1 行資料完整可送出」，右上角按鈕顯示「創建 1 份租約」，不再包含已成功的兩份。
步驟 7：重送這一行並確認全部成功
位置：「租約批量創建」頁籤右上角的按鈕、確認視窗與結果面板
按「創建 1 份租約」。系統會再預覽一次，確認視窗只列出這 1 份租約的影響與名單，已成功的兩份不在裡面；核對無誤後按「建立 1 份租約」。成功後按面板的「成功 3 筆」展開，可核對首輪兩份與本次「周租客（教學用） · 203」。
通知「批次處理完成」只回報本次 1 份租約全部成功；結果面板累計「成功 3 筆」，表格回到 1 行空白。三份租約都建好了。
步驟 8：到租約管理核對新租約
位置：左側「租客服務」→「租約管理」
開啟「租約管理」，找到吳租客、鄭租客與周租客的新租約，核對房屋與房號、租約期間、月租金與押金。狀態是「有效中」，對應房間已是「已租」。押金記錄在「押金管理」，是未實收的狀態，收到錢之後到那裡登錄實收。
三份新租約都在清單裡。接著還要另外處理：收到押金時到「押金管理」登錄實收、設定收款帳戶與每月繳款期間、到「收款管理」建立租金帳單、補電費設定；做法見下方「常見問題」與「接著閱讀」。
步驟 9：到租客管理核對租客狀態
位置：左側「租客服務」→「租客管理」
開啟「租客管理」，找到吳租客、鄭租客與周租客：三位的狀態都是「在住」，房間與當前租約顯示剛建立的那一份。鄭租客原本是「已退租」，建立租約後系統自動改回「在住」；吳租客與周租客原本是「待確認」。
租客狀態與新租約一致，不需要再回「批量操作」改狀態。
步驟 10：修正反向租期再重新預覽
位置：批量操作 → 租約批量創建 → 確認視窗
預覽列出「結束日期不可早於開始日期」時，按「取消」，回該列修正日期，再按「創建 N 份租約」重新預覽。同日起訖可以送出。
反向日期列未被建立；確認前可返回表格修正，成功列不需重新新增。
完成後
「批次處理結果」只剩你預期的失敗或全部成功，而且「租約管理」顯示新租約是「有效中」，期間、月租金與押金都與表格一致，「租客管理」顯示租客是「在住」，即完成建立。建立租約只是第一步：押金實收確認、收款帳戶、租金帳單與電費設定都還要另外處理。
疑難排解
押金：批量建立和單筆新增一樣，每份押金大於 0 的租約會在「押金管理」建立一筆未實收的押金記錄；實際收到後在那裡登錄實收。帳單：批量建立不會產生租金帳單；先設定收款帳戶與每月繳款期間，再到「收款管理」用「批量租金管理」建立帳單。電費：「電費計算方式」預設是「固定電費」，但「電費單價 (元/度)」是空的；有電費的租約請到「租約管理」→「編輯」→「電費設定」補上。租客資料：建立成功的租約會把租客改為「在住」並更新房屋、房號與租金，已退租的租客不需要另外處理。輸入錯誤：日期顛倒、月租金為 0、押金為負都會在預覽時被擋下；金額輸錯但仍合理（例如多打一個零）不會被擋，發現後到「租約管理」編輯修正。取消已建立的租約：到「租約管理」逐份按「封存」，租約移至封存區，可在「封存區」還原；房間會釋放，但押金記錄、已產生的帳單與租客的「在住」狀態不會自動退回，要另外處理。表格裡的下拉文字被截斷：視窗太窄時租客、房屋名稱會被截斷，請以確認視窗的完整名單為準。不要的行按該行的「刪除」。通知「選取已變更」：預覽之後表格內容改了，沒有送出任何變更，請重新按一次按鈕預覽。通知「沒有可執行的項目」：表格中的租約在預覽時全部被擋下，沒有送出任何變更，原因列在結果面板。左側沒有「批量操作」或頁面顯示「功能未啟用」：批量操作是團隊版的功能（14 天試用期間也可使用），目前的方案不含；請公司擁有者到左側「帳號管理」→「方案升級」查看，需要時寄出申請，開通後重新整理頁面。一般用戶直接開啟網址會顯示「權限不足」。若預覽或結果回報「資源不存在或無權執行此批次操作」，先請公司擁有者或公司管理者核對帳號角色、房屋分派是否啟用及本操作需要的權限；不要反覆送出同一筆。試用結束或授權到期：系統會在數分鐘內自動轉為免費版，並寄信通知公司擁有者。批量操作是團隊版的功能，轉換完成後左側不再有「批量操作」，從網址進入會顯示「功能未啟用」；轉換完成前（通常數分鐘內）畫面上方有橫幅說明，預覽仍可使用，但按下確認後批量寫入會被拒絕並顯示授權訊息。要繼續使用，請公司擁有者到左側「帳號管理」→「方案升級」寄出團隊版的開通或續約申請，開通後立即恢復。表格中的份數會讓公司的租約總數超過上限時，預覽就會失敗並寫明目前用量與上限，整批一份都不會建立。這個上限是房間級距的 20 倍（免費版 100、個人版 400／1000／2000、團隊版 1000／4000／10000；已結束的租約也計入，已封存的不計），舊方案的上限更小。對外計價雖然只看房間數與使用者數，這個上限卻是真正的限制，可以先封存不再需要的舊租約；仍不夠時，請從「方案升級」來信說明規模。 若送出時提示租客已封存，該列不會建立租約；重新整理並核對封存紀錄，需要續租時先由有權限的人員還原租客。 正式送出仍會逐筆重新檢查租客與房間未封存，租客與房間沒有其他有效中或草稿租約。若預覽後有人先封存或建立租約，該筆會失敗，租約、租金歷史與押金都不寫入；其他成功列保留，請核對結果再重試失敗列。 同一批失敗項目修正後重新預覽、確認送出，面板會保留首輪成功並更新重試結果；已從本次範圍移除的失敗列不再列入，通知只計本次送出的結果。關閉面板會清除前輪累計；若仍有請求處理中，回應到達後只顯示該次結果。加入新對象送出會重新計數；租客狀態改成另一個目標也視為新操作。預覽取消或網路失敗不會清掉前輪結果。 租客涉及多棟或歷史租約時，必須通過全部相關房屋的權限檢查；已封存、缺失或跨公司的關聯請由公司擁有者或公司管理者先核對處理。沒有任何房屋或租約關聯的待確認租客，管理員不能批次調整狀態，請交由公司擁有者或公司管理者處理。