JSON 轉 Excel 轉換器可在您的瀏覽器中,將 JSON 物件陣列轉換成單一工作表的 .xlsx 活頁簿,檔名為 converted.xlsx,最多可處理 10,000 列與 200 欄資料,且絕不上傳資料內容 —— 這個限制符合 GST 使用者通常要求的離線、隱私至上原則。當您貼上非空白的 JSON 陣列(其項目為物件),並選擇「Convert to Excel」時,頁面會建立本地端下載,同時保留物件中欄位名稱首次出現的順序。字串、數字、布林值與空值會以一般儲存格值寫入,而看起來像試算表公式的值會以純文字寫入,不會被執行。瀏覽器絕不會將 JSON 當作指令碼執行,絕不在產生的活頁簿中執行巨集,也絕不會存取外部連結或遠端活頁簿連線。由於解析與活頁簿產生作業都在您的機器上進行,此轉換就像一個可放在標準 GST 離線工具旁的離線工具,適合用於將 API 範例、設定匯出、測試資料或分析資料,轉換成活頁簿以供審閱或交接。
為何 GST 離線工具需要本地端 JSON 轉 Excel 的途徑
印度的 GST 離線工具生態系通常在本機執行,並接受 GSTR-1、GSTR-3B、對帳與發票管理工作的 Excel 上傳。許多餵入這些活頁簿的上游系統 —— 納稅人入口網站、會計軟體、GST Suvidha Providers、電子發票工具、IRP 回應與 API 道 —— 都會輸出 JSON。在該 JSON 可被整理成離線工具可接受的活頁簿之前,通常需要先在試算表中往返一次,讓人工檢視總計、以 GSTIN 篩選,或清理不符的 HSN 代碼。一個不傳輸資料的本地端 JSON 轉 Excel 步驟,是該流程中最安全的橋樑:試算表成為交接產物,而來源 JSON 仍保留在磁碟上作為真實紀錄。
若需要反向流程 —— 將完成的 GST 申報活頁簿轉回 JSON 以供整合使用 —— 請參閱如何將 Excel 檔案轉換為 JSON 以供 GST 使用。這兩個工具共享相同的隱私保證,因此可在同一個離線工作流程中搭配使用,而不會違反不上傳的規則。
轉換前先準備 JSON
此轉換器對接受的格式相當嚴格。頂層值必須是 JSON 陣列,陣列中的每個項目都必須是物件,而且陣列不可為空。如果您匯出的 JSON 將資料列包裹在外層封套中 —— 例如{ "data": [ {...}, {...} ] }或{ "results": [...] } —— 轉換器會拒絕接收。請先在編輯器中移除封套,讓陣列位於頂層。
- 確認每個物件使用一致的欄位名稱。較晚出現的物件若引入全新的欄位會被接受,但會在現有欄位之後附加一個新欄位,因此標頭順序可能會讓下游匯入工具感到意外。
- 將數字保留為 JSON 數字,並將 GSTIN 等識別碼保留為字串。轉換器不會從拼字推斷型別,而像 "01" 這樣的值不會變成整數 1。
- 在貼上之前,先決定如何處理巢狀物件與陣列。它們會以壓縮的 JSON 文字序列化至單一儲存格中,而不是展開成多個欄位,因為這是平面工作表中唯一誠實的表示方式。
- 將資料量限制在下表所列的文件上限之內,以免轉換器在長時間解析後關閉而失敗。
如果您的原始資料格式錯誤,請使用如何檢查您的 JSON 格式是否正確來找出語法錯誤,再重新嘗試轉換。
在離線工具中將 JSON 轉換為 Excel
- 在瀏覽器中開啟JSON 轉 Excel 轉換器。頁面載入時為空白編輯器 —— 轉換程式庫在您要求時才會載入,以保持初始載入量小。
- 將非空白的 JSON 物件陣列貼入輸入欄。請留意結尾逗號、未加引號的鍵,以及多餘的註解 —— 轉換器會拒絕無效的 JSON,而不會靜默修復。
- 選擇Convert to Excel。解析與活頁簿產生作業都在本機執行;JSON 不會被發送到任何服務、不會與您的帳號綁定儲存,也不會用於訓練此工具。
- 等待名為 converted.xlsx 的本地端下載出現在瀏覽器的下載清單中。
- 在您預備交付的試算表應用程式中開啟下載的活頁簿 —— 例如 LibreOffice Calc、Microsoft Excel、WPS,或您 GST 離線工具中的試算表引擎 —— 並確認標頭列符合您預期的欄位順序。
- 保留原始 JSON 檔作為紀錄來源,特別是在前導零字串、數值精度、空值語意或巢狀結構承載商業意義時。
邊界行為與硬性限制
此轉換器刻意設有限界,並在超過這些界限時以關閉方式失敗。了解確切的數字可避免猜測轉換為何拒絕匯出:
| 限制 | 上限 |
|---|---|
| JSON 輸入大小 | 1,000,000 字元 |
| 列數 | 10,000 |
| 欄數 | 200 |
| 儲存格數 | 200,000 |
此工具也會拒絕空陣列、基本型別的陣列項目(陣列中的字串或數字)、沒有任何欄位的物件,或超過上述任何限制的資料。它不會靜默地捨棄鍵、截斷長字串,或產生不完整的檔案。寫入 JSON 中的日期會保留為來源所提供的值 —— 活頁簿不會透過特定地區的日期格式重新解讀它們,而看起來像公式的值(=SUM(A1:A10)、+CMD|...、=HYPERLINK(...))會以一般文字儲存格寫入,而不會被執行。
此轉換器刻意不做的事項,讓您可預先規劃:
| 功能 | 狀態 |
|---|---|
| 將 JSON 上傳到伺服器 | 否 —— 在瀏器中本機執行 |
| 推斷結構描述或重新命名欄位 | 否 |
| 將巢狀物件展開為欄位 | 否 —— 以壓縮 JSON 文字序列化 |
| 在活頁簿中執行試算表公式 | 否 —— 以純文字寫入 |
| 擷取 URL、合併檔案或驗證商業結構描述 | 否 |
| 產生具型別的日期、地區格式化、圖表、註解、篩選或驗證規則 | 否 |
如果您的下游 GST 離線工具預期使用任何上述更豐富的活頁簿功能,請使用專為該豐富模型設計的軟體來準備,而不是期待此交接步驟提供這些功能。
在交接前驗證活頁簿
產生的活頁簿是資料交接產物,而非公式引擎,因此其驗證清單比完整的試算表專案短,但比隨意檢視更為嚴:
- 確認前幾筆紀錄中,標頭列與來源 JSON 的欄位順序一致。首次出現的順序是穩定的,但較晚引入的欄位會落在比您預期更右邊的位置。
- 抽查一個來源物件缺少欄位的資料列。轉換器會在該欄寫入空白儲存格,而不是略過該列或填入預設值。
- 抽查一個來源物件包含巢狀值的資料列。該儲存格應包含壓縮的 JSON 文字 —— 這是預期的表示方式,而非錯誤。
- 在您的 GST 離線工具所使用的同一個試算表引擎中開啟活頁簿,然後視需要重新儲存或重新匯出。不同的引擎可能會對相同的儲存格內容進行輕微的重新格式化,因此在目的應用程式中進行最後一次目視檢查是值得的。
- 將原始 JSON 與 converted.xlsx 一起保存。當日後對帳標記出不相符之處時,JSON 是您可用來調查的可信資料。
這個邊界是刻意的。本機執行、拒絕執行貼上的資料內容,並止步於平面資料表的 JSON 轉 Excel 交接流程,可保持轉換的可預測性。任何更具企圖心的功能 —— 具型別的日期、計算欄、多張工作表、匯入驗證、公式驅動的摘要 —— 都屬於試算表應用程式本身,在那裡您擁有復原、版本紀錄,以及對執行內容的明確控制。