Bitzsoft.Integrations.Finance 1.0.0-alpha.10

This is a prerelease version of Bitzsoft.Integrations.Finance.

dotnet add package Bitzsoft.Integrations.Finance --version 1.0.0-alpha.10

NuGet\Install-Package Bitzsoft.Integrations.Finance -Version 1.0.0-alpha.10

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" Version="1.0.0-alpha.10" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="Bitzsoft.Integrations.Finance" Version="1.0.0-alpha.10" />
                    

                            Directory.Packages.props

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

                            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 --version 1.0.0-alpha.10

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Bitzsoft.Integrations.Finance, 1.0.0-alpha.10"

#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@1.0.0-alpha.10

#: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&version=1.0.0-alpha.10&prerelease
                    

                            Install as a Cake Addin

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

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Bitzsoft.Integrations.Finance

财税管理集成公共基础 -- 领域异常基类，供所有财税子模块复用。

功能特性

领域异常基类：FinanceException 统一封装供应商名称、错误码与原始错误消息，所有发票 / 税务 / 薪酬社保异常均派生自此类
零依赖基座：仅定义异常约定，不含接口、配置与 DI 注册，作为 Invoice / Tax / Payroll 抽象层的公共上游
结构化错误信息：异常消息自动带 [供应商名] 前缀，并保留 ProviderMessage 供应商原始响应，便于跨供应商问题排查

安装

.NET CLI

dotnet add package Bitzsoft.Integrations.Finance

PackageReference

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

配置

本包为公共基础库，不读取任何配置节，也不注册任何服务。供 Invoice / Tax / Payroll 抽象层引用，传递 FinanceException 等领域类型。

注册服务

本包不提供 DI 注册扩展方法。请使用下方相关包的抽象层或聚合包进行注册。

使用示例

捕获领域异常

发票 / 税务 / 薪酬社保实现包抛出的异常均派生自 FinanceException，宿主应用可统一捕获：

using Bitzsoft.Integrations.Finance;

try
{
    var invoice = await _invoiceProvider.IssueAsync(request);
}
catch (FinanceException ex)
{
    // ex.ProviderName     -- 供应商名称（如 Nuonuo / Baiwang / Kingdee / QiXiangYun）
    // ex.ErrorCode        -- 供应商错误码
    // ex.ProviderMessage  -- 供应商原始错误消息
    // ex.Message          -- 已带 "[供应商名]" 前缀的可读消息
    logger.LogError(ex,
        "财税服务调用失败 Provider={Provider} Code={Code} Detail={Detail}",
        ex.ProviderName, ex.ErrorCode, ex.ProviderMessage);
}

自定义异常派生

实现自有供应商时，继承 FinanceException 即可融入统一异常体系：

public sealed class MyFinanceException : FinanceException
{
    public MyFinanceException(string message, string? errorCode = null)
        : base("MyVendor", message, errorCode) { }
}

核心类型一览

类型	说明
`FinanceException`	财税管理领域统一异常基类（ProviderName / ErrorCode / ProviderMessage / Message 自动带前缀）

依赖

本包无第三方 NuGet 依赖，仅依赖 .NET BCL（System.Runtime）。

包	说明
`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.

NuGet packages (4)

Showing the top 4 NuGet packages that depend on Bitzsoft.Integrations.Finance:

Package	Downloads
Bitzsoft.Integrations.Finance.Invoice 发票管理服务抽象层 — 统一接口定义与基础模型	436
Bitzsoft.Integrations.Finance.Payroll 薪酬社保服务抽象层 — 统一接口定义与基础模型	368
Bitzsoft.Integrations.Finance.Tax 税务管理服务抽象层 — 统一接口定义与基础模型	365
Bitzsoft.Integrations.Finance.All 财税管理集成聚合包 — 包含所有子模块与供应商实现	326

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
1.0.0-alpha.10	42	7/26/2026
1.0.0-alpha.9	89	7/12/2026
1.0.0-alpha.8	97	7/1/2026
1.0.0-alpha.7	109	6/16/2026
1.0.0-alpha.6	106	6/16/2026
1.0.0-alpha.5	99	6/14/2026