灵税宝AgentAPI
  1. 3.2 发票开具服务
灵税宝AgentAPI
  • 灵税宝AI Agent开放平台
  • 1. 产品服务
    • 1.1 工商注册
    • 1.2 智能财税
      • 1.2.1 AI财税管理
      • 1.2.2 财税大模型
    • 1.3 即时结算
      • 1.3.1 即时结算管理
    • 1.4 风控预警
      • 1.4.1 大数据风控系统
  • 2. 解决方案
    • 2.1 即时配送解决方案
  • 3.税务接口定义
    • 3.1 账户服务
      • 3.1.1 单位账户登录
      • 3.1.2 登录状态查询
      • 3.1.3 单位账户快捷登录
      • 3.1.4 检查是否支持单位账户快捷登录
      • 3.1.5 异步自动接收验证码登录税务系统
    • 3.2 发票开具服务
      • 3.2.1 授信额度查询
        POST
      • 3.2.2 一般发票开具
        POST
      • 3.2.3 红字确认单信息生成
        POST
      • 3.2.4 红字确认单开具接口
        POST
      • 3.2.5 一键红冲接口
        POST
      • 3.2.6 申请查询蓝票订单结果
        POST
      • 3.2.7 发票确认及开票结果查询
        POST
      • 3.2.8 红字确认单处理
        POST
    • 3.3 发票查询服务
      • 3.3.1 近十张发票查询接口
      • 3.3.2 发票下载
      • 3.3.3 查询可开红字确认单的蓝票列表
      • 3.3.4 发票查询接口
      • 3.3.5 发票冲红状态查询
      • 3.3.6 红字确认单列表查询
      • 3.3.7 发票明细详情查询
      • 3.3.8 发票入账状态查询
      • 3.3.9 查询发票使用信息状态
      • 3.3.10 单张发票详情查询
      • 3.3.11 获取蓝票订单申请的处理结果
    • 3.6 附录
      • 3.6.1 特定要素类型
      • 3.6.2 申请状态
      • 3.6.3 增值税税率、征收率
      • 3.6.4 减按征收类型
      • 3.6.5 交通工具类型
      • 3.6.6 电子发票状态
      • 3.6.7 纳税人类型
      • 3.6.8 差额征收类型
      • 3.6.9 差额凭证类型
      • 3.6.10 发票票种
      • 3.6.11 身份证件类型
      • 3.6.17 发票状态
      • 3.6.18 发票类型
      • 3.6.19 发票来源
      • 3.6.20 发票来源与发票类型的对照关系
      • 3.6.21 冲红原因
      • 3.6.22 特定征税方式代码
      • 3.6.23 登录地区编码
      • 3.6.24 增值税特殊管理类型
      • 3.6.25 发票入账状态代码
      • 3.6.26 授信类别等级
      • 3.6.27 经办人国籍代码
      • 3.6.28 即征即退类型代码
      • 3.6.29 经办人身份类型
  • 4. 银行接口定义
    • 4.2 批量结算服务
      • 4.2.1 银行接口通信协议
      • 4.2.2 批量结算
      • 4.2.3 批量结算反馈
  1. 3.2 发票开具服务

3.2.4 红字确认单开具接口

POST
/agent/tax/v1/invoice/red_confirm/ation_sheet_issue
开具红票前，需先进行红字确认单的申请，此接口用户红字确认单的申请提交
红字确认单开具,需要自行记录结果UUID，后续的查询需要使用

Body参数#

TaxRedConfirmationSheetIssueRequest 结构定义
Hzqrxxmx 结构定义
Hzqrxxmx GO语言定义
Hzqrxxmx Java语言定义
Hzqrxxmx Typescript语言定义
TaxRedConfirmationSheetIssueRequest GO语言定义
TaxRedConfirmationSheetIssueRequest Java语言定义
TaxRedConfirmationSheetIssueRequest Typescript语言定义
请求Body报文示例

接口响应#

[200]红字确认单开具结果#

ginx.OkResult 结构定义
ResponseRedConfirmationSheet 结构定义
Hzqrxxmx 结构定义
Hzqrxxmx GO语言定义
Hzqrxxmx Java语言定义
Hzqrxxmx Typescript语言定义
ResponseRedConfirmationSheet GO语言定义
ResponseRedConfirmationSheet Java语言定义
ResponseRedConfirmationSheet Typescript语言定义
[200]红字确认单开具结果 报文示例

[400]Bad Request#

ginx.ResponseError 结构定义
[400]Bad Request 报文示例

[500]Internal Server Error#

ginx.ResponseError 结构定义
[500]Internal Server Error 报文示例

请求参数

Query 参数

Body 参数application/json必填

示例
{
    "bz": "string",
    "cezslxdm": "string",
    "chyydm": "string",
    "dfnsrmc": "string",
    "dfnsrsbh": "string",
    "dqnsrsbh": "string",
    "dsfmc": "string",
    "dsfnsrsbh": "string",
    "fpkjfs_dm": "string",
    "fplydm": "string",
    "fprzztdm": "string",
    "ghf_mc": "string",
    "ghf_nsrsbh": "string",
    "gjbq": "string",
    "gmfdsjswjg_dm": "string",
    "gmfssjswjg_dm": "string",
    "gmfzgswj_dm": "string",
    "gxsf": "string",
    "hzcxje": "-16.98",
    "hzcxse": "-1.02",
    "hzfphm": "string",
    "hzfplxdm2": "string",
    "hzfpxxqrdbh": "string",
    "hzkprq": "string",
    "hzqrdmxsl": "string",
    "hzqrxxmx_list": [
        {
            "dw": "string",
            "fpspdj": "string",
            "fpspsl": "string",
            "ggxh": "string",
            "gmfdsjswjg_dm": "string",
            "gmfssjswjg_dm": "string",
            "gmfzgswj_dm": "string",
            "hwhyslwfwmc": "string",
            "hzqrxxuuid": "string",
            "is_show_sl": true,
            "je": "-16.98",
            "lrrq": "string",
            "lrrsfid": "string",
            "lzfp_dm": "string",
            "lzfp_hm": "string",
            "lzmxxh": "string",
            "se": "-1.02",
            "sjcsdq": "string",
            "sjgsdq": "string",
            "sjtb_sj": "string",
            "sl": "0.06",
            "spfwjc": "string",
            "sphfwssflhbbm": "3040201030000000000",
            "tdzsfs_dm": "string",
            "uuid": "string",
            "xgrq": "string",
            "xgrsfid": "string",
            "xh": "string",
            "xmmc": "string",
            "xsfdsjswjg_dm": "string",
            "xsfssjswjg_dm": "string",
            "xsfzgswj_dm": "string",
            "ywqd_dm": "string"
        }
    ],
    "hzqrxxztdm": "string",
    "jazslx_dm": "string",
    "jshj": "string",
    "jshjdx": "拾捌元整",
    "kpfdjxh": "string",
    "kpfnsrsbh": "string",
    "kpr": "string",
    "lrfsf": "string",
    "lrrq": "string",
    "lrrsfid": "string",
    "lzfpTdyslxdm": "string",
    "lzfp_dm": "string",
    "lzfp_hm": "string",
    "lzfplx_dm2": "string",
    "lzfplxdm": "string",
    "lzfppzdm": "string",
    "lzfpqd_hm": "string",
    "lzhjje": "16.98",
    "lzhjse": "1.02",
    "lzkprq": "string",
    "mobile": "string",
    "mx_button_ctrl_dm": [
        "string"
    ],
    "nsrsbh": "91320110MA0000000000",
    "qrfmc": "string",
    "qrjkpbz": "string",
    "qrjkpbztxbz": "string",
    "qrjkpxgbz": "string",
    "qrrq": "string",
    "reqid": "string",
    "sflzfp": "string",
    "sfzzfpbz": "string",
    "sjcsdq": "string",
    "sjgsdq": "string",
    "sjtb_sj": "string",
    "tdyslxdm": "string",
    "uuid": "string",
    "xfsytdm": "string",
    "xgrq": "string",
    "xgrsfid": "string",
    "xhf_mc": "string",
    "xhf_nsrsbh": "string",
    "xhqd_bz": "string",
    "xsfdsjswjg_dm": "string",
    "xsfnsrsbh": "string",
    "xsfssjswjg_dm": "string",
    "xsfzgswj_dm": "string",
    "ybfhcbz": "string",
    "ykjhzfpbz": "string",
    "ywqd_dm": "string",
    "yxbz": "string",
    "zzsytdm": "string"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://agentapi.lingshuibao.com/agent/tax/v1/invoice/red_confirm/ation_sheet_issue?appid&timestamp&sign' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bz": "string",
    "cezslxdm": "string",
    "chyydm": "string",
    "dfnsrmc": "string",
    "dfnsrsbh": "string",
    "dqnsrsbh": "string",
    "dsfmc": "string",
    "dsfnsrsbh": "string",
    "fpkjfs_dm": "string",
    "fplydm": "string",
    "fprzztdm": "string",
    "ghf_mc": "string",
    "ghf_nsrsbh": "string",
    "gjbq": "string",
    "gmfdsjswjg_dm": "string",
    "gmfssjswjg_dm": "string",
    "gmfzgswj_dm": "string",
    "gxsf": "string",
    "hzcxje": "-16.98",
    "hzcxse": "-1.02",
    "hzfphm": "string",
    "hzfplxdm2": "string",
    "hzfpxxqrdbh": "string",
    "hzkprq": "string",
    "hzqrdmxsl": "string",
    "hzqrxxmx_list": [
        {
            "dw": "string",
            "fpspdj": "string",
            "fpspsl": "string",
            "ggxh": "string",
            "gmfdsjswjg_dm": "string",
            "gmfssjswjg_dm": "string",
            "gmfzgswj_dm": "string",
            "hwhyslwfwmc": "string",
            "hzqrxxuuid": "string",
            "is_show_sl": true,
            "je": "-16.98",
            "lrrq": "string",
            "lrrsfid": "string",
            "lzfp_dm": "string",
            "lzfp_hm": "string",
            "lzmxxh": "string",
            "se": "-1.02",
            "sjcsdq": "string",
            "sjgsdq": "string",
            "sjtb_sj": "string",
            "sl": "0.06",
            "spfwjc": "string",
            "sphfwssflhbbm": "3040201030000000000",
            "tdzsfs_dm": "string",
            "uuid": "string",
            "xgrq": "string",
            "xgrsfid": "string",
            "xh": "string",
            "xmmc": "string",
            "xsfdsjswjg_dm": "string",
            "xsfssjswjg_dm": "string",
            "xsfzgswj_dm": "string",
            "ywqd_dm": "string"
        }
    ],
    "hzqrxxztdm": "string",
    "jazslx_dm": "string",
    "jshj": "string",
    "jshjdx": "拾捌元整",
    "kpfdjxh": "string",
    "kpfnsrsbh": "string",
    "kpr": "string",
    "lrfsf": "string",
    "lrrq": "string",
    "lrrsfid": "string",
    "lzfpTdyslxdm": "string",
    "lzfp_dm": "string",
    "lzfp_hm": "string",
    "lzfplx_dm2": "string",
    "lzfplxdm": "string",
    "lzfppzdm": "string",
    "lzfpqd_hm": "string",
    "lzhjje": "16.98",
    "lzhjse": "1.02",
    "lzkprq": "string",
    "mobile": "string",
    "mx_button_ctrl_dm": [
        "string"
    ],
    "nsrsbh": "91320110MA0000000000",
    "qrfmc": "string",
    "qrjkpbz": "string",
    "qrjkpbztxbz": "string",
    "qrjkpxgbz": "string",
    "qrrq": "string",
    "reqid": "string",
    "sflzfp": "string",
    "sfzzfpbz": "string",
    "sjcsdq": "string",
    "sjgsdq": "string",
    "sjtb_sj": "string",
    "tdyslxdm": "string",
    "uuid": "string",
    "xfsytdm": "string",
    "xgrq": "string",
    "xgrsfid": "string",
    "xhf_mc": "string",
    "xhf_nsrsbh": "string",
    "xhqd_bz": "string",
    "xsfdsjswjg_dm": "string",
    "xsfnsrsbh": "string",
    "xsfssjswjg_dm": "string",
    "xsfzgswj_dm": "string",
    "ybfhcbz": "string",
    "ykjhzfpbz": "string",
    "ywqd_dm": "string",
    "yxbz": "string",
    "zzsytdm": "string"
}'

返回响应

🟢200成功
application/json
红字确认单开具结果
Body

示例
{
    "code": 0,
    "data": {
        "cezslxdm": "string",
        "code": "string",
        "dfnsrmc": "string",
        "dfnsrsbh": "string",
        "dqnsrsbh": "string",
        "fplydm": "string",
        "fprzztdm": "string",
        "ghf_mc": "string",
        "ghf_nsrsbh": "string",
        "ghfdsjswjg_dm": "string",
        "ghfssjswjg_dm": "string",
        "ghfzgswj_dm": "string",
        "gjbq": "string",
        "gxsf": "string",
        "hzcxje": "-16.98",
        "hzcxse": "-1.02",
        "hzfp_hm": "string",
        "hzfpxxqrdbh": "string",
        "hzkprq": "string",
        "hzqrdmxsl": "string",
        "hzqrxxmx_list": [
            {
                "dw": "string",
                "fpspdj": "string",
                "fpspsl": "string",
                "ggxh": "string",
                "gmfdsjswjg_dm": "string",
                "gmfssjswjg_dm": "string",
                "gmfzgswj_dm": "string",
                "hwhyslwfwmc": "string",
                "hzqrxxuuid": "string",
                "is_show_sl": true,
                "je": "-16.98",
                "lrrq": "string",
                "lrrsfid": "string",
                "lzfp_dm": "string",
                "lzfp_hm": "string",
                "lzmxxh": "string",
                "se": "-1.02",
                "sjcsdq": "string",
                "sjgsdq": "string",
                "sjtb_sj": "string",
                "sl": "0.06",
                "spfwjc": "string",
                "sphfwssflhbbm": "3040201030000000000",
                "tdzsfs_dm": "string",
                "uuid": "string",
                "xgrq": "string",
                "xgrsfid": "string",
                "xh": "string",
                "xmmc": "string",
                "xsfdsjswjg_dm": "string",
                "xsfssjswjg_dm": "string",
                "xsfzgswj_dm": "string",
                "ywqd_dm": "string"
            }
        ],
        "hzqrxxztdm": "string",
        "jshj": "string",
        "jshjdx": "拾捌元整",
        "lrfsf": "string",
        "lrrq": "string",
        "lrrsfid": "string",
        "lzfpTdyslxdm": "string",
        "lzfp_dm": "string",
        "lzfp_hm": "string",
        "lzfplxdm": "string",
        "lzfppzdm": "string",
        "lzhjje": "16.98",
        "lzhjse": "1.02",
        "lzkprq": "string",
        "message": "string",
        "mxankzdm": "string",
        "nsrsbh": "string",
        "qrfmc": "string",
        "qrjkpbz": "string",
        "qrrq": "string",
        "sfypsdnsrbz": "string",
        "sfzzfpbz": "string",
        "sjcsdq": "string",
        "sjgsdq": "string",
        "sjtbsj": "string",
        "sksfhc_bz": "string",
        "uuid": "string",
        "xfsytdm": "string",
        "xgrq": "string",
        "xgrsfid": "string",
        "xhf_mc": "string",
        "xhf_nsrsbh": "string",
        "xhfdsjswjg_dm": "string",
        "xhfssjswjg_dm": "string",
        "xhfzgswj_dm": "string",
        "xhqd_bz": "string",
        "ykjhzfpbz": "string",
        "ywqddm": "string",
        "yxbz": "string",
        "zzsytdm": "string"
    },
    "msg": "string"
}
🟠400请求有误
🔴500服务器错误
上一页
3.2.3 红字确认单信息生成
下一页
3.2.5 一键红冲接口