星云税融API

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

数电开票

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

开票准备
10 个接口
蓝字发票开具
4 个接口
红字发票
9 个接口
发票查询
3 个接口
版式文件与交付
3 个接口
额度管理
3 个接口
成品油专区
5 个接口
其他业务
7 个接口

购销蓝字发票列表查询

购销蓝字发票列表查询。分页查询可开红字发票对应的蓝字发票列表。

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

请求参数

参数名 类型 必填 说明
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 蓝字发票列表

响应示例

JSON 
{
    "reqId": "bl01",
    "code": "2000",
    "success": true,
    "data": {
        "total": 15,
        "list": [
            {
                "fphm": "23312000000043000001",
                "kprq": "2026-01-15",
                "jshj": 67.39
            }
        ]
    }
}

品名查询税收分类信息

品名查询税收分类信息。通过商品名称模糊查询对应税收分类编码。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/issue/tax-code/by-name

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.spmc String 是 商品名称关键词

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "spmc": "风扇"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.list Array 匹配的税收分类编码列表

响应示例

JSON 
{
    "reqId": "tn01",
    "code": "2000",
    "success": true,
    "data": {
        "list": [
            {
                "spbm": "1090416010000000000",
                "spmc": "家用通风电器具",
                "sl": "0.13"
            }
        ]
    }
}

税编查询税收分类信息

税编查询税收分类信息。通过税收分类编码精确查询。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/issue/tax-code/by-code

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.spbm String 是 税收分类编码

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "spbm": "1090416010000000000"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.spbm String 编码
data.spmc String 名称
data.sl String 税率

响应示例

JSON 
{
    "reqId": "tc01",
    "code": "2000",
    "success": true,
    "data": {
        "spbm": "1090416010000000000",
        "spmc": "家用通风电器具",
        "sl": "0.13"
    }
}

查询税收分类编码信息

查询税收分类编码信息(通用)。支持关键词和编码混合查询。

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

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.keyword String 否 关键词
data.spbm String 否 编码

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "keyword": "电器"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.list Array 编码列表

响应示例

JSON 
{
    "reqId": "ti01",
    "code": "2000",
    "success": true,
    "data": {
        "list": [
            {
                "spbm": "1090416010000000000",
                "spmc": "家用通风电器具",
                "sl": "0.13"
            }
        ]
    }
}

查询商品分类

在电子税务局查询商品分类树形结构，以便进行商品的新增及编辑

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

请求参数

参数名 类型 必填 说明
action String 否 操作类型，固定传spxx_flcx
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 是否异步方式，默认false
data Object 是 业务参数，传空对象{}

请求示例

JSON 
{
    "action": "spxx_flcx",
    "nsrsbh": "91****************4Y",
    "data": [],
    "aggOrgId": "string",
    "async": "false"
}

响应参数

参数名 类型 说明
code String 2000=成功
success Boolean 是否成功
message String 错误信息
reqId String 请求ID
data.list Array 分类树形列表
data.list[].fluuid String 分类UUID
data.list[].flmc String 分类名称
data.list[].fjddm String 父节点代码
data.list[].jdqmc String 节点全名称
data.list[].tjdpxxh Integer 排序序号
data.list[].children Array 子分类列表（递归）

响应示例

JSON 
{
    "code": "2000",
    "data": {
        "list": [
            {
                "fjddm": "00",
                "fluuid": "string",
                "jdqmc": "默认",
                "tjdpxxh": 1,
                "flmc": "默认",
                "children": []
            }
        ]
    },
    "success": true,
    "reqId": "string"
}

新增商品分类

在电子税务局新增商品分类

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

请求参数

参数名 类型 必填 说明
action String 否 操作类型，固定传spxx_fladd
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 是否异步方式，默认false
data.flmc String 是 分类名称
data.fjddm String 否 父级ID，不传则使用默认根级代码00

请求示例

JSON 
{
    "action": "spxx_fladd",
    "nsrsbh": "string",
    "data": {
        "flmc": "string",
        "fjddm": "00"
    },
    "aggOrgId": "string",
    "async": "false"
}

响应参数

参数名 类型 说明
code String 2000=成功
success Boolean 是否成功
message String 错误信息
reqId String 请求ID
data.result Boolean 执行结果：true=成功，false=失败

响应示例

JSON 
{
    "data": {
        "result": true
    },
    "reqId": "string",
    "code": "2000",
    "success": true,
    "message": null
}

删除商品分类

在电子税务局删除指定的商品分类信息

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

请求参数

参数名 类型 必填 说明
action String 否 操作类型，固定传spxx_fldel
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 是否异步方式，默认false
data.fluuid String 是 商品分类UUID

请求示例

JSON 
{
    "action": "spxx_fldel",
    "nsrsbh": "string",
    "data": {
        "fluuid": "string"
    },
    "aggOrgId": "string",
    "async": "false"
}

响应参数

参数名 类型 说明
code String 2000=成功
success Boolean 是否成功
message String 错误信息
reqId String 请求ID
data.result Boolean 执行结果：true=成功，false=失败

响应示例

JSON 
{
    "data": {
        "result": true
    },
    "reqId": "string",
    "code": "2000",
    "success": true,
    "message": null
}

修改商品分类

在电子税务局重命名指定的商品分类信息

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

请求参数

参数名 类型 必填 说明
action String 否 操作类型，固定传spxx_flrename
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 是否异步方式，默认false
data.fluuid String 是 商品分类UUID
data.flmc String 是 新的商品分类名称

请求示例

JSON 
{
    "action": "spxx_flrename",
    "nsrsbh": "91****************4Y",
    "data": {
        "fluuid": "0b2a48aa88884fd59255891eb86f4fef",
        "flmc": "测试测试测试"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
success Boolean 是否成功
message String 错误信息
reqId String 请求ID
data.result Boolean 执行结果：true=成功，false=失败

响应示例

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

查询商品

从电子税务局查询已存在的商品信息列表，支持按名称、简码、规格、税率、编码、分类分页筛选

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

请求参数

参数名 类型 必填 说明
action String 否 操作类型，固定传spxx_cx
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 是否异步方式，默认false
data.pageIndex Integer 是 当前页码
data.pageSize Integer 是 每页行数：10/20/50/100
data.params Object 是 查询参数
data.params.xmmc String 否 项目名称/商品名称
data.params.jm String 否 简码
data.params.ggxh String 否 规格型号
data.params.slv String 否 税率
data.params.dj String 否 单价
data.params.spfwbm String 否 商品服务编码
data.params.spfwjc String 否 商品服务简称
data.params.dwdm String 否 单位代码
data.params.dwmc String 否 单位名称
data.params.fluuid String 否 分类UUID

请求示例

JSON 
{
    "action": "spxx_cx",
    "nsrsbh": "string",
    "data": {
        "pageIndex": 1,
        "pageSize": 10,
        "params": {
            "xmmc": "",
            "fluuid": ""
        }
    },
    "aggOrgId": "string",
    "async": "false"
}

响应参数

参数名 类型 说明
code String 2000=成功
success Boolean 是否成功
message String 错误信息
reqId String 请求ID
data.records Integer 总记录数
data.list Array 商品列表
data.list[].uuid String 商品UUID
data.list[].fluuid String 所属分类UUID
data.list[].xmmc String 项目名称
data.list[].ggxh String 规格型号
data.list[].dwdm String 单位代码
data.list[].dwmc String 单位名称
data.list[].spfwbm String 商品服务编码
data.list[].spfwjc String 商品服务简称
data.list[].jm String 简码
data.list[].dj String 单价
data.list[].hsbz String 含税标志
data.list[].slv String 税率
data.list[].yhzsbz String 优惠政策标志：01等
data.list[].zzstsgl String 增值税特殊管理

响应示例

JSON 
{
    "data": {
        "records": 1,
        "list": [
            {
                "uuid": "string",
                "fluuid": "string",
                "xmmc": "string",
                "ggxh": "string",
                "dwdm": "string",
                "dwmc": "string",
                "spfwbm": "string",
                "spfwjc": "string",
                "jm": "string",
                "dj": "string",
                "hsbz": "string",
                "slv": "string",
                "yhzsbz": "01",
                "zzstsgl": "string"
            }
        ]
    },
    "reqId": "string",
    "code": "2000",
    "success": true,
    "message": null
}

新增商品

在电子税务局新增商品信息

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

请求参数

参数名 类型 必填 说明
action String 否 操作类型，固定传spxx_add
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 是否异步方式，默认false
data.xmmc String 是 项目名称
data.fluuid String 是 商品分类UUID
data.spfwbm String 是 税收服务编码
data.spfwjc String 是 税收服务简称
data.slv String 是 税率
data.ggxh String 否 规格型号
data.dwdm String 否 计量单位代码
data.dwmc String 否 计量单位名称
data.hsbz String 否 含税标记：Y=含税，N=不含税
data.jm String 否 简码
data.dj String 否 单价
data.yhzsbz String 否 是否享受优惠政策：Y/N
data.zzstsgl String 否 增值税简易计税类型：03=免税，08=按3%简易征收
data.sm String 否 商品说明（建议传入税收编码中的sm字段）

请求示例

JSON 
{
    "action": "spxx_add",
    "nsrsbh": "string",
    "data": {
        "xmmc": "string",
        "fluuid": "string",
        "spfwbm": "string",
        "spfwjc": "string",
        "slv": "string",
        "ggxh": "string",
        "dwdm": "string",
        "dwmc": "string",
        "hsbz": "Y",
        "jm": "string",
        "dj": "string",
        "yhzsbz": "N",
        "zzstsgl": "",
        "sm": "string"
    },
    "aggOrgId": "string",
    "async": "false"
}

响应参数

参数名 类型 说明
code String 2000=成功
success Boolean 是否成功
message String 错误信息
reqId String 请求ID
data.result Boolean 执行结果：true=成功，false=失败

响应示例

JSON 
{
    "data": {
        "result": true
    },
    "reqId": "string",
    "code": "2000",
    "success": true,
    "message": null
}

编辑商品

在电子税务局修改指定UUID的商品信息

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

请求参数

参数名 类型 必填 说明
action String 否 操作类型，固定传spxx_update
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 是否异步方式，默认false
data.uuid String 是 商品UUID
data.xmmc String 是 项目名称
data.spfwbm String 是 税收服务编码
data.spfwjc String 是 税收服务简称
data.slv String 是 税率
data.fluuid String 否 商品分类UUID
data.ggxh String 否 规格型号
data.dwdm String 否 计量单位代码
data.dwmc String 否 计量单位名称
data.hsbz String 否 含税标记：Y=含税，N=不含税
data.jm String 否 简码
data.dj String 否 单价
data.yhzsbz String 否 优惠政策标志：01=正常，02=已作废，03=已全额红冲，04=部分红冲
data.zzstsgl String 否 增值税简易计税类型：03=免税，08=按3%简易征收
data.sm String 否 商品说明（建议传入税收编码中的sm字段）

请求示例

JSON 
{
    "action": "spxx_update",
    "nsrsbh": "string",
    "data": {
        "uuid": "string",
        "xmmc": "string",
        "fluuid": "string",
        "spfwbm": "string",
        "spfwjc": "string",
        "slv": "string",
        "ggxh": "string",
        "hsbz": "Y",
        "yhzsbz": "01",
        "zzstsgl": "",
        "sm": "string"
    },
    "aggOrgId": "string",
    "async": "false"
}

响应参数

参数名 类型 说明
code String 2000=成功
success Boolean 是否成功
message String 错误信息
reqId String 请求ID
data.result Boolean 执行结果：true=成功，false=失败

响应示例

JSON 
{
    "data": {
        "result": true
    },
    "reqId": "string",
    "code": "2000",
    "success": true,
    "message": null
}

删除商品

在电子税务局删除一个或多个商品信息

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

请求参数

参数名 类型 必填 说明
action String 否 操作类型，固定传spxx_del
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 是否异步方式，默认false
data.uuids Array[String] 是 商品UUID列表，一次可删除一个或多个

请求示例

JSON 
{
    "action": "spxx_del",
    "nsrsbh": "string",
    "data": {
        "uuids": [
            "string"
        ]
    },
    "aggOrgId": "string",
    "async": "false"
}

响应参数

参数名 类型 说明
code String 2000=成功
success Boolean 是否成功
message String 错误信息
reqId String 请求ID
data.result Boolean 执行结果：true=成功，false=失败

响应示例

JSON 
{
    "data": {
        "result": true
    },
    "reqId": "string",
    "code": "2000",
    "success": true,
    "message": null
}

客户分类查询

在电子税务局查询客户分类树形结构，以便进行客户的新增及编辑

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

请求参数

参数名 类型 必填 说明
action String 否 操作类型，固定传khxx_flcx
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 是否异步方式，默认false
data Object 是 业务参数，传空对象{}

请求示例

JSON 
{
    "action": "khxx_flcx",
    "nsrsbh": "************PDDL2G",
    "data": []
}

响应参数

参数名 类型 说明
code String 2000=成功
success Boolean 是否成功
message String 错误信息
reqId String 请求ID
data.list Array 分类树形列表
data.list[].fluuid String 分类UUID
data.list[].flmc String 分类名称
data.list[].fjddm String 父节点代码（0=根节点）
data.list[].jdqmc String 节点全名称（含路径）
data.list[].tjdpxxh Integer 同级排序序号
data.list[].children Array 子分类列表（递归结构）

响应示例

JSON 
{
    "code": "2000",
    "data": {
        "list": [
            {
                "fjddm": "0",
                "fluuid": "string",
                "jdqmc": "张三",
                "tjdpxxh": 1,
                "flmc": "张三"
            }
        ]
    },
    "success": true,
    "reqId": "9006e9c0ee1843abb8401cb88e16d7fc"
}

新增客户分类

在电子税务局新增客户分类

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

请求参数

参数名 类型 必填 说明
action String 否 操作类型，固定传khxx_fladd
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 是否异步方式，默认false
data.flmc String 是 分类名称
data.fjddm String 否 父级ID，不传则使用默认根级代码0

请求示例

JSON 
{
    "action": "khxx_fladd",
    "nsrsbh": "string",
    "data": {
        "fjddm": "string",
        "flmc": "string"
    },
    "aggOrgId": "string",
    "async": "false"
}

响应参数

参数名 类型 说明
code String 2000=成功
success Boolean 是否成功
message String 错误信息
reqId String 请求ID
data.result Boolean 执行结果：true=成功，false=失败
data.Fluuid String 新增分类的UUID

响应示例

JSON 
{
    "data": {
        "result": true,
        "Fluuid": "string"
    },
    "reqId": "string",
    "code": "2000",
    "success": true,
    "message": null
}

修改客户分类

在电子税务局重命名指定的客户分类信息（此接口税局端不稳定，暂不对外开放）

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

请求参数

参数名 类型 必填 说明
action String 否 操作类型，固定传khxx_flrename
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 是否异步方式，默认false
data.fluuid String 是 分类UUID
data.flmc String 是 新的分类名称

请求示例

JSON 
{
    "action": "khxx_flrename",
    "nsrsbh": "91****************4Y",
    "data": {
        "fluuid": "0b2a48aa88884fd59255891eb86f4fef",
        "flmc": "测试测试测试"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
success Boolean 是否成功
message String 错误信息
reqId String 请求ID
data.result Boolean 执行结果：true=成功，false=失败

响应示例

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

删除客户分类

在电子税务局删除指定的客户分类信息

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

请求参数

参数名 类型 必填 说明
action String 否 操作类型，固定传khxx_fldel
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 是否异步方式，默认false
data.fluuid String 是 客户分类UUID

请求示例

JSON 
{
    "action": "khxx_fldel",
    "nsrsbh": "string",
    "data": {
        "fluuid": "string"
    },
    "aggOrgId": "string",
    "async": "false"
}

响应参数

参数名 类型 说明
code String 2000=成功
success Boolean 是否成功
message String 错误信息
reqId String 请求ID
data.result Boolean 执行结果：true=成功，false=失败

响应示例

JSON 
{
    "data": {
        "result": true
    },
    "reqId": "string",
    "code": "2000",
    "success": true,
    "message": null
}

客户信息查询

从电子税务局查询已存在的客户信息列表，支持按分类、简码、名称、税号分页筛选

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

请求参数

参数名 类型 必填 说明
action String 否 操作类型，固定传khxx_cx
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 是否异步方式，默认false
data.pageIndex Integer 是 当前页码
data.pageSize Integer 是 每页行数：10/20/50
data.params Object 是 查询参数
data.params.khfluuid String 否 客户分类UUID
data.params.jm String 否 简码
data.params.gmfmc String 否 购买方名称
data.params.gmfnsrsbh String 否 购买方纳税人识别号

请求示例

JSON 
{
    "action": "khxx_cx",
    "nsrsbh": "string",
    "data": {
        "pageIndex": 1,
        "pageSize": 10,
        "params": {
            "gmfmc": "",
            "khfluuid": ""
        }
    },
    "aggOrgId": "string",
    "async": "false"
}

响应参数

参数名 类型 说明
code String 2000=成功
success Boolean 是否成功
message String 错误信息
reqId String 请求ID
data.records Integer 总记录数
data.list Array 客户列表
data.list[].khxxuuid String 客户信息UUID
data.list[].khfluuid String 所属分类UUID
data.list[].khflmc String 分类名称
data.list[].jdqmc String 节点全名称
data.list[].gmfmc String 购买方名称
data.list[].gmfnsrsbh String 购买方纳税人识别号
data.list[].jm String 简码
data.list[].dzxxList Array 地址信息列表
data.list[].dzxxList[].dzxxuuid String 地址信息UUID
data.list[].dzxxList[].email String 邮箱
data.list[].dzxxList[].lxdh String 联系电话
data.list[].dzxxList[].dz String 地址
data.list[].dzxxList[].yhzh String 银行账号
data.list[].dzxxList[].yhyywdmc String 银行营业网点名称
data.list[].dzxxList[].sfmrdz String 是否默认地址

响应示例

JSON 
{
    "data": {
        "records": 1,
        "list": [
            {
                "jm": "string",
                "khfluuid": "string",
                "gmfnsrsbh": "string",
                "khflmc": "string",
                "jdqmc": "01",
                "gmfmc": "string",
                "khxxuuid": "string",
                "dzxxList": [
                    {
                        "email": "string",
                        "lxdh": "string",
                        "dz": "string",
                        "yhzh": "string",
                        "yhyywdmc": "string",
                        "sfmrdz": "string",
                        "dzxxuuid": "string"
                    }
                ]
            }
        ]
    },
    "reqId": "string",
    "code": "2000",
    "success": true,
    "message": null
}

新增客户信息

在电子税务局新增客户信息

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

请求参数

参数名 类型 必填 说明
action String 否 操作类型，固定传khxx_add
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 是否异步方式，默认false
data.gmfmc String 是 客户名称
data.khfluuid String 是 客户分类UUID
data.gmfnsrsbh String 否 客户识别号
data.jm String 否 简码
data.dzxxList Array 否 地址信息列表
data.dzxxList[].dz String 否 地址
data.dzxxList[].email String 否 邮箱
data.dzxxList[].lxdh String 否 联系电话
data.dzxxList[].sfmrdz String 否 是否默认地址
data.dzxxList[].yhyywdmc String 否 银行营业网点名称
data.dzxxList[].yhzh String 否 银行账号

请求示例

JSON 
{
    "action": "khxx_add",
    "nsrsbh": "string",
    "data": {
        "gmfmc": "string",
        "gmfnsrsbh": "string",
        "jm": "string",
        "khfluuid": "string",
        "dzxxList": [
            {
                "dz": "string",
                "email": "string",
                "lxdh": "string",
                "sfmrdz": "string",
                "yhyywdmc": "string",
                "yhzh": "string"
            }
        ]
    },
    "aggOrgId": "string",
    "async": "false"
}

响应参数

参数名 类型 说明
code String 2000=成功
success Boolean 是否成功
message String 错误信息
reqId String 请求ID
data.result Boolean 执行结果：true=成功，false=失败

响应示例

JSON 
{
    "data": {
        "result": true
    },
    "reqId": "string",
    "code": "2000",
    "success": true,
    "message": null
}

修改客户信息

在电子税务局修改指定UUID的客户信息

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

请求参数

参数名 类型 必填 说明
action String 否 操作类型，固定传khxx_update
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 是否异步方式，默认false
data.khxxuuid String 是 客户信息UUID
data.gmfmc String 是 客户名称
data.khfluuid String 是 客户分类UUID
data.gmfnsrsbh String 否 客户识别号
data.jdqmc String 否 节点全名称
data.jm String 否 简码
data.khflmc String 否 客户分类名称
data.dzxxList Array 否 地址信息列表
data.dzxxList[].dzxxuuid String 否 地址信息UUID（编辑已有地址时传入）
data.dzxxList[].dz String 否 地址
data.dzxxList[].email String 否 邮箱
data.dzxxList[].lxdh String 否 联系电话
data.dzxxList[].sfmrdz String 否 是否默认地址
data.dzxxList[].yhyywdmc String 否 银行营业网点名称
data.dzxxList[].yhzh String 否 银行账号

请求示例

JSON 
{
    "action": "khxx_update",
    "nsrsbh": "string",
    "data": {
        "khxxuuid": "string",
        "gmfmc": "string",
        "gmfnsrsbh": "string",
        "jm": "string",
        "khfluuid": "string",
        "khflmc": "string",
        "dzxxList": [
            {
                "dzxxuuid": "string",
                "dz": "string",
                "email": "string",
                "lxdh": "string",
                "sfmrdz": "string",
                "yhyywdmc": "string",
                "yhzh": "string"
            }
        ]
    },
    "aggOrgId": "string",
    "async": "false"
}

响应参数

参数名 类型 说明
code String 2000=成功
success Boolean 是否成功
message String 错误信息
reqId String 请求ID
data.result Boolean 执行结果：true=成功，false=失败

响应示例

JSON 
{
    "data": {
        "result": true
    },
    "reqId": "string",
    "code": "2000",
    "success": true,
    "message": null
}

删除客户信息

在电子税务局删除一个或多个客户信息

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

请求参数

参数名 类型 必填 说明
action String 否 操作类型，固定传khxx_del
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 是否异步方式，默认false
data.uuids Array[String] 是 客户UUID列表，一次可删除一个或多个

请求示例

JSON 
{
    "action": "khxx_del",
    "nsrsbh": "string",
    "data": {
        "uuids": [
            "string"
        ]
    },
    "aggOrgId": "string",
    "async": "false"
}

响应参数

参数名 类型 说明
code String 2000=成功
success Boolean 是否成功
message String 错误信息
reqId String 请求ID
data.result Boolean 执行结果：true=成功，false=失败

响应示例

JSON 
{
    "data": {
        "result": true
    },
    "reqId": "string",
    "code": "2000",
    "success": true,
    "message": null
}

附加要素列表查询

查询附加信息维护中的附加要素信息列表，支持按名称分页筛选

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

请求参数

参数名 类型 必填 说明
action String 否 操作类型，固定传fjysxx_cx
nsrsbh String 是 纳税人识别号
accountId String 否 多账号下的账号唯一标识
data.pageIndex String 是 当前页码
data.pageSize String 是 分页大小
data.fjysxmmc String 否 附加信息名称

请求示例

JSON 
{
    "action": "fjysxx_cx",
    "data": {
        "pageSize": "10",
        "pageIndex": "1",
        "fjysxmmc": ""
    },
    "nsrsbh": "91**************2G",
    "accountId": ""
}

响应参数

参数名 类型 说明
code String 错误码
success Boolean 是否成功
message String 错误信息
reqId String 请求ID
data.records Integer 总条数
data.pageSize Integer 分页大小
data.pageIndex Integer 当前页码
data.list Array 附加要素列表
data.list[].uuid String 附加要素UUID
data.list[].fjysxmmc String 附加信息名称
data.list[].yyzt String 引用状态：0=未引用，1=已引用
data.list[].yxbz String 有效标志：Y=有效
data.list[].nsrsbh String 纳税人识别号
data.list[].nsrmc String 纳税人名称
data.list[].lrrmc String 录入人名称
data.list[].lrrq String 录入日期
data.list[].xgrmc String 修改人名称
data.list[].xgrq String 修改日期
data.list[].yyxxList Array 引用信息列表
data.list[].yyxxList[].uuid String 引用UUID
data.list[].yyxxList[].fjysxmUuid String 所属附加要素UUID
data.list[].yyxxList[].cjmbUuid String 场景模板UUID
data.list[].yyxxList[].cjmbmc String 场景模板名称

响应示例

JSON 
{
    "data": {
        "records": 5,
        "pageSize": 10,
        "pageIndex": 1,
        "list": [
            {
                "uuid": "string",
                "fjysxmmc": "开票信息",
                "yyzt": "1",
                "yxbz": "Y",
                "nsrsbh": "string",
                "nsrmc": "string",
                "lrrmc": "string",
                "lrrq": "2024-05-09 14:50:43",
                "xgrmc": "string",
                "xgrq": "2024-05-23 14:13:28",
                "yyxxList": [
                    {
                        "uuid": "string",
                        "fjysxmUuid": "string",
                        "cjmbUuid": "string",
                        "cjmbmc": "测试模板"
                    }
                ]
            }
        ]
    },
    "reqId": "string",
    "code": "2000",
    "success": true,
    "message": null
}

附加要素信息添加

附加要素信息添加。

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

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.ysmc String 是 要素名称
data.yslx String 是 要素类型

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "ysmc": "建筑项目B",
        "yslx": "建筑服务"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.ysId String 新建要素ID

响应示例

JSON 
{
    "reqId": "ex02",
    "code": "2000",
    "success": true,
    "data": {
        "ysId": "YS002"
    }
}

附加要素信息编辑

附加要素信息编辑。

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

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.ysId String 是 要素ID
data.ysmc String 是 要素名称

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "ysId": "YS001",
        "ysmc": "建筑项目A(更新)"
    }
}

响应参数

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

响应示例

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

附加要素信息删除

附加要素信息删除。

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

请求参数

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

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "ysId": "YS001"
    }
}

响应参数

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

响应示例

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

查询场景模版

查询场景模版列表。获取已配置的开票场景模版。

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

请求参数

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

请求示例

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

响应参数

参数名 类型 说明
code String 2000=成功
data.list Array 模版列表
data.list[].mbId String 模版ID
data.list[].mbmc String 模版名称

响应示例

JSON 
{
    "reqId": "sc01",
    "code": "2000",
    "success": true,
    "data": {
        "list": [
            {
                "mbId": "MB001",
                "mbmc": "日常销售模版"
            }
        ]
    }
}

添加场景模版

添加场景模版。

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

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.mbmc String 是 模版名称
data.mbContent Object 是 模版内容(预设开票参数)

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "mbmc": "建筑服务模版",
        "mbContent": {
            "fplxdm": "032",
            "tdys": "建筑服务"
        }
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.mbId String 新建模版ID

响应示例

JSON 
{
    "reqId": "sc02",
    "code": "2000",
    "success": true,
    "data": {
        "mbId": "MB002"
    }
}

编辑场景模版

编辑场景模版。

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

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.mbId String 是 模版ID
data.mbmc String 否 模版名称
data.mbContent Object 否 模版内容

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "mbId": "MB001",
        "mbmc": "日常销售模版(更新)"
    }
}

响应参数

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

响应示例

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

删除场景模版

删除场景模版。

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

请求参数

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

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "mbId": "MB001"
    }
}

响应参数

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

响应示例

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

异步请求结果查询(开票)

数电开票异步请求结果查询。开票接口同步超时(code=2001)时通过此接口查询最终结果。

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

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.kplsh String 是 开票流水号(开票接口返回)

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "kplsh": "202403010449175685068215"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功/2001=处理中
data.kplsh String 开票流水号
data.fphm String 发票号码(成功时返回)
data.kprq String 开票日期(成功时返回)

响应示例

JSON 
{
    "reqId": "issue019",
    "code": "2000",
    "success": true,
    "data": {
        "kplsh": "202403010449175685068215",
        "fphm": "23312000000043000001",
        "kprq": "2026-03-15"
    }
}

业务请求回调通知(开票)

数电开票业务请求回调通知。异步开票完成后系统推送结果到配置的回调地址。

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

请求参数

参数名 类型 必填 说明
taskId String 是 任务ID/开票流水号
status Integer 是 0=初始化/1=执行中/2=失败/3=成功
data Object 否 回调数据(含fphm/kprq等)

请求示例

JSON 
{
    "taskId": "202403010449175685068215",
    "status": 3,
    "data": {
        "fphm": "23312000000043000001",
        "kprq": "2026-03-15"
    }
}

响应参数

参数名 类型 说明
code String 返回2000表示已接收
msg String 处理结果

响应示例

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

扫脸认证回调通知

扫脸认证回调通知。用户完成扫脸后系统推送认证结果。

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

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
rzid String 是 认证ID
slzt String 是 刷脸状态：2=成功/3=失败

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "rzid": "2e7cfe4c02f547ed8ee1d016f05",
    "slzt": "2"
}

响应参数

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

响应示例

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

当前属期增值税是否申报

查询当前属期增值税是否已申报。已申报的属期不可再开票。

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

请求参数

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

请求示例

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

响应参数

参数名 类型 说明
code String 2000=成功
data.sfysb String 是否已申报：Y=已申报/N=未申报
data.skssq String 当前税款所属期

响应示例

JSON 
{
    "reqId": "issue020",
    "code": "2000",
    "success": true,
    "data": {
        "sfysb": "N",
        "skssq": "2026-03"
    }
}

查询企业未申报税目

查询企业未申报税目。返回当前未完成申报的税种列表。

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

请求参数

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

请求示例

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

响应参数

参数名 类型 说明
code String 2000=成功
data.list Array 未申报税目列表
data.list[].szmc String 税种名称
data.list[].skssq String 税款所属期

响应示例

JSON 
{
    "reqId": "issue021",
    "code": "2000",
    "success": true,
    "data": {
        "list": [
            {
                "szmc": "增值税",
                "skssq": "2026-03"
            }
        ]
    }
}

合格证台账信息查询

已开具发票的合格证台账信息查询。查询已关联发票的车辆合格证信息。

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

请求参数

参数名 类型 必填 说明
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 台账列表

响应示例

JSON 
{
    "reqId": "mv01",
    "code": "2000",
    "success": true,
    "data": {
        "total": 0,
        "list": []
    }
}

机动车专用发票列表查询

机动车类专用发票列表查询。分页查询已开具的机动车专用发票。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/issue/mv/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 发票列表

响应示例

JSON 
{
    "reqId": "mv02",
    "code": "2000",
    "success": true,
    "data": {
        "total": 0,
        "list": []
    }
}

机动车专用发票申请导出

机动车类专用发票申请导出。将发票数据导出为Excel文件。

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

请求参数

参数名 类型 必填 说明
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": "mv03",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "931928300933249"
    }
}

机动车导出未下载文件列表

机动车类专用发票导出业务未下载文件列表。

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

请求参数

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

请求示例

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

响应参数

参数名 类型 说明
code String 2000=成功
data.list Array 文件列表
data.list[].fileId String 文件ID
data.list[].fileName String 文件名

响应示例

JSON 
{
    "reqId": "mv04",
    "code": "2000",
    "success": true,
    "data": {
        "list": []
    }
}

机动车导出文件下载

机动车类专用发票导出业务未下载文件下载。

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

请求参数

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

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "fileId": "FILE001"
    }
}

响应参数

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

响应示例

JSON 
{
    "reqId": "mv05",
    "code": "2000",
    "success": true,
    "data": {
        "fileUrl": "https:\/\/oss.example.com\/export\/mv_export.xlsx"
    }
}

跨区域涉税事项报验管理编号查询

建筑服务-跨区域涉税事项报验管理编号信息查询。用于查询建筑服务跨区域涉税事项的报验管理编号信息，支持按工程项目名称、合同对方信息、行政区划、有效期等条件筛选。

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

请求参数

参数名 类型 必填 说明
action String 否 操作类型，本接口传入：queryKqysssxbyglbhcx
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 是否异步方式，默认false
data.pageIndex Integer 是 当前页码
data.pageSize Integer 是 每页条数，枚举值：5/10/20/50/100
data.gcxmmc String 否 工程项目名称
data.htdfnsrmc String 否 合同对方纳税人名称
data.htdfnsrsbh String 否 合同对方纳税人识别号
data.kqyjydxzqh String 否 跨区域经营地行政区划
data.wcjyhdssglzmbh String 否 跨区域涉税事项报验管理编号
data.zmyxqxq String 否 跨区域涉税事项有效期起，格式：yyyy-MM-dd
data.zmyxqxz String 否 跨区域涉税事项有效期止，格式：yyyy-MM-dd
data.cjsjq String 是 报告开具时间起，格式：yyyy-MM-dd
data.cjsjz String 是 报告开具时间止，格式：yyyy-MM-dd
data.wcjyhdssglzmbhq String 否 跨税报起
data.wcjyhdssglzmbhy String 否 跨税报止

请求示例

JSON 
{
    "data": {
        "pageIndex": 1,
        "pageSize": 10,
        "cjsjq": "2024-01-01",
        "cjsjz": "2024-12-31"
    },
    "nsrsbh": "9115**********6W2C"
}

响应参数

参数名 类型 说明
code String 2000=成功
success Boolean 是否成功
message String 错误信息提示
reqId String 请求ID
data.pageIndex Integer 当前页码
data.pageSize Integer 每页条数
data.records Integer 总记录数
data.list Array 结果列表
data.list[].djxh String 登记序号
data.list[].gcxmmc String 工程项目名称
data.list[].jdxzdm String 跨区域经营乡镇街道行政区域代码
data.list[].jdxzmc String 跨区域经营乡镇街道
data.list[].wcjyd String 外出经营地
data.list[].wcjydxzqhszdm String 外出经营地行政区划代码
data.list[].wcjydxzqhsz String 外出经营地行政区划
data.list[].wcjyhdssglzmbh String 跨区域涉税事项报验管理编号
data.list[].xgrq String 修改日期

响应示例

JSON 
{
    "reqId": "7f3e7b6cf71b42d3a3c39f82471a77a4",
    "code": "2000",
    "success": true,
    "message": null,
    "data": {
        "pageIndex": 1,
        "records": 1,
        "pageSize": 10,
        "list": [
            {
                "djxh": "101111**********0000",
                "gcxmmc": "工程项目名称",
                "jdxzdm": "跨区域经营乡镇街道行政区域代码",
                "jdxzmc": "跨区域经营乡镇街道",
                "wcjyd": "甘肃省嘉峪关市",
                "wcjydxzqhszdm": "110116",
                "wcjydxzqhsz": "北京市怀柔区",
                "wcjyhdssglzmbh": "海地税外证〔2000〕0000号",
                "xgrq": "2018-09-18 09:00:00"
            }
        ]
    }
}

提交跨区域涉税事项报验管理

建筑服务-提交跨区域涉税事项报验管理开具

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

请求参数

参数名 类型 必填 说明
action String 否 操作类型，本接口传入：saveKqysssxbg
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 是否异步方式，默认false
data.kqysssxbgVO Object 是 跨区域经营基本信息
data.kqysssxbgVO.htdfnsrsbh String 否 合同对方纳税人识别号
data.kqysssxbgVO.htdfnsrmc String 是 合同对方纳税人名称
data.kqysssxbgVO.jyfsdmjh String 是 经营方式代码集合
data.kqysssxbgVO.wcjydxzqhszDm String 是 外出经营地行政区划代码
data.kqysssxbgVO.wcjyd String 是 外出经营地详细地址
data.kqysssxbgVO.jdxzDm String 否 乡镇街道
data.kqysssxbgVO.lxr String 是 联系人
data.kqysssxbgVO.lxrsj String 是 联系人手机
data.kqysssxbgHwxxVO Object 是 跨区域经营合同信息
data.kqysssxbgHwxxVO.wcjyhwmc String 是 外出经营货物/工程名称
data.kqysssxbgHwxxVO.htbh String 否 合同编号
data.kqysssxbgHwxxVO.wcjyhwzz Number 是 外出经营货物总值(元)
data.kqysssxbgHwxxVO.wcjyhwyxqxq String 是 有效期起，格式：yyyy-MM-dd
data.kqysssxbgHwxxVO.wcjyhwyxqxz String 是 有效期止，格式：yyyy-MM-dd

请求示例

JSON 
{
    "nsrsbh": "913************QY4Y",
    "data": {
        "kqysssxbgVO": {
            "htdfnsrsbh": "",
            "htdfnsrmc": "宝鸡********有限公司",
            "jyfsdmjh": "19",
            "wcjydxzqhszDm": "610303",
            "wcjyd": "宝鸡市********负一楼",
            "jdxzDm": "十里铺街道",
            "lxr": "董*",
            "lxrsj": "138****3105"
        },
        "kqysssxbgHwxxVO": {
            "wcjyhwmc": "宝鸡银泰城**********搭建合同",
            "htbh": "",
            "wcjyhwzz": 87760.86,
            "wcjyhwyxqxq": "2025-10-06",
            "wcjyhwyxqxz": "2025-12-31"
        }
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
success Boolean 是否成功
message String 错误信息提示
reqId String 请求ID
data.result Boolean 是否保存成功
data.msg String 保存信息

响应示例

JSON 
{
    "reqId": "7f3e7b6cf71b42d3a3c39f82471a77a4",
    "code": "2000",
    "success": true,
    "message": null,
    "data": {
        "result": true,
        "msg": "跨区域涉税事项报告信息保存成功。"
    }
}

开票准备

企业基本信息(开票)

开票准备阶段:获取当前登录企业的基本信息,从局端实时获取(企享云未加工)。返回纳税人类型(Nsrlx:1一般/2小规模/3转登记/4辅导期/5自然人)/全电标志(Qdbz:Y/N)/新电票试点(Xdpsdqybz)/可开票种(Fpzldms)/特定业务类型(Tdys:建筑/货运/不动产/二手车/拖拉机/不动产租赁/旅客运输等)/默认开票人(Kpr)/办税人/财务负责人/对公账户(YhxxList)/当前税款所属期(Dqskssq)等。action=qyjbxxcx

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

请求参数

参数名 类型 必填 说明
action String 否 操作类型,固定传qyjbxxcx(路径已含可省)
nsrsbh String 是 税号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 异步标志,默认false

请求示例

JSON 
{
    "action": "qyjbxxcx",
    "nsrsbh": "91XXXXXXXXXXXXXXX"
}

响应参数

参数名 类型 说明
code String 2000=成功
data.Nsrmc String 纳税人名称
data.Nsrsbh String 纳税人识别号
data.Nsrlx String 纳税人类型:1一般/2小规模/3转登记小规模/4辅导期一般/5自然人
data.Qdbz String 全电标志:Y=全电试点/N=非全电
data.Xdpsdqybz String 新电票试点企业标识:Y/N
data.Sfkkjzzfp String 是否可开增值税发票:Y/N
data.Jzjtbz String 即征即退标志:Y/N
data.Kpr String 默认开票人
data.Bsrxm String 办税人姓名
data.Cwfzrxm String 财务负责人姓名
data.Fddbrxm String 法定代表人姓名
data.Fpzldms Array 可开发票种类:[{Fpzldm,Fpzlmc}]
data.Tdys Array 特定业务类型:[{Tdyslxdm,Tdyslxmc}]如建筑服务/货运/不动产销售/二手车/不动产租赁/旅客运输
data.YhxxList Array 对公账号信息:[{Yhzh,YhzhxzDm,Yhyywdmc,YhyywdDm}]
data.Dqskssq String 当前税款所属期,如202403
data.Province String 所在省市
data.Swjgmc String 税务机关名称
data.Zcdz String 注册地址
data.Scjydz String 生产经营地址
data.Qysxed Number 授信额度

响应示例

JSON 
{
    "reqId": "1f349ace904b481182c494844a82f467",
    "code": "2000",
    "success": true,
    "data": {
        "Nsrmc": "XX信息有限公司",
        "Nsrsbh": "91XXXXXXXXX",
        "Nsrlx": "1",
        "Qdbz": "Y",
        "Sfkkjzzfp": "Y",
        "Kpr": "X鑫",
        "Bsrxm": "X磊",
        "Cwfzrxm": "X敏",
        "Fpzldms": [
            {
                "Fpzldm": "01",
                "Fpzlmc": "增值税专用发票"
            },
            {
                "Fpzldm": "02",
                "Fpzlmc": "普通发票"
            }
        ],
        "Tdys": [
            {
                "Tdyslxdm": "03",
                "Tdyslxmc": "建筑服务"
            },
            {
                "Tdyslxdm": "04",
                "Tdyslxmc": "货物运输服务"
            },
            {
                "Tdyslxdm": "05",
                "Tdyslxmc": "不动产销售"
            },
            {
                "Tdyslxdm": "09",
                "Tdyslxmc": "旅客运输服务"
            }
        ],
        "Dqskssq": "202403",
        "Province": "上海",
        "Swjgmc": "XX税务局第十八税务所",
        "YhxxList": [
            {
                "Yhzh": "XXX10301",
                "YhzhxzDm": "1110",
                "Yhyywdmc": "XX上海青浦支行"
            }
        ]
    }
}

开票额度查询

查询企业发票开票额度。返回当前可用单张最大开票金额、累计开票限额及已用额度。action=kped_cx

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

请求参数

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

请求示例

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

响应参数

参数名 类型 说明
code String 2000=成功
data.dzLjKpxe String 单张累计开票限额
data.ljKyKpje String 累计可用开票金额
data.ljYyKpje String 累计已用开票金额
data.qdbz String 全电标志

响应示例

JSON 
{
    "reqId": "issue001",
    "code": "2000",
    "success": true,
    "data": {
        "dzLjKpxe": "100000",
        "ljKyKpje": "85000",
        "ljYyKpje": "15000",
        "qdbz": "Y"
    }
}

办税开票人授信类别查询

扫脸时长查询(又称"办税开票人授信类别查询")。获取当前纳税人风险等级/预警等级/授信信息。⭐提升开票体验要点:返回参数scanTime是扫脸二维码可设置的最大时长,在"扫脸时长设置"接口里把phxxz设置为scanTime,即可最大限度延长扫脸有效期,减少重复扫脸。action=sxlb_cx

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

请求参数

参数名 类型 必填 说明
action String 否 操作类型,sxlb_cx
nsrsbh String 是 税号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 异步标志,默认false

请求示例

JSON 
{
    "action": "sxlb_cx",
    "nsrsbh": "91XXXXXXXXXXXXXXX"
}

响应参数

参数名 类型 说明
code String 2000=成功
data.yjjb String 预警级别:01无预警/02红色预警/03黄色预警/04蓝色预警
data.sxlb String 授信类别:1高风险/2中风险/3低风险/4无风险纳税人
data.sfsl String 开票前是否需要刷脸:Y/null=需要,N=无需。⭐非N值时需触发刷脸程序
data.scanTime Integer 扫码能设置的最大时长(分钟)
data.phxxz String 当前扫码设置的时长(分钟)

响应示例

JSON 
{
    "reqId": "91c29e6cf1df4ddd9856019e0d1a634d",
    "code": "2000",
    "success": true,
    "data": {
        "yjjb": "01",
        "sxlb": "3",
        "sfsl": "Y",
        "itsScanFlag": "N"
    }
}

获取人脸识别二维码

获取人脸识别二维码。开票前需刷脸认证时调用，返回二维码内容及认证ID(rzid)。用户使用税务APP或国家网络身份认证APP扫码。action=ewm_sq

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

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
accountId String 否 账号ID
data.slfs String 否 刷脸方式：1=税务APP/2=国家网络身份认证APP

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "slfs": "1"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.rzid String 认证ID，用于后续查询认证结果
data.ewmNr String 二维码内容(URL)，展示给用户扫码
data.yxsj Integer 有效时间(秒)

响应示例

JSON 
{
    "reqId": "issue002",
    "code": "2000",
    "success": true,
    "data": {
        "rzid": "2e7cfe4c02f547ed8ee1d016f05",
        "ewmNr": "https:\/\/dppt.zj-l-tax.gov.cn\/...",
        "yxsj": 180
    }
}

获取人脸识别结果

获取人脸识别结果(税务APP/国家网络身份认证APP扫码后查询)。通过前一步获取到的rzid查询认证状态。建议按3-5s轮询直到slzt=2(扫脸成功)或slzt=3(二维码过期重新获取)。action=rzztcx

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

请求参数

参数名 类型 必填 说明
action String 否 操作类型,rzztcx
nsrsbh String 是 税号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 异步标志,默认false
data.rzid String 是 前一接口(获取人脸识别二维码)返回的认证二维码ID

请求示例

JSON 
{
    "action": "rzztcx",
    "nsrsbh": "91XXXXXXXXXXXXXXX",
    "data": {
        "rzid": "2e7cfe4c02f547ed8ee1d016f05"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.nsrsbh String 纳税人识别号
data.slzt String 刷脸状态:1=已生成二维码未扫脸/2=扫脸成功/3=二维码已过期

响应示例

JSON 
{
    "reqId": "bad3a46b47dc4c509717463cebc5f28e",
    "code": "2000",
    "success": true,
    "data": {
        "nsrsbh": "91XXXXXXXXX",
        "slzt": "1"
    }
}

税收分类编码查询

查询税收分类编码信息。开票时选择正确的税收分类编码。

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

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.keyword String 否 关键词搜索
data.spbm String 否 商品编码精确查询

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "keyword": "风扇"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.list Array 编码列表
data.list[].spbm String 商品编码
data.list[].spmc String 商品名称
data.list[].sl String 税率

响应示例

JSON 
{
    "reqId": "issue018",
    "code": "2000",
    "success": true,
    "data": {
        "list": [
            {
                "spbm": "1090416010000000000",
                "spmc": "家用通风电器具",
                "sl": "0.13"
            }
        ]
    }
}

扫脸时长查询(legacy)

⚠️legacy端点,保留兼容。新接入请使用 issue-face-duration-query (/v2/invoice/qdfp/sxlbCx)

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

请求参数

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

请求示例

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

响应参数

参数名 类型 说明
code String 2000=成功
data Object 同issue-face-duration-query返回结构

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "sxlb": "3",
        "sfsl": "Y",
        "scanTime": 1440
    }
}

扫脸时长设置

扫脸时长设置(设置扫脸二维码有效时长)。⚠️登录人身份必须是"财务负责人"或"法定代表人",否则调用会失败。⭐最佳实践:先调sxlbCx拿scanTime,把其值带入本接口的phxxz,即可最大化扫脸有效期。单位分钟(原文"最小为1天,需要是天的倍数"=1440的倍数,但示例显示可为20,实际以局端校验为准)。action=smsc

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

请求参数

参数名 类型 必填 说明
action String 否 操作类型,smsc
nsrsbh String 是 税号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 异步标志,默认false
data.phxxz String 是 扫码时长(分钟)。原文要求需为1440的倍数(1天=1440,2天=2880),示例却是20。建议取sxlbCx返回的scanTime值

请求示例

JSON 
{
    "action": "smsc",
    "nsrsbh": "91XXXXXXXXXXXXXXX",
    "data": {
        "phxxz": "1440"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data Object 成功时为空对象{}

响应示例

JSON 
{
    "code": "2000",
    "data": [],
    "success": true,
    "reqId": "2f102e6303c244d69af3fabb61afbf1b"
}

个税APP获取人脸识别二维码

个税APP扫码获取人脸识别二维码。通过个税APP进行实名认证扫码。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/issue/pit-face/qrcode

请求参数

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

请求示例

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

响应参数

参数名 类型 说明
code String 2000=成功
data.rzid String 认证ID
data.ewmNr String 二维码内容

响应示例

JSON 
{
    "reqId": "pit01",
    "code": "2000",
    "success": true,
    "data": {
        "rzid": "abc123def456",
        "ewmNr": "https:\/\/pit.tax.gov.cn\/..."
    }
}

个税APP获取人脸识别结果

个税APP扫码获取人脸识别结果。轮询查询用户通过个税APP扫码后的认证状态。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/issue/pit-face/result

请求参数

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

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "rzid": "abc123def456"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.slzt String 刷脸状态：1=已生成/2=成功/3=过期

响应示例

JSON 
{
    "reqId": "pit02",
    "code": "2000",
    "success": true,
    "data": {
        "slzt": "2"
    }
}

蓝字发票开具

蓝字发票开具

开具数电蓝字发票

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

请求示例

JSON 
{
    "nsrsbh": "91xxx",
    "items": [
        {
            "spmc": "办公用品",
            "je": "1000.00",
            "sl": "0.13"
        }
    ]
}

响应示例

JSON 
{
    "code": 200,
    "data": {
        "fphm": "2024xxxx",
        "kprq": "2026-04-04"
    }
}

农产品收购发票

开具农产品收购发票。使用与蓝字发票相同的开具接口，fplxdm传对应农产品发票类型代码。

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

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.fplxdm String 是 发票类型代码(农产品收购)
data.xsf_nsrsbh String 是 销方税号
data.gmf_nsrmc String 是 购方名称
data.xmmx Array 是 开票明细

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "fplxdm": "040",
        "xsf_nsrsbh": "91320100MA1K2XXXXX",
        "gmf_nsrmc": "农户张三",
        "xmmx": [
            {
                "spbm": "1010101010100000000",
                "spmc": "小麦",
                "xmmc": "小麦",
                "sl": "0.09",
                "je": "10000",
                "se": "900"
            }
        ]
    }
}

响应参数

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

响应示例

JSON 
{
    "reqId": "issue003",
    "code": "2000",
    "success": true,
    "data": {
        "kplsh": "202403010449175685068216",
        "fphm": "23312000000043000010",
        "kprq": "2026-03-20"
    }
}

报废产品收购发票

开具报废产品收购发票。使用与蓝字发票相同的开具接口。

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

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.fplxdm String 是 发票类型代码
data.xsf_nsrsbh String 是 销方税号
data.xmmx Array 是 开票明细

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "fplxdm": "050",
        "xsf_nsrsbh": "91320100MA1K2XXXXX",
        "xmmx": [
            {
                "spbm": "1090501010000000000",
                "spmc": "废钢",
                "xmmc": "废钢",
                "sl": "0.13",
                "je": "50000",
                "se": "6500"
            }
        ]
    }
}

响应参数

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

响应示例

JSON 
{
    "reqId": "issue004",
    "code": "2000",
    "success": true,
    "data": {
        "kplsh": "202403010449175685068217",
        "fphm": "23312000000043000011"
    }
}

二手车销售统一发票

开具二手车销售统一发票。使用统一开票接口，fplxdm传二手车类型代码，需含车辆信息。

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

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.fplxdm String 是 发票类型代码(二手车)
data.xsf_nsrsbh String 是 销方税号
data.gmf_nsrmc String 是 购方名称
data.cjhm String 是 车架号
data.cpzh String 是 车牌照号
data.xmmx Array 是 开票明细

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "fplxdm": "042",
        "xsf_nsrsbh": "91320100MA1K2XXXXX",
        "gmf_nsrmc": "买方公司",
        "cjhm": "LSVAU2BR3PN123456",
        "cpzh": "苏A12345",
        "xmmx": [
            {
                "spmc": "小汽车",
                "je": "80000"
            }
        ]
    }
}

响应参数

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

响应示例

JSON 
{
    "reqId": "issue005",
    "code": "2000",
    "success": true,
    "data": {
        "kplsh": "202403010449175685068218",
        "fphm": "23312000000043000012"
    }
}

红字发票

申请红字信息表

申请红字信息表。开具红字发票前必须先申请红字信息表。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"
    }
}

发票查询

已开发票列表查询

已开发票列表查询。分页查询企业已开具的发票列表。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
    }
}

版式文件与交付

下载版式文件(销项)

下载已开发票的版式文件(PDF/OFD/XML)。

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

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.fphm String 是 发票号码
data.bswjLx String 否 版式文件类型：PDF/OFD/XML

请求示例

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

响应参数

参数名 类型 说明
code String 2000=成功
data.fileList Array 文件列表
data.fileList[].fileType String 文件类型
data.fileList[].fileUrl String 下载URL

响应示例

JSON 
{
    "reqId": "issue015",
    "code": "2000",
    "success": true,
    "data": {
        "fileList": [
            {
                "fileType": "PDF",
                "fileUrl": "https:\/\/oss.example.com\/invoice\/xxx.pdf"
            }
        ]
    }
}

税局邮箱交付

通过税局邮箱交付发票。将开好的发票通过税局邮箱发送给购方。

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

请求参数

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

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "fphm": "23312000000043000001",
        "email": "customer@example.com"
    }
}

响应参数

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

响应示例

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

下载版式文件(废弃)

下载版式文件(已废弃)。请使用 issue-format-download 替代。

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

请求参数

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

请求示例

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

响应参数

参数名 类型 说明
code String 2000=成功

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": []
}

额度管理

发票额度调整申请

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

登录查看报价
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"
            }
        ]
    }
}

成品油专区

查询成品油库存汇总台账

查询成品油库存汇总台账。分页查询指定月份的成品油库存情况,包含期初/期末/本期进/本期销等数据。action=kchztz

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

请求参数

参数名 类型 必填 说明
action String 否 操作类型,kchztz
nsrsbh String 是 税号(外层与data内层都需要)
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 异步标志,默认false
data.nsrsbh String 是 税号
data.cxssny String 是 查询所属年月,格式yyyyMM
data.pageIndex Integer 否 当前页码
data.pageSize Integer 否 每页条数,可选值:5/10/20/50/100

请求示例

JSON 
{
    "nsrsbh": "91XXXXXXXXXXXXXXXXX",
    "data": {
        "nsrsbh": "91XXXXXXXXXXXXXXXXX",
        "cxssny": "202404",
        "pageIndex": "1",
        "pageSize": "10"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.pageIndex Integer 当前页码
data.pageSize Integer 每页条数
data.records Integer 总记录数
data.list[].xh Integer 序号
data.list[].ypmc String 油品名称(如汽油/柴油)
data.list[].ypbm String 油品编码(税收分类编码)
data.list[].qcdqkc String 期初当期库存
data.list[].qmdqkc String 期末当期库存
data.list[].qcsdkc String 期初实地库存
data.list[].qmsdkc String 期末实地库存
data.list[].bqjskc String 本期进时库存
data.list[].bqjsuokc String 本期进锁库存
data.list[].bqsdkc String 本期实地库存

响应示例

JSON 
{
    "reqId": "7f3e7b6cf71b42d3a3c39f82471a77a4",
    "code": "2000",
    "success": true,
    "data": {
        "pageIndex": 1,
        "records": 16,
        "pageSize": 10,
        "list": [
            {
                "xh": 1,
                "ypmc": "汽油",
                "ypbm": "1070101010100000000",
                "qcdqkc": "71.98544995",
                "qmdqkc": "70.50685032",
                "qcsdkc": "0",
                "qmsdkc": "0",
                "bqjskc": "1.47859963",
                "bqjsuokc": "0",
                "bqsdkc": "0"
            }
        ]
    }
}

成品油换算标准(税收商品)

查询成品油换算标准(税收商品查询)。分页列出税收分类编码下的成品油商品及换算标准(吨升率等)。action=cpyspbm

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/issue/oil/tax-std

请求参数

参数名 类型 必填 说明
action String 否 操作类型,cpyspbm
nsrsbh String 是 税号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 异步标志,默认false
data.params Object 是 查询参数对象
data.pageIndex Integer 是 当前页码
data.pageSize Integer 是 每页条数,可选值:5/10/20/50/100

请求示例

JSON 
{
    "nsrsbh": "91XXXXXXXXXXXXXXXXX",
    "data": {
        "pageIndex": "1",
        "pageSize": "10"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.pageIndex Integer 当前页码
data.records Integer 总记录数
data.pageSize Integer 每页条数
data.list[].dzSpbm String 商品编码(税收分类编码)
data.list[].dzSpfwmc String 商品范围名称
data.list[].dzSpfwjc String 商品范围简称
data.list[].dzFlspbm String 父级分类商品编码
data.list[].dzDysm String 对应税目
data.list[].smDm String 税目代码
data.list[].dzSlvYT String 税率/吨
data.list[].dzSlvYL String 税率/升
data.list[].dzDwzhLT String 单位换算:升换算吨(吨升率)
data.list[].dzTsqyLx/dzSyqyLx String 特殊/适用企业类型
data.list[].dzYxbz String 有效标志Y/N
data.list[].dzSfhz String 是否核准Y/N
data.list[].dzSfms String 是否免税Y/N
data.list[].dzIsroot String 是否根节点Y/N

响应示例

JSON 
{
    "reqId": "7f3e7b6cf71b42d3a3c39f82471a77a4",
    "code": "2000",
    "success": true,
    "data": {
        "pageIndex": 1,
        "records": 1,
        "pageSize": 10,
        "list": [
            {
                "dzSpbm": "1070101010100000000",
                "dzSpfwmc": "汽油",
                "dzSpfwjc": "汽油",
                "dzFlspbm": "1070101010000000000",
                "dzDysm": "汽油",
                "smDm": "101020609",
                "dzSlvYT": "2109.76",
                "dzSlvYL": "1.52",
                "dzDwzhLT": "1388",
                "dzTsqyLx": "0",
                "dzSyqyLx": "0",
                "dzYxbz": "Y",
                "dzSfhz": "N",
                "dzSfms": "N",
                "dzIsroot": "N"
            }
        ]
    }
}

成品油换算标准(海关商品)

查询成品油换算标准(海关商品查询)。分页列出海关商品编码(HS编码)下的成品油对应税收分类及换算标准。与税收商品查询互补,用于进口成品油场景。action=cpyspbmhg

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/issue/oil/customs-std

请求参数

参数名 类型 必填 说明
action String 否 操作类型,cpyspbmhg
nsrsbh String 是 税号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 异步标志,默认false
data.params Object 是 查询参数对象
data.pageIndex Integer 否 当前页码
data.pageSize Integer 否 每页条数,可选值:5/10/20/50/100

请求示例

JSON 
{
    "nsrsbh": "91XXXXXXXXXXXXXXXXX",
    "data": {
        "pageIndex": "1",
        "pageSize": "10"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.pageIndex Integer 当前页码
data.records Integer 总记录数
data.pageSize Integer 每页条数
data.list[].DzHgsh String 海关商品编码(HS编码)
data.list[].DzHwmc String 货物名称
data.list[].DzSsflbm String 所属分类编码(税收分类编码)
data.list[].DzSpfwmc String 商品范围名称
data.list[].DzDyssdlbm String 对应税收大类编码
data.list[].DzDyssdlmc String 对应税收大类名称
data.list[].DzHsbz String 换算标准(吨升率)
data.list[].DzSlv String 税率
data.list[].DzSyqyLx String 适用企业类型
data.list[].DzYxbs String 有效标识Y/N
data.list[].Lrrq String 录入日期

响应示例

JSON 
{
    "reqId": "7f3e7b6cf71b42d3a3c39f82471a77a4",
    "code": "2000",
    "success": true,
    "data": {
        "pageIndex": 1,
        "records": 1,
        "pageSize": 10,
        "list": [
            {
                "DzHgsh": "2707999000",
                "DzHwmc": "蒸馏煤焦油所得的其他产品",
                "DzSsflbm": "1070101050100000000",
                "DzSpfwmc": "石脑油",
                "DzDyssdlbm": "1070101050000000000",
                "DzDyssdlmc": "石脑油类",
                "DzHsbz": "1.385",
                "DzSlv": "1.52",
                "DzSyqyLx": "0",
                "DzYxbs": "Y",
                "Lrrq": "2022-02-23 15:00:00"
            }
        ]
    }
}

查询成品油授权编码

查询成品油授权编码。分页列出当前纳税人被授权可开票的成品油商品明细(含开票使用权限标志)。action=cpyspbmmx

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/issue/oil/auth-code

请求参数

参数名 类型 必填 说明
action String 否 操作类型,cpyspbmmx
nsrsbh String 是 税号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 异步标志,默认false
data.params Object 是 查询参数对象
data.pageIndex Integer 否 当前页码
data.pageSize Integer 否 每页条数,可选值:5/10/20/50/100

请求示例

JSON 
{
    "nsrsbh": "91XXXXXXXXXXXXXXXXX",
    "data": {
        "nsrsbh": "91XXXXXXXXXXXXXXXXX",
        "pageIndex": "1",
        "pageSize": "10"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.pageIndex Integer 当前页码
data.records Integer 总记录数
data.pageSize Integer 每页条数
data.list[].sphfwssflhbbm String 商品和服务税收分类合并编码
data.list[].sphfwmc String 商品和服务范围名称
data.list[].sphfwfljc String 商品和服务分类简称
data.list[].dyzspm String 对应征收品目
data.list[].kpsyqx String 开票使用权限:是/否

响应示例

JSON 
{
    "reqId": "7f3e7b6cf71b42d3a3c39f82471a77a4",
    "code": "2000",
    "success": true,
    "data": {
        "pageIndex": 1,
        "records": 1,
        "pageSize": 10,
        "list": [
            {
                "sphfwssflhbbm": "1070101010100000000",
                "sphfwmc": "汽油",
                "sphfwfljc": "汽油",
                "dyzspm": "汽油",
                "kpsyqx": "是"
            }
        ]
    }
}

查询成品油对应品目列表

查询成品油对应品目列表(消费税税目)。返回成品油对应的消费税税目及税目代码清单(如汽油/柴油/石脑油等)。请求体极简,data传空对象{}即可。action=cpydysm

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

请求参数

参数名 类型 必填 说明
action String 否 操作类型,cpydysm
nsrsbh String 是 税号
aggOrgId String 是 企业ID
accountId String 否 多账号下的账号唯一标识
async Boolean 否 异步标志,默认false
data Object 是 业务参数(传空对象{}即可,无需其他字段)

请求示例

JSON 
{
    "nsrsbh": "91XXXXXXXXXXXXXXXXX",
    "data": []
}

响应参数

参数名 类型 说明
code String 2000=成功
data.pageIndex Integer 当前页码
data.records Integer 总记录数
data.pageSize Integer 每页条数
data.list[].smbm String 消费税税目代码(如101020609)
data.list[].smmc String 消费税税目名称(如汽油/柴油/石脑油)

响应示例

JSON 
{
    "reqId": "7f3e7b6cf71b42d3a3c39f82471a77a4",
    "code": "2000",
    "success": true,
    "data": {
        "pageIndex": 1,
        "records": 1,
        "pageSize": 10,
        "list": [
            {
                "smmc": "汽油",
                "smbm": "101020609"
            }
        ]
    }
}

其他业务

跨区域涉税事项编号查询

跨区域涉税事项报验管理编号信息查询。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/issue/cross-region/query

请求参数

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

请求示例

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

响应参数

参数名 类型 说明
code String 2000=成功
data.list Array 报验编号列表

响应示例

JSON 
{
    "reqId": "cr01",
    "code": "2000",
    "success": true,
    "data": {
        "list": []
    }
}

提交跨区域涉税事项报验

提交跨区域涉税事项报验管理。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/issue/cross-region/submit

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.byglbh String 是 报验管理编号

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "byglbh": "KQSSSX20260301"
    }
}

响应参数

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

响应示例

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

查询是否金银首饰试点企业

查询当前企业是否为金银首饰试点企业。

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

请求参数

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

请求示例

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

响应参数

参数名 类型 说明
code String 2000=成功
data.sfsd String 是否试点：Y/N

响应示例

JSON 
{
    "reqId": "gp01",
    "code": "2000",
    "success": true,
    "data": {
        "sfsd": "N"
    }
}

查询是金银首饰经营企业

查询当前企业是否为金银首饰经营企业。

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

请求参数

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

请求示例

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

响应参数

参数名 类型 说明
code String 2000=成功
data.sfjy String 是否经营：Y/N

响应示例

JSON 
{
    "reqId": "gb01",
    "code": "2000",
    "success": true,
    "data": {
        "sfjy": "N"
    }
}

查询车架号信息

机动车查询车架号信息。通过车架号(VIN)查询车辆详细信息。

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

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.cjhm String 是 车架号(VIN码)

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "cjhm": "LSVAU2BR3PN123456"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.cjhm String 车架号
data.cllx String 车辆类型
data.pp String 品牌

响应示例

JSON 
{
    "reqId": "vin01",
    "code": "2000",
    "success": true,
    "data": {
        "cjhm": "LSVAU2BR3PN123456",
        "cllx": "小型轿车",
        "pp": "大众"
    }
}

不动产房源信息查询

不动产房源信息查询。查询不动产开票所需的房源信息。

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

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.keyword String 否 关键词搜索(项目名/地址)

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "keyword": "阳光花园"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.list Array 房源信息列表

响应示例

JSON 
{
    "reqId": "re01",
    "code": "2000",
    "success": true,
    "data": {
        "list": []
    }
}

查询涉税专业服务协议

查询涉税专业服务协议要素采集信息表。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/issue/tax-service/query

请求参数

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

请求示例

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

响应参数

参数名 类型 说明
code String 2000=成功
data.list Array 协议列表

响应示例

JSON 
{
    "reqId": "ts01",
    "code": "2000",
    "success": true,
    "data": {
        "list": []
    }
}

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

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