team/hyapi-server
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

f

Browse Source
This commit is contained in:
liangzai
2026-04-21 22:36:48 +08:00
commit 488c695fdf
748 changed files with 266838 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
resources/dev-report/.gitignore vendored Normal file
View File

@@ -0,0 +1,4 @@
# 本地调试数据，勿提交敏感企业信息
fixture.json
built.json
*.local.json

330
resources/dev-report/BUILT_REPORT_FIELDS.md Normal file
View File

@@ -0,0 +1,330 @@
# 企业全景报告 · Build 后 JSON 字段说明
本文描述 **`BuildReportFromRawSources` / `buildReport` 产出的报告对象**（与 `cmd/qygl_report_build`、QYGLJ1U9 聚合逻辑一致）。
数值在 JSON 中可能为 **number**（`json.Unmarshal` 后常见 `float64`）或 **string**，以实际序列化结果为准。
## 数据来源概览
| 报告一级字段 | 主要来源（原始接口 / 表） |
|-------------|---------------------------|
| `basic`、`branches`、`guarantees`、`management`、`assets`、`activities`（部分）等 | 企业全量信息核验 V2（QYGLUY3S，`jiguang`） |
| 存在 `annualReports` 且非空时 | 上述块中与公示年报重复的 `YEARREPORT*` 表会在构建前剔除，改由年报接口数据支撑展示逻辑 |
| `shareholding`、`controller`、`beneficiaries`、`investments`（`list`） | 优先股权全景（QYGLJ0Q1，`equity`），否则回退全量 |
| `risks` 中司法部分 | 司法涉诉（QYGL5S1I，`judicial`）等 |
| `annualReports` | 企业年报（QYGLDJ12，`annualRaw`），键名统一转小驼峰 |
| `taxViolations` | 税收违法（QYGL8848），`items[]` 为驼峰化对象 |
| `ownTaxNotices` | 欠税公告（QYGL7D9A），`items[]` 为固定映射字段 |
## 线上接口额外字段
经 **QYGLJ1U9** 返回时，在 Build 结果上还会增加（不参与 `BuildReportFromRawSources` 纯构建）：
| 字段 | 说明 |
|------|------|
| `reportId` | 报告编号，用于查看页 |
| `reportUrl` | 报告查看链接 |
## 根对象字段
| 字段 | 类型 | 说明 |
|------|------|------|
| `reportTime` | string | 报告生成时间，`2006-01-02 15:04:05` |
| `entName` | string | 企业名称（与 `basic.entName` 一致，便于顶层取用） |
| `creditCode` | string | 统一社会信用代码 |
| `basic` | object | 主体登记信息，见下节 |
| `basicList` | array | **可选**。全量 `BASICLIST` 原始数组，有数据时存在 |
| `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 | 上市信息，无则 `null` |
| `riskOverview` | object | 综合风险评分与标签（由报告聚合结果计算） |
| `annualReports` | array | 企业年报（公示）列表，按 `reportYear` 降序 |
| `taxViolations` | object | `{ total, items[] }` 税收违法 |
| `ownTaxNotices` | object | `{ total, items[] }` 欠税公告 |
---
## `basic`（主体概览）
由全量 `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` | string[]，曾用名；无则为 `[]` |
---
## `branches[]`
| 字段 | 说明 |
|------|------|
| `name`、`regNo`、`creditCode`、`regOrg` | 分支机构名称、注册号、统一码、登记机关 |
---
## `shareholding`
| 字段 | 类型 | 说明 |
|------|------|------|
| `shareholders` | array | 股东及出资明细 |
| `shareholderCount` | int | 股东人数 |
| `registeredCapital`、`currency` | number / string | 注册资本与币种（来自 BASIC） |
| `topHolderName`、`topHolderPercent` | string / number | 第一大股东及持股比例 |
| `top5TotalPercent` | number | 前五大股东持股比例合计 |
| `equityChanges` | array | 股权变更记录 |
| `equityPledges` | array | 股权出质 |
| `paidInDetails` | array | 实缴出资明细（年报表） |
| `subscribedCapitalDetails` | array | 认缴出资明细（年报表） |
| `hasEquityPledges` | bool | 是否存在股权出质 |
### `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[]` / `paidInDetails[]` / `subscribedCapitalDetails[]`
结构与 `qyglj1u9_processor_build.go` 中 `mapEquityPledges`、`mapPaidInDetails`、`mapSubscribedCapitalDetails` 一致（含 `yearReportId`、`investor`、金额日期方式等字段）。
---
## `controller`（可为 `null`）
| 字段 | 说明 |
|------|------|
| `id`、`name`、`type`、`percent` | 实控人标识、名称、类型、比例 |
| `path` | object \| null，`nodes` / `links`，节点上可能含 `entityId`（由 `uid` 复制） |
| `reason`、`source` | 说明、数据来源 |
---
## `beneficiaries[]`
| 字段 | 说明 |
|------|------|
| `id`、`name`、`type`、`typeCode`、`percent`、`path`、`reason`、`source` | 受益人标识、名称、类型、比例、路径、理由、来源 |
---
## `investments`
| 字段 | 说明 |
|------|------|
| `totalCount`、`totalAmount` | 对外投资户数、认缴合计（全量路径下） |
| `list` | 对外投资企业列表 |
| `legalRepresentativeInvestments` | 法定代表人对外投资（FRINV） |
### `list[]` 常见子字段
`entName`、`creditCode`、`regNo`、`entType`、`regCap`、`regCapCurrency`、`entStatus`、`regOrg`、`establishDate`、`investAmount`、`investCurrency`、`investPercent`、`investMethod`、`isListed`、`source`。
---
## `guarantees[]`
| 字段 | 说明 |
|------|------|
| `yearReportId`、`mortgagor`、`creditor`、`principalAmount`、`principalKind`、`guaranteeType`、`periodFrom`、`periodTo`、`guaranteePeriod` | 年报担保摘要 |
---
## `management`
| 字段 | 说明 |
|------|------|
| `executives` | array，`name`、`position` |
| `legalRepresentativeOtherPositions` | array，法人对外任职：`entName`、`position`、`name`、`regNo`、`creditCode`、`entStatus` |
| `employeeCount`、`femaleEmployeeCount` | 从业人数、女性从业人数（来自最新年报 BASIC 摘要） |
| `socialSecurity` | object | 社会保险分项参保人数等，**一般为全量 `YEARREPORTSOCSEC` 首条原始对象**（键名多为大写，与数据源一致）；无数据时可能为空对象 `{}` |
---
## `assets`
| 字段 | 说明 |
|------|------|
| `years` | array，按年度的资产经营摘要 |
### `assets.years[]`
| 字段 | 说明 |
|------|------|
| `year`、`reportDate` | 年度、关联年报标识（实现上取自 `ANCHEID`） |
| `assetTotal`、`revenueTotal`、`mainBusinessRevenue`、`taxTotal`、`equityTotal`、`profitTotal`、`netProfit`、`liabilityTotal` | 资产、收入、税费、权益、利润、负债等 |
| `businessStatus`、`mainBusiness` | 经营状态、主营业务 |
---
## `licenses`
| 字段 | 说明 |
|------|------|
| `permits` | array，`name`、`valFrom`、`valTo`、`licAnth`、`licItem` |
| `permitChanges` | array，`changeDate`、`detailBefore`、`detailAfter`、`changeType` |
| `ipPledges` | array，原始知产出质结构（与全量一致） |
| `otherLicenses` | array，当前固定为空数组 |
---
## `activities`
| 字段 | 说明 |
|------|------|
| `bids` | array，招投标原始项 |
| `websites` | array，网站或网店（年报表 `YEARREPORTWEBSITEINFO`） |
---
## `inspections[]`
| 字段 | 说明 |
|------|------|
| `dataType`、`regOrg`、`inspectDate`、`result` | 抽查类型、机关、日期、结果 |
---
## `risks`
### 标量与汇总
| 字段 | 说明 |
|------|------|
| `riskLevel`、`riskScore` | 内部粗算风险等级/分数（与 `riskOverview` 计算方式不同，以 `riskOverview` 为准做展示） |
| `hasCourtJudgments`、`hasJudicialAssists`、`hasDishonestDebtors`、`hasLimitHighDebtors` | 布尔标志 |
| `hasAdminPenalty`、`hasException`、`hasSeriousIllegal` | 行政处罚、经营异常、严重违法 |
| `hasTaxOwing`、`hasSeriousTaxIllegal`、`hasMortgage`、`hasEquityPledges` | 欠税、重大税收违法、动产抵押、股权出质 |
| `hasQuickCancel` | 简易注销公告 |
| `dishonestDebtorCount`、`limitHighDebtorCount` | 失信、限高条数 |
### 主要数组 / 对象
| 字段 | 说明 |
|------|------|
| `dishonestDebtors` | 失信被执行人（映射后子字段含 `id`、`obligation`、`caseNo`、`execCourt` 等） |
| `limitHighDebtors` | 限高名单（原始结构数组） |
| `litigation` | 涉诉汇总，`administrative` / `civil` / … 各类下为 `{ count, cases[] }`，`cases[]` 含 `caseNo`、`court`、`filingDate` 等 |
| `adminPenalties`、`adminPenaltyUpdates` | 行政处罚及变更 |
| `exceptions` | 经营异常原始列表 |
| `seriousIllegals` | 严重违法原始列表 |
| `mortgages` | 动产抵押（含子数组 `mortgagees`、`collaterals` 等） |
| `quickCancel`、`liquidation` | 简易注销、清算信息，无则 `null` |
| `taxRecords` | `{ taxLevelAYears[], seriousTaxIllegal[], taxOwings[] }`（全量税务相关原始切片） |
| `courtJudgments`、`judicialAssists` | 裁判文书、司法协助（原始结构） |
---
## `timeline[]`
| 字段 | 说明 |
|------|------|
| `date`、`type`、`title`、`detailBefore`、`detailAfter`、`source` | 变更日期、事项类型、标题、变更前后、来源 |
---
## `listed`（可为 `null`）
| 字段 | 说明 |
|------|------|
| `isListed` | bool |
| `company` | object，上市主体工商摘要片段 |
| `stock`、`topShareholders`、`listedManagers` | 股票信息、十大股东、高管（多为原始结构） |
---
## `riskOverview`（综合风险，供页眉/总览）
| 字段 | 说明 |
|------|------|
| `riskLevel` | string，`低` / `中` / `高` |
| `riskScore` | int，0–100 |
| `tags` | string[]，命中风险点的简短标签 |
| `items` | array，`{ name, hit }`，各维度是否命中 |
---
## `annualReports[]`
- 每条为 **QYGLDJ12 单条年报**经 **`convertReportKeysToCamel` 递归转小驼峰** 后的对象。
- 除汇总字段外，常见还包含（名称以驼峰为准）：网站 `reportWebsiteInfo`、股东 `reportShareholderInfo`、对外投资 `reportInvestInfo` 与 `investInfo`、社保 `reportSocialSecurityInfo`、担保 `reportGuaranteeInfo`、股权变更 `reportEquityChangeInfo`、变更 `reportChangeInfo` 等，**具体键集合以接口返回为准**。
- 页面汇总网格展示的字段集合与 `qyglj1u9_processor_build.go` 中 `mapAnnualReports` 之后、`qiye.html` 内 `sumKeys` 对齐（`investInfo` 仅在详情列表展示，不在顶层网格重复）。
---
## `taxViolations`
```json
{ "total": 0, "items": [] }
```
- `total`：条数，缺省时与 `items.length` 一致。
- `items[]`：**QYGL8848 每条记录键名转驼峰后的对象**。展示层常用字段包括（以实际数据为准）：`entityName`、`taxpayerCode`、`caseType`、`entityCategory`、`illegalFact`、`punishBasis`、`illegalStartDate`、`illegalEndDate`、`illegalTime`、`publishDepartment`、`checkDepartment`、`belongDepartment`、`police`、`agencyPersonInfo` 等。
---
## `ownTaxNotices`
```json
{ "total": 0, "items": [] }
```
### `items[]` 固定映射字段
| 字段 | 说明 |
|------|------|
| `taxIdNumber` | 纳税人识别号 |
| `taxpayerName` | 纳税人名称 |
| `taxCategory` | 欠税税种 |
| `ownTaxBalance`、`ownTaxAmount`、`newOwnTaxBalance` | 欠税余额、欠税金额、当前新发生欠税余额 |
| `taxType` | 税务类型（来自原始 `type`） |
| `publishDate` | 发布日期 |
| `department` | 主管税务机关 |
| `location` | 地点 |
| `legalPersonName` | 法定代表人 |
| `personIdNumber`、`personIdName` | 证件号码及证件名称字段名 |
| `taxpayerType`、`regType` | 纳税人类型、登记类型 |
---
## 维护说明
- **字段增删**以 `internal/domains/api/services/processors/qygl/qyglj1u9_processor_build.go` 为准；年报、税收违法条目的细键若接口升级，可能随 `convertReportKeysToCamel` 自动变为新驼峰键。
- 前端展示标签中文名见 `resources/qiye.html` 中 `keyLabels`（与 Build 字段名对应）。

615
resources/dev-report/QYGLJ1U9_字段释义_全量.md Normal file
View File

@@ -0,0 +1,615 @@
# 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` | 综合风险得分（0–100，分数越高表示综合风险越低） |
| `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[]`
企业关联的多个登记主体基础信息时出现的列表，单条对象字段以实际返回为准。

203
resources/dev-report/QYGLJ1U9_客户字段说明.md Normal file
View File

@@ -0,0 +1,203 @@
# 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"
}
]
}
```

57879
resources/dev-report/raw.bundle.template.json Normal file
View File

File diff suppressed because one or more lines are too long