把記錄帶進 Topf

Topf 讀取 CSV，這是一種常見的表格格式。如果銀行或 App 的匯出格式中有 CSV，請選擇它。欄位之間可以用逗號、分號或定位字元分隔，Topf 會自己判斷。

• Excel：「檔案」、「另存新檔」，格式選 CSV UTF-8。
• Numbers：「檔案」、「輸出為」、CSV。
• Google 試算表：「檔案」、「下載」，格式選 CSV。

一個檔案最多 50,000 列、20 MB。更大的表格最好拆成幾個檔案，例如每年一個。

如果字母變成奇怪的符號，表示檔案不是 UTF-8，而是較舊的編碼。Topf 不會用猜的：它會顯示檔案裡的文字在五種編碼下的樣子，選擇顯示正確的那一種即可。

對帳單的表格上方常有幾列關於帳戶的說明。Topf 會找到欄位名稱所在的列；如果找錯了，打開檔名下方的選單，選擇另一列，或說明沒有標題列。

交易的每個欄位對應檔案裡的一欄。只有日期和金額是必要的；其他欄位沒有時會這樣處理：

• 帳戶：在下一步為整個檔案選擇一個。
• 類別：支出記入「其他支出」，收入記入「其他收入」。
• 備註：沒有備註。
• 貨幣：帳戶的貨幣。
• 時間：取日期裡的時間，或中午 12 點。

只有在確定無誤時，Topf 才會自己填入欄位：欄名和欄位名稱完全相同，而且每個值都能辨識。從 Topf 匯出的檔案會被完整辨識，Topf 支援的任何語言都可以。手動選擇的項目不會被自動改掉。

檔案裡的金額有三種寫法，金額的選單都能處理：

• 「單一欄，帶正負號」：支出帶負號，收入不帶。不需要任何操作。
• 「支出不帶負號」：適用於支出寫成正數的檔案。不選這一項，支出會被當成收入。
• 「支出和收入分欄」：適用於借方和貸方分成兩欄的對帳單。兩欄都要選。

寫成 1,234 的金額：如果逗號分隔千位，就是 1234；如果逗號是小數點，就是 1.234。如果一欄有兩種讀法，Topf 會詢問，並顯示每種情況各讀成什麼。

像 05/04/2026 這樣的日期，在一些國家是4月5日，在另一些國家是5月4日。Topf 依整欄判斷：如果每個值都有兩種讀法，它會詢問並顯示兩種讀法。

沒有時間的交易記在中午 12 點；今天的交易不會晚於目前這一分鐘。未來的日期不會匯入。

在「帳戶和類別」這一步，檔案裡的每個帳戶和類別各佔一列，在這裡決定去處：帳本裡的某個帳戶或類別、新增帳戶或類別，或「不匯入」。

只有答案唯一時，Topf 才會自動對應：名稱和貨幣都相同的帳戶，名稱和類型都相同的類別，或這個檔案上次匯入時建立的項目。如果有好幾個都符合，這一列會要求選擇，按鈕也會等待。

新帳戶的餘額從零開始，之後等於其中交易的總和：CSV 檔案沒有期初餘額。之後可以在帳戶裡修正。

在免費版中，匯入最多建立免費版允許數量的新帳戶；其餘的會停在「不匯入」，旁邊標有 Plus。類別沒有數量限制。

從 Topf 匯出的檔案會被完整辨識：欄位會自動對應，帳戶和類別依 ID 找到。用它可以把交易搬到另一個使用者帳號，或找回曾經匯出的內容。檔案裡只有交易：預算、定期交易和期初餘額不會跟著移轉；以主要貨幣計的金額也不會讀取，因為匯率會依每個日期重新取得。

在所有帳戶的匯出中，一筆轉帳佔兩列，Topf 會把它們重新合成一筆轉帳。單一帳戶的匯出只包含這個帳戶的一側；如果另一個帳戶已經以相同貨幣存在於帳本中，這一側會成為轉帳。銀行和其他 App 的檔案沒有這種成對的列：每一列都會成為一筆支出或收入，因為依日期和金額把列配對只能用猜的。

把同一個檔案再次匯入同一個帳戶，不會新增任何內容。互相重疊的對帳單，例如有幾天重疊的兩個月，每筆交易只會加入一次。匯入到另一個帳戶時，同一個檔案會重新加入。沒有登入帳號時匯入過的檔案也是如此：連接帳號後，同一個檔案可能會再次加入這些列。

Topf 依整列內容辨識一列。如果銀行每次都重新編號或修改列，這些列可能會再次加入。匯入前請核對「帳戶和類別」頂部那一列顯示將加入幾筆；如果結果不對，就復原整個匯入。

在 Topf 裡刪除的交易，再次匯入不會恢復：匯入是移入資料，不是還原備份。

無法準確讀取的列，Topf 不會去猜。「帳戶和類別」頂部那一列會統計這些列；「詳細資訊」會列出每一列和原因：

• 沒有日期或金額，或日期不存在；
• 日期在未來，或金額為零；
• 小數位數超過該貨幣允許的位數；
• 貨幣無法辨識，或和帳戶的貨幣不同；
• 備註超過 280 個字元。

貨幣可以寫成代碼，例如 EUR，也可以寫成符號，例如 €。$ 和 ¥ 屬於好幾種貨幣，因此需要寫代碼。

再次打開匯入，點一下「上次匯入」下方的「復原匯入」並確認。這次匯入的交易會離開帳本，匯入後修改過的也一樣；它建立的帳戶和類別如果沒有其他地方在用，也會一併移除。

復原會保留在這部裝置上，直到下一次匯入。其他裝置上無法復原；沒有登入帳號時完成的匯入，連接帳號後就不能再復原。復原之後，可以用任何選擇重新匯入同一個檔案。

如果匯入到一半時關閉了 Topf，已寫入的內容會留在帳本裡，同樣可以復原：匯入畫面會顯示已寫入幾筆、共幾筆。

匯入是免費的。每筆交易以所屬帳戶的貨幣記入，換算成主要貨幣的匯率依交易日期取得，和補記過去某天的交易時一樣。