gibbs-shih
commented
2 months ago 對接財政部電子發票系統-以F0401為例
前言
財政部電子發票整合服務平台依據電子發票資料交換標準訊息建置指引（MIG），為參與單位（如營業人、加值服務中心等）在建置與資料交換時提供參考。MIG 旨在為網際網路使用者提供電子發票 XML 訊息的標準規範，並根據國內實際業務需求及相關法令進行調整，以適應國內電子發票的網際網路作業。該指引詳細說明了電子發票 XML 訊息的架構、語法及資料轉換規格。本文將以 F0401 平台存證開立發票訊息為實作範例進行說明。
電子發票資料交換標準訊息建置指引（MIG）v4.0
指引共分為27章，4個部分：
- 第1章：該指引概括性使用說明
-
第2章：介紹 W3C 所使用之資料型態及說明標準訊息之結構
註：W3C（全球資訊網聯盟）成立於1994年，旨在開發網頁標準和指南，並促進互通技術的發展，保障網絡的可及性和兼容性
- 第3章-第25章：詳細說明電子發票個別訊息規格
- 第26章-第27章：說明電子發票整合服務平台回應訊息規格
電子發票個別訊息，分為 B2B 交換、存證、字軌、共通4大類別：
- 交換訊息：營業人與營業人交易(B2B)、營業人與機關團體交易(B2B)
- 存證訊息：營業人與營業人交易(B2B)、營業人與機關團體交易(B2B)、營業人與非營業人交易(B2C)、使用載具索 取電子發票
- 電子發票訊息彙整表
以 F0401 平台存證開立發票訊息(賣方) 實作為例
範例實作只取必要欄位
訊息功能
「開立發票訊息」係由電子發票整合服務平台記錄賣方銷售貨物或勞務，開立發票予買方之所有資料，主要係為了營業人進行資訊存證使用。
訊息結構圖
-
Main
-
invoiceNumber 發票號碼：InvoiceNumberType
- InvoiceNumberType：string
- 含字軌，共10碼，例：QQ12345678
-
invoiceDate 發票日期：DateType
- DateType：string
- 臺灣時區僅支援西元年方式，例：20240101
-
invoiceTime 發票時間：TimeType
- TimeType：string
- hh:mm:ss
-
seller 賣方資訊：RoleDescriptionType
- RoleDescriptionType：group
-
buyer 買方資訊：RoleDescriptionType（同上）
-
invoiceType 發票類別：InvoiceTypeEnum
- InvoiceTypeEnum：string
代號 類型 07 一般稅額計算之電子發票 08 特種稅額計算之電子發票 -
donateMark 捐贈註記：DonateMarkEnum
- DonateMarkEnum：string
代號 類型 0 非捐贈發票 1 捐贈發票 -
printMark 電子發票證明聯已列印註記：string，Y/N
- 為 Y 時載具類別號碼，載具顯碼ID，載具隱碼 ID 必須為空白，捐贈註記必為 0
-
-
Details
-
description 品名：string
-
quantity 數量：number
-
unitPrice 單價：number
-
taxType 課稅別：TaxTypeEnum
- TaxTypeEnum：string
代號 類型 1 應稅 2 零稅率 3 免稅 4 應稅（特種稅率） 9 混合應稅與免稅或零稅率(限訊息 F0401 使用) -
amount 金額：number
-
sequenceNumber 明細排列序號：string，系統使用發票明細之排列序號
-
-
Amount
- salesAmount 應稅銷售額合計：number
- freeTaxSalesAmount 免稅銷售額合計：number
- zeroTaxSalesAmount 零稅率銷售額合計：number
- taxType 課稅別T：TaxTypeEnum (同Details的TaxTypeEnum)
- taxRate 稅率：TaxRateEnum
- TaxRateEnum：number
- 範例：稅率為5%時，本欄位值為 0.05
- taxAmount 營業稅額：number
- totalAmount 總計：number
訊息樹狀圖
XML Schema 語法標示
F0401 轉為 XML 格式，請參考 XML Schema，為指引中第76-89頁，詳細說明了元素名稱、語法標示（資料類型、該類型參數）、資料長度、必要性、備註等資訊。
實作結果
實作步驟
-
step1 - 建立2個 class
- Invoice
- ProductItem
-
step2 - 依階層架構、所需欄位建立模板
-
step3 - 讀取模板並給範例數字
- 讀取模板
-
輸入範例數字
-
step4 - 使用 Mustache 來渲染模板
-
step5 - 使用 xml2js 解析和驗證 XML 字符串
結語
本文介紹了如何對接財政部電子發票系統，並以 F0401 平台存證開立發票訊息為例進行實作說明。透過遵循電子發票資料交換標準訊息建置指引（MIG），我們能夠有效地建立符合規範的 XML 訊息。實作過程中，我們使用了 Mustache 來渲染模板，並利用 xml2js 來解析和驗證 XML 字符串，確保資料的正確性與完整性。希望這篇文章能為有意對接電子發票系統的開發者提供初步的參考與指引。
延續 #231 #247 完成對接財政部電子發票系統文章