Bitzsoft.Integrations.Finance.Tax.QiXiangYun 1.0.0-alpha.8

.NET 5.0 This package targets .NET 5.0. The package is compatible with this framework or higher.
This is a prerelease version of Bitzsoft.Integrations.Finance.Tax.QiXiangYun.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package Bitzsoft.Integrations.Finance.Tax.QiXiangYun --version 1.0.0-alpha.8
                    


                    

                
NuGet\Install-Package Bitzsoft.Integrations.Finance.Tax.QiXiangYun -Version 1.0.0-alpha.8
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="Bitzsoft.Integrations.Finance.Tax.QiXiangYun" Version="1.0.0-alpha.8" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Bitzsoft.Integrations.Finance.Tax.QiXiangYun" Version="1.0.0-alpha.8" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Bitzsoft.Integrations.Finance.Tax.QiXiangYun" />
                    


                            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 Bitzsoft.Integrations.Finance.Tax.QiXiangYun --version 1.0.0-alpha.8
                    


                    

                
#r "nuget: Bitzsoft.Integrations.Finance.Tax.QiXiangYun, 1.0.0-alpha.8"
#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 Bitzsoft.Integrations.Finance.Tax.QiXiangYun@1.0.0-alpha.8
#: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=Bitzsoft.Integrations.Finance.Tax.QiXiangYun&version=1.0.0-alpha.8&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Bitzsoft.Integrations.Finance.Tax.QiXiangYun&version=1.0.0-alpha.8&prerelease
                    


                            Install as a Cake Tool

Bitzsoft.Integrations.Finance.Tax.QiXiangYun

企享云税务服务实现，对接企享云开放平台 API。

功能特性

基于税务管理抽象接口实现企享云税务服务，支持：

  • 发票归集与查询
  • 发票识别（OCR）
  • 发票查验
  • 发票下载（版式文件）
  • 发票入账
  • 进项认证

安装

dotnet add package Bitzsoft.Integrations.Finance.Tax.QiXiangYun

<PackageReference Include="Bitzsoft.Integrations.Finance.Tax.QiXiangYun" Version="*" />

配置

{
  "Finance": {
    "Tax": {
      "QiXiangYun": {
        "AppKey": "企享云提供的 AppKey",
        "AppSecret": "双方约定的 AppSecret",
        "BaseUrl": "https://api.qixiangyun.com",
        "TaxNumber": "企业税号"
      }
    }
  }
}
参数 必填 默认值 说明
AppKey 是 — 企享云侧提供的对接码
AppSecret 是 — 双方约定的签名密钥
BaseUrl 否 企享云正式环境地址 API 基地址
TaxNumber 是 — 企业税号

注册服务

using Bitzsoft.Integrations.Finance.Tax.QiXiangYun;

services.AddBitzsoftQiXiangYunTax(configuration, "Finance:Tax:QiXiangYun");

第三方请求日志

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

// ① 默认：启用记录管道但不持久化（日志丢弃）
services.AddBitzsoftQiXiangYunTax(options => { /* ... */ });

// ② 持久化：宿主注册 IRequestLogStore 实现后，所有出站请求自动落库
services.AddRequestLogging<MyRequestLogStore>(opts =>
{
    opts.MaxBodyLength = 8192;
    opts.SensitiveFields.Add("mySecret");
});
services.AddBitzsoftQiXiangYunTax(options => { /* ... */ });

核心接口

QiXiangYunInvoiceProvider

发票管理核心服务，提供以下功能：

发票归集
  • 发票归集请求提交
  • 异步任务轮询
  • 归集结果查询
发票识别
  • PDF/OFD/图片发票识别
  • 结构化数据提取
  • 明细项解析
发票查验
  • 真伪查验
  • 状态确认
  • 可抵扣判断
发票下载
  • 版式文件下载（PDF/OFD）
  • 批量下载支持
发票入账
  • 入账申请
  • 入账状态查询
进项认证
  • 认证发起
  • 认证结果查询
  • 异步轮询支持

QiXiangYunAsyncTaskManager

异步任务管理器，处理企享云的异步任务模式：

  • 自动轮询任务状态
  • 可配置轮询间隔与上限
  • 超时处理

目标框架

  • .NET 5.0
  • .NET 8.0
  • .NET 10.0

相关包

包名 说明
Bitzsoft.Integrations.Finance.Tax 抽象层
Bitzsoft.Integrations.Compatibility 基础工具库
Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  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 is compatible.  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 (1)

Showing the top 1 NuGet packages that depend on Bitzsoft.Integrations.Finance.Tax.QiXiangYun:

Package Downloads
Bitzsoft.Integrations.Finance.All

财税管理集成聚合包 — 包含所有子模块与供应商实现

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.2 0 8/29/2026
1.0.1 136 8/3/2026
1.0.0 130 8/2/2026
1.0.0-alpha.10 68 7/26/2026
1.0.0-alpha.9 63 7/12/2026
1.0.0-alpha.8 67 7/1/2026
1.0.0-alpha.7 77 6/16/2026
1.0.0-alpha.6 68 6/16/2026
1.0.0-alpha.5 68 6/14/2026