星云税融API

API 文档
Base URL: https://shuiwu.xingyunv2.cn
接口文档
文档 / 发票汇总

发票汇总

全量发票汇总信息

发起发票汇总任务

发起发票汇总信息采集任务。异步获取指定期间的进销项发票汇总数据。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/summary/start

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.kssj String 是 开始时间，yyyy-MM-dd
data.jssj String 是 结束时间
data.hzlx String 否 汇总类型：jx=进项/xx=销项/all=全部

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "kssj": "2026-01-01",
        "jssj": "2026-03-31",
        "hzlx": "all"
    }
}

响应参数

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

响应示例

JSON 
{
    "reqId": "sm01",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "531000000000001"
    }
}

查询发票汇总任务结果

查询发票汇总任务结果。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/summary/result

请求参数

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

请求示例

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

响应参数

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

响应示例

JSON 
{
    "reqId": "sm02",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "531000000000001",
        "status": 3
    }
}

获取发票汇总数据

获取已汇总的发票数据。任务成功后获取汇总结果。

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

请求参数

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

请求示例

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

响应参数

参数名 类型 说明
code String 2000=成功
data.jxHz Object 进项汇总
data.xxHz Object 销项汇总
data.jxHz.totalJe Number 进项总金额
data.jxHz.totalSe Number 进项总税额
data.xxHz.totalJe Number 销项总金额
data.xxHz.totalSe Number 销项总税额

响应示例

JSON 
{
    "reqId": "sm03",
    "code": "2000",
    "success": true,
    "data": {
        "jxHz": {
            "totalJe": 800000,
            "totalSe": 104000,
            "fpCount": 86
        },
        "xxHz": {
            "totalJe": 1200000,
            "totalSe": 156000,
            "fpCount": 120
        }
    }
}

同步获取发票汇总

同步获取发票汇总信息。直接返回结果，无需异步。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/summary/sync

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.kssj String 是 开始时间
data.jssj String 是 结束时间

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "kssj": "2026-03-01",
        "jssj": "2026-03-31"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.jxHz Object 进项汇总
data.xxHz Object 销项汇总

响应示例

JSON 
{
    "reqId": "sm04",
    "code": "2000",
    "success": true,
    "data": {
        "jxHz": {
            "totalJe": 200000,
            "totalSe": 26000
        },
        "xxHz": {
            "totalJe": 300000,
            "totalSe": 39000
        }
    }
}

发票汇总异步回调

发票汇总异步任务执行结果回调。

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

请求参数

参数名 类型 必填 说明
taskId String 是 任务ID
status Integer 是 0=初始化/1=执行中/2=失败/3=成功

请求示例

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

响应参数

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

响应示例

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

进销项发票统计信息

获取进销项发票统计信息。异步任务。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/summary/stats

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.kssj String 是 开始时间
data.jssj String 是 结束时间

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "kssj": "2026-01-01",
        "jssj": "2026-03-31"
    }
}

响应参数

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

响应示例

JSON 
{
    "reqId": "sm05",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "531000000000002"
    }
}

查询进销项发票统计结果

查询进销项发票统计结果。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/summary/stats/result

请求参数

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

请求示例

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

响应参数

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

响应示例

JSON 
{
    "reqId": "sm06",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "531000000000002",
        "status": 3,
        "stats": {
            "jxJe": 800000,
            "xxJe": 1200000
        }
    }
}

同步获取进销项统计

同步获取进销项发票统计。直接返回结果。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/summary/stats/sync

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.kssj String 是 开始时间
data.jssj String 是 结束时间

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "kssj": "2026-03-01",
        "jssj": "2026-03-31"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.stats Object 统计数据

响应示例

JSON 
{
    "reqId": "sm07",
    "code": "2000",
    "success": true,
    "data": {
        "stats": {
            "jxJe": 200000,
            "jxSe": 26000,
            "xxJe": 300000,
            "xxSe": 39000
        }
    }
}

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

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