{"openapi":"3.0.3","info":{"title":"API百宝箱 · 发票查验接口","version":"1.0.0","description":"统一一个接口覆盖全票种发票真伪查验,按地区码 dq 自动路由。判断真伪看 data.verified。"},"servers":[{"url":"https://openapi.kailingteck.com"}],"paths":{"/api/v1/verify":{"post":{"summary":"发票查验","description":"传入发票字段进行真伪核验。不同票种传不同字段:数电票=发票号码+开票日期+价税合计;专票+不含税金额;普票+校验码后6位;区块链/通用电子需带地区码 dq。","parameters":[{"name":"X-App-Key","in":"header","required":true,"schema":{"type":"string"},"description":"平台分配的 app_key"},{"name":"X-Timestamp","in":"header","required":true,"schema":{"type":"string"},"description":"Unix 秒级时间戳"},{"name":"X-Sign","in":"header","required":true,"schema":{"type":"string"},"description":"sha256(appKey+timestamp+body+appSecret) 小写 hex"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyRequest"},"examples":{"数电普票":{"value":{"fphm":"26112000002558759236","kprq":"2026-06-23","jshj":377}},"增值税普票":{"value":{"fpdm":"011002100211","fphm":"90341717","kprq":"2022-11-15","jym":"579034"}},"区块链深圳":{"value":{"dq":"4403","fpdm":"144032609110","fphm":"07782308","xfsbh":"91440300MA5HTARM9D","jym":"6c6b5"}}}}}},"responses":{"200":{"description":"查验结果(以 data.verified 判断真伪)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyResponse"}}}}}}}},"components":{"schemas":{"VerifyRequest":{"type":"object","required":["fphm"],"properties":{"fphm":{"type":"string","description":"发票号码"},"fpdm":{"type":"string","description":"发票代码(数电票可空)"},"kprq":{"type":"string","description":"开票日期 yyyy-MM-dd"},"je":{"type":"number","description":"不含税金额(专用发票必填)"},"jym":{"type":"string","description":"校验码后6位(普通发票必填;区块链为短码)"},"jshj":{"type":"number","description":"价税合计(数电票/通用电子必填)"},"xfsbh":{"type":"string","description":"销售方税号(区块链/通用电子必填)"},"dq":{"type":"string","description":"地区码(特殊票种:4403深圳区块链/4400广东通用电子等)"},"customReqId":{"type":"string","description":"自定义请求ID"},"cyList":{"type":"array","items":{"type":"object"},"description":"批量查验(单次最多50张)"}}},"VerifyResponse":{"type":"object","properties":{"code":{"type":"string","example":"CYT_00000"},"msg":{"type":"string"},"requestId":{"type":"string"},"data":{"type":"object","properties":{"verified":{"type":"boolean","description":"是否查验通过(看这个)"},"channel":{"type":"string","description":"自动路由到的查验通道"},"reason":{"type":"string","description":"未通过时的原因"},"result":{"type":"array","items":{"type":"object","properties":{"success":{"type":"boolean"},"fphm":{"type":"string"},"kprq":{"type":"string"},"fplx":{"type":"string"},"data":{"type":"object","description":"全票面明细(字段随票种不同:税额普票=se,航空票=zzsse)"}}}}}}}}}}}