204 lines
9.0 KiB
Markdown
204 lines
9.0 KiB
Markdown
# 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` 税收违法信息
|
||
|
||
结构示例：
|
||
|
||
```json
|
||
{
|
||
"total": 2,
|
||
"items": [
|
||
{
|
||
"entityName": "示例企业",
|
||
"taxpayerCode": "xxxx",
|
||
"illegalFact": "......",
|
||
"publishDepartment": "......",
|
||
"illegalTime": "2025-06-12"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
### 3) `ownTaxNotices` 欠税公告信息
|
||
|
||
结构示例：
|
||
|
||
```json
|
||
{
|
||
"total": 1,
|
||
"items": [
|
||
{
|
||
"taxpayerName": "示例企业",
|
||
"taxIdNumber": "xxxx",
|
||
"taxCategory": "增值税",
|
||
"ownTaxBalance": "100000",
|
||
"publishDate": "2025-12-01"
|
||
}
|
||
]
|
||
}
|
||
```
|