Excel 轉 JSON 轉換器可將本機 .xlsx 活頁簿中的單一工作表,直接在您的瀏覽器分頁中轉成可讀的 JSON 檔——無需上傳至伺服器、無需安裝,也無需登入。對於在 Excel 中準備 GSTR-1、GSTR-3B 或其他 GST 申報資料的使用者而言,這提供了一條快速的本地路徑,可在 GST 官方離線工具之外產生 JSON 下載。當無法使用可安裝的工具、活頁簿已先在另一套試算表中清理完成,或需要在 JSON 送進 GST 入口網站之前先行檢視輸出內容時,這個工具特別實用。本工具僅讀取已儲存的儲存格內容,絕不會執行公式、巨集或外部連結,並會將結果以 JSON Blob 寫入,由瀏覽器透過一般的下載提示存檔。整個過程中,您的活頁簿都留在自己的電腦上。這使得它成為 GST 離線工具的實用搭配或備援方案,適合任何想要快速、注重隱私地完成 Excel 轉 JSON 交接、卻不想啟動桌面應用程式的人。

how to convert excel to json in gst offline tool
如何在 GST 離線工具之外將 Excel 轉換為 JSON

為何瀏覽器型轉換器能與 GST 離線工具互補

GSTN 入口網站提供的官方 GST 離線工具,仍是申報 GSTR 報表的首選途徑,因為它所產生的 JSON 酬載,正是 GST 入口網站上傳端點所設計接受的格式。瀏覽器型的本地轉換器並非要取代該流程,而是能在可安裝工具不敷使用的真實情境中派上用場:

  • 您所使用的電腦無法安裝 GST 離線工具——例如受到管制的辦公室筆電、權限受限的環境,或非 Windows 裝置。
  • Excel 活頁簿是在 Google Sheets、LibreOffice 或 Mac 上製作的,而您想直接取得 JSON 下載,完全不開啟 GST 離線工具。
  • 您需要在上傳前,將清理過的資料快速預覽為 JSON,方便與同事、稽核人員或開發人員分享。
  • 在將工作表交給 GST 離線工具之前,您想確認該工作表的列是否格式正確——標頭不重複、沒有空白列、沒有合併儲存格。

在上述任一種情況下,Excel 轉 JSON 轉換器都會在本機讀取活頁簿,並在幾次點擊之內產生 JSON 檔。

底層的轉換運作原理

這個工具有意將範圍縮得很窄。當您選擇一個 .xlsx 活頁簿時,頁面會先檢查該檔案是否為經典的 OOXML ZIP、大小不超過 20 MB、不是 Zip64 或多片磁碟封存,且其宣告的展開大小與項目數都在安全範圍內。只有通過這些檢查之後,才會載入一個鎖定在瀏覽器端的解析器來讀取試算表封存檔。

解析器僅讀取已儲存的儲存格內容。它不會計算公式、執行巨集、追蹤外部連結,也不會解讀內嵌內容。這對 GST 使用者很重要,因為含有大量公式的 GSTR 工作表(例如計算「應稅金額加上整合稅」這類稅額的工作表)匯出時,會輸出最後一次儲存的數字,而不是重新計算後的結果。若活頁簿上次是在 Excel 中編輯,這些數字通常如您所預期;但若是在 Google Sheets 中編輯、而公式從未有機會重新計算,請先在 Excel 中開啟並存檔,以更新儲存的值。

所選工作表中第一個非空白列會被視為欄位名稱列。每一個標頭都不可為空且不可重複,因為在 JSON 物件中重複的鍵會無聲地覆寫資料。接下來的每一列則會成為一筆 JSON 記錄。空白的儲存格會變成 null。已儲存的文字、數字與布林值則會以一般 JSON 值的形式保留下來。

在本地將 Excel 轉成 JSON 以利 GST 申報

請依照下列步驟,從清理過的 GST 工作表產生 JSON 下載:

  1. 在 Excel 或相容的編輯器中,以一般 .xlsx 活頁簿的形式開啟您的 GSTR 工作表。刪除完全空白的列、不要合併任何儲存格,並確認第 1 列是包含唯一欄位名稱的乾淨標頭列,例如 GSTIN、法律名稱、發票號碼、發票日期、發票金額、供應地點、稅率、應稅金額、整合稅、中央稅、州稅、附加稅。
  2. 在現代的桌面瀏覽器中開啟 Excel 轉 JSON 轉換器。點選檔案選擇器,從電腦中選取 .xlsx 活頁簿。超過 20 MB、經過加密或採用舊版 .xls 格式的檔案將會被拒絕。
  3. 在工作表選擇器中,選擇您要匯出的單一工作表——例如 B2B、B2C 或 EXP——而非整本活頁簿。本工具每次執行僅匯出一張工作表。
  4. 點選「轉換」。頁面會在您的瀏覽器中讀取活頁簿,建立 JSON Blob,並觸發下載。過程中沒有任何資料會離開您的電腦。
  5. 在文字編輯器中開啟下載下來的 .json 檔,或將其送入 JSON 格式化工具,讓每一筆記錄各自位於一個縮排區塊中。將前三筆與最後三筆記錄與來源工作表進行抽核。
  6. 將原始的 .xlsx 留作您的紀錄來源。將 JSON 下載視為供檢視、分享或下游工具使用的快照,而非具權威性的版本。

限制與本工具無法做到的事

透過一個簡單的比較,可以為 GST 申報人釐清兩條路徑之間的預期差異:

面向GST 離線工具(官方)Excel 轉 JSON 轉換器(瀏覽器)
需要安裝是——Windows 桌面安裝程式否——在瀏覽器分頁中執行
資料處理位置本地桌面電腦本地瀏覽器分頁
檔案是否上傳至伺服器僅在您將 JSON 推送至 GST 入口網站時全程皆不上傳
接受 .xlsx是,另外也接受工具本身的範本是,經典 OOXML .xlsx 上限 20 MB
接受舊版 .xls否——請先轉換為 .xlsx否——請先轉換為 .xlsx
執行公式是——載入時重新計算否——僅讀取已儲存的值
輸出目的地可供 GST 入口網站上傳接受的 JSON您下載到本機的 JSON 檔
結構描述保證符合 GSTR 申報結構描述無——僅根據您的標頭產生通用 JSON
每張工作表的儲存格地址上限由官方工具設定100,000 個已定址儲存格

結構描述這一列是兩者之間最關鍵的差異。瀏覽器工具不會驗證輸出是否符合任何特定的 GSTR 申報結構描述,因此其 JSON 最適合用於檢視、撰寫指令稿或內部交接。能直接產出 GST 入口網站所接受 JSON 的,仍是官方 GST 離線工具。

第二個表格整理出頁面在解析前會強制執行的明確限制:

限制數值超過時的處理方式
活頁簿大小上限20 MB在載入解析器前即拒絕
活頁簿格式經典 OOXML .xlsx拒絕(不接受 .xls、.xlsm、.xlsb、.ods)
Zip64 / 多片磁碟封存不支援在載入解析器前即拒絕
所選工作表的已定址儲存格數100,000中止並顯示錯誤,不會輸出部分結果
有密碼保護的活頁簿不支援拒絕並顯示錯誤

轉換前的工作表準備工作

由於轉換器僅讀取已儲存的內容,JSON 輸出的品質便受工作表品質所限制。在匯出 GST 工作表之前,先進行下列幾個實務步驟,可避免常見的意外:

  • 在最上方放置唯一的標頭列。若您的工作表含有標題列、空白的分隔列,或同時具有兩個標頭列(「人類可讀」標頭加上「代碼」標頭),請先將其攤平,讓轉換器只看到單一且不重複的欄位名稱列。
  • 刪除記錄之間的空白列。Excel 中的空白列會在輸出中變成空白的 JSON 物件,導致檔案雜亂,也可能干擾後續的解析作業。
  • 避免合併儲存格。合併儲存格在儲存時只會保留單一值橫跨其他位置;取消合併後,每個欄位才能各自獨立呈現。
  • 在下游 JSON 消費者無法重新計算的情況下,請以儲存值取代公式。複製該公式欄,然後選擇「選擇性貼上 → 值」。
  • 對於日期,請注意轉換器匯出的是活頁簿所儲存的數值。若您需要 ISO 8601 格式的字串(例如 2024-12-31),請在匯出前先在 Excel 中將該欄格式化為日期字串,或在後續以指令稿處理 JSON。

本工具不會推論巢狀物件、不會對數值進行正規化、不會驗證商業結構描述,也不會修復公式。JSON 是一種資料表示法,而非試算表的複製品,因此格式設定、條件式格式、圖表、影像、註解、篩選器、列印設定、活頁簿保護、命名範圍以及公式的原始文字,皆不在匯出範圍內。若您需要在匯出前檢視版面配置,請先在 Excel 相容的檢視器中開啟檔案。

何時應繼續使用官方 GST 離線工具

瀏覽器轉換器是有用的助手,但無法取代 GST 入口網站所驗證的那條路徑。當您要產生可直接上傳至 GST 入口網站的 JSON、需要符合該申報項目專屬的結構描述(包括分區彙總、HSN 摘要與文件層級的加總)時,請使用官方 GST 離線工具。當活頁簿含有巨集、自訂驗證,或含有公式驅動、預期工具會重新計算的加總時,也請繼續使用官方工具;又或者您是在已對應到官方工具輸入範本的企業合規流程中進行申報時,亦同。

至於其他情境——快速的 JSON 預覽、開啟 GST 離線工具前的健全性檢查、與開發人員分享清理過的資料,或是在沒有安裝權限的電腦上作業——本地的 Excel 轉 JSON 轉換器都能產生可預期且可供檢視的 JSON 下載。若想更深入地了解使用同一個轉換器進行類似 GST 導向流程的操作,請參閱這篇 適用於 GST 的本地 Excel 轉 JSON 工作流程