接口文档 - 星云税融API

接口文档

文档 / 数电开票 / 发票查询

数电开票 - 发票查询

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

发票查询

已开发票列表查询

已开发票列表查询。分页查询企业已开具的发票列表。action=ykfp_lb_cx

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/issue/list

请求参数

参数名	类型	必填	说明
nsrsbh	String	是	纳税人识别号
aggOrgId	String	是	企业ID
data.kpksrq	String	否	开票开始日期，yyyy-MM-dd
data.kpjsrq	String	否	开票结束日期
data.pageIndex	Integer	否	页码
data.pageSize	Integer	否	每页条数

请求示例

JSON

{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "kpksrq": "2026-03-01",
        "kpjsrq": "2026-03-31",
        "pageIndex": 1,
        "pageSize": 20
    }
}

响应参数

参数名	类型	说明
code	String	2000=成功
data.total	Integer	总记录数
data.list	Array	发票列表
data.list[].fphm	String	发票号码
data.list[].kprq	String	开票日期
data.list[].jshj	Number	价税合计
data.list[].fpzt	String	发票状态

响应示例

JSON

{
    "reqId": "issue012",
    "code": "2000",
    "success": true,
    "data": {
        "total": 15,
        "list": [
            {
                "fphm": "23312000000043000001",
                "kprq": "2026-03-15",
                "jshj": 67.39,
                "fpzt": "正常"
            }
        ]
    }
}

已开发票明细查询

已开发票明细查询。查询单张发票的完整明细(含商品行)。

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/issue/detail

请求参数

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

请求示例

JSON

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

响应参数

参数名	类型	说明
code	String	2000=成功
data.fphm	String	发票号码
data.kprq	String	开票日期
data.jshj	Number	价税合计
data.xmmx	Array	商品明细行

响应示例

JSON

{
    "reqId": "issue013",
    "code": "2000",
    "success": true,
    "data": {
        "fphm": "23312000000043000001",
        "kprq": "2026-03-15",
        "jshj": 67.39,
        "fpzt": "正常",
        "xmmx": [
            {
                "spmc": "桌面风扇",
                "je": 59.64,
                "se": 7.75,
                "sl": "0.13"
            }
        ]
    }
}

已开发票统计查询

已开发票汇总统计。按月/按类型统计开票金额、税额等汇总数据。

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/issue/stats

请求参数

参数名	类型	必填	说明
nsrsbh	String	是	纳税人识别号
aggOrgId	String	是	企业ID
data.kpksrq	String	否	统计开始日期
data.kpjsrq	String	否	统计结束日期

请求示例

JSON

{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "kpksrq": "2026-03-01",
        "kpjsrq": "2026-03-31"
    }
}

响应参数

参数名	类型	说明
code	String	2000=成功
data.totalJe	Number	合计金额
data.totalSe	Number	合计税额
data.totalJshj	Number	合计价税合计
data.fpCount	Integer	发票张数

响应示例

JSON

{
    "reqId": "issue014",
    "code": "2000",
    "success": true,
    "data": {
        "totalJe": 150000,
        "totalSe": 19500,
        "totalJshj": 169500,
        "fpCount": 15
    }
}

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