民間公司要跟政府電子交換公文，di 檔和 sw 檔怎麼產生？

恆遠自己就是要跟政府機關往來的民間公司。去年我們申請了商工電子公文交換，拿到機關代碼、裝好 WebjAgent，以為接下來就能發文了，結果卡在一個沒人講清楚的地方：公文本體要自己生。

WebjAgent 只負責把檔案送出去和收進來，它不會幫你做公文。你得自己產出一個副檔名 .di 的公文本文檔、一個 .sw 的交換表單檔，格式還要符合檔案管理局的 104DTD。這篇把我們實際做出來的過程、官方免費工具能做到哪裡、以及最容易被退件的幾個地方寫下來。

先講結論：WebjAgent 只收發，公文本體要自己生

要跟政府電子交換公文，你需要三樣東西：交換會員資格、工商憑證卡、以及一套能產出合規 di 與 sw 檔的方法。前兩樣申請就有，第三樣沒有人會直接給你。

全國可以做公文電子交換的非公務機關大約有一萬五千家，包含私人企業、學校、醫院與財團法人，2021 年全國電子公文收發量約 1.46 億封（叡揚資訊的整理）。這個數字代表你不是少數，卡住的人很多，只是沒人把過程寫出來。

di 檔和 sw 檔到底裝了什麼

一句話分工：di 裝公文內容，sw 裝要寄給誰。

di 是有欄位語意的 XML，收文機關拿它自己渲染成帶電子公文交換章的 PDF。所以不能反過來拿一份 PDF 去反推 di，方向是錯的，而且必然失真。

不花錢的兩條路：官方免費工具能做到哪

官方確實有免費工具，而且做得到電子交換，先講清楚免得你多花錢。

筆硯平台的常見問題裡寫得很明白：「凡是中華民國的國民都可以申請成為我的E政府會員」（平台 FAQ）。所以民間公司不是被排除在外，門檻在別的地方。

官方工具的天花板在哪裡

成本不在授權費，在你要花多久才能發出第一封文。

筆硯的官方系統操作手冊共 104 頁，其中「安裝」章節就佔了 20 頁，做出第一份公文要再讀 28 頁。手冊裡多處提到 IE 瀏覽器、要把平台加入信任的網站、進入網站會自動安裝元件，這是 IE 時代的瀏覽器元件架構。

我們的判斷是這樣：對每天發幾十封文的機關來說，這些成本攤提得掉，官方工具是對的選擇。但對一年只發幾封文的民間公司，為了幾封公文去裝元件、讀百頁手冊，多數人算一算就退回紙本了。離線版模組地址簿停更這件事更關鍵，機關代碼會過期，而代碼錯就是退件。

104DTD 最容易被退件的四個地方

先給答案：編碼、元素順序、實體綁定、機關代碼。四個裡面編碼最容易中，而且錯了會直接噴錯誤碼。

編碼這件事有官方答案。經濟部商工電子公文交換服務的常見問題裡，0201 錯誤的解答是「上傳的公文本文檔（di 檔）格式為 Big5 編碼，新系統不支援，新系統僅支援 Unicode 編碼」（官方 FAQ）。抓錯 DTD 版本會讓整個實作白做，這是我們踩過最貴的一個坑。

官方的 DTD 與實作範例其實是公開的，只是入口很少人知道：檔案管理局的公文及檔案管理資訊系統驗證網下載專區，「文書及檔案管理電腦化作業規範之實作範例」那包裡有完整的 104DTD 與十二組真實範例檔。動手寫任何程式碼之前先去拿這包，不要用猜的。

機關代碼查錯必退，但地址簿只認全名

地址簿是唯一權威來源，而且每日更新，發文前一定要查。

公文電子交換系統地址簿是政府開放資料，免費下載，收錄四萬多個機關。我們實際跑過一次分布：狀態為啟用的有 39,722 個，停用與刪除的合計不到 300 個。民間公司的代碼是 EB 開頭加八碼。

實務上最常卡住的是名稱。地址簿存的是官方全名「高雄市鳳山區忠孝國民小學」，承辦人記得的是「鳳山忠孝國小」。直接用簡稱去查會查不到，很容易誤判成該校不能電子收文，實際上它在地址簿裡而且是啟用狀態。查不到的時候先換全名再試一次。

檔案送出前怎麼自己驗

用 xmllint 對官方 DTD 做驗證，macOS 與多數 Linux 內建，不用另外裝。

# 把官方 DTD 與待驗檔案放同一個資料夾
xmllint --valid --noout 你的檔案.di

回傳 exit code 0 就是結構合法。我們拿官方的十二組範例檔實測過，28 個 di 檔有 27 個通過。

確認發文成功的判準也有官方說法：以受文者清單的「使用者確認時間」為準。發文夾狀態顯示「公文傳送中」是正常現象，不代表失敗。

我們把這段做成一個工具

把上面這些規則寫成程式之後，發一封公文就只剩填表單。

我們做了一個公文交換檔產生器，只解決「產出合規交換檔」這一段，不取代文書系統。開網頁填表單就產出 di 與 sw，不必安裝任何瀏覽器元件，Mac 和 Windows 都能跑。

• 內建全國地址簿，打「鳳山忠孝國小」就找得到官方全名，停用的機關不會出現在選項裡
• 落檔前先跑 DTD 驗證，不通過就不寫檔，格式問題在送出前就被擋下
• 附件依規範以總大小 2048KB 控管，超標在上傳當下就擋，不是等發文才發現
• 依政府文書格式參考規範排版的 A4 預覽，發文前用肉眼校對，可以列印或存成 PDF
• 常發的機關存成常用清單或群組，一鍵帶入正副本與含附件設定

這是恆遠自己要用才做的東西，做完發現同樣卡住的公司不少，所以開放授權。採單一法人使用、原始碼交付、一年內格式更新，三種可以搭配，價格個案洽談。想聊聊你們的情況可以走客製化系統諮詢。

延伸閱讀

政府相關的合規門檻不只公文，網站無障礙也已經是標案硬門檻，可以看WCAG 2.2 合規路線圖。想了解一套系統從需求到驗收怎麼走，可以看系統開發流程完整拆解；系統上線後的維運成本則整理在客製化系統上線後三個月隱性成本。