使用 CSV 現況總表匯入租屋資料
適用於負責初次建檔的公司負責人與公司管理者；管理員只能匯入已獲指派權限的既有房屋。下載範本、把現有租客與租約整理成一份 CSV，上傳後先預覽（預覽不會寫入任何資料），修正錯誤列、確認額度，再一次匯入房屋、房間、租客與租約。匯入會為每份租約在押金管理建立一筆已收的押金記錄（收款日先記為租期開始日），但不會建立帳單、收款紀錄或合約文件。
開始前
- 用公司負責人、公司管理者或管理員的帳號登入。一般成員、租客與獨立房東看不到「資料匯入」；公司需已開通租客管理功能，左側選單才會有「租客服務」群組。公司唯讀時，範本下載、預覽與匯入都會被擋下：包括試用或付費剛到期、系統還在轉為免費版的短暫空窗（通常數分鐘內，稍後重新整理即可），以及免費版的啟用中成員或房間超過上限時（到期後轉為免費版，只有超過免費版額度才唯讀）。 管理員匯入既有房屋需同時有檢視與管理房間權限；包含租客或租約的列另需編輯權限，沿用租客時也需有該租客所有關聯房屋的檢視與編輯權限。新房屋請由公司負責人或公司管理者先建立，再依「邀請公司同事，並設定物件管理權限」完成房屋指派；管理員重新預覽，確認該列不再顯示權限錯誤後才匯入。
- 備好一份 Excel 的現況總表：每間房一列，至少要有房屋名稱與房號；有人住的列，請照目前有效的租約填租客姓名、租期、月租金與押金。完整欄位格式見下方「欄位對照表」。
- 匯入前先知道額度。對外計價只看房間數與使用者數：免費版 5 間房，個人版 20、50 或 100 間，團隊版 50、200 或 500 間，14 天試用 500 間房。已封存的房屋與房間不計入。但房屋、租客與租約也各有上限，達到時一樣不能新增：房屋上限等於房間級距（空房屋也計入），租客與租約上限是房間級距的 20 倍（免費版 100、個人版 400／1000／2000、團隊版 1000／4000／10000），已結束的租約與已搬離但未封存的租客仍計入；舊方案這三項的上限更小。房屋、房間、租客、租約四項只要有一項超過上限，整份檔案都不會匯入（沒有只匯入一半這回事）。
- 先知道匯入的範圍：會建立房屋、房間、租客與租約；每份租約的押金會在「押金管理」建立一筆已收的記錄，收款日先記為租期開始日；不會建立帳單與收款紀錄、收款帳戶設定、合約文件與附件，也不會開通租客登入帳號。匯入後還要補房屋地址、修正占位資料，再接續收款設定。
- 畫面使用「晴禾租屋（教學用）」的合成資料：房屋、租客皆為虛構，Email 為 example.invalid、電話為 0900000001 起。教學用範例檔不要匯入你的正式公司。
- 檔案大小最多 2MiB（2,097,152 bytes，包含剛好等於上限）；預覽與正式匯入採同一限制，超過時請拆成較小的 CSV。
操作步驟
步驟 1：開啟「資料匯入」頁面
位置：公司入口左側選單「租客服務」→「資料匯入」
在左側選單的「租客服務」群組按「資料匯入」。頁面由上而下分三段：「第一步 下載表格並填寫」、「第二步 上傳表格，核對內容」與「第三步 確認後匯入」。看不到這個選項時，確認登入帳號是公司負責人、公司管理者或管理員，並確認公司已開通租客管理功能；其他角色直接輸入網址也只會看到「權限不足」。
畫面標題為「資料匯入」，並看到「第一步 下載表格並填寫」。此時系統還沒有讀取或寫入任何資料。
步驟 2：下載填寫表格
位置：「資料匯入」→「第一步 下載表格並填寫」
按「下載填寫表格」。瀏覽器會下載 rent-roll-template.csv，用 Excel 開啟。範本第一列是 14 個欄位名稱（物件、房號、房型、租客、電話、email、身分證字號、租期、租金、押金、車位、車牌、現住YN、備註），下面有兩列「中山路一號」的示範資料。
電腦收到 rent-roll-template.csv。兩列示範資料只是範例，請改成自己的資料或整列刪除；留著的話會被當成真實資料匯入。第一列的欄位名稱請保留。
步驟 3：照範例一間房填一列
位置：「第一步 下載表格並填寫」→「照這個例子填」
每間房填一列；同一棟房屋的「物件」每一列都寫一樣的名稱，同一棟的同一房號只能出現一次。有人住：填「租客」姓名，「現住YN」填 Y，並照租約填「租期」、「租金」與「押金」。空房：「租客」留空、「現住YN」填 N。租金與押金只填數字，例如 12000。每個欄位的格式見本文的「欄位對照表」；頁面上的「其他欄位怎麼填（點開查看）」也可以展開查看。
你的表格每一列都是「一棟房屋＋一個房號」。這一步在 Excel 中完成，好寓|租屋管理系統 畫面不會有變化。
步驟 4：另存成 CSV UTF-8（逗號分隔）
位置：Excel「檔案」→「另存新檔」；操作提示在「第一步 下載表格並填寫」的「填完後，這樣儲存」
在 Excel 點「檔案」→「另存新檔」，檔案類型選「CSV UTF-8（逗號分隔）」，按「儲存」。不要改第一列的欄位名稱。若用一般的「CSV（逗號分隔）」，在中文版 Windows 常是 Big5 編碼，系統會拒絕並提示改選 UTF-8。電話欄請先把儲存格格式設為「文字」，開頭的 0 才不會消失。
得到副檔名 .csv 的檔案，例如「晴禾現況總表（教學用）.csv」。系統只接受 .csv，單檔最多 2000 列資料、2MiB（2,097,152 bytes，含上限）；多 1 byte 也會拒絕，超過請分批。
步驟 5：選擇檔案並等待自動預覽
位置：「資料匯入」→「第二步 上傳表格，核對內容」→「選擇填好的檔案」
按「選擇填好的檔案」輸入框，選取剛存的 CSV（這是瀏覽器內建的選檔控制項，依瀏覽器語言，按鈕可能顯示為「選擇檔案」或 Choose File）。選好後系統會自動預覽，沒有另一個「預覽」按鈕；輸入框會被清空是正常的，檔名顯示在下方「已選擇 …」。想換檔案時，按「清除選擇」或直接再選另一個檔。
出現「請核對匯入內容」：這個檔案共幾列、將新增的房屋、房間、租客與租約數量，以及「略過 N 列」與「有錯誤 N 列」。畫面註明「現在還沒有匯入」，預覽不會寫入資料庫。示範檔共 6 列：房屋 1、房間 3、租客 3、租約 3，略過 1 列、有錯誤 1 列。
步驟 6：核對方案額度
位置：預覽下方的「方案額度」區塊
逐行看房屋、房間、租客與租約：「目前」是公司現有數量（不含已封存的資料），「這次要新增」是這份檔案預計新增的數量，「方案上限」是公司目前的額度。新方案裡通常最先卡住的是「房間」；房屋的上限等於房間級距，租客與租約是房間級距的 20 倍，舊方案的上限更小（見上方「匯入前先知道額度」）。有錯誤的列不會佔用額度。四行都沒有超過，就可以繼續。
示範（個人版，20 間房）：房屋目前 1、新增 1、上限 20；房間目前 2、新增 3、上限 20；租客目前 1、新增 3、上限 400；租約目前 1、新增 3、上限 400，都沒有超過。有超過時請看下一步。
步驟 7：額度超過時的處理
位置：預覽下方「超過方案額度，無法匯入」區塊，與「第三步 確認後匯入」
只有額度超過時才會遇到這一步。任何一項超過上限，該行會變紅，區塊標題變成「超過方案額度，無法匯入」，並出現「查看方案與升級」；「第三步 確認後匯入」的「確認匯入」會停用，旁邊寫著「有項目超過方案額度，因此「確認匯入」已停用。」系統不做部分匯入。處理方式有三種：按「查看方案與升級」前往「方案升級」，選好方案後寄出申請（會開啟郵件軟體，沒有線上付款；好寓|租屋管理系統 開立帳單、收款後人工開通，開通後立即生效）；把檔案減到額度以內（分批、移除暫不需要的列）；或先把用不到的房間封存（已封存的房間不計入額度），再重新選檔預覽。以畫面上的「方案上限」為準，平台後台也可能人工調整單一公司的額度。
示範改用免費版（5 間房）、而且已有 3 間房的公司：房間目前 3、新增 3、上限 5，超過 1 項而變紅，「確認匯入」為灰色不能按。其餘三項（房屋 1、新增 1、上限 5；租客 1、新增 3、上限 100；租約 1、新增 3、上限 100）雖然沒有超過，也一樣不能匯入。額度調整或檔案縮小後，重新選檔預覽，確認四行都沒有紅字。
步驟 8：逐列檢查：新增、略過與錯誤
位置：預覽下方的「逐列檢查結果」表格
表格每一列的「狀態」徽章是「新增」、「略過」或「錯誤」；「原因與警告」說明這一列要做什麼。「新增」會寫入，「略過」是資料已經存在、不會重複建立，「錯誤」整列不會匯入，錯誤列的第一行是錯誤原因，後面幾行是沒有這個錯誤時原本會做的事。橘色字是警告，不會擋下匯入，但寫進去的可能是占位資料。文字的顏色不代表成敗，以「狀態」徽章為準。列號就是 CSV 的列號（表頭是第 1 列），可以在 Excel 找到同一列。
示範 6 列：第 2 列 101 沿用既有房間、新建租客與租約，並把房間改為已出租；第 3 列 102 沒填 email，警告會用占位 email 建立租客；第 4 列 103 的租客與租約已存在，狀態是「略過」；第 5 列 201 是「錯誤」，原因是租期迄日 2026-10-01 不晚於起日 2027-09-30（起迄顛倒）；第 6 列 202 是空房，只建房間；第 7 列 203 的租期「2026年10月起」無法解析，警告會以匯入當天起算一年當占位日期。
步驟 9：修正錯誤列後重新選檔
位置：Excel → 回到「第二步 上傳表格，核對內容」
回到 Excel，修正錯誤列（示範：把第 5 列的租期改成 2026-10-01~2027-09-30），一樣另存成 CSV UTF-8，再按「選擇填好的檔案」選擇修正後的檔案。新的預覽會取代上一份預覽。直到「有錯誤 0 列」、額度也沒有超過。警告不會擋下匯入，但建議先在表格改好；示範刻意保留第 7 列的警告，留到匯入後再到租約修正。
畫面顯示「有錯誤 0 列」，「第三步 確認後匯入」的「確認匯入」可以按。示範預計新增房屋 1、房間 4、租客 4、租約 4，略過 1 列。
步驟 10：按「確認匯入」並核對確認視窗
位置：「第三步 確認後匯入」→「確認匯入」→ 視窗「確認匯入這份資料」
按「確認匯入」，視窗會列出將新增的房屋、房間、租客與租約數量、包含的列（最多列 10 列，其餘寫「其餘 N 列」），以及「另有 N 列會略過、N 列因為有錯誤不會匯入」。確認無誤後按「開始匯入 4 位租客」（按鈕上的數字依內容而變）；想再檢查就按「取消」。只按一次並等候結果，頁面會用同一把鑰匙擋掉重複送出。
視窗說明這個操作只新增資料，並把有現住租客卻仍標示可租用的房間改為已出租，不會刪除既有資料；匯入之後若要移除，必須逐筆刪除。按下「開始匯入」後，系統會重新讀取你選的檔案並再算一次，再逐列寫入，不是直接套用預覽。
步驟 11：核對匯入結果
位置：「匯入結果」區塊與下方「逐列檢查結果」
先看「匯入結果」三行：「成功新增 N 列」、「略過 N 列」、「失敗 N 列」，再看下方表格的狀態：「已新增」、「已略過」或「失敗」。這裡以「列」計數，不是租客人數：一列可能同時建立房屋、房間、租客與租約。要看略過的原因，展開「略過的列（N）」。
示範：成功新增 5 列、略過 1 列、失敗 0 列，並出現「匯入完成」通知。區塊下方的「接下來」有「到租客清單看看」、「檢視租約」、「檢視房間」與「再匯入一個檔案」。
步驟 12：有失敗列時只修正失敗的列
位置：「匯入結果」→「失敗的列」
預覽有「錯誤」列卻仍按下匯入時，那些列會變成「失敗」，並在「失敗的列」逐列列出列號、房屋、房號與原因，同時出現「匯入完成，但有幾列失敗」的通知。預覽已標示錯誤的列不會寫入；寫入途中才失敗的列，可能已建立房屋、房間或租客，請先核對清單。房間或租客已有有效或草稿租約時，該列不會新增租約、押金或租金歷史；即使預覽通過，匯入途中也會重新檢查。先到「租約管理」確認既有租約並透過租約流程處理，再重新選檔預覽。其他失敗列修好後，可以只上傳失敗的那幾列，也可以重傳整份檔案，系統只會補上缺少的部分。若仍失敗，保留列號與原因文字向本平台客服回報。
示範（直接匯入有錯誤列的原始檔）：成功新增 4 列、略過 1 列、失敗 1 列，失敗的是第 5 列，原因是租期迄日不晚於起日。修正該列並重新選檔、預覽、確認後，才會補上這一列。
步驟 13：到租客清單確認租客
位置：「匯入結果」→「到租客清單看看」→「租客管理」
按「到租客清單看看」，核對新匯入的租客姓名、電話、房屋與房間、租期、月租與押金。沒填 email 的租客（示範：林租客）會顯示以「import-」開頭、「@import.local」結尾的占位 email，這個信箱不存在、寄不出信；開通租客帳號前，請在租客資料補上本人的有效 email 或手機號碼。匯入完成後，租客、租約、房間、房屋與押金清單都會直接更新，不必重新整理頁面。
清單依建立時間由新到舊列出新租客，狀態為「在住」；示範共 5 位，其中周租客是原本就有的。已存在的租客不會被這次匯入改寫姓名、電話或 email。
步驟 14：到租約管理核對租約與占位租期
位置：左側選單「租客服務」→「租約管理」
核對每份租約的租客、房屋與房間、租約期間、月租金、押金，狀態應為「有效中」；清單另有「合約」「續約」兩欄，匯入的租約都顯示「尚未產生」「尚未發起」，因為匯入不建立合約文件。特別留意租約期間是占位日期的租約（示範：吳租客 2026/10/14 至 2027/10/14，因為 CSV 的租期無法解析），按該列的「編輯」改成實際租期。押金同時會在「押金管理」建立一筆已收的記錄，收款日先記為租期開始日；實際收款日不同時，到「押金管理」按該筆的「更正收款日」，選擇款項實際收到的日期後再按「更正收款日」，不必先撤銷實收。
示範共 5 份租約，都是「有效中」；吳租客的期間為占位日期，需要編輯。 房況依目前的有效或草稿租約推導；若其他人已終止租約，匯入不會把房間改回「已出租」。略過既有租約的列也會重新核對房況。
步驟 15：到房間管理確認房間狀態
位置：左側選單「資產管理」→「房間管理」
核對房號、房屋、狀態與租客。原本標示「可租」、這次有現住租客的房間（示範：101）已改為「已租」；「現住YN」填 N 的空房（示範：202）維持「可租」。既有房間的房型與租金不會被覆寫，新房間的房型與租金來自 CSV。
示範共 6 間房間：新增 102、201、202、203；101、102、103、201、203 為「已租」，202 為「可租」。
步驟 16：到房屋管理確認新房屋並補地址
位置：左側選單「資產管理」→「房屋管理」
核對房屋名稱與已租、可租房間數。匯入新建的房屋沒有地址資料，系統暫時用房屋名稱當作地址（示範：「晴禾巷弄（教學用）」的地址欄也是同一個名稱）；請在該房屋右側按「更多」→「編輯房屋」，補上實際地址。
示範共 2 棟房屋：晴禾巷弄（教學用）已租 2、可租 1；晴禾公寓（教學用）已租 3，並沿用原有地址。匯入完成；接著補地址、修正占位租期與 email，再做收款設定。
步驟 17：逐列核對個資與封存原因
位置：資料匯入 → 逐列檢查結果
逐列讀取電話、Email、證號、房屋名稱、占用租約及封存原因。錯列不會匯入；先核對原始資料，不要填入別人的 Email 或另建重複房間。帶時區日期會換成台北日期。
本例 8 列中有 7 列錯誤，只有台北日期 2026-10-02 至 2027-10-01、租金與押金皆為 0 的合法列可匯入；0 元仍需日後核對。
步驟 18：確認只有合法列寫入
位置：資料匯入 → 匯入結果
確認匯入後讀取成功與失敗列。本例只匯入 1 位租客，7 個錯誤列保留具體原因。修改 CSV 的錯列，再重新選檔及預覽。
合法列保留；錯列沒有建立半套房屋、房間或租約，不需重新建立成功資料。
步驟 19：檢查剛好 2MiB 的檔案
位置：資料匯入 → 第二步上傳表格
選取 CSV。大小剛好 2,097,152 bytes 可以進入內容檢查，仍須核對列數、欄位、租期及額度，並確認後才匯入。
預覽出現代表通過檔案大小檢查，尚未匯入資料。
步驟 20：超過一個位元組時縮小檔案
位置：資料匯入 → 第二步上傳表格
2,097,153 bytes 已超過上限，畫面會顯示檔案太大。刪除不需要的資料或拆分 CSV 後重新選檔，不要只改副檔名。
超限檔案在前端被拒絕，不會送出匯入 API 或寫入資料。
步驟 21：重新選擇修正後的 CSV
位置：資料匯入 → 選擇填好的檔案
重新選取縮小後的 CSV。確認舊大小錯誤已清除，再逐列核對新預覽，最後才按「確認匯入」。
本次預覽對應新檔案，不會沿用超限檔案的錯誤。
步驟 22：上傳格式錯誤時重新選檔
位置：資料匯入 → 第二步上傳表格
出現「上傳內容格式不完整或不正確，請重新選擇檔案後再試」時，重新選擇正確的 CSV。這是上傳內容錯誤，還沒有進入逐列匯入。
標準輸入錯誤不會寫入資料；重新選檔成功後，才可核對預覽。
完成後
在「匯入結果」看到成功、略過與失敗的列數，失敗為 0（或失敗的列已修正並補匯入），並在租客、租約、房間與房屋清單確認資料。匯入只建立資料，還不能開始收租：接著補房屋地址、修正占位租期與占位 email，再依序設定收款帳戶與每月繳款期間、開通租客帳號、批量建立租金帳單。匯入的押金會出現在「押金管理」，視為已收、收款日先記為租期開始日；日期不對時，在那裡按該筆的「更正收款日」改成實際收款日。
疑難排解
看不到「資料匯入」或進入後顯示「權限不足」：確認登入帳號是公司負責人、公司管理者或管理員，並確認公司已開通租客管理功能。出現「僅能查看資料」之類的訊息：公司目前是唯讀，可能是試用或付費剛到期、系統還在轉為免費版（通常數分鐘內，稍後重新整理就會恢復），也可能是免費版的啟用中成員或房間超過上限（需先停用或移除成員、封存房間，或升級，見「管理公司成員」篇的免費版超額說明）。選檔後出現紅字：只接受 .csv、不能是空檔、不能超過 2MB 與 2000 列；說「不是 UTF-8」就改存成 CSV UTF-8；說缺少「物件」或「房號」欄位，就檢查第一列欄位名稱；說雙引號沒關，就修正該列的引號。這類整份被擋下的問題修好後重新選檔即可，「重新預覽」只在預覽失敗時出現。單列的錯誤：房屋名稱在公司內有多棟同名或在封存區，先改名或到封存區還原；房間在封存區，先還原；房間已有其他租客的有效租約，先到「租約管理」處理退租或終止；同一房號換了人、這一列又沒填 email，系統無法確定是不是同一人，請為該列填上 email；email 已被其他公司的租客使用，改用別的 email 或留空；管理員的房屋權限會在預覽、確認與重試時重新檢查；缺少檢視、管理房間或該列需要的編輯權限時，該列會被擋下。新房屋由公司負責人或公司管理者先建立並完成指派，再由管理員重新預覽。若權限在匯入期間變更，先到房屋與租約清單核對已完成的資料，再請有權限的人員確認結果。預覽出現「超過方案額度，無法匯入」：見步驟 7，整份檔案不會匯入，要升級方案、縮小檔案或先封存用不到的房間；免費版一共只能有 5 間房。範本的兩列示範資料沒刪就會被匯入。匯入後沒有一鍵復原，需逐筆刪除或封存；為了避免重複，請先確認預覽再按確認。同一份檔案重複匯入是安全的，已存在的資料會略過。預覽與結果表最多顯示 500 列（錯誤列優先），摘要與數量是全部列。 若預覽後租客或房間已被封存，或租客、房間已有其他有效中或草稿租約，確認匯入時該列不會建立租約、租金歷史或押金。先重新整理，核對封存區與租約清單，必要時由有權限的人員還原或處理既有租約，再重新預覽；其他已成功的列仍保留。 租約日期按台北日曆日判定。含時區時間的輸入會先換算台北日期；例如 9 月 30 日 07:59 到期與 08:00 起租都屬 9 月 30 日，同日交接的電費須按實際用量人工核對。 預覽後房屋被封存時，該列也不能新增房間；先還原房屋再重新預覽。含時間的租期必須帶完整時區，例如 2026-10-31T23:30:00-0800 與 2026-10-31T23:30:00-08:00 都會換算為台北 2026-11-01。沒有時區、不支援或不真實的時間戳會逐列拒絕，請改成 YYYY-MM-DD 或完整 ISO 時間戳後重新預覽。 預覽與確認匯入均檢查租客電話、Email、證號格式及證號檢查碼；錯誤會列在該列且不寫入該列資料。修正 CSV 後重新預覽；選填個資可留空。 Email 可使用 +tag，不能含逗號或分號；預覽與確認匯入都會重新檢查。 CSV 大小上限含等號：2 MiB（2,097,152 bytes）可上傳，超過時請縮小檔案或分批匯入；預覽及確認匯入使用相同限制。 若提示「上傳內容格式不完整或不正確，請重新選擇檔案後再試。」，請重新選擇 CSV 再送出；尚未完成預覽或確認匯入時，不會建立資料。 新建房屋的名稱在移除頭尾及合併連續空白後須為 2–100 字。CSV 沒有地址欄，新屋先以名稱作佔位地址；匯入後請到房屋編輯補齊真實地址（5–200 字）。既有房屋不會由匯入改名或更新地址。 CSV 上限為 2,097,152 bytes（2 MiB），剛好等於上限可預覽；多 1 byte（2,097,153 bytes）即拒絕，錯誤訊息會列出精準大小與上限。請拆檔後重新選擇。 匯入逐列處理。同一列新增的房屋、房間、租客、位置及租約必須一起成功；確認期間房間被封存，或建約、押金及租金歷史建立失敗時，該列新增資料全部不保留，原有資料維持原狀，其他成功列仍保留。先查看失敗原因，核對封存狀態與現有租約，再重新選檔並預覽。
延伸閱讀
同主題的其他教學
相關功能與租務核對清單
給自管房東與代管團隊的延伸參考：了解本篇對應功能，或先用清單核對業務資料。