# API百宝箱 · 接口聚合开放平台（API百宝箱） > 北京开灵科技有限公司（开灵科技）出品的接口聚合开放平台。把税务与发票领域「公开却难取」的能力，白标成一套统一的 REST 接口：一套签名（X-App-Key / X-Timestamp / X-Sign）、一套错误码（CYT_*）、一套计量，覆盖发票查验、正向开票、反向开票、乐企直连、自然人代开与企业抬头查询。支持云端接入与私有化部署。 ## 关于开灵科技 - 公司全称：北京开灵科技有限公司 - 官网：https://www.kailingteck.com - 开放平台：https://openapi.kailingteck.com - 服务热线：010-60974119｜VIP 专线顾问：185-1389-5936 - 地址：北京市海淀区清河永泰园建金中心 4 层 410 - 备案：京ICP备2022005606号-1 - 业务范围：发票查验、销项开票、进项收票、反向开票（资源回收 / 农产品收购）、乐企直连与联用、自然人代开（劳务 / 货运 / 房租）、电子会计档案、AI-OCR 票据识别、AI 数字员工与企业 Agent 落地。 ## 鉴权与调用约定 - 请求头：`X-App-Key`、`X-Timestamp`（Unix 秒，与服务器时差需在 ±300 秒内）、`X-Sign` - 签名：`X-Sign = sha256(appKey + 时间戳 + 请求报文 + appSecret)`，取小写十六进制 - 返回信封：`code` / `msg` / `requestId` / `timestamp` / `data`，`code = CYT_00000` 表示成功，业务字段都在 `data` 里 - 限流：默认 120 次/分钟，超出返回 `CYT_42901` - 密钥获取：联系开灵商务或项目经理开通；联调期可先用各模块的演示密钥（只走模拟数据） ## 平台 - [API百宝箱 · 发票查验与反向开票接口聚合开放平台](https://openapi.kailingteck.com/)：开灵科技 API百宝箱，一个接口对接六路税务能力：发票查验、正向开票、反向开票、乐企直连、自然人代开、企业抬头查询。统一签名、统一错误码、开箱即用，支持私有化部署。 - [在线沙箱 · 免密钥试跑发票查验接口](https://openapi.kailingteck.com/sandbox)：不用申请密钥，浏览器里直接试跑发票查验接口：数电票、增值税专票普票、区块链电子发票、航空铁路票，填单号即出核验结果与完整报文。 ## 发票查验 - [发票查验接口文档 · 数电票／增值税／区块链全票种](https://openapi.kailingteck.com/docs)：一个 POST 接口查验全票种发票真伪：数电发票、增值税专用发票、普通发票、区块链电子发票、通行费票、航空铁路票。含请求字段、返回字段、错误码与签名算法。 ## 企业信息查询 - [企业抬头与税号查询接口 · 开票抬头自动补全](https://openapi.kailingteck.com/docs/enterprise)：输入企业名称关键字，返回统一社会信用代码、开票地址、电话、开户行与账号，用于开票抬头自动补全与抬头校验。含模糊搜索与精确查询两种用法。 ## 正向开票 - [正向开票接口总览 · 业务流程泳道图](https://openapi.kailingteck.com/docs/forward)：正向开票（销项开票）接口全景：从开票、查结果、红冲、查红票到发票统计对账五个动词，配泳道图讲清系统之间谁调谁、什么时候回调。 - [正向开票在线调试台 · 填表即发真实请求](https://openapi.kailingteck.com/docs/forward/try)：浏览器里直接调正向开票接口：填表生成请求报文、自动算签名、实时看返回，不用写代码就能验证联调参数。 - [开票接口 · 提交开票申请](https://openapi.kailingteck.com/docs/forward/create)：正向开票核心接口：提交购销方信息与商品明细发起开具数电发票，支持多税率、折扣行、清单票与特定业务（建筑服务、不动产、运输等）扩展块。 - [查开票结果接口 · 轮询与回调两种取法](https://openapi.kailingteck.com/docs/forward/query)：按流水号查询开票结果，拿到发票号码、开票日期、价税合计与版式文件下载地址；也可改用开票结果回调，开完即推，不必轮询。 - [红冲接口 · 数电发票红字冲销](https://openapi.kailingteck.com/docs/forward/red)：对已开蓝票发起红字冲销：全额红冲与部分红冲的报文差异、红字确认单流程、以及红冲后如何取回红票文件。 - [查红票接口 · 红字发票开具结果查询](https://openapi.kailingteck.com/docs/forward/red-query)：查询红冲申请的处理结果与红票号码，与蓝票共用同一套回调，靠 notify_type 区分蓝票红票。 - [发票统计与对账接口 · 明细／税率／申报](https://openapi.kailingteck.com/docs/forward/statistic)：一个接口按 type 分四类用法：销项发票明细查询、税率统计、申报统计与结果查询，用于月度对账与申报底稿。 ## 反向开票 - [反向开票接口全集 · 资源回收自然人代开](https://openapi.kailingteck.com/docs/reverse)：反向开票 8 个接口一页看全：查企业开通状态、提交转账开票、收款二维码、查开票状态、取消申请、下载发票、蓝票冲红与冲红状态，含业务泳道图与 AI 接入包。 ## 工商银行·业务型 - [反向开票业务型接口 · 8 个动词直接对接](https://openapi.kailingteck.com/docs/rinv)：把乐企直联 25 个原子接口编排成 8 个业务动词：企业开通、散户入驻、查散户状态、转账并开票、查开票结果、散户改卡注销、红冲作废、下载发票，一个动词一次调用。 - [调用日志(自助查) · 看自己的传参与返回](https://openapi.kailingteck.com/docs/rinv/logs)：用自己的密钥查最近几次调用的完整请求体与返回报文，对接联调时自查，不必再找开灵要日志。只能看到本密钥的记录。 - [反向开票在线调试台 · 业务型接口试跑](https://openapi.kailingteck.com/docs/rinv/try)：在浏览器里试跑反向开票业务型接口：选动词、填参数、自动签名、看真实返回，联调期免写代码。 - [企业开通接口 · 回收企业税务授权](https://openapi.kailingteck.com/docs/rinv/enterprise-open)：回收企业（付款开票方）首次开通：取得税务授权跳转链接，企业法人用电子税务局 App 扫码授权。一次性低频页面类接口。 - [实人认证接口 · 人脸+短信核验本人](https://openapi.kailingteck.com/docs/rinv/face-auth)：独立的实人身份核验:发链接给本人,现场人脸与公安基准照比对加手机号短信验证,每次产生一个独立核验结果。司机打卡、领料签收、现场确认等场景适用,被认证人无需银行卡。 - [散户入驻接口 · 自然人实人认证扫脸](https://openapi.kailingteck.com/docs/rinv/seller-onboard)：自然人（出售方散户）入驻第一步：发起实人认证，取得扫脸链接交本人完成刷脸，认证通过后才能建收款人并开票。 - [建收款人档案接口 · 散户入驻第二步](https://openapi.kailingteck.com/docs/rinv/seller-register)：散户刷脸通过后必须再建收款人档案：把姓名、身份证、收款银行卡报给工行，在回收企业名下建成收款人。刷脸只是实名认证，不等于已入驻，不做这一步开票会被退回。 - [查散户状态接口 · 额度与开票资格全景](https://openapi.kailingteck.com/docs/rinv/seller-status)：一次拿到散户全景：是否实名、500 万年度额度剩余、收款人建档／审核／授权／冻结状态，并直接给出「现在能不能给他开票」的结论。 - [转账并开票接口 · 反向开票核心动词](https://openapi.kailingteck.com/docs/rinv/invoice-create)：反向开票核心接口：传订单与散户信息，内部先过额度闸门，通过后返回付款链接；付款完成后由银行自动开票、代扣个税并打款给散户。 - [查开票结果接口 · 状态归并与取票](https://openapi.kailingteck.com/docs/rinv/invoice-status)：把银行侧 5 个原始状态翻译成一个业务状态，返回发票号码与税额；带 withInvoice=true 时顺带取回 PDF／OFD／XML 票文件。 - [散户改卡与注销接口 · 收款人维护](https://openapi.kailingteck.com/docs/rinv/seller-maintain)：散户入驻后的维护动作：更换收款银行卡、或注销解绑收款人。两个数据类接口，含改卡后何时生效的说明。 - [红冲与作废接口 · 开错票怎么冲掉](https://openapi.kailingteck.com/docs/rinv/invoice-red-void)：开错票、退货时冲掉原票：红冲开一张红票对冲（页面类，需人工确认）,作废直接取消（数据类）。红冲后个税与手续费自动冲退。 - [下载发票接口 · 单张补下载票文件](https://openapi.kailingteck.com/docs/rinv/invoice-download)：单独下载某张发票的版式文件，用于补下载与归档。日常查结果接口带 withInvoice 即可，不必单独调用。 ## 工商银行·乐企直联 - [乐企直联原子接口总览 · 调用时序蓝图](https://openapi.kailingteck.com/docs/icbc)：银行乐企直联反向开票 25 个原子接口的调用时序蓝图：从企业授权、散户扫脸、建收款人、下单付款到开票、红冲、对账，一张图看清先后顺序。 - [企业授权接口 · 出授权二维码](https://openapi.kailingteck.com/docs/icbc/enterprise-auth)：页面类接口：生成企业税务授权页面链接与二维码，由法人或财务负责人用电子税务局 App 登录本企业扫码刷脸完成授权。 - [散户扫脸接口 · 自然人实人认证](https://openapi.kailingteck.com/docs/icbc/face-auth)：发起自然人实人认证，返回扫脸页面链接；散户本人完成人脸核身后才可建收款人。页面类接口。 - [查扫脸结果接口 · 实人认证状态](https://openapi.kailingteck.com/docs/icbc/face-auth-query)：查询自然人实人认证的处理结果，判断是否可以进入建收款人环节。数据类接口。 - [建收款人接口 · 散户建档](https://openapi.kailingteck.com/docs/icbc/receiver-add)：为已完成实人认证的散户建立收款人档案，登记姓名、证件号、银行卡与联系方式，建档后进入审核。 - [入驻审核结果接口 · 收款人审核状态](https://openapi.kailingteck.com/docs/icbc/receiver-audit)：查询收款人建档后的审核结果，审核通过才允许下单开票。数据类接口。 - [查额度接口 · 自然人 500 万红线](https://openapi.kailingteck.com/docs/icbc/person-quota)：查询自然人年度累计开票额度与剩余可开金额，反向开票 500 万红线的闸门接口，下单前必查。 - [预下单接口 · 提交开票信息](https://openapi.kailingteck.com/docs/icbc/order-pre)：提交收购订单与开票信息生成待付款单据，返回订单号供后续付款接口使用。数据类接口。 - [付款接口 · 反向开票的扳机](https://openapi.kailingteck.com/docs/icbc/order-pay)：整条反向开票链路的扳机接口：付款成功后自动触发开票、代扣个税与向散户打款。付款前请先确认额度与收款人状态。 - [批量付款开票接口 · 一次付多单](https://openapi.kailingteck.com/docs/icbc/order-batch-pay)：一次提交多张待付款单据批量付款并开票，适用于收购量大的场景，含批次结果的分单查询方式。 - [开票通知接口 · 开票结果回调](https://openapi.kailingteck.com/docs/icbc/invoice-notify)：开票完成后由上游主动推送结果到你配置的回调地址，含回调报文字段、验签方式与重试策略。 - [查开票状态接口 · 单据开票进度](https://openapi.kailingteck.com/docs/icbc/invoice-query)：按订单号查询开票进度与发票号码，回调没收到时的兜底查询手段。数据类接口。 - [下载发票接口 · 取版式文件](https://openapi.kailingteck.com/docs/icbc/invoice-download)：按发票号码取回 PDF／OFD／XML 版式文件，用于交付、归档与电子会计档案入库。 - [散户改卡接口 · 修改收款人](https://openapi.kailingteck.com/docs/icbc/receiver-update)：修改已建档收款人的银行卡与联系方式，含改卡后的生效时点与常见拒绝原因。 - [散户注销接口 · 删除收款人](https://openapi.kailingteck.com/docs/icbc/receiver-delete)：注销并删除收款人档案，解除与回收企业的绑定关系。注销后需重新入驻才能再次开票。 - [查散户接口 · 查询收款人档案](https://openapi.kailingteck.com/docs/icbc/receiver-query)：按证件号或收款人编号查询已建档散户的档案信息与当前状态。数据类接口。 - [红冲接口 · 红字冲销开票](https://openapi.kailingteck.com/docs/icbc/invoice-red-offset)：对已开蓝票发起红字冲销，生成红字确认单并开出红票；红冲后已代扣的个税与手续费自动冲退。页面类接口。 - [撤销红字确认单接口](https://openapi.kailingteck.com/docs/icbc/invoice-red-offset-revoke)：红字确认单提交后、红票开出前的撤销通道，用于填错撤回。含可撤销的时间窗口说明。 - [作废接口 · 发票取消](https://openapi.kailingteck.com/docs/icbc/invoice-reversal)：当期未交付的发票直接作废取消，与红冲的适用场景差异、以及作废失败的常见原因。数据类接口。 - [退税接口 · 再生资源专用](https://openapi.kailingteck.com/docs/icbc/invoice-back-tax)：仅再生资源业务适用的退税接口，用于红冲或退货后申请已缴税款退还。含适用条件与受理状态。 - [对账单接口 · SFTP 取文件机制](https://openapi.kailingteck.com/docs/icbc/reconcile)：对账单不走 HTTP 而走 SFTP 取文件，含目录约定、文件命名规则、字段口径与与接口数据对不上的排查顺序。 - [查开票人登记确认接口 · 授权办完没有](https://openapi.kailingteck.com/docs/icbc/register-confirm)：查询开票人员是否已完成登记确认，开票前的硬条件之一：登记人数为 0 时通道再通也开不出票。 - [票源体检接口 · 还能开多少票](https://openapi.kailingteck.com/docs/icbc/ticket-info)：查询税局票源情况：停开标志、已下载额度、已下载未使用金额、剩余份数与额度有效期，判断还能不能继续开票。 - [授权续期接口 · 免得再找老板扫码](https://openapi.kailingteck.com/docs/icbc/refresh-auth)：在授权到期前发起续期，避免再次组织法人扫码刷脸。含可续期时间窗口与失败处理。 - [开票失败重推接口 · 重试一次](https://openapi.kailingteck.com/docs/icbc/upload-retry)：开票上传失败后触发一次重推，适用于税局侧偶发超时；含可重推的失败类型与不可重推的情形。 - [按月对账接口 · 蓝票红票税额汇总](https://openapi.kailingteck.com/docs/icbc/summary-confirm)：按月查询蓝票张数金额、红票张数金额与已缴税费，以及确认状态，用于月度申报前的核对。 - [白标 H5 · 发条链接就办开通](https://openapi.kailingteck.com/docs/icbc/h5)：终端用户手机上不持任何密钥：后端换一条一次性链接发给企业法人或散户本人，点开即可办企业授权与散户入驻。页面可按客户品牌白标。 ## 银联商务 - [农产品反向开票接口 · 业务型与原子接口全集](https://openapi.kailingteck.com/docs/unionpay)：农产品收购反向开票接口全集：12 个业务动词加 26 个原子接口，含 OPEN-BODY-SIG 签名说明、商户绑定登记、自然人实名、开票红冲与时序图。 ## 乐企联用·报废产品收购 - [报废产品收购反向开票接口 · 9 个业务动词](https://openapi.kailingteck.com/docs/leqi-scrap)：乐企联用报废产品收购反向开票：纳税人资格判定、代征税款校验、待办核查、出售方核验、计税建单、缴税状态、开票、退税与撤单九个业务接口。 - [判断纳税人开票资格接口](https://openapi.kailingteck.com/docs/leqi-scrap/taxpayer-check)：一次调用同时查纳税人基本信息与风险信息（信用等级、风险类型、预警级别）,合并研判直接给出能否开票的结论。建单前第一道闸。 - [代征税款资格校验接口](https://openapi.kailingteck.com/docs/leqi-scrap/agent-tax-check)：校验回收企业是否具备代征代缴资格与相应税种登记，决定开票时税款由谁承担、怎么缴。 - [待办事项核查接口](https://openapi.kailingteck.com/docs/leqi-scrap/pending-check)：查询税局侧是否存在阻断开票的待办事项，避免建单后才发现被拦。数据类接口。 - [出售方核验接口 · 自然人身份校验](https://openapi.kailingteck.com/docs/leqi-scrap/seller-check)：核验出售方（自然人或个体户）的身份信息与开票资格，含证件校验与额度提示。 - [计税建单接口 · 算税并生成单据](https://openapi.kailingteck.com/docs/leqi-scrap/tax-calc-order)：按收购金额与品目自动计算应缴税费并生成待缴税单据，返回税额明细与缴款标识。 - [缴税状态查询接口](https://openapi.kailingteck.com/docs/leqi-scrap/tax-pay-status)：查询建单后的缴税进度，缴税成功才可进入开票环节。数据类接口。 - [开票接口 · 报废产品收购发票开具](https://openapi.kailingteck.com/docs/leqi-scrap/invoice-create)：缴税完成后发起开票，开具报废产品收购反向开票发票，返回发票号码与版式文件地址。 - [退税申请接口](https://openapi.kailingteck.com/docs/leqi-scrap/refund-apply)：撤单或红冲后申请已缴税款退还，含受理条件、退税进度查询与常见驳回原因。 - [撤单接口 · 取消收购单据](https://openapi.kailingteck.com/docs/leqi-scrap/order-cancel)：开票前撤销已建单据，释放占用的税款与额度。含可撤销的状态条件。 ## 乐企数字开放平台 - [乐企数字开放平台接入指引 · 从申请到联调](https://openapi.kailingteck.com/docs/leqi)：国家税务总局乐企数字开放平台的接入路径：资格申请、报备材料、凭证配置、加解密与验签要点，以及自建与联用两条路线怎么选。 - [乐企接口目录 · 服务编码总表](https://openapi.kailingteck.com/docs/leqi/api)：乐企平台服务编码目录：开票域、查询域、申报域各服务编码与用途对照，便于按业务定位该调哪个服务。 - [乐企下载中心 · 规范文档与工具包](https://openapi.kailingteck.com/docs/leqi/downloads)：乐企对接需要的规范文档、字段说明与加解密工具包集中下载，免去在多处翻找。 ## 乐企开票·支付宝 - [乐企开票开通接口 · 商户开通与授权](https://openapi.kailingteck.com/docs/alipay)：乐企开票能力的开通类接口：商户签约、税务授权、开通状态查询，是走通支付即开票的前置步骤。 - [支付即开票接口 · 正向开票](https://openapi.kailingteck.com/docs/alipay/forward)：交易支付完成后自动开票的正向开票接口：开票申请、结果查询、红冲与票面推送，适用于成品油、零售等高频开票场景。 - [订单交易接口 · 反向开票](https://openapi.kailingteck.com/docs/alipay/reverse)：反向开票场景下的订单交易类接口：建单、支付、开票与状态回查，含与正向开票的差异说明。 ## AI 接入包（纯 Markdown，可直接喂给大模型写对接代码） - [发票查验 AI 接入包](https://openapi.kailingteck.com/api/skill/verify) - [企业抬头查询 AI 接入包](https://openapi.kailingteck.com/api/skill/enterprise) - [正向开票 AI 接入包](https://openapi.kailingteck.com/api/skill/forward) - [反向开票 AI 接入包](https://openapi.kailingteck.com/api/skill/reverse) - [反向开票业务型接口 AI 接入包](https://openapi.kailingteck.com/api/skill/rinv) - [乐企联用报废产品收购 AI 接入包](https://openapi.kailingteck.com/api/skill/leqi-scrap) ## 常见问题 ### 发票查验接口支持哪些票种？ 支持全电发票（数电票）、增值税专用发票、增值税普通发票、区块链电子发票、通行费电子发票，以及航空运输电子客票行程单与铁路电子客票。同一个接口按票种自动路由，调用方只需按票种传对应字段。 ### 什么是反向开票？和普通开票有什么区别？ 反向开票是由收购方（如资源回收企业、农产品收购企业）向出售方（自然人散户）开具发票，与常规由销售方开票的方向相反。适用于报废产品收购、农产品收购等出售方无法自行开票的场景，开票同时完成代扣代缴个人所得税与款项支付。 ### 自然人反向开票有额度限制吗？ 有。同一自然人在同一年度内通过反向开票取得的销售额存在上限（常见口径为 500 万元）,超过后不能继续以自然人身份反向开票。平台提供额度查询接口，建议在下单开票前先查额度，避免开票失败。 ### 乐企联用的开票额度是怎么分配的？ 有额度这一说。税务机关会给企业核定一个开票额度，接入乐企平台后，平台会从税局端把额度下载一部分到平台侧使用，首次开通通常下载三成。当月额度不够时可以手工再下载，次月一般自动把上月额度续下来，也可以约定按五成到八成的固定比例下载，用不完的部分能手工退回税局端。需要特别注意的是，已下载到乐企平台的额度相当于被这个通道占用，企业在其他渠道（包括自行登录电子税务局开票）不能再使用这部分额度。举例来说，企业核定总额度一百万元、乐企侧已下载五十万元，那么在电子税务局能用的就只剩五十万元。平台提供额度查询接口，可实时查看税局端核定额度、已下载额度、已下载未使用额度以及剩余可开份数，建议在开票前先查一次，避免额度不足导致开票失败。 ### 接入需要准备什么？多久能跑通？ 需要企业营业执照、税号与开票相关授权，由开灵科技签发 AppKey 与 AppSecret。联调期可先用各模块的演示密钥试跑，一般接口调试约 1 周、切换生产约 1 周。在线沙箱不需要密钥即可先体验。 ### 接口怎么鉴权？签名怎么算？ 请求头带 X-App-Key、X-Timestamp、X-Sign 三个字段。签名算法为 sha256(appKey + 时间戳 + 请求报文 + appSecret),取小写十六进制。时间戳为 Unix 秒级，与服务器时差需在 ±300 秒内，用于防重放。 ### 支持私有化部署吗？数据会不会外泄？ 支持。面向国央企、外资企业等对数据自主可控要求高的客户提供私有化部署，支持主流国产操作系统与数据库。平台侧只做转发与计量，不留存业务明细的敏感字段；云端部署已通过等保三级测评。 ### 怎么获取 AppKey 和 AppSecret？ 调用正式接口需要密钥，请联系开灵商务或您的开灵项目经理开通，服务热线 010-60974119。联调阶段可先使用文档中各模块提供的演示密钥，演示密钥只走模拟数据，不消耗真实额度。 ## Optional - [全文索引 llms-full.txt](https://openapi.kailingteck.com/llms-full.txt)：把全部 AI 接入包拼在一起的长文本 - [在线沙箱](https://openapi.kailingteck.com/sandbox)：不用密钥即可试跑发票查验 - [开灵科技官网](https://www.kailingteck.com)