接口文档 - 星云税融API

接口文档

文档 / 数电开票 / 额度管理

数电开票 - 额度管理

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

额度管理

发票额度调整申请

申请调整发票额度。当可用额度不足时，可向税局申请临时或永久调增。

登录查看报价

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

请求参数

参数名	类型	必填	说明
nsrsbh	String	是	纳税人识别号
aggOrgId	String	是	企业ID
data.sqed	String	是	申请额度
data.sqyy	String	是	申请原因

请求示例

JSON

{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "sqed": "500000",
        "sqyy": "业务量增长"
    }
}

响应参数

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

响应示例

JSON

{
    "reqId": "issue017",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "931928300933248"
    }
}

发票额度调整查询

查询发票额度调整申请状态。

登录查看报价

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

请求参数

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

请求示例

JSON

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

响应参数

参数名	类型	说明
code	String	2000=成功
data.status	String	审批状态
data.sqed	String	申请额度

响应示例

JSON

{
    "reqId": "qq01",
    "code": "2000",
    "success": true,
    "data": {
        "status": "已批准",
        "sqed": "500000"
    }
}

申请额度列表

查询申请额度列表。获取历史额度调整申请记录。

登录查看报价

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

请求参数

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

请求示例

JSON

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

响应参数

参数名	类型	说明
code	String	2000=成功
data.total	Integer	总记录数
data.list	Array	申请记录列表

响应示例

JSON

{
    "reqId": "ql01",
    "code": "2000",
    "success": true,
    "data": {
        "total": 2,
        "list": [
            {
                "sqed": "500000",
                "status": "已批准",
                "sqrq": "2026-03-01"
            }
        ]
    }
}

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