在瀏覽器開啟本機 .xlsx 活頁簿、選取存放稅務資料的工作表,再把紀錄下載成 JSON 檔,即可把 Excel 檔轉成 ITR 申報用的 JSON——不上傳、沒有伺服器佇列,轉換頁也不會保留該活頁簿。匯出檔對每一列資料各含一個 JSON 物件,欄位名稱取自工作表第一列非空白列,因此乾淨的標題列是最重要的單一準備步驟。因為整條流程都在目前瀏覽器分頁執行,薪資明細、Form 26AS 摘錄、資本利得帳本與銀行利息表都會留在裝置上,直到你刻意把 JSON 檔交給另一個工具。

為什麼 ITR 申報常常需要 JSON 而不是 Excel
多數納稅人把所得、扣除額與資本利得資料放在 Excel,因為試算表容易編輯、也容易分享。然而所得稅入口網站在納稅人使用第三方申報工具、以 JSON 為基礎的結構描述,或會在送出前預先驗證申報的開發者友善準備工具時,愈來愈常期望結構化輸入。JSON 讓每一列都有一組可預測的鍵,讓指令碼能把欄位對應到特定 ITR 附表,不必猜欄字母,也不必剖析合併儲存格。
當「TDS deducted」這類欄位必須落到特定附表列,或依銀行的利息明細必須維持分組在像「bank_name」這樣穩定的鍵底下時,這種可預測性就很重要。試算表仍適合人工編輯,但 JSON 檔對任何程式化交接都更乾淨,包括離線 ITR 工具、稽核指令碼,以及把 AIS 資料與你的活頁簿比對的對帳工具。
Excel 轉 JSON 轉換器會做與不會做的事
Excel 轉 JSON 轉換器 從本機 .xlsx 活頁簿取出一張選定的工作表,把以標題為準的列轉成你可檢查、下載,或交給另一個本機工作流程的 JSON 檔。頁面在瀏覽器分頁內讀取活頁簿,並建立供下載的 JSON Blob;活頁簿不會上傳到轉換伺服器、不會排隊處理,也不會被工具保留。轉換一律產生新的下載,絕不會更動你電腦上儲存的活頁簿。
本工具刻意只讀取已儲存的儲存格值。它不執行試算表公式、巨集、外部連結、指令碼或內嵌內容,因此公式儲存格會匯出 Excel 上次儲存的值,而不是在瀏覽器裡重新計算。格式、欄寬、條件式格式、圖表、圖片、註解、篩選、列印設定、活頁簿保護、定義名稱,以及公式原始文字都不在此次匯出範圍內,因為 JSON 是資料表示,不是試算表複本。
轉換前如何準備 Excel 工作表
JSON 物件無法像工作表那樣容忍含糊。兩個重複的標題會在結果物件中互相覆蓋,因此你所選工作表的第一列非空白列,必須為每個打算匯出的欄提供獨一無二且非空白的名稱。請在 Excel 本身重新命名任何重複項——例如把「TDS」與「TDS_2」改成「TDS_1」與「TDS_2」——而不是讓工具發明會讓 JSON 更難稽核的欄位名稱。
空白儲存格在輸出中變成 null,這對真正缺漏的資料有用,但當空白儲存格只是代表「我忘了填」時就有害。把工作表從頭看過一遍,決定實際上要匯出哪些列,轉換前先填上空白或刪除有問題的列。若某一欄含有日期,請記住本工具匯出的是活頁簿儲存的數值;它不會猜測地區或日期意圖,因此視覺上看起來是「01-04-2024」的欄,除非你在儲存前已把儲存格格式化成可辨識的文字或 ISO 日期字串,否則可能匯出成 Excel 序號。
讓活頁簿保持小而聚焦。為 ITR 資料選最小的相關工作表——通常是薪資、TDS 或資本利得——並把摘要表、樞紐分析表與參考表排除在匯出之外。若你需要先目視檢查資料,請在本機 Excel 檢視器開啟檔案,不要用雲端服務。
把 Excel 轉成 ITR 申報用的 JSON
- 把活頁簿存成一般 .xlsx 檔。轉換器只接受標準 OOXML 格式,並拒絕舊版 .xls 檔、啟用巨集的格式、受密碼保護的檔案,以及雲端網址。
- 在瀏覽器分頁開啟 Excel 轉 JSON 轉換器。確認要轉換的檔案在同一裝置上,且不大於 20 MB。
- 從檔案挑選器選擇本機 .xlsx 活頁簿。頁面會在讓 SheetJS 讀取活頁簿之前檢查傳統 ZIP 目錄、宣告的展開套件大小,以及項目數量,並直接拒絕 Zip64 或多磁碟套件。
- 選取第一列非空白列含有欄位名稱的工作表。每個標題都必須非空白且獨一無二,否則重複的鍵會在 JSON 物件中覆蓋資料。
- 點選轉換動作,等待頁面建立 JSON Blob。轉換會讀取已儲存的文字、數字與布林值;空白儲存格變成 null。
- 下載產出的 .json 檔,並在交給 ITR 入口網站、指令碼或第三方申報工具之前,先在本機開啟。
儲存格值如何對應到 JSON 紀錄
每一列非標題列都會變成一筆 JSON 紀錄,其鍵來自你的標題列。已儲存的文字值呈現為 JSON 字串,已儲存的數字呈現為 JSON 數字,已儲存的布林值呈現為 JSON 的 true 或 false。空白儲存格變成 null,這是「沒有儲存任何值」的誠實表示,通常也是 ITR 資料所需要的。
日期是最常見的意外。因為本工具不執行公式、也不推斷地區,日期欄會匯出底層數值序號,除非該儲存格是以格式化文字儲存。在建立來源工作表時就為此規劃:要麼把日期格式化成你能掌控的文字字串,要麼接受任何下游指令碼都必須解讀該序號。貨幣符號、百分比符號與千分位分隔符只是顯示格式,匯出時會被剝除,因此顯示為「₹5,00,000」的薪資儲存格會匯出成數字 500000。
使用前如何驗證 JSON
使用下載的 JSON 檔之前,一律先開啟一次。用本機 JSON 格式化器 把紀錄美化列印,對照來源工作表點算列數,並確認欄位名稱符合 ITR 工具的期望。快速讀過前三筆與後三筆紀錄,就能在把壞資料傳進申報工作流程之前,抓住多數標題錯誤、缺漏列與非預期的 null。
若下游指令碼拒絕該檔,把相同內容貼進 JSON 驗證器,確認檔案語法有效。ITR 工具裡多數「匯入失敗」錯誤,可追溯到多餘的結尾逗號、從複製貼上混入的彎引號字元,或在 Excel 插入欄之後變成重複的標題。
須留意的限制與錯誤
轉換器的範圍刻意做得很窄。選定的工作表必須維持在 100,000 個已定址儲存格以內,活頁簿也必須通過頁面在讀取任何試算表內容前執行的 ZIP 層安全檢查。損壞、加密、過大或不支援的活頁簿會以錯誤停止,而不是產出部分下載,這對稅務相關匯出是正確行為。
| Excel 功能 | JSON 檔中的結果 |
|---|---|
| 儲存格內已儲存的文字 | JSON 字串值 |
| 儲存格內已儲存的數字 | JSON 數值 |
| 儲存格內已儲存的布林值 | JSON 的 true 或 false |
| 空白儲存格 | JSON null |
| 公式儲存格 | 上次儲存的值,而非重新計算 |
| 巨集、外部連結、內嵌指令碼 | 不執行、不匯出 |
| 欄寬、格式、圖表、註解 | 不在匯出範圍內 |
| 活頁簿類型 | 轉換器是否接受 |
|---|---|
| 標準 .xlsx OOXML 活頁簿 | 是 |
| 舊版 .xls 檔 | 否 |
| 啟用巨集的 .xlsm 或 .xlsb | 否 |
| 受密碼保護的活頁簿 | 否 |
| 雲端網址或遠端共用連結 | 否 |
| 大於 20 MB 的活頁簿 | 否 |
| Zip64 或多磁碟套件 | 否 |
本工具不合併活頁簿、不推斷巢狀物件、不正規化值、不驗證業務結構描述,也不修復公式。若你的 ITR 工作流程需要巢狀結構,例如依銀行分組的利息,請在下載 JSON 檔之後用指令碼建立該分組——轉換器的工作是在明確的瀏覽器安全限制內,透明地本機匯出所選工作表已儲存的儲存格值。把原始活頁簿當正式紀錄來源,把 JSON 當成任何時候都能重新產生的衍生交接檔。
相關閱讀:如何在瀏覽器預覽中線上開啟 Excel 檔。