跳到正文
开灵科技 - 北京开灵科技有限公司API百宝箱
发票查验 · 正向开票 · 反向开票 · 乐企直连 —— 均已上线实测

你要的接口,
百宝箱里都有

开灵科技 API百宝箱把"公开却难取"的税务能力,封装成开箱即用的 REST 接口:发票查验、正向开票、反向开票、乐企直连、自然人代开、企业抬头查询, 一套签名、一套错误码全部打通,支持云端接入与私有化部署。

8+ 票种覆盖99.9% 可用性目标~2s 平均响应
POST /api/v1/verify/einvoice
# 一次调用,核验数电发票真伪
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,
  "状态": "正常" }
统一查验接口地址
全票种一个地址,传字段即可
POSThttps://openapi.kailingteck.com/api/v1/verify

支持票种

主流发票全覆盖

数电普通发票数电专用发票数电纸质发票增值税普通发票增值税专用发票电子普通发票通行费发票区块链发票

为生产环境而生

把发票真伪验证,变成一行 API 调用。

统一接口规范
一套字段、一套错误码,屏蔽数电票/增值税票/区块链票等多平台差异,接一次覆盖全票种。
签名鉴权 + 防重放
App 凭据签名校验,时间戳防重放,凭据全程不外泄,调用日志可审计追溯。
极速接入
cURL / Node / Java 即用示例,在线沙箱实时联调,数分钟完成对接上线。
多源容灾
后端聚合底层查验源,可灰度切换上游通道,客户侧零感知、零改造。
配额与计费
按租户独立签发密钥,配额、启停、用量看板一应俱全,计费透明可控。
税局口径一致
查验结果对齐全国增值税发票查验平台,返回全票面要素与最新发票状态。

接口能力总览

一个平台对接六路税务能力,按业务场景直接挑接口。

常见问题

接入前最常被问到的几件事,先在这里说清楚。

发票查验接口支持哪些票种?

+

支持全电发票(数电票)、增值税专用发票、增值税普通发票、区块链电子发票、通行费电子发票,以及航空运输电子客票行程单与铁路电子客票。同一个接口按票种自动路由,调用方只需按票种传对应字段。

什么是反向开票?和普通开票有什么区别?

+

反向开票是由收购方(如资源回收企业、农产品收购企业)向出售方(自然人散户)开具发票,与常规由销售方开票的方向相反。适用于报废产品收购、农产品收购等出售方无法自行开票的场景,开票同时完成代扣代缴个人所得税与款项支付。

自然人反向开票有额度限制吗?

+

有。同一自然人在同一年度内通过反向开票取得的销售额存在上限(常见口径为 500 万元),超过后不能继续以自然人身份反向开票。平台提供额度查询接口,建议在下单开票前先查额度,避免开票失败。

乐企联用的开票额度是怎么分配的?

+

有额度这一说。税务机关会给企业核定一个开票额度,接入乐企平台后,平台会从税局端把额度下载一部分到平台侧使用,首次开通通常下载三成。当月额度不够时可以手工再下载,次月一般自动把上月额度续下来,也可以约定按五成到八成的固定比例下载,用不完的部分能手工退回税局端。需要特别注意的是,已下载到乐企平台的额度相当于被这个通道占用,企业在其他渠道(包括自行登录电子税务局开票)不能再使用这部分额度。举例来说,企业核定总额度一百万元、乐企侧已下载五十万元,那么在电子税务局能用的就只剩五十万元。平台提供额度查询接口,可实时查看税局端核定额度、已下载额度、已下载未使用额度以及剩余可开份数,建议在开票前先查一次,避免额度不足导致开票失败。

接入需要准备什么?多久能跑通?

+

需要企业营业执照、税号与开票相关授权,由开灵科技签发 AppKey 与 AppSecret。联调期可先用各模块的演示密钥试跑,一般接口调试约 1 周、切换生产约 1 周。在线沙箱不需要密钥即可先体验。

接口怎么鉴权?签名怎么算?

+

请求头带 X-App-Key、X-Timestamp、X-Sign 三个字段。签名算法为 sha256(appKey + 时间戳 + 请求报文 + appSecret),取小写十六进制。时间戳为 Unix 秒级,与服务器时差需在 ±300 秒内,用于防重放。

支持私有化部署吗?数据会不会外泄?

+

支持。面向国央企、外资企业等对数据自主可控要求高的客户提供私有化部署,支持主流国产操作系统与数据库。平台侧只做转发与计量,不留存业务明细的敏感字段;云端部署已通过等保三级测评。

怎么获取 AppKey 和 AppSecret?

+

调用正式接口需要密钥,请联系开灵商务或您的开灵项目经理开通,服务热线 010-60974119。联调阶段可先使用文档中各模块提供的演示密钥,演示密钥只走模拟数据,不消耗真实额度。

几分钟接入,开始查验

在线沙箱免费体验,真实票种实时核验。准备好后在控制台签发密钥即可上线。