API DETAIL

企业年报详情接口

根据企业 ID 或统一社会信用代码及年报年份,查询该年度企业年报结构化详情(基本信息、股东出资、网站网店、资产、对外投资、对外担保等),有哪些年度有年报可以通过企业基本信息接口查看。

分类:企业信息 方法:POST MCP Tool:yuandian_rh_enterpriseAnnualReport 静态 API 文档

首屏摘要

接口名称企业年报详情接口
接口描述根据企业 ID 或统一社会信用代码及年报年份,查询该年度企业年报结构化详情(基本信息、股东出资、网站网店、资产、对外投资、对外担保等),有哪些年度有年报可以通过企业基本信息接口查看。
分类企业信息
调用地址https://open.chineselaw.com/open/rh_enterpriseAnnualReport
文档摘要企业年报详情接口 1. 基本信息 **接口名称**:企业年报详情 **接口用途**:根据企业 ID 或统一社会信用代码及年报年份,查询该年度企业年报结构化详情(基本信息、股东出资、网站网店、资产、对外投资、对外担保等),有哪些年度有年报可以通过企业基本信息接口查看。 2. 请求信息 **HTTP Method**:GET **URL**:/legal-insight/service/app/dify/company/enterpriseAnnualReport 3. 请求参…

请求参数

3. 请求参数(Query)

参数名 类型 是否必填 说明
id string 企业 ID
tyshxydm string 统一社会信用代码
year string 年报年份(对应 ES reportYear

idtyshxydm 不能同时为空。

响应参数

5. 响应说明

5.1 通用返回结构

字段名 类型 说明
status string success / notFound
code number 成功 200
message string 提示信息
data object 数据结果

5.2 data 对象说明

字段名 类型 说明
id string 企业 ID
name string 企业名称
企业基本信息 object 年报中的企业联系与状态等
股东及出资信息 object[] 股东及认缴/实缴出资
网站或网店信息 object[] 网站或网店
企业资产信息 object 资产、利润、负债等
对外投资信息 object[] 年报披露的对外投资
对外担保信息 object[] 对外担保

错误码

暂无错误码说明

调用示例

CURL

curl --location --request GET '/legal-insight/service/app/dify/company/enterpriseAnnualReport?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&year=2023' \
--header 'X-API-Key: 你的api_key' \
--header 'Accept: application/json'

JAVA

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

public class EnterpriseAnnualReportExample {
    public static void main(String[] args) throws Exception {
        String apiKey = "你的api_key";
        String url = "/legal-insight/service/app/dify/company/enterpriseAnnualReport?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&year=2023";

        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .timeout(Duration.ofSeconds(60))
                .header("X-API-Key", apiKey)
                .header("Accept", "application/json")
                .GET()
                .build();

        HttpClient client = HttpClient.newHttpClient();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

PYTHON

import requests

url = "/legal-insight/service/app/dify/company/enterpriseAnnualReport"
API_KEY = "你的api_key"
headers = {
    "X-API-Key": API_KEY,
    "Accept": "application/json",
}
params = {
    'id': 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14',
    'year': '2023',
}
response = requests.get(url, params=params, headers=headers, timeout=60)
response.raise_for_status()
print(response.json())

JAVASCRIPT

const API_KEY = "你的api_key";
const url = new URL("/legal-insight/service/app/dify/company/enterpriseAnnualReport");
url.searchParams.set('id', 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14');
url.searchParams.set('year', '2023');

const res = await fetch(url, {
  method: "GET",
  headers: {
    "X-API-Key": API_KEY,
    "Accept": "application/json",
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
console.log(await res.json());

MCP Tool 名称

MCP Serveryuandian-company(企业信息 Server)
Streamable HTTP 入口https://open.chineselaw.com/mcp/company/stream
MCP Toolyuandian_rh_enterpriseAnnualReport

响应示例

{
  "code": 200,
  "data": {
    "id": "a80a4cc8-9954-4dd3-bcaf-aebb99487b14",
    "name": "示例科技有限公司",
    "企业基本信息": {
      "企业名称": "示例科技有限公司",
      "工商注册号": "110000000000001",
      "统一社会信用代码": "91110000000000000X",
      "企业经营状态": "开业",
      "从业人数": "企业选择不公示",
      "联系电话": "010-12345678",
      "企业邮箱": "企业选择不公示",
      "企业通信地址": "北京市海淀区示例路1号"
    },
    "股东及出资信息": [],
    "网站或网店信息": [],
    "企业资产信息": {
      "资产总额": "企业选择不公示",
      "所有者权益合计": "企业选择不公示",
      "销售总额(营业总收入)": "企业选择不公示",
      "主营业务收入": "企业选择不公示",
      "利润总额": "企业选择不公示",
      "净利润": "企业选择不公示",
      "纳税总额": "企业选择不公示",
      "负债总额": "企业选择不公示"
    },
    "对外投资信息": [],
    "对外担保信息": []
  },
  "message": "请求成功",
  "status": "success"
}

完整文档

企业年报详情接口

1. 基本信息

  • 接口名称:企业年报详情
  • 接口用途:根据企业 ID 或统一社会信用代码及年报年份,查询该年度企业年报结构化详情(基本信息、股东出资、网站网店、资产、对外投资、对外担保等),有哪些年度有年报可以通过企业基本信息接口查看。

2. 请求信息

  • HTTP Method:GET
  • URL/legal-insight/service/app/dify/company/enterpriseAnnualReport

3. 请求参数(Query)

参数名 类型 是否必填 说明
id string 企业 ID
tyshxydm string 统一社会信用代码
year string 年报年份(对应 ES reportYear

idtyshxydm 不能同时为空。

4. 请求示例

GET /legal-insight/service/app/dify/company/enterpriseAnnualReport?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&year=2023

5. 响应说明

5.1 通用返回结构

字段名 类型 说明
status string success / notFound
code number 成功 200
message string 提示信息
data object 数据结果

5.2 data 对象说明

字段名 类型 说明
id string 企业 ID
name string 企业名称
企业基本信息 object 年报中的企业联系与状态等
股东及出资信息 object[] 股东及认缴/实缴出资
网站或网店信息 object[] 网站或网店
企业资产信息 object 资产、利润、负债等
对外投资信息 object[] 年报披露的对外投资
对外担保信息 object[] 对外担保

6. 响应示例

{
  "code": 200,
  "data": {
    "id": "a80a4cc8-9954-4dd3-bcaf-aebb99487b14",
    "name": "示例科技有限公司",
    "企业基本信息": {
      "企业名称": "示例科技有限公司",
      "工商注册号": "110000000000001",
      "统一社会信用代码": "91110000000000000X",
      "企业经营状态": "开业",
      "从业人数": "企业选择不公示",
      "联系电话": "010-12345678",
      "企业邮箱": "企业选择不公示",
      "企业通信地址": "北京市海淀区示例路1号"
    },
    "股东及出资信息": [],
    "网站或网店信息": [],
    "企业资产信息": {
      "资产总额": "企业选择不公示",
      "所有者权益合计": "企业选择不公示",
      "销售总额(营业总收入)": "企业选择不公示",
      "主营业务收入": "企业选择不公示",
      "利润总额": "企业选择不公示",
      "净利润": "企业选择不公示",
      "纳税总额": "企业选择不公示",
      "负债总额": "企业选择不公示"
    },
    "对外投资信息": [],
    "对外担保信息": []
  },
  "message": "请求成功",
  "status": "success"
}

7. 代码示例

7.1 CURL

curl --location --request GET '/legal-insight/service/app/dify/company/enterpriseAnnualReport?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&year=2023' \
--header 'X-API-Key: 你的api_key' \
--header 'Accept: application/json'

7.2 Python

import requests

url = "/legal-insight/service/app/dify/company/enterpriseAnnualReport"
API_KEY = "你的api_key"
headers = {
    "X-API-Key": API_KEY,
    "Accept": "application/json",
}
params = {
    'id': 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14',
    'year': '2023',
}
response = requests.get(url, params=params, headers=headers, timeout=60)
response.raise_for_status()
print(response.json())

7.3 Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

public class EnterpriseAnnualReportExample {
    public static void main(String[] args) throws Exception {
        String apiKey = "你的api_key";
        String url = "/legal-insight/service/app/dify/company/enterpriseAnnualReport?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&year=2023";

        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .timeout(Duration.ofSeconds(60))
                .header("X-API-Key", apiKey)
                .header("Accept", "application/json")
                .GET()
                .build();

        HttpClient client = HttpClient.newHttpClient();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

7.4 JavaScript

const API_KEY = "你的api_key";
const url = new URL("/legal-insight/service/app/dify/company/enterpriseAnnualReport");
url.searchParams.set('id', 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14');
url.searchParams.set('year', '2023');

const res = await fetch(url, {
  method: "GET",
  headers: {
    "X-API-Key": API_KEY,
    "Accept": "application/json",
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
console.log(await res.json());