Mitzh.Invoice.Core 1.0.0

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package Mitzh.Invoice.Core --version 1.0.0
                    


                    

                
NuGet\Install-Package Mitzh.Invoice.Core -Version 1.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Mitzh.Invoice.Core" Version="1.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Mitzh.Invoice.Core" Version="1.0.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Mitzh.Invoice.Core" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Mitzh.Invoice.Core --version 1.0.0
                    


                    

                
#r "nuget: Mitzh.Invoice.Core, 1.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Mitzh.Invoice.Core@1.0.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Mitzh.Invoice.Core&version=1.0.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Mitzh.Invoice.Core&version=1.0.0
                    


                            Install as a Cake Tool

Mitzh.Invoice.Core

.NET 8 离线发票解析类库，根命名空间 Mitzh。支持文件路径、文件流及 XML 内容，直接返回 InvoiceModel。

安装

dotnet add package Mitzh.Invoice.Core --version 1.0.0

文件路径、流及 XML 内容

using Mitzh;

using var recognizer = new InvoiceRecognizer(@"D:\InvoiceParser\models");
InvoiceModel fromPath = await recognizer.RecognizeAsync(@"D:\invoices\sample.ofd");

await using var stream = File.OpenRead(@"D:\invoices\sample.pdf");
InvoiceModel fromStream = await recognizer.RecognizeAsync(stream);

string xml = await File.ReadAllTextAsync(@"D:\invoices\sample.xml");
InvoiceModel fromXml = await recognizer.RecognizeXmlAsync(xml);

XML、原生文字 PDF/OFD 不需要模型，可以使用 new InvoiceRecognizer()。图片/扫描 PDF 需要指定本地中文 OCR 模型目录；默认目录为应用可执行文件旁的 models/。Core NuGet 包不包含模型，使用 仓库 models 的模型及配套字典，保留第三方许可证。模型加载后常驻，建议复用一个识别器；内部限制并发，不要在调用完成前 Dispose。输入流保持打开，不要求支持 Seek。

扫描 PDF 另需本地 pdftoppm，可用 InvoiceRecognitionOptions.PdfToPpm 指定完整路径；不使用外部网络 OCR 服务。

ParseResult detailed = await recognizer.RecognizeDetailedAsync(@"D:\invoices\sample.ofd");
IReadOnlyList<TextBox> boxes = detailed.Evidence;
IReadOnlyList<StructuredFieldEvidence> fields = detailed.StructuredFields;

StructuredFields 仅结构化 XML/OFD 附件返回，可为 null；Evidence 为文字坐标证据。不能将结构化 XML 伪造为 OCR 坐标。

模型

  • 发票：Type、Code、Number、IssueDate、CheckCode、Drawer。
  • 购销方：BuyerName/BuyerTaxId、SellerName/SellerTaxId。
  • 金额：Amount（不含税）、Tax、Total（价税合计），使用 decimal?。
  • Items：商品、规格、单位、数量、单价、金额、税率、税额、页码。
  • RailwayTicket：铁路客票乘车人、脱敏证件号、车次、区间、乘车日期/时间、席别、车厢/座号、电子客票号、业务类型；普通发票为 null。
  • Warnings 与 RequiresReview：缺项、冲突、金额一致性及真实性未验证提示。警告不等同于解析异常。

未识别字段保持 null，发票号码保持字符串及前导零。类库异常通过正常 .NET 异常机制抛出；HTTP 的 code/msg/data 包装属于 Api 包。

能力边界

支持 EInvoice 数电 XML、原生文字 OFD/PDF、JPG/PNG 及部分扫描 PDF 版式；铁路 OFD 要求内嵌 rai 2021-11-30 XBRL 附件，单文档/单上下文。未知版式、图片 OFD、复杂图形变换可能需要人工复核或渲染器。

默认 20 MiB、30 页、120 秒超时，可用 InvoiceRecognitionOptions 调整。XML 禁止 DTD/外部实体，不读取外部 schema。未验证数字签名或税务真实性。

源码、完整说明、许可和回归程序：Mitzh/InvoiceParser。

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
3.0.0 84 10/29/2026
2.0.0 87 10/29/2026
1.0.0 88 10/29/2026