程式猿Fighting!

---

完全沒開發過跟電子發票有關的東西，一直不清楚他們得流程

當初稍微看一下，想說有提供API，以為只要能串接API就能搞定整個流程

最後才發現大錯特錯。

政府電子發票API說穿了只是一些雞肋的功能而已，提供查詢阿，或是對獎用的API

跟電子發票開立和上傳，完全沒關係。

(B2C)真正發票開立和上傳系統綁定在TurnKey軟體上，需要產生發票的XML文檔，之後上傳到他們的整合平台才算開立發票成功。

---

那時候因為專案時間急迫，和網路上沒現成的範例能使用，只找到一個有關的Githut

各位可以參考看看 電子發票資料Turnkey交換範例 ，我後面所提供的範例檔，裡面的 EInvoiceXSD 也是出至此處

該交換範例所使用的方式，是使用資料類別來產生XML，因為我也需要利用資料類別串接SQL資料，所以剛好適用

不過結構上不太夠用，加上本來就是範例，所以後來整個結構就重寫，讓結構更適合我的專案。

之後我所提供的範例檔，並不能直接執行成為專案，因為專案有跟SQL結構綁在一起，我只提供XML的當參考使用

所以如果要使用我的範例檔，請自行修改以符合自己的專案。

並且，該範例檔，結構上並不是很完美，也有很多只是為了通過政府的系統，而簡單寫，不太會再去用到

像是產生實體發票的PDF檔，即是簡單撰寫，因為我的專案中，全部走電子發票載具流程(新稱法，雲端發票)，根本不會印製出來

但是政府需要提供印製實體發票的範本，才能去申請字軌。

所以有些東西只是簡單寫，並沒有打算要再修改，有需要的人請自行強化自己所需的部分

---

我的專案結構分為

EInvoiceDataB2B-給B2B使用的類別，並不是很完整，因為一開始寫B2C所以B2C結構比較完整。

EInvoiceDataB2C-給B2C使用的類別，因為專案最主要用B2C所以算整體上最完整的。

EInvoiceDataBranchTrack- 字軌用的結構

EInvoiceDataClass-共通用的結構及enum定義

EInvoiceDataPlatform-平台用的結構，也不是很完整，本來要寫成讓平台回傳的文檔

可以開啟轉回結構檔案顯示在程式中，但是後來專案沒用到，就沒去補充

EInvoiceQrHelper-電子發票實體列印相關的類別，利用itextsharp.dll 簡單做一個 PDF，有需要的請自行修改

XmlHelperAll-產生Xml用的共通性類別

XmlHelperB2B-空的，因為沒用到B2B所以就沒寫

XmlHelperB2C- For B2C用類別

XmlHelperForTesting- For Turnkey自行檢測所需xml檔的類別，但是寫完沒測試，因為第一次跑官方流程，所以一開始先自己直接產生發票

之後了解官方流程後才回來寫這個，所以就沒再測試了

XmlHelperPlatform- For 平台回傳或是其他的xml用類別

驗證用的XSD檔案，檔案出處請參考

itextsharp.dll- 以前舊專案Copy來的，好像才2的樣子，現在都已經 iText7了，不過7要收費，再NuGet可以直接下載iText5版本來用

QREncrypter.dll-電子發票官方的文檔 加解密工具 裡面提供的Dll，因為太多我也忘記是從哪個檔案裡面找到的請自行在這裡研究吧

---

再說明一次，我提供的範例檔案並不是完整專案檔

就算開個空專案全部放進去，也不一定能執行(因為有些結構是SQL結構，我沒放進來)，可能會有些缺失

只是提供一些 for Turnkey 的程式參考範例而已，給一些開發人員啟發

不太適合全新手使用。使用上有問題歡迎留言提問

範例檔案下載

---

如果我之前文章說到，感覺沒貼一些程式碼，就是怪怪的

所以下面會解說一些內容，但並不全面

這裏面放的是 轉換成Xml用的一些基礎類別

其中 Master屬性，代表再XML為必要的，再產生XML時會先檢查

錯誤會直接中斷再程式裡面，並不會產生XML文件檔

[AttributeUsage(AttributeTargets.Property)]
public class MasterAttribute : Attribute
{
}

如果通過，再利用XSD檔案作格式跟SIZE的檢查。但是XML檔案已經產生

所以如果XSD檔案檢查沒過，就要自己再去把文件檔案移除掉

然後 enum 有給數字的，都代表要取數字出來用，而沒給數字直接流水編碼的代表要取文字使用

namespace EInvoiceDataClass.B2C

發票類別都利用 namespace來做區分，所以程式要同時用到兩個(B2C和B2B)，請自行修改

在Invoice類別裡面，提供一個產生標準(Master欄位)發票類別，產生出來之後外部程式在自行修改細節

(產生出來的是For 我專案用的，所以內容請自行修改)

// 產生標準的Invoice 資料
public static Invoice GenerateStandardInvoiceData(int ProductItemQuantity = 1)
{
    Random rd = new Random();
    Invoice rtn = new Invoice();
    var main = rtn.Main;
    // 發票號碼外面補
    main.InvoiceDate = DateTime.Now.ToString("yyyyMMdd");
    main.InvoiceTime = DateTime.Now.ToString("HH:mm:ss");
    var seller = main.Seller;
    seller.Identifier = "公司統編";
    seller.Name = "公司名稱";
    //seller.Address = "公司地址";
    //seller.PersonInCharge = "負責人名稱";
    //seller.TelephoneNumber = "聯絡電話";
    //seller.FacsimileNumber = "傳真電話";
    //seller.EmailAddress = "信箱資料";
 
    var buyer = main.Buyer;
    buyer.Identifier = "0000000000";
    buyer.Name = rd.Next(0, 10000).ToString("D4");
    // 檢查碼不可寫      
    main.InvoiceType = InvoiceTypeEnum.GeneralTax;
    main.DonateMark = DonateMarkEnum.NotDonate;
    main.CarrierType = EInvoiceStaticData.CarrierTypeEnumType1;
    main.PrintMark = "N";
    main.RandomNumber = rd.Next(0, 10000).ToString("D4");
 
    // Details
    var productItem = new InvoiceProductItemDetails();
    productItem.Description = "產品敘述";
    productItem.Quantity = ProductItemQuantity;
    productItem.UnitPrice = 1000;  // 售價
    productItem.Amount = (productItem.Quantity * productItem.UnitPrice);
    rtn.Details.ProductItem.Add(productItem);
    productItem.SequenceNumber = rtn.Details.ProductItem.Count.ToString("D3");
 
    var amount = rtn.Amount;
    amount.SalesAmount = productItem.Amount;
    amount.FreeTaxSalesAmount = 0;
    amount.ZeroTaxSalesAmount = 0;
    amount.TaxType = TaxTypeEnum.Tax;
    amount.TaxRate = 0.05M;
    amount.TaxAmount = 0;
    amount.TotalAmount = Convert.ToInt64(amount.SalesAmount);
 
    return rtn;
}

資料類別大約就這些值得說一下的，另外因為我專案只需要用B2C

後來B2B只是順便補充進去，所以會感覺B2B寫得挺草率的。

這是要產生印製發票的範本PDF，有需要的可以參考研究看看

另外iText的QR因為一開始查不到使用UTF-8的方式，所以轉成圖片都會不見

所以我專案是用Base64產生圖片，但是後來找到方法，只是已經通過驗證了，所以我就沒再去用了

利用下面這方式，可以產生UTF-8的圖片

// 如要使用 UTF-8的QR圖方法
var hints = new Dictionary<EncodeHintType, Object>() { { EncodeHintType.CHARACTER_SET, "UTF-8" } };
//byte[] bytes = Encoding.UTF8.GetBytes(temp.ToString());
//int byteLength = bytes.Length; // Max 133，超過圖片大小會不同
//var QrImageLeft = new BarcodeQRCode(temp.ToString(), 1, 1, hints).GetImage();
//QrImageLeft.ScaleToFit(new Rectangle(0, 0, 46, 46)); // 提供另一個方式去設定圖片大小

基礎共通性的類別

其中我把XSD驗證 註解不用，因為我格式都是固定死的，並不會變更，所以就不做檢查

有需要檢查的人使用前記得要先設定

// Xsd檔案放置的位置
public static string CheckXsdPath { get; set; }

最後是每個XML檔案都要設定的格式問題，這問題查了許久才找到解法

最主要是設定xsi要去做XSD驗證使用，xsi格式會跟標準的不同

// xsi 會消失
//rootXmlElement.SetAttribute("xmlns:xsi", "http://www.w3.org/2001/XMLSchema-instance");
//rootXmlElement.SetAttribute("xsi:schemaLocation", $"{CommonData.Xmlns} {CommonData.XsdName}");
 
// 自動產生的不是xsi
//rootXmlElement.SetAttribute("schemaLocation", "http://www.w3.org/2001/XMLSchema-instance", $"{CommonData.Xmlns} {CommonData.XsdName}"); 
 
// 理論上可運作，不過跟範例的Attribute順序不同
XmlAttribute attribute = doc.CreateAttribute("xsi", "schemaLocation", "http://www.w3.org/2001/XMLSchema-instance");
attribute.Value = $"{CommonData.Xmlns} {CommonData.XsdName}";
rootXmlElement.SetAttributeNode(attribute);

大致上就這些吧

剩下的就一些做工的部分而已，另外利用遞迴方式去抓類別的名稱跟數值來轉成XML檔。

這部分並沒有寫得很好看，不過運作起來以符合我專案內容了

所以可能會有其他BUG或是有更好優化的方式。歡迎留言討論

範例檔案下載