发起企业数据采集

POST

/app-api/v2/collect/beginFinTask

该接口用于发起企业数据采集（需区分自持和托管）：

自持账号模式下：自行异步登录后再调用该接口；

托管模式下：传入账号必要信息直接调用。

跨区域、特定主体登录、本主体采集必须分开采集（一次只能提交一个主体类型任务进来）

跨区域和特定主体登录采集的业务，只会返回：
1)基础信息节点中的基础信息-taxCompanyEnterpriseInfoDtoPageResult节点
2)申报表节点：只采集房产税、土地的申报表结构化数据
3)税源获取节点：只采集土地-税源获取=syhqTd、房产-税源获取=syhqFc；

错误代码	错误信息	解决方案
2000	成功
4xxx	获取失败

请求参数

Header 参数

Body 参数application/json

示例

{
    "nsrsbh": "91************0",
    "areaCode": "二位或四位地区编码",
    "cjyfq": "202401",
    "cjyfz": "202403"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/app-api/v2/collect/beginFinTask' \
--header 'access-key;' \
--header 'secret-key;' \
--header 'Content-Type: application/json' \
--data '{
    "nsrsbh": "91************0",
    "areaCode": "二位或四位地区编码",
    "cjyfq": "202401",
    "cjyfz": "202403"
}'

返回响应

🟢200

application/json

成功

Bodyapplication/json

示例

{
    "code": "5000",
    "success": false,
    "message": "异常信息",
    "reqId": "d56999744734437eb10f3369d52efc15"
}

修改于 2026-09-16 07:18:30

申报缴款个人明细查询反馈

获取采集状态信息