批量下单

接口描述

---

批量提交企业名单，系统自动创建批量下单任务并异步处理，支持任务状态查询与明细进度跟踪

更新日志

版本	修改描述	修订人	修订时间
1.0.0	初版	hualess	2026-08-31

批量下单

调用接口

请求方式： POST（HTTPS）请求地址： https://eagleinsight.cn/open-api/batch-export-apply

⚠️ 注意：本接口需携带有效的 access_token 进行身份验证，未授权访问将被拒绝。

请求参数

{
  "reportType": "NB",
  "reportYear": "2024",
  "companyList": [
    "北京XX科技有限公司",
    "91310100MA98765432"
  ],
  "needReport": false
}

请求参数说明

Header 参数（http header）

参数名	类型	必填	说明
Authorization	string	是	请求令牌，Bearer [access_token]

Body 参数（application/json）

参数名	类型	必填	说明
reportType	string	是	报告类型：NB（工商年报）/ GYL（供应链）/ JY（经营分析）/ SF（司法高阶版）
reportYear	string	否	年报申请年份（如2024/2025），仅NB类型必填，默认2024
companyList	List<string>	是	企业名称或统一社会信用代码列表，最多500条
needReport	boolean	否	是否需要生成报告，仅NB有效，默认false；为true时返回报告地址url

返回结果（校验通过）

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "taskId": "BE1234567890",
    "totalCount": 50
  }
}

返回结果（校验失败 — 有不合法企业，不创建任务）

{
  "code": 400,
  "msg": "企业校验未通过，请修正后重新提交",
  "data": {
    "failCount": 2,
    "failList": [
      "不存在的公司",
      "无信用代码的企业"
    ]
  }
}

返回参数说明

参数	类型	含义
taskId	string	任务编号（仅校验全通过时返回），用于查询任务状态
totalCount	int	总条数（去重后，仅校验通过时返回）
failCount	int	校验失败数（仅校验失败时返回）
failList	List<string>	校验失败的企业名称列表（仅校验失败时返回）

校验规则： 后端批量查数仓校验企业存在性 + 回填统一社会信用代码。任一企业校验失败（企业不存在 / 无统代），整批不创建任务，返回失败企业原始入参名称让客户修正后重新提交。只有全部企业校验通过才会创建任务并返回 taskId。重复企业自动去重（不重复扣额度）。

批量下单查询

调用接口

请求方式： POST（HTTPS）请求地址： https://eagleinsight.cn/open-api/batch-export-query

⚠️ 注意：本接口需携带有效的 access_token 进行身份验证，未授权访问将被拒绝。

请求参数

{
  "taskId": "BE1234567890"
}

请求参数说明

Header 参数（http header）

参数名	类型	必填	说明
Authorization	string	是	请求令牌，Bearer [access_token]

Body 参数（application/json）

参数名	类型	必填	说明
taskId	string	是	任务编号（批量下单返回的 taskId）

返回结果

点击展开 JSON 数据

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "taskId": "BE1234567890",
    "taskName": "批量下单_BE1234567890",
    "reportType": "NB",
    "status": "3",
    "statusDesc": "全成功",
    "totalCount": 50,
    "successCount": 45,
    "failCount": 5,
    "hasData": 1,
    "zipUrl": "https://oss.example.com/batch/批量下单_BE1234567890.zip",
    "details": [
      {
        "companyName": "北京XX科技有限公司",
        "creditNo": "91110100MA12345678",
        "status": "3",
        "statusDesc": "成功",
        "orderNo": "NB1234567890",
        "fileUrl": "https://oss.example.com/report/xxx.pdf",
        "fileSuffix": "pdf",
        "hasData": 1,
        "msg": null
      },
      {
        "companyName": "上海YY贸易有限公司",
        "creditNo": "91310100MA98765432",
        "status": "-1",
        "statusDesc": "失败",
        "orderNo": "NB1234567891",
        "fileUrl": null,
        "fileSuffix": null,
        "hasData": 0,
        "msg": "报告生成失败"
      }
    ]
  }
}

返回参数说明

参数	类型	含义
taskId	string	任务编号
taskName	string	任务名称
reportType	string	报告类型
status	string	任务状态
statusDesc	string	任务状态描述
totalCount	int	总条数（实时聚合）
successCount	int	成功条数（实时聚合）
failCount	int	失败条数（实时聚合）
hasData	int	是否有文件产出：0 无数据 / 1 有文件
zipUrl	string	ZIP下载地址（打包完成后有值）
details	array	明细列表

明细字段

参数	类型	含义
companyName	string	企业名称
creditNo	string	统一社会信用代码
status	string	明细状态
statusDesc	string	明细状态描述
orderNo	string	订单号（报告类）
fileUrl	string	单文件下载地址（成功且有文件时返回）
fileSuffix	string	文件后缀（pdf/xlsx）
hasData	int	是否有文件产出：0 无数据 / 1 有文件
msg	string	失败原因 / 无数据提示

任务状态枚举

状态	含义	描述
1	处理中	中间状态，任务正在处理
2	部分成功	完成状态，部分企业成功部分失败
3	全成功	完成状态，所有企业均成功
-1	失败	完成状态，全部企业失败

明细状态枚举

状态	含义	描述
0	待处理	中间状态，尚未开始处理
1	处理中	中间状态，正在生成数据
3	成功	完成状态，fileUrl 有值
-1	失败	完成状态，msg 有失败原因

安全说明

• 所有请求必须携带有效的 access_token 参数。
• access_token 应通过登录接口获取，且具有时效性和权限限制。
• 未授权访问将返回错误码并拒绝请求。
• 单次下单最多 500 条企业，超出将被拒绝。
• 额度不足时下单将被拒绝，不产生任务。
• 查询接口通过任务归属校验，用户只能查询自己创建的任务。