星云税融API

API 文档
Base URL: https://shuiwu.xingyunv2.cn
接口文档
文档 / 数电开票 / 红字发票

数电开票 - 红字发票

蓝字/红字发票开具、额度查询等

红字发票

申请红字信息表

申请红字信息表。开具红字发票前必须先申请红字信息表。action=hzxxb_sq

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

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.lzfphm String 是 对应蓝字发票号码
data.lzfpkprq String 是 蓝字发票开票日期
data.chyydm String 是 冲红原因代码：01=开票有误/02=销货退回/03=服务终止/04=销售折让
data.xmmx Array 是 红冲明细

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "lzfphm": "23312000000043000001",
        "lzfpkprq": "2026-01-15",
        "chyydm": "01",
        "xmmx": [
            {
                "spmc": "桌面风扇",
                "je": "-59.64",
                "se": "-7.75"
            }
        ]
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.hzxxbbh String 红字信息表编号
data.status String 状态

响应示例

JSON 
{
    "reqId": "issue006",
    "code": "2000",
    "success": true,
    "data": {
        "hzxxbbh": "HZXXB2026030001",
        "status": "待确认"
    }
}

红字发票开具

开具红字发票。红字信息表确认后调用此接口正式开具红字发票。action=hzfp_kj

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

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.hzxxbbh String 是 红字信息表编号
data.lzfphm String 是 蓝字发票号码

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "hzxxbbh": "HZXXB2026030001",
        "lzfphm": "23312000000043000001"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.kplsh String 开票流水号
data.fphm String 红字发票号码
data.kprq String 开票日期

响应示例

JSON 
{
    "reqId": "issue007",
    "code": "2000",
    "success": true,
    "data": {
        "kplsh": "202403010449175685068220",
        "fphm": "23312000000043000020",
        "kprq": "2026-03-20"
    }
}

确认红字信息表

确认红字信息表。购方收到红字信息表后进行确认。action=hzxxb_qr

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

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.hzxxbbh String 是 红字信息表编号
data.qrlx String 是 确认类型：1=同意/2=拒绝

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "hzxxbbh": "HZXXB2026030001",
        "qrlx": "1"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.result Boolean 确认结果

响应示例

JSON 
{
    "reqId": "issue008",
    "code": "2000",
    "success": true,
    "data": {
        "result": true
    }
}

撤销红字信息表

撤销红字信息表。在对方确认前可撤销。action=hzxxb_cx

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

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.hzxxbbh String 是 红字信息表编号

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "hzxxbbh": "HZXXB2026030001"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.result Boolean 撤销结果

响应示例

JSON 
{
    "reqId": "issue009",
    "code": "2000",
    "success": true,
    "data": {
        "result": true
    }
}

查询红字信息列表

查询红字信息列表。分页查询已申请的红字信息表。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/issue/red/list

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.pageIndex Integer 否 页码
data.pageSize Integer 否 每页条数

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "pageIndex": 1,
        "pageSize": 20
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.total Integer 总记录数
data.list Array 红字信息表列表
data.list[].hzxxbbh String 编号
data.list[].lzfphm String 蓝字发票号码
data.list[].status String 状态

响应示例

JSON 
{
    "reqId": "issue010",
    "code": "2000",
    "success": true,
    "data": {
        "total": 3,
        "list": [
            {
                "hzxxbbh": "HZXXB2026030001",
                "lzfphm": "23312000000043000001",
                "status": "已确认"
            }
        ]
    }
}

查询红字信息明细

查询红字信息明细。获取单条红字信息表的完整详情。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/issue/red/detail

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.hzxxbbh String 是 红字信息表编号

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "hzxxbbh": "HZXXB2026030001"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.hzxxbbh String 编号
data.lzfphm String 蓝字发票号码
data.chyydm String 冲红原因代码
data.xmmx Array 明细

响应示例

JSON 
{
    "reqId": "issue011",
    "code": "2000",
    "success": true,
    "data": {
        "hzxxbbh": "HZXXB2026030001",
        "lzfphm": "23312000000043000001",
        "chyydm": "01",
        "status": "已确认",
        "xmmx": [
            {
                "spmc": "桌面风扇",
                "je": -59.64,
                "se": -7.75
            }
        ]
    }
}

红字发票概况统计

红字发票概况统计。按时间范围统计红字发票开具概况。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/issue/red/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.totalCount Integer 红字发票总张数
data.totalJe Number 红字金额合计

响应示例

JSON 
{
    "reqId": "rs01",
    "code": "2000",
    "success": true,
    "data": {
        "totalCount": 2,
        "totalJe": -1200
    }
}

购销蓝票可红冲信息

购销蓝票可红冲信息。查询可进行红冲的蓝字发票信息。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/issue/red/blue-info

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.fphm String 是 蓝字发票号码

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "fphm": "23312000000043000001"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.sfkHc Boolean 是否可红冲
data.fphm String 发票号码
data.jshj Number 价税合计

响应示例

JSON 
{
    "reqId": "rb01",
    "code": "2000",
    "success": true,
    "data": {
        "sfkHc": true,
        "fphm": "23312000000043000001",
        "jshj": 67.39
    }
}

红字确认单下载

红字确认单下载。下载已确认的红字信息表PDF文件。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/issue/red/download

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.hzxxbbh String 是 红字信息表编号

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "hzxxbbh": "HZXXB2026030001"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.fileUrl String 文件下载URL

响应示例

JSON 
{
    "reqId": "rd01",
    "code": "2000",
    "success": true,
    "data": {
        "fileUrl": "https:\/\/oss.example.com\/hzqrd\/xxx.pdf"
    }
}

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

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