你要的接口,
百宝箱里都有
开灵科技 API百宝箱把"公开却难取"的税务能力,封装成开箱即用的 REST 接口:发票查验、正向开票、反向开票、乐企直连、自然人代开、企业抬头查询, 一套签名、一套错误码全部打通,支持云端接入与私有化部署。
# 一次调用,核验数电发票真伪 curl -X POST .../api/v1/verify/einvoice -H "X-App-Key: cyt_xxx" -d '{"cyList":[{"fphm":"2611...","jshj":377}]}' # 返回(节选) { "code": "CYT_00000", "verified": true, "销方": "北京祥瑞南门餐饮", "价税合计": 377.00, "状态": "正常" }
https://openapi.kailingteck.com/api/v1/verify支持票种
主流发票全覆盖
为生产环境而生
把发票真伪验证,变成一行 API 调用。
接口能力总览
一个平台对接六路税务能力,按业务场景直接挑接口。
发票查验接口
数电票、增值税专用发票与普通发票、区块链电子发票、通行费、航空铁路票,一个地址全票种查验。
查看接口文档 →企业抬头与税号查询
输名称出统一社会信用代码、开票地址、开户行账号,开票抬头自动补全。
查看接口文档 →正向开票接口
开票、查结果、红冲、查红票、发票统计与对账,五个动词覆盖销项全流程。
查看接口文档 →反向开票接口
资源回收、报废产品收购场景,向自然人散户开票并代扣代缴、自动打款。
查看接口文档 →反向开票业务型接口
把 25 个原子接口编排成 8 个业务动词,企业开通到开票下载一个动词一次调用。
查看接口文档 →农产品收购反向开票
农产品收购场景的业务型与原子接口全集,含商户绑定、自然人实名与开票红冲。
查看接口文档 →报废产品收购反向开票
乐企联用九个业务动词:资格判定、计税建单、缴税、开票、退税与撤单。
查看接口文档 →支付即开票
交易支付完成即自动开票,适用于成品油、零售等高频开票场景。
查看接口文档 →常见问题
接入前最常被问到的几件事,先在这里说清楚。
发票查验接口支持哪些票种?
+
支持全电发票(数电票)、增值税专用发票、增值税普通发票、区块链电子发票、通行费电子发票,以及航空运输电子客票行程单与铁路电子客票。同一个接口按票种自动路由,调用方只需按票种传对应字段。
什么是反向开票?和普通开票有什么区别?
+
反向开票是由收购方(如资源回收企业、农产品收购企业)向出售方(自然人散户)开具发票,与常规由销售方开票的方向相反。适用于报废产品收购、农产品收购等出售方无法自行开票的场景,开票同时完成代扣代缴个人所得税与款项支付。
自然人反向开票有额度限制吗?
+
有。同一自然人在同一年度内通过反向开票取得的销售额存在上限(常见口径为 500 万元),超过后不能继续以自然人身份反向开票。平台提供额度查询接口,建议在下单开票前先查额度,避免开票失败。
乐企联用的开票额度是怎么分配的?
+
有额度这一说。税务机关会给企业核定一个开票额度,接入乐企平台后,平台会从税局端把额度下载一部分到平台侧使用,首次开通通常下载三成。当月额度不够时可以手工再下载,次月一般自动把上月额度续下来,也可以约定按五成到八成的固定比例下载,用不完的部分能手工退回税局端。需要特别注意的是,已下载到乐企平台的额度相当于被这个通道占用,企业在其他渠道(包括自行登录电子税务局开票)不能再使用这部分额度。举例来说,企业核定总额度一百万元、乐企侧已下载五十万元,那么在电子税务局能用的就只剩五十万元。平台提供额度查询接口,可实时查看税局端核定额度、已下载额度、已下载未使用额度以及剩余可开份数,建议在开票前先查一次,避免额度不足导致开票失败。
接入需要准备什么?多久能跑通?
+
需要企业营业执照、税号与开票相关授权,由开灵科技签发 AppKey 与 AppSecret。联调期可先用各模块的演示密钥试跑,一般接口调试约 1 周、切换生产约 1 周。在线沙箱不需要密钥即可先体验。
接口怎么鉴权?签名怎么算?
+
请求头带 X-App-Key、X-Timestamp、X-Sign 三个字段。签名算法为 sha256(appKey + 时间戳 + 请求报文 + appSecret),取小写十六进制。时间戳为 Unix 秒级,与服务器时差需在 ±300 秒内,用于防重放。
支持私有化部署吗?数据会不会外泄?
+
支持。面向国央企、外资企业等对数据自主可控要求高的客户提供私有化部署,支持主流国产操作系统与数据库。平台侧只做转发与计量,不留存业务明细的敏感字段;云端部署已通过等保三级测评。
怎么获取 AppKey 和 AppSecret?
+
调用正式接口需要密钥,请联系开灵商务或您的开灵项目经理开通,服务热线 010-60974119。联调阶段可先使用文档中各模块提供的演示密钥,演示密钥只走模拟数据,不消耗真实额度。
