Files
hyapi-server/resources/dev-report/QYGLJ1U9_字段释义_全量.md
2026-04-21 22:36:48 +08:00

26 KiB
Raw Permalink Blame History

QYGLJ1U9 企业全景报告 · 字段释义

一、接口返回的补充字段

字段 说明
reportId 报告编号,用于打开报告页面或下载 PDF。
reportUrl 报告访问地址(完整 URL 或站内相对路径,视部署配置而定)。

二、根结构

字段 说明
reportTime 报告生成时间。
entName 企业名称。
creditCode 统一社会信用代码。
basic 登记注册与主体概况。
basicList 多主体场景下的基础信息列表;单条结构以实际返回为准。
branches 分支机构列表。
shareholding 股权结构、股东、出资与股权变动等。
controller 实际控制人。
beneficiaries 最终受益人。
investments 对外投资及法定代表人相关投资。
guarantees 年报披露的对外担保。
management 高管、法定代表人对外任职、从业人数、社保等。
assets 各年度资产与经营概况。
licenses 行政许可、许可变更、知识产权出质等。
activities 招投标、网站或网店等经营动态。
inspections 抽查检查记录。
risks 司法、行政处罚、经营异常、税务、抵押出质等风险明细。
timeline 工商登记变更时间线。
listed 是否上市及上市相关公开信息。
riskOverview 综合风险等级、得分、标签与维度命中情况。
annualReports 企业年报公示信息列表(一般按报告年度降序)。
taxViolations 税收违法记录条数与明细列表。
ownTaxNotices 欠税公告条数与明细列表。

三、basic 主体概况

字段 说明
entName 企业名称
creditCode 统一社会信用代码
regNo 注册号
orgCode 组织机构代码
entType 企业类型(中文)
entTypeCode 企业类型代码
entityTypeCode 实体类型代码
establishDate 成立日期
registeredCapital 注册资本(数值)
regCapCurrency 注册资本币种
regCapCurrencyCode 注册资本币种代码
regOrg 登记机关
regOrgCode 登记机关代码
regProvince 登记所在省
provinceCode 省级区划代码
regCity 登记所在市
regCityCode 地市代码
regDistrict 登记所在区县
districtCode 区县代码
address 住所
postalCode 邮政编码
legalRepresentative 法定代表人
compositionForm 组成形式
approvedBusinessItem 许可经营项目
status 经营状态(中文)
statusCode 经营状态代码
operationPeriodFrom 营业期限自
operationPeriodTo 营业期限至
approveDate 核准日期
cancelDate 注销日期
revokeDate 吊销日期
cancelReason 注销原因
revokeReason 吊销原因
businessScope 经营范围
lastAnnuReportYear 最近公示年报年度
oldNames 曾用名列表

四、branches[] 分支机构

字段 说明
name 机构名称
regNo 注册号
creditCode 统一社会信用代码
regOrg 登记机关

五、shareholding 股权与出资

字段 说明
shareholders 股东及出资明细列表
shareholderCount 股东人数
registeredCapital 注册资本
currency 注册资本币种
topHolderName 第一大股东名称
topHolderPercent 第一大股东持股比例
top5TotalPercent 前五名股东持股比例合计
equityChanges 股权变更记录
equityPledges 股权出质登记
paidInDetails 实缴出资明细(与年报关联)
subscribedCapitalDetails 认缴出资明细(与年报关联)
hasEquityPledges 是否存在股权出质

股东 shareholders[] 常见字段

字段 说明
name 股东名称
type 股东类型(展示用语)
typeCode 股东类型代码
ownershipPercent 持股比例
subscribedAmount 认缴出资额
paidAmount 实缴出资额
subscribedCurrency 认缴币种
subscribedCurrencyCode 认缴币种代码
paidCurrency 实缴币种
subscribedDate 认缴日期
paidDate 实缴日期
subscribedMethod 认缴出资方式
subscribedMethodCode 认缴出资方式代码
paidMethod 实缴出资方式
creditCode 股东统一社会信用代码
regNo 股东注册号
isHistory 是否为历史股东
source 数据说明(如来自不同产品线时可能出现)

equityChanges[] 股权变更

字段 说明
changeDate 变更日期
shareholderName 股东
percentBefore 变更前出资比例
percentAfter 变更后出资比例
source 信息来源说明

equityPledges[] 股权出质

字段 说明
regNo 登记编号
pledgor 出质人
pledgorIdNo 出质人证件号
pledgedAmount 出质股权数额
pledgee 质权人
pledgeeIdNo 质权人证件号
regDate 登记日期
status 登记状态
publicDate 公示日期

paidInDetails[] 实缴明细

字段 说明
yearReportId 关联年报标识
investor 股东/投资人
paidDate 实缴日期
paidMethod 实缴方式
accumulatedPaid 累计实缴额

subscribedCapitalDetails[] 认缴明细

字段 说明
yearReportId 关联年报标识
investor 股东/投资人
subscribedDate 认缴日期
subscribedMethod 认缴方式
accumulatedSubscribed 累计认缴额

六、controller 实际控制人

字段 说明
id 实控人标识
name 姓名或名称
type 类型
percent 持股或控制比例
path 控制路径(含节点、连线等,结构以实际为准)
reason 备注说明
source 信息来源说明

七、beneficiaries[] 最终受益人

字段 说明
id 受益人标识
name 名称
type 受益人类型(展示)
typeCode 类型代码
percent 受益权比例
path 受益路径(结构以实际为准)
reason 认定理由等
source 信息来源说明

八、investments 对外投资

字段 说明
totalCount 对外投资企业数量
totalAmount 对外认缴出资金额合计
list 对外投资企业列表
legalRepresentativeInvestments 法定代表人对外投资或任职相关企业

list[] 常见字段

字段 说明
entName 被投资企业名称
creditCode 统一社会信用代码
regNo 注册号
entType 企业类型
regCap 注册资本
regCapCurrency 注册资本币种
entStatus 企业经营状态
regOrg 登记机关
establishDate 成立日期
investAmount 认缴投资额
investCurrency 投资币种
investPercent 投资比例
investMethod 投资方式
isListed 是否上市公司
source 信息来源说明

legalRepresentativeInvestments[] 常见字段

字段 说明
entName 企业名称
creditCode 统一社会信用代码
regNo 注册号
entType 企业类型
regCap 注册资本
entStatus 经营状态
regOrg 登记机关
establishDate 成立日期
investAmount 投资额
investPercent 投资比例
investMethod 投资方式

九、guarantees[] 对外担保

字段 说明
yearReportId 关联年报
mortgagor 债务人/抵押相关主体
creditor 债权人
principalAmount 主债权金额
principalKind 主债权种类
guaranteeType 担保方式
periodFrom 履行债务起始日
periodTo 履行债务截止日
guaranteePeriod 保证期间

十、management 人员与社保

字段 说明
executives 主要管理人员
legalRepresentativeOtherPositions 法定代表人在其他企业的任职
employeeCount 从业人数
femaleEmployeeCount 女性从业人数
socialSecurity 单位参保缴费等社会保险信息(字段名以实际返回为准)

executives[]

字段 说明
name 姓名
position 职务

legalRepresentativeOtherPositions[]

字段 说明
entName 任职单位名称
position 职务
name 人员姓名
regNo 注册号
creditCode 统一社会信用代码
entStatus 企业状态

十一、assets 资产与经营

字段 说明
years 按年报年度的资产与损益摘要

years[]

字段 说明
year 年报年度
reportDate 年报关联标识
assetTotal 资产总额
revenueTotal 销售(营业)总收入
mainBusinessRevenue 主营业务收入
taxTotal 纳税总额
equityTotal 所有者权益合计
profitTotal 利润总额
netProfit 净利润
liabilityTotal 负债总额
businessStatus 企业经营状态
mainBusiness 主营业务

十二、licenses 许可与知识产权

字段 说明
permits 行政许可
permitChanges 行政许可变更
ipPledges 知识产权出质
otherLicenses 其他许可(预留,常见为空列表)

permits[]

字段 说明
name 许可名称
valFrom 有效期自
valTo 有效期至
licAnth 许可机关
licItem 许可内容

permitChanges[]

字段 说明
changeDate 变更日期
detailBefore 变更前内容
detailAfter 变更后内容
changeType 变更事项

十三、activities 经营动态

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

十四、inspections[] 抽查检查

字段 说明
dataType 抽查类型
regOrg 检查机关
inspectDate 检查日期
result 检查结果

十五、risks 风险与合规

汇总标志

字段 说明
riskLevel 风险等级文字(低/中/高),与 riskOverview 计算口径不同
riskScore 风险分值,与 riskOverview 计算口径不同
hasCourtJudgments 是否存在裁判文书相关记录
hasJudicialAssists 是否存在司法协助
hasDishonestDebtors 是否存在失信被执行人
hasLimitHighDebtors 是否存在限制高消费被执行人
hasAdminPenalty 是否存在行政处罚
hasException 是否存在经营异常名录记录
hasSeriousIllegal 是否存在严重违法失信等记录
hasTaxOwing 是否存在欠税记录
hasSeriousTaxIllegal 是否存在重大税收违法
hasMortgage 是否存在动产抵押
hasEquityPledges 是否存在股权出质
hasQuickCancel 是否存在简易注销相关公告
dishonestDebtorCount 失信记录条数
limitHighDebtorCount 限高记录条数

列表类字段(内容为监管或司法公开原始结构,子字段以实际为准)

字段 说明
courtJudgments 裁判文书
judicialAssists 司法协助
dishonestDebtors 失信被执行人(已做字段映射的列表)
limitHighDebtors 限制高消费被执行人
adminPenalties 行政处罚
adminPenaltyUpdates 行政处罚变更或补充
exceptions 经营异常
seriousIllegals 严重违法
mortgages 动产抵押

dishonestDebtors[] 失信被执行人(映射后)

字段 说明
id 记录标识
obligation 生效法律文书确定义务
judgmentAmountEst 判决履行金额(估计)
discreditDetail 失信行为情形
execCourt 执行法院
caseNo 案号
execBasisNo 执行依据文号
performanceStatus 履行情况
execBasisOrg 执行依据作出单位
publishDate 发布日期
gender 性别
filingDate 立案日期
province 省份

adminPenaltyUpdates[]

字段 说明
updateDate 更新日期
updateContent 更新内容

mortgages[] 动产抵押

字段 说明
regNo 登记编号
regDate 登记日期
regOrg 登记机关
guaranteedAmount 被担保主债权数额
status 登记状态
publicDate 公示日期
details 登记公示信息摘要
mortgagees 抵押权人
collaterals 抵押物
debts 被担保主债权
alterations 变更
cancellations 注销

litigation 涉诉案件分类

含行政、执行、保全、民事、刑事、破产、管辖、赔偿等类别(键名为英文分类代码)。每一类下为:

字段 说明
count 该类别案件数量
cases 该类别案件列表

案件 cases[] 常见统一字段:

字段 说明
caseNo 案号
court 法院
region 地域
filingDate 立案日期
judgmentDate 裁判日期
trialLevel 审理程序
caseType 案件类型
status 案件进展
cause 案由
amount 争议金额或标的
victoryResult 裁判结果侧记
字段 说明
totalCases 上述各类案件合计条数

quickCancel 简易注销

字段 说明
entName 企业名称
creditCode 统一社会信用代码
regNo 注册号
regOrg 登记机关
noticeFromDate 公告开始日
noticeToDate 公告结束日
cancelResult 简易注销结果
dissents 异议信息列表

异议项:dissentOrg 异议提出单位、dissentDes 异议内容、dissentDate 异议日期。

liquidation 清算

字段 说明
principal 清算组负责人
members 清算组成员名单

taxRecords 税务相关原始汇总

字段 说明
taxLevelAYears 纳税信用等级等相关年度信息
seriousTaxIllegal 重大税收违法案件
taxOwings 欠税信息

十六、timeline[] 工商变更时间线

字段 说明
date 变更日期
type 变更事项类型
title 变更事项标题
detailBefore 变更前内容
detailAfter 变更后内容
source 信息来源

十七、listed 上市信息

字段 说明
isListed 是否上市企业
company 上市主体工商登记相关信息
stock 股票公开信息;无数据时可为空
topShareholders 前十大股东公开信息
listedManagers 上市公司高管公开信息

company

字段 说明
bizScope 经营范围
creditCode 统一社会信用代码
regAddr 注册地址
regCapital 注册资本
orgCode 组织机构代码
cur 币种代码
curName 币种名称

十八、riskOverview 综合风险(推荐用于总览展示)

字段 说明
riskLevel 综合风险等级:低 / 中 / 高
riskScore 综合风险得分0100分数越高表示综合风险越低
tags 命中风险点的简短标签
items 各检查维度是否命中,name 为维度名称,hit 为是否命中

十九、annualReports[] 企业年报

每条为一年度公示年报,字段名为小驼峰,具体键集合随公示数据扩展而变化。常见包含网站网店、股东及出资、对外投资、社保、对外担保、股权变更、年报修改等子模块(多为对象或数组嵌套)。


二十、taxViolations 税收违法

字段 说明
total 记录条数
items 税收违法案件列表,字段名为小驼峰,以实际返回为准

常见字段示例:企业名称、纳税人识别号、案件性质、违法事实、处罚依据、违法起止时间、公示机关、检查机关等。


二十一、ownTaxNotices 欠税公告

字段 说明
total 公告条数
items 欠税公告明细

items[]

字段 说明
taxIdNumber 纳税人识别号
taxpayerName 纳税人名称
taxCategory 欠缴税种
ownTaxBalance 欠税余额
ownTaxAmount 欠税金额
newOwnTaxBalance 新发生欠税余额
taxType 税务记录类型
publishDate 发布日期
department 主管税务机关
location 经营地点
legalPersonName 法定代表人
personIdNumber 身份证件号码
personIdName 身份证件名称栏目
taxpayerType 纳税人类型
regType 登记注册类型

二十二、basicList[]

企业关联的多个登记主体基础信息时出现的列表,单条对象字段以实际返回为准。