自建電子發票平台
自己產生發票、自己上傳財政部,會員載具和中獎通知也在自己的系統裡
直接上傳財政部 × 自家會員載具 × 每天逐張對帳
ISSUE · UPLOAD · RECONCILE
營運系統 → 開票 API
POST /v1/invoices
開票前檢查
電子發票證明聯
115年11-12月
AB-00000001
上傳財政部
每日彙總 · 逐張比對
會員載具
背景
為什麼做這個
公司原本透過第三方加值中心開電子發票。營運和人資都已經是自己的系統,這次把發票也接回來:自己產生發票檔、自己上傳財政部、自己發行會員載具。
自己上傳有一道門檻:財政部要求登記上傳主機的對外固定 IP,雲端主機的對外 IP 偏偏不固定。這件事一直卡著,直到為了別的串接架好固定 IP 的出口中繼,才正式動工。
發票平台做成獨立服務,營運系統透過 API 開票,發票資料不放進營運系統的資料庫。第一版接營運系統的對帳開票,熱感紙和 A4 證明聯都能印,B2B 發票只做存證。
關鍵亮點
關鍵亮點
發票檔照官方範例逐字比對
上傳財政部的發票檔(MIG 4.1 格式)、證明聯上的條碼和 QR Code 加密,都拿官方範例逐字比對過才算數。字軌取號用 20 張同時開立測過,不會開出重複的號碼。
上傳主機走固定 IP
財政部的上傳軟體 Turnkey 跑在一台獨立機器上,跟營運系統、客服系統共用同一個固定出口 IP。上傳用的憑證私鑰在那台機器上產生,不離開機器。
開票當下查手機條碼
客人給的手機條碼,開票時先問財政部存不存在,不存在就擋下、不吃號。財政部那邊連不上就照常開立並留下紀錄,不讓查詢卡住出貨。
自家會員載具
會員用 Email 驗證碼登入,看得到同一個信箱的所有發票,也能設定預設捐贈碼。上傳財政部的載具號碼是系統產生的會員編號,不放 Email。歸戶到財政部載具的兩種方式都實際跑過財政部的測試。
每天跟財政部逐張對帳
每天抓財政部的每日彙總逐張比對,漏上傳、上傳失敗沒處理、確認回執沒收到,都列成待處理。上傳軟體的錯誤目錄也會掃,字軌快用完會提醒,系統每 6 小時自動檢核一次。
中獎通知與事後補印
匯入財政部的中獎清冊,會員頁顯示中獎狀態並寄 Email 通知,中獎證明聯照規定掛號寄送。客人事後要紙本,照財政部手冊的做法註銷後同號重開、改成列印。
成果
成果
- 第一張測試發票上傳財政部測試環境成功,開立、作廢、註銷、折讓都走過一輪
- 財政部自行檢測的系統檢核全部通過,含一次上傳 1,000 張的壓力測試
- 會員載具的歸戶測試通過,作業手冊經財政部承辦人審閱定稿
- 營運系統的開立、作廢、折讓、列印四條路一次接好,用開關切換,打開就生效
- 正式站與會員頁已上線
- 154 項單元測試,另有接資料庫的整合測試
工程筆記
開發踩過的坑
這些不是規格書寫得出來的東西,是真的做下去、上線後才踩到的。留在這裡,也提醒自己下次別再踩。
壓力測試的 1,000 張被拆成三包
財政部的壓力測試要 1,000 張發票在同一包上傳。上傳軟體預設會自己分包,第一次送檢就因此查無資料。暫停上傳軟體、讓 1,000 張累積到同一包再送,第二次系統檢核全過。
一個上傳封包裡有好幾張發票
上傳軟體會把多張發票合併成一包上傳。回寫處理結果時要從封包內容讀出每一張的號碼,不能假設一包就是一張。
測試環境回呼的是正式網址
會員載具歸戶測試時,財政部的驗證環境回呼的卻是正式網址,正式站還沒部署就回 404。暫時把正式網域指到測試站,才通過這一關。
書面審查要用官方範本,版面不能改
自行檢測的書面文件第一次被退,原因是沒有用官方範本。改用官方檔案、只填空格和附上佐證,才進到下一關。
回顧
“發票系統的時間大多花在跟財政部對齊。檔案格式、上傳主機、會員載具,每一項都要過他們的測試或審核,自行檢測的書面文件就被退了好幾次。我把查到的財政部原文都存進專案,每一步對著原文做,被退件時翻原文,就知道該改哪一句。”