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

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

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

來自 GSTN 入口網站的官方 GST 離線工具仍是申報 GSTR 報稅表的建議途徑,因為它會產生 GST 入口網站上傳端點設計用來接收的 JSON 承載。瀏覽器型本機轉換器並非用來取代該工作流程,但對於可安裝工具並不理想的幾種實際情境,它能派上用場:

  • 您所在的電腦無法安裝 GST 離線工具——例如受嚴格管控的辦公室筆電、權限受限的環境,或非 Windows 裝置。
  • Excel 活頁簿是在 Google Sheets、LibreOffice 或 Mac 上準備的,而您不想開啟 GST 離線工具就想取得 JSON 下載。
  • 您需要在上傳前,快速取得清理後資料的 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、Legal Name、Invoice Number、Invoice Date、Invoice Value、Place of Supply、Rate、Taxable Value、Integrated Tax、Central Tax、State Tax、Cess。
  2. 在現代的桌面瀏覽器中開啟 Excel 轉 JSON 轉換器。點擊檔案選擇器,從您的電腦中選取 .xlsx 活頁簿。超過 20 MB、有加密,或為舊版 .xls 格式的檔案將會被拒絕。
  3. 從工作表選擇器中,挑選您要匯出的單一工作表——例如 B2B、B2C 或 EXP——而非整本活頁簿。本工具每次執行只會匯出一張工作表。
  4. 點擊 Convert(轉換)。頁面會在您的瀏覽器中讀取活頁簿,建立 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 離線工具仍是能直接產生 GST 入口網站接受之 JSON 的途徑。

第二個表格列出頁面在剖析前強制執行的明確限制:

限制數值超出時的處理
活頁簿大小上限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、需要該申報表的特定結構描述時,請使用官方 GST 離線工具,這包含區段層級的彙總、HSN 摘要與文件層級的加總。當活頁簿含有巨集、自訂驗證,或含有預期會被工具重新計算、以公式驅動的加總時,請繼續使用官方工具;又或者當您是在一個已對應至官方工具輸入範本的企業合規工作流程中進行申報時,也請繼續使用官方工具。

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

延伸閱讀:如何在沒有 Excel 的情況下,於桌面應用程式中開啟線上 Excel。