# 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"
        }
    ]
}
```