Bitzsoft.Integrations.Finance.Invoice.Nuonuo 1.0.0-alpha.10

Bitzsoft.Integrations.Finance.Invoice.Nuonuo

诺诺发票服务实现 -- 对接诺诺网（诺税通）开放平台 API，提供发票全生命周期管理。

功能特性

• 完整开票能力：开具蓝字发票、红字冲销、作废（基于 IInvoiceProvider）
• 数电票专用接口：INuonuoDigitalProvider 提供数电票开具与查询（issueDigitalInvoice / queryDigitalInvoice）
• 进项全流程管理：INuonuoInputProvider 提供进项同步、查询、勾选 / 取消勾选认证、进项统计（syncInputInvoice / queryInputInvoice / tickInputInvoice / queryInputStatistics）
• 红字信息表：INuonuoRedLetterProvider 提供红字信息表申请、下载、查询
• 库存管理：INuonuoStockProvider 提供库存查询、待开票号码获取、失败重开（reInvoice）
• 批量查验：INuonuoVerifyProvider 提供批量查验与校验码查询
• OCR + 编码匹配：实现 IInvoiceOcrProvider（发票识别查验一体化）与 ITaxCodeMatchProvider（税收分类编码智能匹配）
• 聚合接口：INuonuoInvoiceProvider 一次性聚合上述全部能力

安装

.NET CLI

dotnet add package Bitzsoft.Integrations.Finance.Invoice.Nuonuo

PackageReference

<PackageReference Include="Bitzsoft.Integrations.Finance.Invoice.Nuonuo" Version="1.0.0" />

配置

appsettings.json

{
  "Finance": {
    "Invoice": {
      "Nuonuo": {
        "AppKey": "诺诺提供的 AppKey",
        "AppSecret": "双方约定的 AppSecret",
        "TaxNumber": "企业税号",
        "BaseUrl": "https://sdk.nuonuo.com/open/v1/services",
        "TokenUrl": "https://open.nuonuo.com/accessToken",
        "UseSandbox": false
      }
    }
  }
}

含 AppSecret 等敏感信息，严禁序列化、日志输出或暴露给前端。

注册服务

从 IConfiguration 绑定（推荐）

using Bitzsoft.Integrations.Finance.Invoice.Nuonuo;

builder.Services.AddBitzsoftNuonuoInvoice(
    builder.Configuration,
    "Finance:Invoice:Nuonuo");

委托配置

builder.Services.AddBitzsoftNuonuoInvoice(options =>
{
    options.AppKey = "诺诺提供的 AppKey";
    options.AppSecret = "双方约定的 AppSecret";
    options.TaxNumber = "企业税号";
});

注册后 Provider 为 Singleton，同时注册聚合接口 INuonuoInvoiceProvider、抽象接口 IInvoiceOcrProvider / ITaxCodeMatchProvider 与各角色接口，支持按需注入细粒度能力。

第三方请求日志

内置 Bitzsoft.Integrations.RequestLogging 出站请求记录管道，默认使用 NullRequestLogStore 不持久化。

// 持久化：宿主注册 IRequestLogStore 实现后，所有出站请求自动落库
services.AddRequestLogging<MyRequestLogStore>(opts =>
{
    opts.MaxInMemoryBodyBytes = 64 * 1024; // 仅控制内存/加密临时文件切换，不截断正文
    opts.SensitiveFields.Add("AppSecret");
});
services.AddBitzsoftNuonuoInvoice(options => { /* ... */ });

使用示例

using Bitzsoft.Integrations.Finance.Invoice.Nuonuo;
using Bitzsoft.Integrations.Finance.Invoice.Models;

// 注入聚合接口（含全部能力）
public class NuonuoService(INuonuoInvoiceProvider nuonuo)
{
    // 基础开票（来自 IInvoiceProvider）
    public Task<InvoiceIssueResult> IssueAsync(InvoiceIssueRequest req) => nuonuo.IssueAsync(req);

    // 数电票开具
    public Task<InvoiceIssueResult> IssueDigitalAsync(DigitalInvoiceRequest req)
        => nuonuo.IssueDigitalInvoiceAsync(req);

    // 进项查询
    public Task<InputQueryResult> QueryInputAsync(DateTime start, DateTime end)
        => nuonuo.QueryInputInvoiceAsync(start, end);
}

// 或仅注入所需角色接口
public class StockOnlyService(INuonuoStockProvider stock)
{
    public Task<IReadOnlyList<InvoiceStockInfo>> GetStockAsync() => stock.GetInvoiceStockAsync();
}

核心类型一览

Provider 与注册

扩展接口

同时实现抽象层接口：IInvoiceProvider（开具 / 红冲 / 作废 / 查询 / 查验 / 详情 / 交付）、IInvoiceOcrProvider、ITaxCodeMatchProvider。

依赖

相关包

• Bitzsoft.Integrations.Finance.Invoice -- 发票管理抽象层
• Bitzsoft.Integrations.Finance.Invoice.All -- 发票管理聚合包（含本实现）
• Bitzsoft.Integrations.Finance.All -- 财税管理全量聚合包
• Bitzsoft.Integrations.Compatibility -- 基础工具库
• Bitzsoft.Integrations.RequestLogging -- 出站请求记录