星云税融API

API 文档
Base URL: https://shuiwu.xingyunv2.cn
接口文档

发票认证 - 统计确认

进项认证、勾选、统计确认

统计确认

申请统计

申请统计确认。勾选完成后提交统计申请,统计当前所属期的全部勾选数据。

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

请求参数

参数名 类型 必填 说明
nsrsbh String 纳税人识别号
aggOrgId String 企业ID

请求示例

JSON
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440"
}

响应参数

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

响应示例

JSON
{
    "reqId": "auth010",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933253"
    }
}

统计确认

确认统计结果。统计申请成功后需要确认,确认后当期勾选数据不可再修改。

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

请求参数

参数名 类型 必填 说明
nsrsbh String 纳税人识别号
aggOrgId String 企业ID

请求示例

JSON
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440"
}

响应参数

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

响应示例

JSON
{
    "reqId": "auth011",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933254"
    }
}

撤销统计确认

撤销统计确认。在申报前可撤销已确认的统计,撤销后可重新勾选。

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

请求参数

参数名 类型 必填 说明
nsrsbh String 纳税人识别号
aggOrgId String 企业ID

请求示例

JSON
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440"
}

响应参数

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

响应示例

JSON
{
    "reqId": "auth012",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933255"
    }
}

统计确认/撤销结果查询

统计确认/撤销统计结果查询。查询统计确认或撤销操作的执行状态。

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

请求参数

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

请求示例

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

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态
data.tjje Number 统计金额
data.tjse Number 统计税额

响应示例

JSON
{
    "reqId": "auth033",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933254",
        "status": 3,
        "tjje": 500000,
        "tjse": 65000
    }
}

最新统计确认信息查询

获取企业电子发票服务平台最新统计确认结果

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

请求参数

参数名 类型 必填 说明
nsrsbh String 纳税人识别号

请求示例

JSON
{
    "nsrsbh": "91****************90"
}

响应参数

参数名 类型 说明
code String 错误码,2000=成功
success Boolean 是否成功
message String 错误信息
reqId String 请求ID
data.nsrsbh String 纳税人识别号
data.skssq String 税款所属期,格式:yyyyMM
data.jgzt String 统计确认结果状态:0=未统计,1=已统计未确认,2=已确认,3=已撤销未统计,4=已统计未确认(密码错误)
data.ywlx String 申请标识:1=申请统计,2=撤销统计,3=申请确认,7=退税确认
data.cljg String 申请处理结果:1=成功,2=已申请统计,3=已统计完成等
data.zt String 任务状态:1=进行中,2=失败,3=成功
data.code String 任务失败错误码
data.message String 任务失败错误信息
data.tjsj String 统计时间,格式:yyyyMMddHHmmss
data.time String 任务发起时间
data.id String 申请ID
data.jglx String 机构类型:01=总机构,02=分机构,03=机构本身
data.tjxx Array 统计信息列表
data.jxdkhz Array 增值税申报进项抵扣汇总
data.fpxx Array 发票信息列表
data.cyfpxx Array 差异发票信息列表,结构同fpxx
data.ncptjxx Array 农产品加计扣除勾选统计结果
data.ncpfpxx Array 历史已加计扣除农产品发票信息
data.tszt String 退税任务状态:1=进行中,2=失败,3=成功
data.tsqrjgzt String 退税确认结果状态:2=成功,5=无需确认
data.tstjxx Array 出口退税勾选统计结果
data.tsfpxx Array 退税发票信息

响应示例

JSON
{
    "reqId": "ce20f30221294095a9c495a0bb1731db",
    "code": "2000",
    "success": true,
    "message": null,
    "data": {
        "cljg": null,
        "cyfpxx": [],
        "fpxx": [],
        "id": null,
        "jglx": null,
        "jgzt": "0",
        "nsrsbh": "91**************2G",
        "skssq": "202211",
        "time": null,
        "tjsj": null,
        "tjxx": [],
        "ywlx": null,
        "zt": null
    }
}

最新统计信息采集

发起最新统计确认信息采集任务

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

请求参数

参数名 类型 必填 说明
nsrsbh String 纳税人识别号
accountId String 登录账户唯一标识,多账号时必传
sync Boolean 是否同步获取结果,默认false

请求示例

JSON
{
    "nsrsbh": "52**************XJ"
}

响应参数

参数名 类型 说明
code String 错误码,2000=成功
success Boolean 是否成功
message String 错误信息
reqId String 请求ID
data String|Object 异步模式返回任务ID;同步模式返回统计确认结果对象
data.nsrsbh String 纳税人识别号(同步模式)
data.skssq String 税款所属期(同步模式)
data.jgzt String 统计确认结果状态:0=未统计,1=已统计未确认,2=已确认,3=已撤销未统计,4=已统计未确认(密码错误)
data.tjsj String 统计时间
data.jglx String 机构类型:01=总机构,02=分机构,03=机构本身
data.zt String 任务状态:1=进行中,2=失败,3=成功
data.code String 任务失败错误码(zt=2时返回)
data.message String 任务失败错误信息(zt=2时返回)
data.tjxx Array 统计信息列表
data.jxdkhz Array 增值税申报进项抵扣汇总
data.ncptjxx Array 农产品加计扣除勾选统计结果
data.fpxx Array 发票信息列表
data.cyfpxx Array 差异发票信息列表,结构同fpxx
data.tszt String 退税任务状态
data.tsqrjgzt String 退税确认结果状态
data.tstjxx Array 出口退税勾选统计结果
data.tsfpxx Array 退税发票信息
data.action String 同步超时转异步时返回操作类型:sqTjqrxxCj
data.taskId String 同步超时转异步时返回的任务ID

响应示例

JSON
{
    "reqId": "1accd95fefc343319163afcc2bb5879c",
    "code": "2000",
    "success": true,
    "message": null,
    "data": 475132666845504
}

最新统计信息采集结果

最新统计信息采集结果查询。

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

请求参数

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

请求示例

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

响应参数

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

响应示例

JSON
{
    "reqId": "auth038",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933265",
        "status": 3
    }
}

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

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