星云税融API

API 文档
Base URL: https://shuiwu.xingyunv2.cn
接口文档
文档 / 工商年报申报

工商年报申报

工商年报数据报送

发起工商年报数据采集

发起工商年报数据采集任务

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/biz/annual/collect

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.year Integer 是 报告年度

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "year": 2025
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "BIZ20260301001"
    }
}

查询工商年报采集结果

查询工商年报采集任务结果

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/biz/annual/collect/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "BIZ20260301001"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 0=初始化/1=执行中/2=失败/3=成功

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "BIZ20260301001",
        "status": 3
    }
}

获取工商年报采集数据

获取工商年报采集数据

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/biz/annual/data

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "BIZ20260301001"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data Object 工商年报数据

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "companyInfo": [],
        "financialInfo": []
    }
}

工商年报数据报送

工商年报数据报送提交

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/biz/annual/submit

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.year Integer 是 报告年度
data.reportData Object 是 年报数据

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "year": 2025,
        "reportData": []
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "BIZ20260301002"
    }
}

查询工商年报报送结果

查询工商年报报送结果

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/biz/annual/submit/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "BIZ20260301002"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "BIZ20260301002",
        "status": 3
    }
}

工商年报任务回调

工商年报任务回调接口

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/biz/annual/callback

请求参数

参数名 类型 必填 说明
taskId String 是 任务ID
status Integer 是 任务状态

请求示例

JSON 
{
    "taskId": "BIZ20260301002",
    "status": 3
}

响应参数

参数名 类型 说明
code String 返回2000表示已接收

响应示例

JSON 
{
    "code": "2000",
    "msg": "成功"
}

© 2026 星云税融API. All rights reserved.

如需接入支持，请联系技术团队 | 注册账号