tyapi-server/resources/dev-report/QYGLJ1U9_客户字段说明.md

QYGLJ1U9 企业全景报告字段说明

一、返回对象总览

字段	类型	说明
reportId	string	报告编号，可用于后续按编号访问报告页面或下载 PDF。
reportUrl	string	报告访问链接。
reportTime	string	报告生成时间，格式示例：2026-03-21 19:30:45。
entName	string	企业名称。
creditCode	string	统一社会信用代码。
basic	object	企业主体基础信息。
branches	array	分支机构列表。
shareholding	object	股权结构与股东信息。
controller	object / null	实际控制人信息。
beneficiaries	array	最终受益人列表。
investments	object	对外投资信息。
guarantees	array	对外担保信息。
management	object	高管、人员和社保相关信息。
assets	object	资产经营类年度信息。
licenses	object	行政许可、许可变更、知识产权出质等。
activities	object	招投标、网站网店等经营活动信息。
inspections	array	抽查检查信息。
risks	object	风险与合规信息。
timeline	array	工商变更时间线。
listed	object / null	上市相关信息。
riskOverview	object	风险总览（等级、分值、标签）。
annualReports	array	企业年报列表。
taxViolations	object	税收违法信息，结构为 { total, items }。
ownTaxNotices	object	欠税公告信息，结构为 { total, items }。

---

二、核心字段说明

1) basic 企业主体基础信息

常见字段如下：

字段	说明
entName	企业名称
creditCode	统一社会信用代码
regNo	注册号
orgCode	组织机构代码
entType	企业类型
establishDate	成立日期
registeredCapital	注册资本
regCapCurrency	注册资本币种
legalRepresentative	法定代表人
status	经营状态
operationPeriodFrom / operationPeriodTo	营业期限起止
regOrg	登记机关
address	企业地址
businessScope	经营范围
oldNames	曾用名列表

2) shareholding 股权结构

字段	说明
shareholders	股东列表
shareholderCount	股东人数
topHolderName	第一大股东名称
topHolderPercent	第一大股东持股比例
top5TotalPercent	前五大股东持股比例合计
equityChanges	股权变更记录
equityPledges	股权出质记录
paidInDetails	实缴出资明细
subscribedCapitalDetails	认缴出资明细

shareholders 常见子字段： name、type、ownershipPercent、subscribedAmount、paidAmount、subscribedDate、paidDate。

3) controller 实际控制人

常见字段：id、name、type、percent、path、reason。

4) beneficiaries 最终受益人

每条常见字段：id、name、type、percent、path、reason。

5) investments 对外投资

字段	说明
totalCount	对外投资企业数量
totalAmount	对外投资金额汇总（如有）
list	对外投资企业列表
legalRepresentativeInvestments	法定代表人对外投资列表

list 常见子字段：entName、creditCode、entStatus、regCap、investAmount、investPercent。

6) management 管理层与人员信息

字段	说明
executives	高管列表（姓名、职务）
legalRepresentativeOtherPositions	法人对外任职信息
employeeCount	员工人数
femaleEmployeeCount	女性员工人数
socialSecurity	社保相关字段集合

7) assets 资产经营信息

assets.years 为按年度的经营数据，常见字段： year、assetTotal、revenueTotal、mainBusinessRevenue、taxTotal、equityTotal、profitTotal、netProfit、liabilityTotal。

8) licenses 许可与资质信息

字段	说明
permits	行政许可列表
permitChanges	行政许可变更列表
ipPledges	知识产权出质列表
otherLicenses	其他许可信息

9) activities 经营活动信息

字段	说明
bids	招投标信息
websites	网站或网店信息

10) inspections 抽查检查

每条常见字段：dataType、regOrg、inspectDate、result。

---

三、风险相关字段

1) riskOverview 风险总览（建议用于首页展示）

字段	类型	说明
riskLevel	string	风险等级：低 / 中 / 高。
riskScore	number	风险分值（0-100）。
tags	array	风险标签列表。
items	array	各类风险项命中情况，元素结构通常为 { name, hit }。

2) risks 风险详情

常见布尔字段：
hasCourtJudgments、hasJudicialAssists、hasDishonestDebtors、hasLimitHighDebtors、hasAdminPenalty、hasException、hasSeriousIllegal、hasTaxOwing、hasSeriousTaxIllegal、hasMortgage、hasEquityPledges、hasQuickCancel。

常见明细字段：
dishonestDebtors、limitHighDebtors、litigation、adminPenalties、adminPenaltyUpdates、exceptions、seriousIllegals、mortgages、taxRecords、courtJudgments、judicialAssists、quickCancel、liquidation。

---

四、年报与税务字段

1) annualReports 企业年报列表

每个元素代表一个年度年报，字段较多，常见包括：

• 基础信息（如年度、企业基本经营情况）
• 股东与出资信息
• 对外投资信息
• 网站网店信息
• 社保信息
• 对外担保信息
• 股权变更信息
• 年报变更信息

2) taxViolations 税收违法信息

结构示例：

{
    "total": 2,
    "items": [
        {
            "entityName": "示例企业",
            "taxpayerCode": "xxxx",
            "illegalFact": "......",
            "publishDepartment": "......",
            "illegalTime": "2025-06-12"
        }
    ]
}

3) ownTaxNotices 欠税公告信息

结构示例：

{
    "total": 1,
    "items": [
        {
            "taxpayerName": "示例企业",
            "taxIdNumber": "xxxx",
            "taxCategory": "增值税",
            "ownTaxBalance": "100000",
            "publishDate": "2025-12-01"
        }
    ]
}