Files
tyapi-server/resources/dev-report/QYGLJ1U9_字段释义_全量.md
2026-04-08 19:25:36 +08:00

616 lines
26 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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[]`
企业关联的多个登记主体基础信息时出现的列表,单条对象字段以实际返回为准。