Bitzsoft.Integrations.EnterpriseInfo 1.0.0-alpha.3

Bitzsoft.Integrations.EnterpriseInfo

企业信息查询抽象层 —— 统一接口与强类型模型，屏蔽企查查、天眼查、启信宝等第三方供应商差异。

功能特性

• 统一查询接口 IEnterpriseInfoProvider：屏蔽底层供应商差异，提供一致的企业信息查询 API
• 企业搜索：按关键字搜索企业，支持分页
• 工商信息：获取企业基本照面信息及详情（股东、主要人员、分支机构、变更记录等）
• 三要素核验：企业名称、统一社会信用代码、法定代表人姓名一致性验证
• 风险扫描：多维度风险摘要（失信、被执行、诉讼、经营异常、行政处罚等）
• 股东信息：企业股东出资比例及类型
• 司法案件：裁判文书、失信被执行、开庭公告等司法数据
• 实际控制人：穿透企业股权结构获取实际控制人及控制链
• 强类型模型：所有接口返回不可变（init）强类型模型，IReadOnlyList<T> 保证集合只读
• 可扩展架构：实现 IEnterpriseInfoProvider 即可接入新的企业信息供应商

安装

.NET CLI

dotnet add package Bitzsoft.Integrations.EnterpriseInfo

PackageReference

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

配置

本包为抽象层，不包含具体供应商配置。请查阅各实现包的文档：

• Qichacha —— appsettings.json 中配置 Key + SecretKey
• Tianyancha —— appsettings.json 中配置 Token
• Qixin —— appsettings.json 中配置 AppKey + SecretKey

注册服务

// 单一供应商注册（以企查查为例）
services.AddBitzsoftQichachaEnterpriseInfo(options =>
{
    options.Key = "your-app-key";
    options.SecretKey = "your-secret-key";
});

// 或使用 IConfiguration 绑定
services.AddBitzsoftQichachaEnterpriseInfo(configuration, "Qichacha");

使用示例

企业搜索与基本信息查询

using Bitzsoft.Integrations.EnterpriseInfo;
using Bitzsoft.Integrations.EnterpriseInfo.Models;

public class EnterpriseService
{
    private readonly IEnterpriseInfoProvider _provider;

    public EnterpriseService(IEnterpriseInfoProvider provider)
    {
        _provider = provider;
    }

    public async Task<EnterpriseBasicInfo> LookupAsync(string keyword)
    {
        // 先模糊搜索
        var searchResult = await _provider.SearchAsync(keyword);
        var match = searchResult.Items.FirstOrDefault();
        if (match is null)
            throw new InvalidOperationException($"未找到匹配企业: {keyword}");

        // 获取工商照面信息
        return await _provider.GetBasicInfoAsync(match.CreditCode ?? match.Name);
    }
}

三要素核验

public async Task<bool> VerifyEnterpriseAsync(
    string creditCode, string name, string legalPerson)
{
    var result = await _provider.VerifyAsync(creditCode, name, legalPerson);
    return result.IsMatch;
}

风险扫描

public async Task<EnterpriseRiskSummary> AssessRiskAsync(string creditCodeOrName)
{
    var summary = await _provider.GetRiskSummaryAsync(creditCodeOrName);

    Console.WriteLine($"企业: {summary.Name}");
    Console.WriteLine($"风险等级: {summary.RiskLevel}");
    Console.WriteLine($"失信记录: {summary.DishonestCount}");
    Console.WriteLine($"被执行: {summary.ExecutedCount}");
    Console.WriteLine($"诉讼: {summary.LitigationCount}");
    Console.WriteLine($"经营异常: {summary.AbnormalCount}");
    Console.WriteLine($"行政处罚: {summary.PenaltyCount}");

    return summary;
}

获取股东与实际控制人

public async Task ShareholderReportAsync(string creditCodeOrName)
{
    var shareholders = await _provider.GetShareholdersAsync(creditCodeOrName);
    foreach (var s in shareholders.Take(5))
    {
        Console.WriteLine($"{s.Name}: {s.ShareholdingRatio:P1} ({s.ShareholderType})");
    }

    var controller = await _provider.GetActualControllerAsync(creditCodeOrName);
    Console.WriteLine($"实际控制人: {controller.ControllerName}, 控制比例: {controller.ControlRatio:P1}");
}

核心类型一览

依赖

• Microsoft.Extensions.DependencyInjection —— DI 容器支持

相关包

• Bitzsoft.Integrations.Compatibility —— 基础工具库
• Bitzsoft.Integrations.EnterpriseInfo.Qichacha —— 企查查实现（167 个 API）
• Bitzsoft.Integrations.EnterpriseInfo.Tianyancha —— 天眼查实现（225 个 API）
• Bitzsoft.Integrations.EnterpriseInfo.Qixin —— 启信宝实现（270 个 API）
• Bitzsoft.Integrations.EnterpriseInfo.All —— 全部供应商聚合包