C#/Java 动态生成电子发票

感谢大哥 https://www.cnblogs.com/Yesi/p/11399064.html

电子发票是电商时代的产物，PDF发票是最常见的电子发票之一。在这篇文章中，我将给大家分享一个免费的动态生成PDF电子发票的C#方案，并在文章末尾附上Java解决方案。

典型的发票包含客户和供应商的名称和地址、发票编号、购买物品的描述、付款金额等信息。为了动态地生成发票，我使用MS Word创建了一个模板，在该模板中设计好想要呈现的大部分内容及文档样式，然后通过代码替换文本和插入新内容，最后保存为PDF文档。用代码操作Word文档的部分需要使用免费版的Spire.Doc for .NET7.1。

创建模板
如图1所示，发票模板由两个表组成。表1用于显示买卖双方的信息和订单信息，表2用于陈列卖方向买方提供的产品或服务列表。我们需要做的是替换表1中以#开头的文本，并将客户的购物清单填充至第二个表格。

为了能自动计算总金额，需要在某些单元格添加公式域。例如，单元格E2包含公式“=C2*D2”，该公式将计算单元格B2中商品的总价。当买家购买超过一件商品时，我们需要在表格添加更多行并动态更新一些单元格的公式。

图1 发票模板

如何替换文本
Spire.Doc 有一个IBodyRegion.Replace(string given, string replace, bool caseSensitive, bool wholeWord)方法，可以用于替换文档中的指定字符串。例如，将“#orderNum”替换成“2516595027”，我们可以直接使用下面的代码，代码中doc是Document对象。

doc.Replace("#orderNum", "2516595027", true, true);

如何更新表格二

现在，让我们看看如何向现有表格添加行，如何将数据填充至表格，以及如何动态地更新公式。为了使逻辑更清晰，我创建了三个方法，并制作了图2，来展示它们的具体含义以及它们之间的调用关系。

图2 自定义方法的含义及调用关系

下面，看一下这三个方法的代码片段：

1. AddRows()

此方法实际上复制了现有表格的第二行，将复制行依次添加到第二行的下面。新行继承了第二行的单元格格式、字体样式和公式。因此，我们需要依次更新新行中的公式，以及下面随行数增加而变化的公式。

private static void AddRows(Table table, int rowNum)
{
 
    for (int i = 0; i < rowNum; i++)
    {
        //将指定个数的第二行的复制行依次添加到第二行下面
        table.Rows.Insert(2 + i, table.Rows[1].Clone());
 
        //更新“金额”所对应单元格的公式
        foreach (var item in table.Rows[2 + i].Cells[4].Paragraphs[0].ChildObjects)
        {
            if (item is Field)
            {
                Field field = item as Field;
                field.Code = string.Format("=C{0}*D{0}\# "0.00"", 3 + i);
            }
            break;
        }
 
    }
 
    //更新“折扣金额”对应的单元格的公式
    foreach (var item in table.Rows[4 + rowNum].Cells[4].Paragraphs[0].ChildObjects)
    {
        if (item is Field)
        {
            Field field = item as Field;
            field.Code = string.Format("=E{0}*0.05\# "0.00"", 3 + rowNum);
        }
        break;
    }
 
    //更新“总计”对应的单元格的公式
    foreach (var item in table.Rows[5 + rowNum].Cells[4].Paragraphs[0].ChildObjects)
    {
        if (item is Field)
        {
            Field field = item as Field;
            field.Code = string.Format("=E{0}-E{1}\# "￥#,##0.00"", 3 + rowNum, 5 + rowNum);
        }
        break;
    }
 
}

 2. FillTableWithData()

此方法仅用于将sting[][]类型数据从表格的第二行开始写入表格。

private static void FillTableWithData(Table table, string[][] data)
 {
     for (int r = 0; r < data.Length; r++)
     {
         for (int c = 0; c < data[r].Length; c++)
         {
             //将数据从表格的第二行开始写入表格
             table.Rows[r + 1].Cells[c].Paragraphs[0].Text = data[r][c];
         }
     }
 }

3. WriteDataToDocument()

由于发票模板已经有一行（第二行）用于显示一项商品，因此我们需要判断是否需要添加更多行。如果客户只购买一项商品，模板文档就可以容纳商品信息并输出结果；否则，我们需要添加行来容纳更多的项目，并动态更新公式以获得正确的总金额。

private static void WriteDataToDocument(Document doc, string[][] purhcaseData)
{
    //获取Word模板中的第二个表格
    Table table = doc.Sections[0].Tables[1] as Table;
 
    //若购买商品多于一项，则添加purhcaseData.Length - 1个行
    if (purhcaseData.Length > 1)
    {
        AddRows(table, purhcaseData.Length - 1);
    }
 
    //将购买数据填充至表格
    FillTableWithData(table, purhcaseData);
}

WriteDataToDocument()方法的参数之一是sting[][]对象，该对象存储了客户的购买信息，它的每个元素都是一个字符串数组，可以这样设置：

string[] product = new string[] { "1023", "华为 P30 Pro （8G+128G）全网通", "1", "4288" };

string[][]的长度则是商品的项数，如果长度大于1，则需要添加[长度 - 1]个新行。

生成发票

以下是Main函数中用于生成PDF发票的代码。

using Spire.Doc;
using Spire.Doc.Fields;
 
namespace CreatePdfInvoice
{
    class Program
    {
        static void Main(string[] args)
        {
            //加载Word模板文档
            Document doc = new Document();
            doc.LoadFromFile("Invoice-Template.docx");
 
            //替换文档中以#开头的文本
            doc.Replace("#customerName", "小伟", true, true);
            doc.Replace("#contactNum", "13601234567", true, true);
            doc.Replace("#shippingAdd", "北京市海淀区幸福小区1幢2单元3号", true, true);
            doc.Replace("#orderDate", "2019-05-30", true, true);
            doc.Replace("#orderNum", "2516595027", true, true);
 
            //定义客户购买数据
            string[][] purchaseData = {
 
                                  new string[]{"1023","华为 P30 Pro （8G+128G）全网通","1","4288"},
                                  new string[]{"1429","华为Watch GT运动版","2","1288"},
                                  new string[]{"1268","华为无线耳机 FreeBuds 2Pro","2","799"},
                                  new string[]{"1281","华为 MateBook 14 （i5 8G 512G)","1","5999"},
                              };
 
            //将购买数据写入模板文档的第二个表格
            WriteDataToDocument(doc, purchaseData);
 
            //更新域
            doc.IsUpdateFields = true;
 
            //保存为PDF格式文档
            doc.SaveToFile("Invoice.pdf", FileFormat.PDF);
            System.Diagnostics.Process.Start("Invoice.pdf");
        }
    }
}

生成的结果文档如下：

图 3 多项目PDF发票

如果你输入购买数据只有一行，那么你将得到如图4所示的结果文档。

string[][] purchaseData = {new string[]{"1023","华为 P30 Pro （8G+128G）全网通","1","4288"},};

图4 单项目PDF发票

工程下载

C#工程(含DLL和模板文档)	https://pan.baidu.com/s/1jCI1J5J08hGReGIe0ZzOsA	提取码：zp6n
Java 工程(含Jar和模板文档)	https://pan.baidu.com/s/1bthB3gnd0B0JQYzwZDWmVA	提取码：ciey

注：

免费版 Spire.Doc能加载和生成的Word文档不能超过500个段落或25个表格，将Word文档保存为PDF时仅支持前3页。绝大多数发票只有1页或2页，所以该方案适用于大多数情况。

 可以用 MailMerge 替换，可以参考 https://www.e-iceblue.com/Tutorials/Spire.Doc/Spire.Doc-Program-Guide/How-to-Use-Mail-Merge-to-Create-Report.html