灵税宝AgentAPI
  1. 3.4 发票开具服务
灵税宝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.2 接口协议说明
      • 3.2.1 税务接口通信协议
      • 3.2.1 接口鉴权
    • 3.3 账户服务
      • 3.3.1 单位账户登录
      • 3.3.2 登录状态查询
    • 3.4 发票开具服务
      • 3.4.4 授信额度查询
        POST
      • 3.4.6 一般发票开具
        POST
    • 3.5 发票查询服务
      • 3.5.1 近十张发票查询接口
      • 3.5.6 发票下载
    • 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.4 发票开具服务

3.4.6 一般发票开具

POST
/agent/tax/v1/invoice/issu

接口说明#

此接口用于一般发票开具,目前支持通用蓝字 / 红字发票和差额票的开具。

约束条件#

1.
调用 3.3.1 单位账户登录 接口成功;
2.
开具出口退税发票时,购方企业必须是"外贸综合服务"企业
3.
开具数电纸票时需要先请求"全电纸票发票种类查询"接口
4.
开票请求不能缺少节点,差额发票和附加要素列表字段不需要时也需传空值

请求参数

Query 参数
appid
string 
必需
用户唯一凭证,由平台提供
示例值:
Zu4PXFeyu7gX
timestamp
string 
Unix时间戳
必需
示例值:
1746979999
sign
string 
必需
hmac+sha256 加密
示例值:
d88b1f5c2ec5b8e016b8523edd5977e7549d6d73c3c01a0724410951c7be2b39
Body 参数application/json
fpkjxx_fptxx
#/definitions/171620681
必需
Could not resolve '#/definitions/171620681'
fpkjxx_xmxxs
$ref(#/definitions/171620682)[]
发票明细
必需
Could not resolve '#/definitions/171620682'
#/definitions/171620682
可选
Could not resolve '#/definitions/171620682'
zfxx_list
$ref(#/definitions/171620711)[]
支付信息
可选
数电票时选填
Could not resolve '#/definitions/171620711'
#/definitions/171620711
可选
Could not resolve '#/definitions/171620711'
cepzmxs
array[object (schema.Cepzmx) {13}] 
差额发票
可选
开具差额发票时必填
bckcje
string 
本次扣除金额
可选
bz
string 
备注
可选
fpdm
string 
发票代码
可选
fphm
string 
发票号码
可选
hjje
string 
合计金额
可选
kce
string 
扣除额
可选
kjrq
string 
开具日期
可选
lrfs
string 
录入方式
可选
pzhjje
string 
凭证合计金额
可选
pzhm
string 
凭证号码
可选
pzlx
string 
票种类型
可选
xh
string 
序号
可选
zzfphm
string 
纸质发号码
可选
fjys_xxs
$ref(#/definitions/171620680)[]
附加要素列表
可选
附加要素列表全字段都要传,可以没有值
Could not resolve '#/definitions/171620680'
#/definitions/171620680
可选
Could not resolve '#/definitions/171620680'
示例
{
    "reqid": "20250601230114752263864",
    "nsrsbh": "91530302MAD475743B",
    "mobile": "13004160225",
    "fpkjxx_fptxx": {
        "fpqqlsh": "20250601230114751937800",
        "nsrmc": "灵税宝(曲靖)网络有限公司",
        "nsrsbh": "91530302MAD475743B",
        "kpxm": "*信息技术服务*数据处理服务",
        "kplx": "1",
        "bmb_bbh": "",
        "xhfmc": "灵税宝(曲靖)网络有限公司",
        "xhf_nsrsbh": "91530302MAD475743B",
        "xhf_dzdh": "0874-3284919,云南省曲靖市麒麟区沿江街道办事处东海屯路346号曲靖麒麟人力资源服务产业园212号",
        "xhf_yhzh": "平安银行股份有限公司昆明巫家坝支行,15450474610023",
        "xhf_dz": "云南省曲靖市麒麟区沿江街道办事处东海屯路346号曲靖麒麟人力资源服务产业园212号",
        "xhf_dh": "0874-3284919",
        "xhf_yh": "平安银行股份有限公司昆明巫家坝支行",
        "xhf_zh": "15450474610023",
        "ghfqylx": "01",
        "ghfmc": "云南新视数据管理有限公司",
        "ghf_nsrsbh": "91530111MAC0A1J15D",
        "ghf_dzdh": "中国(云南)自由贸易试验区昆明片区官渡区矣六街道办事处观云海千云荟一号楼3层0302号,15368864099",
        "ghf_yhzh": "中国民生银行股份有限公司昆明螺蛳湾支行,637404546",
        "ghf_dz": "中国(云南)自由贸易试验区昆明片区官渡区矣六街道办事处观云海千云荟一号楼3层0302号",
        "ghf_dh": "15368864099",
        "ghf_yh": "中国民生银行股份有限公司昆明螺蛳湾支行",
        "ghf_zh": "637404546",
        "sfzsgmfyhzh": "N",
        "sfzsxsfyhzh": "N",
        "fpzl_dm": "81",
        "xsfzrr_bz": "N",
        "gmfzrr_bz": "N",
        "zzfp_bz": "N",
        "kphjje": "18.00",
        "hjbhsje": "16.98",
        "hjse": "1.02",
        "bz": "",
        "is_dae": ""
    },
    "fpkjxx_xmxxs": [
        {
            "xh": "001",
            "fphxz": "0",
            "xmmc": "*信息技术服务*数据处理服务",
            "xmdw": "项",
            "ggxh": "次",
            "xmsl": "1",
            "xmdj": "16.98",
            "hsbz": "0",
            "spbm": "3040201030000000000",
            "yhzcbs": "0",
            "lslbs": "",
            "xmje": "16.98",
            "sl": "0.06",
            "se": "1.02"
        }
    ]
}

示例代码

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/issu?appid=Zu4PXFeyu7gX&timestamp=1746979999&sign=d88b1f5c2ec5b8e016b8523edd5977e7549d6d73c3c01a0724410951c7be2b39' \
--header 'Content-Type: application/json' \
--data-raw '{
    "reqid": "20250601230114752263864",
    "nsrsbh": "91530302MAD475743B",
    "mobile": "13004160225",
    "fpkjxx_fptxx": {
        "fpqqlsh": "20250601230114751937800",
        "nsrmc": "灵税宝(曲靖)网络有限公司",
        "nsrsbh": "91530302MAD475743B",
        "kpxm": "*信息技术服务*数据处理服务",
        "kplx": "1",
        "bmb_bbh": "",
        "xhfmc": "灵税宝(曲靖)网络有限公司",
        "xhf_nsrsbh": "91530302MAD475743B",
        "xhf_dzdh": "0874-3284919,云南省曲靖市麒麟区沿江街道办事处东海屯路346号曲靖麒麟人力资源服务产业园212号",
        "xhf_yhzh": "平安银行股份有限公司昆明巫家坝支行,15450474610023",
        "xhf_dz": "云南省曲靖市麒麟区沿江街道办事处东海屯路346号曲靖麒麟人力资源服务产业园212号",
        "xhf_dh": "0874-3284919",
        "xhf_yh": "平安银行股份有限公司昆明巫家坝支行",
        "xhf_zh": "15450474610023",
        "ghfqylx": "01",
        "ghfmc": "云南新视数据管理有限公司",
        "ghf_nsrsbh": "91530111MAC0A1J15D",
        "ghf_dzdh": "中国(云南)自由贸易试验区昆明片区官渡区矣六街道办事处观云海千云荟一号楼3层0302号,15368864099",
        "ghf_yhzh": "中国民生银行股份有限公司昆明螺蛳湾支行,637404546",
        "ghf_dz": "中国(云南)自由贸易试验区昆明片区官渡区矣六街道办事处观云海千云荟一号楼3层0302号",
        "ghf_dh": "15368864099",
        "ghf_yh": "中国民生银行股份有限公司昆明螺蛳湾支行",
        "ghf_zh": "637404546",
        "sfzsgmfyhzh": "N",
        "sfzsxsfyhzh": "N",
        "fpzl_dm": "81",
        "xsfzrr_bz": "N",
        "gmfzrr_bz": "N",
        "zzfp_bz": "N",
        "kphjje": "18.00",
        "hjbhsje": "16.98",
        "hjse": "1.02",
        "bz": "",
        "is_dae": ""
    },
    "fpkjxx_xmxxs": [
        {
            "xh": "001",
            "fphxz": "0",
            "xmmc": "*信息技术服务*数据处理服务",
            "xmdw": "项",
            "ggxh": "次",
            "xmsl": "1",
            "xmdj": "16.98",
            "hsbz": "0",
            "spbm": "3040201030000000000",
            "yhzcbs": "0",
            "lslbs": "",
            "xmje": "16.98",
            "sl": "0.06",
            "se": "1.02"
        }
    ]
}'

返回响应

🟢200成功
application/json
Body
allOf {2} 
可选
object (ginx.OkResult) 
可选
code
integer 
错误码
可选
data
可选
msg
string 
错误信息
可选
object 
可选
data
#/definitions/172726479
可选
Could not resolve '#/definitions/172726479'
示例
{
    "code": 0,
    "data": {
        "fp_hm": "25532000000055871314",
        "zzfp_hm": "",
        "fp_dm": "",
        "kprq": "2025-05-1 09:56:55",
        "xhf_nsrsbh": "",
        "xhf_mc": "",
        "jshj": "",
        "bzxx": "",
        "hzfpxxqrdbh": ""
    },
    "msg": ""
}
🟠400请求有误
🔴500服务器错误
上一页
3.4.4 授信额度查询
下一页
3.5.1 近十张发票查询接口